| <!-- jQuery Eclipse IP approval https://dev.eclipse.org/ipzilla/show_bug.cgi?id=10801 --> | |
| <script type="text/javascript" charset="utf8" src="../../../docs/assets/scripts/jquery-1.8.1.min.js"></script> | |
| <script type="text/javascript" charset="utf8"> | |
| $(document).ready(function(){ | |
| var images = document.getElementsByTagName('img'); | |
| for (var i = 0; i < images.length; i++) { | |
| var image = images[i]; | |
| var parentElement = image.parentElement; | |
| var a = document.createElement('a'); | |
| if (! image.getAttribute('src').includes("logo-codenvy.svg") && ! image.getAttribute('src').includes("codenvy-contribute.svg") ){ | |
| a.href = image.getAttribute('src'); | |
| a.target = "_blank"; | |
| a.appendChild(image); | |
| parentElement.appendChild(a); | |
| } | |
| } | |
| }); | |
| </script> | |
| <!DOCTYPE HTML> | |
| <html lang="en-US"> | |
| <head> | |
| <title>OpenShift Installation - | |
| Docs | |
| - Eclipse Che</title> | |
| <meta charset="UTF-8"> | |
| <meta name="viewport" content="width=device-width,initial-scale=1"> | |
| <meta name="generator" content="Jekyll v3.5.1"> | |
| <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900"> | |
| <link rel="stylesheet" href="../../../docs/assets/css/screen.css"> | |
| <link rel="icon" type="image/x-icon" href="../../../docs/assets/imgs/favicon.ico"> | |
| <!--[if lt IE 9]> | |
| <script src="/js/html5shiv.min.js"></script> | |
| <script src="/js/respond.min.js"></script> | |
| <![endif]--> | |
| </head> | |
| <body class="wrap"> | |
| <header> | |
| <nav class="mobile-nav show-on-mobiles"> | |
| <ul> | |
| <li class="current"> | |
| <a href="../../../docs/index.html">Docs</a> | |
| </li> | |
| <li class=""> | |
| <a href="../../../docs/tutorials/multi-machine/index.html">Tutorials</a> | |
| </li> | |
| <li class=""> | |
| <a href="../../../docs/openshift/config/index.html">OpenShift</a> | |
| </li> | |
| <li> | |
| <a href="https://github.com/eclipse/che-docs/tree/master/src/main">GitHub</a> | |
| </li> | |
| </ul> | |
| </nav> | |
| <div class="grid"> | |
| <div class="unit one-third center-on-mobiles"> | |
| <a href="https://eclipse.org/che/"> | |
| <span class="sr-only">Eclipse Che</span> | |
| <img src="../../../docs/assets/imgs/logo-eclipseche.svg" alt="Eclipse Che Logo" width="249" height="115"> | |
| </a> | |
| </div> | |
| <nav class="main-nav unit two-thirds hide-on-mobiles"> | |
| <ul> | |
| <li class="current"> | |
| <a href="../../../docs/index.html">Docs</a> | |
| </li> | |
| <li class=""> | |
| <a href="../../../docs/tutorials/multi-machine/index.html">Tutorials</a> | |
| </li> | |
| <li class=""> | |
| <a href="../../../docs/openshift/config/index.html">OpenShift</a> | |
| </li> | |
| <li> | |
| <a href="https://github.com/eclipse/che-docs/tree/master/src/main">GitHub</a> | |
| </li> | |
| </ul> | |
| </nav> | |
| </div> | |
| </header> | |
| <section class="docs"> | |
| <div class="grid"> | |
| <div class="docs-nav-mobile unit whole show-on-mobiles"> | |
| <select onchange="if (this.value) window.location.href=this.value"> | |
| <option value="">Navigate the docs…</option> | |
| <optgroup label="SETUP"> | |
| <ul> | |
| <option value="../../../docs/index.html">Introduction</option> | |
| <option value="../../../docs/setup/getting-started/index.html">Getting Started: Local</option> | |
| <option value="../../../docs/setup/getting-started-saas-cloud/index.html">Getting Started: SaaS Cloud</option> | |
| <option value="../../../docs/setup/configuration/index.html">Configuration</option> | |
| <option value="../../../docs/setup/managing/index.html">Managing</option> | |
| <option value="../../../docs/setup/cli/index.html">CLI Reference</option> | |
| <option value="../../../docs/setup/glossary/index.html">Glossary</option> | |
| <option value="../../../docs/setup/docker/index.html">Docker Installation</option> | |
| <option value="../../../docs/setup/openshift/index.html">OpenShift Installation</option> | |
| <option value="../../../docs/setup/selenium/index.html">How to run selenium tests</option> | |
| </ul> | |
| <ul> | |
| <li class=""><a href="../../../docs/index.html">Introduction</a></li> | |
| <li class=""><a href="../../../docs/setup/getting-started/index.html">Getting Started: Local</a></li> | |
| <li class=""><a href="../../../docs/setup/getting-started-saas-cloud/index.html">Getting Started: SaaS Cloud</a></li> | |
| <li class=""><a href="../../../docs/setup/configuration/index.html">Configuration</a></li> | |
| <li class=""><a href="../../../docs/setup/managing/index.html">Managing</a></li> | |
| <li class=""><a href="../../../docs/setup/cli/index.html">CLI Reference</a></li> | |
| <li class=""><a href="../../../docs/setup/glossary/index.html">Glossary</a></li> | |
| <li class=""><a href="../../../docs/setup/docker/index.html">Docker Installation</a></li> | |
| <li class="current"><a href="../../../docs/setup/openshift/index.html">OpenShift Installation</a></li> | |
| <li class=""><a href="../../../docs/setup/selenium/index.html">How to run selenium tests</a></li> | |
| </ul> | |
| </optgroup> | |
| <optgroup label="WORKSPACE ADMINISTRATION"> | |
| <ul> | |
| <option value="../../../docs/devops/intro/index.html">Introduction</option> | |
| <option value="../../../docs/devops/runtime-stacks/index.html">Runtime Stacks</option> | |
| <option value="../../../docs/devops/runtime-recipes/index.html">Runtime Recipes</option> | |
| <option value="../../../docs/devops/project-samples/index.html">Project Samples</option> | |
| <option value="../../../docs/devops/runtime-machines/index.html">Runtime Machines</option> | |
| <option value="../../../docs/devops/volume-mounts/index.html">Volume Mounts</option> | |
| <option value="../../../docs/devops/ws-agents/index.html">Workspace Agents</option> | |
| <option value="../../../docs/devops/workspaces-data-model/index.html">Workspace Data Model</option> | |
| <option value="../../../docs/devops/runtime-stacks-data-model/index.html">Runtime Stacks Data Model</option> | |
| <option value="../../../docs/devops/project-samples-data-model/index.html">Project Samples Data Model</option> | |
| </ul> | |
| <ul> | |
| <li class=""><a href="../../../docs/devops/intro/index.html">Introduction</a></li> | |
| <li class=""><a href="../../../docs/devops/runtime-stacks/index.html">Runtime Stacks</a></li> | |
| <li class=""><a href="../../../docs/devops/runtime-recipes/index.html">Runtime Recipes</a></li> | |
| <li class=""><a href="../../../docs/devops/project-samples/index.html">Project Samples</a></li> | |
| <li class=""><a href="../../../docs/devops/runtime-machines/index.html">Runtime Machines</a></li> | |
| <li class=""><a href="../../../docs/devops/volume-mounts/index.html">Volume Mounts</a></li> | |
| <li class=""><a href="../../../docs/devops/ws-agents/index.html">Workspace Agents</a></li> | |
| <li class=""><a href="../../../docs/devops/workspaces-data-model/index.html">Workspace Data Model</a></li> | |
| <li class=""><a href="../../../docs/devops/runtime-stacks-data-model/index.html">Runtime Stacks Data Model</a></li> | |
| <li class=""><a href="../../../docs/devops/project-samples-data-model/index.html">Project Samples Data Model</a></li> | |
| </ul> | |
| </optgroup> | |
| <optgroup label="USER GUIDE"> | |
| <ul> | |
| <option value="../../../docs/ide/projects/index.html">Projects</option> | |
| <option value="../../../docs/ide/import-a-project/index.html">Import</option> | |
| <option value="../../../docs/ide/ssh/index.html">SSH</option> | |
| <option value="../../../docs/ide/sync/index.html">Local IDE Sync</option> | |
| <option value="../../../docs/ide/editor-settings/index.html">Editor</option> | |
| <option value="../../../docs/ide/intellisense/index.html">Intellisense</option> | |
| <option value="../../../docs/ide/commands/index.html">Commands</option> | |
| <option value="../../../docs/ide/git-svn/index.html">Git and SVN</option> | |
| <option value="../../../docs/ide/previews/index.html">Previews</option> | |
| <option value="../../../docs/ide/build/index.html">Build</option> | |
| <option value="../../../docs/ide/run/index.html">Run</option> | |
| <option value="../../../docs/ide/sharing/index.html">Share</option> | |
| <option value="../../../docs/ide/debug/index.html">Debug</option> | |
| <option value="../../../docs/ide/docker/index.html">Docker</option> | |
| <option value="../../../docs/ide/electron/index.html">Install Che Desktop Client</option> | |
| </ul> | |
| <ul> | |
| <li class=""><a href="../../../docs/ide/projects/index.html">Projects</a></li> | |
| <li class=""><a href="../../../docs/ide/import-a-project/index.html">Import</a></li> | |
| <li class=""><a href="../../../docs/ide/ssh/index.html">SSH</a></li> | |
| <li class=""><a href="../../../docs/ide/sync/index.html">Local IDE Sync</a></li> | |
| <li class=""><a href="../../../docs/ide/editor-settings/index.html">Editor</a></li> | |
| <li class=""><a href="../../../docs/ide/intellisense/index.html">Intellisense</a></li> | |
| <li class=""><a href="../../../docs/ide/commands/index.html">Commands</a></li> | |
| <li class=""><a href="../../../docs/ide/git-svn/index.html">Git and SVN</a></li> | |
| <li class=""><a href="../../../docs/ide/previews/index.html">Previews</a></li> | |
| <li class=""><a href="../../../docs/ide/build/index.html">Build</a></li> | |
| <li class=""><a href="../../../docs/ide/run/index.html">Run</a></li> | |
| <li class=""><a href="../../../docs/ide/sharing/index.html">Share</a></li> | |
| <li class=""><a href="../../../docs/ide/debug/index.html">Debug</a></li> | |
| <li class=""><a href="../../../docs/ide/docker/index.html">Docker</a></li> | |
| <li class=""><a href="../../../docs/ide/electron/index.html">Install Che Desktop Client</a></li> | |
| </ul> | |
| </optgroup> | |
| <optgroup label="PORTABLE WORKSPACES"> | |
| <ul> | |
| <option value="../../../docs/chedir/getting-started/index.html">Chedir - Getting Started</option> | |
| <option value="../../../docs/chedir/why/index.html">Chedir - Why Chedir?</option> | |
| <option value="../../../docs/chedir/installation/index.html">Chedir - Installation</option> | |
| <option value="../../../docs/chedir/project-setup/index.html">Chedir - Project Setup</option> | |
| <option value="../../../docs/chedir/up-and-down/index.html">Chedir - Up and Down</option> | |
| <option value="../../../docs/chedir/chefiles/index.html">Chedir - Chefile</option> | |
| <option value="../../../docs/chedir/ssh/index.html">Chedir - SSH</option> | |
| <option value="../../../docs/chedir/factories/index.html">Chedir - Factories</option> | |
| <option value="">Error Generating Page Link. Contact Maintainer./docs/factory-getting-started/</option> | |
| <option value="">Error Generating Page Link. Contact Maintainer./docs/factory-creating/</option> | |
| <option value="">Error Generating Page Link. Contact Maintainer./docs/factory-json-reference/</option> | |
| </ul> | |
| <ul> | |
| <li class=""><a href="../../../docs/chedir/getting-started/index.html">Chedir - Getting Started</a></li> | |
| <li class=""><a href="../../../docs/chedir/why/index.html">Chedir - Why Chedir?</a></li> | |
| <li class=""><a href="../../../docs/chedir/installation/index.html">Chedir - Installation</a></li> | |
| <li class=""><a href="../../../docs/chedir/project-setup/index.html">Chedir - Project Setup</a></li> | |
| <li class=""><a href="../../../docs/chedir/up-and-down/index.html">Chedir - Up and Down</a></li> | |
| <li class=""><a href="../../../docs/chedir/chefiles/index.html">Chedir - Chefile</a></li> | |
| <li class=""><a href="../../../docs/chedir/ssh/index.html">Chedir - SSH</a></li> | |
| <li class=""><a href="../../../docs/chedir/factories/index.html">Chedir - Factories</a></li> | |
| <li class=""><a href="../../../docs/factory/getting-started/index.html">Factory - Getting Started</a></li> | |
| <li class=""><a href="../../../docs/factory/creating/index.html">Factory - Creating</a></li> | |
| <li class=""><a href="../../../docs/factory/json-reference/index.html">Factory - JSON Reference</a></li> | |
| </ul> | |
| </optgroup> | |
| <optgroup label="DEVELOPER GUIDE - REST API"> | |
| <ul> | |
| <option value="../../../docs/assemblies/intro/index.html">Introduction</option> | |
| <option value="../../../docs/assemblies/archetype/index.html">Archetype</option> | |
| <option value="../../../docs/assemblies/assembly-lifecycle/index.html">Assembly Dev Lifecycle</option> | |
| <option value="../../../docs/assemblies/plugin-lifecycle/index.html">Plugin Lifecycle</option> | |
| <option value="../../../docs/assemblies/sdk-rest-apis/index.html">SDK REST APIs</option> | |
| <option value="../../../docs/assemblies/sdk-class-reference/index.html">SDK Class Reference</option> | |
| <option value="../../../docs/assemblies/sdk-dependency-injection/index.html">SDK Dependency Injection</option> | |
| <option value="../../../docs/assemblies/sdk-dto/index.html">SDK DTOs</option> | |
| <option value="../../../docs/assemblies/sdk-properties/index.html">SDK Properties</option> | |
| <option value="../../../docs/assemblies/sdk-code-editors/index.html">SDK Editors</option> | |
| <option value="../../../docs/assemblies/sdk-embed-htmljs/index.html">SDK Embedded JavaScript</option> | |
| <option value="../../../docs/assemblies/sdk-project-types/index.html">SDK Project Types</option> | |
| <option value="../../../docs/assemblies/sdk-actions/index.html">SDK Actions</option> | |
| <option value="../../../docs/assemblies/sdk-services/index.html">SDK Services</option> | |
| <option value="../../../docs/assemblies/sdk-parts/index.html">SDK Parts</option> | |
| <option value="../../../docs/assemblies/sdk-themes/index.html">SDK Themes</option> | |
| <option value="../../../docs/assemblies/sdk-custom-agents/index.html">SDK Custom Agents</option> | |
| <option value="../../../docs/assemblies/sdk-language-server-protocol/index.html">SDK Language Server Protocol</option> | |
| <option value="../../../docs/assemblies/sdk-workspace/index.html">SDK Workspace</option> | |
| </ul> | |
| <ul> | |
| <li class=""><a href="../../../docs/assemblies/intro/index.html">Introduction</a></li> | |
| <li class=""><a href="../../../docs/assemblies/archetype/index.html">Archetype</a></li> | |
| <li class=""><a href="../../../docs/assemblies/assembly-lifecycle/index.html">Assembly Dev Lifecycle</a></li> | |
| <li class=""><a href="../../../docs/assemblies/plugin-lifecycle/index.html">Plugin Lifecycle</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-rest-apis/index.html">SDK REST APIs</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-class-reference/index.html">SDK Class Reference</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-dependency-injection/index.html">SDK Dependency Injection</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-dto/index.html">SDK DTOs</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-properties/index.html">SDK Properties</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-code-editors/index.html">SDK Editors</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-embed-htmljs/index.html">SDK Embedded JavaScript</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-project-types/index.html">SDK Project Types</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-actions/index.html">SDK Actions</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-services/index.html">SDK Services</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-parts/index.html">SDK Parts</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-themes/index.html">SDK Themes</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-custom-agents/index.html">SDK Custom Agents</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-language-server-protocol/index.html">SDK Language Server Protocol</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-workspace/index.html">SDK Workspace</a></li> | |
| </ul> | |
| </optgroup> | |
| </select> | |
| </div> | |
| <div class="unit four-fifths"> | |
| <article> | |
| <div class="improve right hide-on-mobiles"> | |
| <a href="https://github.com/codenvy/che-docs/blob/master/src/main/_docs/setup/setup-openshift.md"><i class="fa fa-pencil"></i> Improve this page</a> | |
| <!--<a href="https://github.com/eclipse/che/blob/master/docs/_docs/setup/setup-openshift.md"><i class="fa fa-pencil"></i> Improve this page</a>--> | |
| </div> | |
| <div class="doc-title"> | |
| <h1>OpenShift Installation</h1> | |
| <div class="doc-title-border"> | |
| </div> | |
| </div> | |
| <p>You can run the Che server and its workspaces with <a href="https://www.openshift.com/">OpenShift</a>. OpenShift is built on top of Kubernetes and has a built-in Docker registry, reverse proxy and OAuth server. OpenShift can be used to deploy Che as enterprise-wide cloud IDE.</p> | |
| <p>We currently support Che deployment for the following OpenShift flavours:</p> | |
| <ul> | |
| <li><a href="#deploy-che-on-openshift-container-platform">OpenShift Container Platform</a></li> | |
| <li><a href="#deploy-che-on-minishift">Minishift</a></li> | |
| <li><a href="#deploy-che-on-openshiftio">Openshift.io</a> (only for developing Che itself)</li> | |
| </ul> | |
| <h1 id="deploy-che-on-openshift-container-platform">Deploy Che on OpenShift Container Platform</h1> | |
| <p>Use environment variables to set <a href="#deployment-options">deployment options</a>:</p> | |
| <div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="nb">export </span><span class="nv">OPENSHIFT_ENDPOINT</span><span class="o">=</span><OCP_ENDPOINT_URL> <span class="c"># e.g. https://opnshmdnsy3t7twsh.centralus.cloudapp.azure.com:8443</span> | |
| <span class="nb">export </span><span class="nv">OPENSHIFT_TOKEN</span><span class="o">=</span><OCP_TOKEN> | |
| <span class="nb">export </span><span class="nv">OPENSHIFT_NAMESPACE_URL</span><span class="o">=</span><CHE_HOSTNAME> <span class="c"># e.g. che-eclipse-che.52.173.199.80.xip.io</span> | |
| <span class="nb">export </span><span class="nv">OPENSHIFT_FLAVOR</span><span class="o">=</span>ocp | |
| </code></pre> | |
| </div> | |
| <p>Download and run deployment scripts:</p> | |
| <div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="nv">DEPLOY_SCRIPT_URL</span><span class="o">=</span>https://raw.githubusercontent.com/eclipse/che/master/dockerfiles/init/modules/openshift/files/scripts/deploy_che.sh | |
| <span class="nv">WAIT_SCRIPT_URL</span><span class="o">=</span>https://raw.githubusercontent.com/eclipse/che/master/dockerfiles/init/modules/openshift/files/scripts/wait_until_che_is_available.sh | |
| <span class="nv">STACKS_SCRIPT_URL</span><span class="o">=</span>https://raw.githubusercontent.com/eclipse/che/master/dockerfiles/init/modules/openshift/files/scripts/replace_stacks.sh | |
| curl -fsSL <span class="k">${</span><span class="nv">DEPLOY_SCRIPT_URL</span><span class="k">}</span> -o ./get-che.sh | |
| curl -fsSL <span class="k">${</span><span class="nv">WAIT_SCRIPT_URL</span><span class="k">}</span> -o ./wait-che.sh | |
| curl -fsSL <span class="k">${</span><span class="nv">STACKS_SCRIPT_URL</span><span class="k">}</span> -o ./stacks-che.sh | |
| bash ./get-che.sh <span class="o">&&</span> bash ./wait-che.sh <span class="o">&&</span> bash ./stacks-che.sh | |
| </code></pre> | |
| </div> | |
| <h1 id="deploy-che-on-minishift">Deploy Che on Minishift</h1> | |
| <p>Download and run deployment scripts:</p> | |
| <div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="nv">DEPLOY_SCRIPT_URL</span><span class="o">=</span>https://raw.githubusercontent.com/eclipse/che/master/dockerfiles/init/modules/openshift/files/scripts/deploy_che.sh | |
| <span class="nv">WAIT_SCRIPT_URL</span><span class="o">=</span>https://raw.githubusercontent.com/eclipse/che/master/dockerfiles/init/modules/openshift/files/scripts/wait_until_che_is_available.sh | |
| <span class="nv">STACKS_SCRIPT_URL</span><span class="o">=</span>https://raw.githubusercontent.com/eclipse/che/master/dockerfiles/init/modules/openshift/files/scripts/replace_stacks.sh | |
| curl -fsSL <span class="k">${</span><span class="nv">DEPLOY_SCRIPT_URL</span><span class="k">}</span> -o ./get-che.sh | |
| curl -fsSL <span class="k">${</span><span class="nv">WAIT_SCRIPT_URL</span><span class="k">}</span> -o ./wait-che.sh | |
| curl -fsSL <span class="k">${</span><span class="nv">STACKS_SCRIPT_URL</span><span class="k">}</span> -o ./stacks-che.sh | |
| bash ./get-che.sh <span class="o">&&</span> bash ./wait-che.sh <span class="o">&&</span> bash ./stacks-che.sh | |
| </code></pre> | |
| </div> | |
| <h1 id="deploy-che-on-openshiftio">Deploy Che on openshift.io</h1> | |
| <p>Please note that deploying Che on <a href="openshift.io">OpenShift.io</a> (OSIO) is only intended for Che developers and OSIO contributors. This is useful when a developer wants to test how changes will work on <a href="openshift.io">OpenShift.io</a>. If you are interested in using OpenShift.io you can <a href="https://openshift.io/">sign up</a> for the service.</p> | |
| <p>Use environment variables to set <a href="#deployment-options">deployment options</a>:</p> | |
| <div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="nb">export </span><span class="nv">OPENSHIFT_TOKEN</span><span class="o">=</span><OSO_TOKEN> <span class="c"># Retrieve the OSO_TOKEN from https://console.starter-us-east-2.openshift.com/console/command-line</span> | |
| <span class="nb">export </span><span class="nv">OPENSHIFT_FLAVOR</span><span class="o">=</span>osio | |
| </code></pre> | |
| </div> | |
| <p>Download and run deployment scripts:</p> | |
| <div class="language-shell highlighter-rouge"><pre class="highlight"><code><span class="nv">DEPLOY_SCRIPT_URL</span><span class="o">=</span>https://raw.githubusercontent.com/eclipse/che/master/dockerfiles/init/modules/openshift/files/scripts/deploy_che.sh | |
| <span class="nv">WAIT_SCRIPT_URL</span><span class="o">=</span>https://raw.githubusercontent.com/eclipse/che/master/dockerfiles/init/modules/openshift/files/scripts/wait_until_che_is_available.sh | |
| <span class="nv">STACKS_SCRIPT_URL</span><span class="o">=</span>https://raw.githubusercontent.com/eclipse/che/master/dockerfiles/init/modules/openshift/files/scripts/replace_stacks.sh | |
| curl -fsSL <span class="k">${</span><span class="nv">DEPLOY_SCRIPT_URL</span><span class="k">}</span> -o ./get-che.sh | |
| curl -fsSL <span class="k">${</span><span class="nv">WAIT_SCRIPT_URL</span><span class="k">}</span> -o ./wait-che.sh | |
| curl -fsSL <span class="k">${</span><span class="nv">STACKS_SCRIPT_URL</span><span class="k">}</span> -o ./stacks-che.sh | |
| bash ./get-che.sh <span class="o">&&</span> bash ./wait-che.sh <span class="o">&&</span> bash ./stacks-che.sh | |
| </code></pre> | |
| </div> | |
| <h1 id="deployment-options">Deployment Options</h1> | |
| <p>You can set different deployment options using environment variables:</p> | |
| <ul> | |
| <li><code class="highlighter-rouge">OPENSHIFT_FLAVOR</code>: Possible values are <code class="highlighter-rouge">ocp</code>, <code class="highlighter-rouge">minishift</code> and <code class="highlighter-rouge">osio</code> (default is <code class="highlighter-rouge">minishift</code>)</li> | |
| <li><code class="highlighter-rouge">OPENSHIFT_ENDPOINT</code>: URL of the OpenShift API (default is unset for ocp, <code class="highlighter-rouge">https://$(minishift ip):8443/</code> for minishift, <code class="highlighter-rouge">https://api.starter-us-east-2.openshift.com</code> for osio)</li> | |
| <li><code class="highlighter-rouge">OPENSHIFT_TOKEN</code> (default is unset)</li> | |
| <li><code class="highlighter-rouge">CHE_OPENSHIFT_PROJECT</code>: The OpenShift namespace where Che will be deployed (default is <code class="highlighter-rouge">eclipse-che</code> for ocp and minishift and <code class="highlighter-rouge">${OPENSHIFT_ID}-che</code> for osio)</li> | |
| <li><code class="highlighter-rouge">CHE_IMAGE_REPO</code>: <code class="highlighter-rouge">che-server</code> Docker image repository that will be used for deployment (default is <code class="highlighter-rouge">docker.io/eclipse/che-server</code>)</li> | |
| <li><code class="highlighter-rouge">CHE_IMAGE_TAG</code>: <code class="highlighter-rouge">che-server</code> Docker image tag that will be used for deployment (default is <code class="highlighter-rouge">nightly-centos</code>)</li> | |
| <li><code class="highlighter-rouge">CHE_LOG_LEVEL</code>: Logging level of output for Che server. Can be <code class="highlighter-rouge">debug</code> or <code class="highlighter-rouge">info</code> (default is <code class="highlighter-rouge">DEBUG</code>)</li> | |
| <li><code class="highlighter-rouge">CHE_DEBUGGING_ENABLED</code>: If set to <code class="highlighter-rouge">true</code> the script will create the OpenShift service to debug che-server (default is <code class="highlighter-rouge">true</code>)</li> | |
| <li><code class="highlighter-rouge">CHE_KEYCLOAK_DISABLED</code>: If this is set to true Keycloack authentication will be disabled (default is <code class="highlighter-rouge">true</code> for ocp and minishift, <code class="highlighter-rouge">false</code> for osio)</li> | |
| <li><code class="highlighter-rouge">OPENSHIFT_NAMESPACE_URL</code>: The Che application hostname (default is unset for ocp, <code class="highlighter-rouge">${CHE_OPENSHIFT_PROJECT}.$(minishift ip).nip.io</code> for minishift, <code class="highlighter-rouge">${CHE_OPENSHIFT_PROJECT}.8a09.starter-us-east-2.openshiftapps.com</code> for osio)</li> | |
| </ul> | |
| <p>OCP and Minishift only options:</p> | |
| <ul> | |
| <li><code class="highlighter-rouge">OPENSHIFT_USERNAME</code>: username to login on the OpenShift cluster. Ignored if <code class="highlighter-rouge">OPENSHIFT_TOKEN</code> is set (default is <code class="highlighter-rouge">developer</code>)</li> | |
| <li><code class="highlighter-rouge">OPENSHIFT_PASSWORD</code>: password to login on the OpenShift cluster. Ignored if <code class="highlighter-rouge">OPENSHIFT_TOKEN</code> is set (default is <code class="highlighter-rouge">developer</code>)</li> | |
| </ul> | |
| <h1 id="custom-che-workspace-runtimes-in-openshift">Custom Che Workspace Runtimes in OpenShift</h1> | |
| <p>Defining a custom Runtime Stack using <a href="../../../docs/devops/runtime-recipes/index.html">a recipe</a>, as a Dockerfile or a Docker Compose file, is currently not supported on OpenShift.</p> | |
| <p>However it is still possible to define new Runtime Stacks using Docker images that have been pushed to a Docker registry. Instructions to create a custom Runtime Stack can be found <a href="../../../docs/devops/runtime-stacks/index.html">here</a>.</p> | |
| <p>Custom Docker images must meet <a href="../../../docs/devops/runtime-recipes/index.html#che-runtime-required-dependencies">the normal criteria</a> required to run as a Che runtime. In addition it should follow the <a href="https://docs.openshift.org/latest/creating_images/guidelines.html#openshift-origin-specific-guidelines">guidelines to create Docker images to run on OpenShift</a>.</p> | |
| <p>Some examples of Dockerfiles used to create such images can be found <a href="https://github.com/redhat-developer/che-dockerfiles/tree/master/recipes">here</a>.</p> | |
| </article> | |
| </div> | |
| <div class="unit one-fifth hide-on-mobiles"> | |
| <aside> | |
| <h4>SETUP</h4> | |
| <ul> | |
| <li class=""><a href="../../../docs/index.html">Introduction</a></li> | |
| <li class=""><a href="../../../docs/setup/getting-started/index.html">Getting Started: Local</a></li> | |
| <li class=""><a href="../../../docs/setup/getting-started-saas-cloud/index.html">Getting Started: SaaS Cloud</a></li> | |
| <li class=""><a href="../../../docs/setup/configuration/index.html">Configuration</a></li> | |
| <li class=""><a href="../../../docs/setup/managing/index.html">Managing</a></li> | |
| <li class=""><a href="../../../docs/setup/cli/index.html">CLI Reference</a></li> | |
| <li class=""><a href="../../../docs/setup/glossary/index.html">Glossary</a></li> | |
| <li class=""><a href="../../../docs/setup/docker/index.html">Docker Installation</a></li> | |
| <li class="current"><a href="../../../docs/setup/openshift/index.html">OpenShift Installation</a></li> | |
| <li class=""><a href="../../../docs/setup/selenium/index.html">How to run selenium tests</a></li> | |
| </ul> | |
| <h4>WORKSPACE ADMINISTRATION</h4> | |
| <ul> | |
| <li class=""><a href="../../../docs/devops/intro/index.html">Introduction</a></li> | |
| <li class=""><a href="../../../docs/devops/runtime-stacks/index.html">Runtime Stacks</a></li> | |
| <li class=""><a href="../../../docs/devops/runtime-recipes/index.html">Runtime Recipes</a></li> | |
| <li class=""><a href="../../../docs/devops/project-samples/index.html">Project Samples</a></li> | |
| <li class=""><a href="../../../docs/devops/runtime-machines/index.html">Runtime Machines</a></li> | |
| <li class=""><a href="../../../docs/devops/volume-mounts/index.html">Volume Mounts</a></li> | |
| <li class=""><a href="../../../docs/devops/ws-agents/index.html">Workspace Agents</a></li> | |
| <li class=""><a href="../../../docs/devops/workspaces-data-model/index.html">Workspace Data Model</a></li> | |
| <li class=""><a href="../../../docs/devops/runtime-stacks-data-model/index.html">Runtime Stacks Data Model</a></li> | |
| <li class=""><a href="../../../docs/devops/project-samples-data-model/index.html">Project Samples Data Model</a></li> | |
| </ul> | |
| <h4>USER GUIDE</h4> | |
| <ul> | |
| <li class=""><a href="../../../docs/ide/projects/index.html">Projects</a></li> | |
| <li class=""><a href="../../../docs/ide/import-a-project/index.html">Import</a></li> | |
| <li class=""><a href="../../../docs/ide/ssh/index.html">SSH</a></li> | |
| <li class=""><a href="../../../docs/ide/sync/index.html">Local IDE Sync</a></li> | |
| <li class=""><a href="../../../docs/ide/editor-settings/index.html">Editor</a></li> | |
| <li class=""><a href="../../../docs/ide/intellisense/index.html">Intellisense</a></li> | |
| <li class=""><a href="../../../docs/ide/commands/index.html">Commands</a></li> | |
| <li class=""><a href="../../../docs/ide/git-svn/index.html">Git and SVN</a></li> | |
| <li class=""><a href="../../../docs/ide/previews/index.html">Previews</a></li> | |
| <li class=""><a href="../../../docs/ide/build/index.html">Build</a></li> | |
| <li class=""><a href="../../../docs/ide/run/index.html">Run</a></li> | |
| <li class=""><a href="../../../docs/ide/sharing/index.html">Share</a></li> | |
| <li class=""><a href="../../../docs/ide/debug/index.html">Debug</a></li> | |
| <li class=""><a href="../../../docs/ide/docker/index.html">Docker</a></li> | |
| <li class=""><a href="../../../docs/ide/electron/index.html">Install Che Desktop Client</a></li> | |
| </ul> | |
| <h4>PORTABLE WORKSPACES</h4> | |
| <ul> | |
| <li class=""><a href="../../../docs/chedir/getting-started/index.html">Chedir - Getting Started</a></li> | |
| <li class=""><a href="../../../docs/chedir/why/index.html">Chedir - Why Chedir?</a></li> | |
| <li class=""><a href="../../../docs/chedir/installation/index.html">Chedir - Installation</a></li> | |
| <li class=""><a href="../../../docs/chedir/project-setup/index.html">Chedir - Project Setup</a></li> | |
| <li class=""><a href="../../../docs/chedir/up-and-down/index.html">Chedir - Up and Down</a></li> | |
| <li class=""><a href="../../../docs/chedir/chefiles/index.html">Chedir - Chefile</a></li> | |
| <li class=""><a href="../../../docs/chedir/ssh/index.html">Chedir - SSH</a></li> | |
| <li class=""><a href="../../../docs/chedir/factories/index.html">Chedir - Factories</a></li> | |
| <li class=""><a href="../../../docs/factory/getting-started/index.html">Factory - Getting Started</a></li> | |
| <li class=""><a href="../../../docs/factory/creating/index.html">Factory - Creating</a></li> | |
| <li class=""><a href="../../../docs/factory/json-reference/index.html">Factory - JSON Reference</a></li> | |
| </ul> | |
| <h4>DEVELOPER GUIDE - REST API</h4> | |
| <ul> | |
| <li class=""><a href="../../../docs/assemblies/intro/index.html">Introduction</a></li> | |
| <li class=""><a href="../../../docs/assemblies/archetype/index.html">Archetype</a></li> | |
| <li class=""><a href="../../../docs/assemblies/assembly-lifecycle/index.html">Assembly Dev Lifecycle</a></li> | |
| <li class=""><a href="../../../docs/assemblies/plugin-lifecycle/index.html">Plugin Lifecycle</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-rest-apis/index.html">SDK REST APIs</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-class-reference/index.html">SDK Class Reference</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-dependency-injection/index.html">SDK Dependency Injection</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-dto/index.html">SDK DTOs</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-properties/index.html">SDK Properties</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-code-editors/index.html">SDK Editors</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-embed-htmljs/index.html">SDK Embedded JavaScript</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-project-types/index.html">SDK Project Types</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-actions/index.html">SDK Actions</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-services/index.html">SDK Services</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-parts/index.html">SDK Parts</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-themes/index.html">SDK Themes</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-custom-agents/index.html">SDK Custom Agents</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-language-server-protocol/index.html">SDK Language Server Protocol</a></li> | |
| <li class=""><a href="../../../docs/assemblies/sdk-workspace/index.html">SDK Workspace</a></li> | |
| </ul> | |
| </aside> | |
| </div> | |
| <div class="clear"></div> | |
| </div> | |
| </section> | |
| <script> | |
| var anchorForId = function (id) { | |
| var anchor = document.createElement("a"); | |
| anchor.className = "header-link"; | |
| anchor.href = "#" + id; | |
| anchor.innerHTML = "<span class=\"sr-only\">Permalink</span><i class=\"fa fa-link\"></i>"; | |
| anchor.title = "Permalink"; | |
| return anchor; | |
| }; | |
| var linkifyAnchors = function (level, containingElement) { | |
| var headers = containingElement.getElementsByTagName("h" + level); | |
| for (var h = 0; h < headers.length; h++) { | |
| var header = headers[h]; | |
| if (typeof header.id !== "undefined" && header.id !== "") { | |
| header.appendChild(anchorForId(header.id)); | |
| } | |
| } | |
| }; | |
| document.onreadystatechange = function () { | |
| if (this.readyState === "complete") { | |
| var contentBlock = document.getElementsByClassName("artik")[0] || document.getElementsByClassName("openshift")[0] || document.getElementsByClassName("tutorials")[0] || document.getElementsByClassName("docs")[0] || document.getElementsByClassName("news")[0]; | |
| if (!contentBlock) { | |
| return; | |
| } | |
| for (var level = 1; level <= 6; level++) { | |
| linkifyAnchors(level, contentBlock); | |
| } | |
| } | |
| }; | |
| </script> | |
| </body> | |
| </html> |