diff --git a/.gitignore b/.gitignore index bed5638306..d7a37026fe 100644 --- a/.gitignore +++ b/.gitignore @@ -43,3 +43,4 @@ yarn.lock # Do not commit diagrams generated for downstream crw* +CLAUDE.md diff --git a/antora.yml b/antora.yml index 3fdc2afb7c..40cb031041 100644 --- a/antora.yml +++ b/antora.yml @@ -11,6 +11,7 @@ nav: - modules/upgrade/nav.adoc - modules/secure/nav.adoc - modules/optimize/nav.adoc + - modules/integrate/nav.adoc - modules/administration-guide/nav.adoc - modules/extensions/nav.adoc - modules/glossary/nav.adoc diff --git a/modules/administration-guide/nav.adoc b/modules/administration-guide/nav.adoc index 844c4820c7..e746b81bdc 100644 --- a/modules/administration-guide/nav.adoc +++ b/modules/administration-guide/nav.adoc @@ -51,13 +51,6 @@ *** xref:configuring-ai-providers.adoc[] **** xref:ai-provider-api-key-secret-reference.adoc[] *** xref:customizing-openshift-che-branding-images.adoc[] -** xref:configuring-oauth-for-git-providers.adoc[] -*** xref:configuring-oauth-2-for-github.adoc[] -*** xref:configuring-oauth-2-for-gitlab.adoc[] -*** xref:configuring-oauth-2-for-a-bitbucket-server.adoc[] -*** xref:configuring-oauth-2-for-the-bitbucket-cloud.adoc[] -*** xref:configuring-oauth-1-for-a-bitbucket-server.adoc[] -*** xref:configuring-oauth-2-for-microsoft-azure-devops-services.adoc[] ** xref:configuring-fuse.adoc[] *** xref:enabling-access-to-dev-fuse-for-openshift.adoc[] *** xref:enabling-fuse-for-all-workspaces.adoc[] diff --git a/modules/administration-guide/pages/managing-workloads-using-the-che-server-api.adoc b/modules/administration-guide/pages/managing-workloads-using-the-che-server-api.adoc index a30623710a..2dcfc8b031 100644 --- a/modules/administration-guide/pages/managing-workloads-using-the-che-server-api.adoc +++ b/modules/administration-guide/pages/managing-workloads-using-the-che-server-api.adoc @@ -15,7 +15,7 @@ To manage {prod-short} server and {prod-short} dashboard workloads, use the Swag - `pass:c,a,q[{prod-url}]/swagger` ({prod-short} server) - `pass:c,a,q[{prod-url}]/dashboard/api/swagger` ({prod-short} dashboard) -IMPORTANT: DevWorkspace is a k8s object and manipulations should happen on the Kubernetes API level - xref:end-user-guide:managing-workspaces-with-apis.adoc[] +IMPORTANT: DevWorkspace is a k8s object and manipulations should happen on the Kubernetes API level - xref:integrate:managing-workspaces-with-apis.adoc[] .Additional resources diff --git a/modules/discover/pages/roles-and-tasks.adoc b/modules/discover/pages/roles-and-tasks.adoc index c487c1a27b..e1e570c528 100644 --- a/modules/discover/pages/roles-and-tasks.adoc +++ b/modules/discover/pages/roles-and-tasks.adoc @@ -18,7 +18,7 @@ Common tasks include: * Deploy {prod-short} on a cluster. See xref:install:installing-che.adoc[]. * Configure the `CheCluster` custom resource. See xref:administration-guide:understanding-the-checluster-custom-resource.adoc[]. -* Set up OAuth for Git providers. See xref:administration-guide:configuring-oauth-for-git-providers.adoc[]. +* Set up OAuth for Git providers. See xref:integrate:configuring-oauth-for-git-providers.adoc[]. * Upgrade to the latest version. See xref:administration-guide:upgrading-che.adoc[]. * Monitor metrics and logs. See xref:administration-guide:configuring-observability.adoc[]. diff --git a/modules/end-user-guide/nav.adoc b/modules/end-user-guide/nav.adoc index af660602bd..20244eecdb 100644 --- a/modules/end-user-guide/nav.adoc +++ b/modules/end-user-guide/nav.adoc @@ -47,19 +47,7 @@ ** xref:mounting-configmaps.adoc[] *** xref:mounting-git-configuration.adoc[] *** xref:mounting-ssh-configuration.adoc[] -** xref:enabling-artifact-repositories-in-a-restricted-environment.adoc[] -*** xref:enabling-maven-artifact-repositories.adoc[] -*** xref:enabling-gradle-artifact-repositories.adoc[] -*** xref:enabling-npm-artifact-repositories.adoc[] -*** xref:enabling-python-artifact-repositories.adoc[] -*** xref:enabling-go-artifact-repositories.adoc[] -*** xref:enabling-nuget-artifact-repositories.adoc[] * xref:requesting-persistent-storage-for-workspaces.adoc[] -* xref:integrating-with-kubernetes.adoc[] -** xref:managing-workspaces-with-apis.adoc[] -** xref:automatic-token-injection.adoc[] -** xref:navigating-che-from-openshift-developer-perspective.adoc[] -** xref:navigating-openshift-web-console-from-che.adoc[] * xref:troubleshooting-che.adoc[] ** xref:viewing-che-workspaces-logs.adoc[] *** xref:viewing-workspace-logs-in-cli.adoc[] diff --git a/modules/end-user-guide/pages/authenticating-to-a-git-server-from-a-workspace.adoc b/modules/end-user-guide/pages/authenticating-to-a-git-server-from-a-workspace.adoc index 82294e90fd..bf6b831245 100644 --- a/modules/end-user-guide/pages/authenticating-to-a-git-server-from-a-workspace.adoc +++ b/modules/end-user-guide/pages/authenticating-to-a-git-server-from-a-workspace.adoc @@ -7,19 +7,17 @@ [id="authenticating-to-a-git-server-from-a-workspace"] = Authenticating to a Git server from a workspace -pass:[] In a workspace, you can run Git commands that require user authentication like cloning a remote private Git repository or pushing to a remote public or private Git repository. User authentication to a Git server from a workspace is configured by the administrator or, in some cases, by the individual user: -* Your administrator sets up an xref:administration-guide:configuring-oauth-for-git-providers.adoc[OAuth application on GitHub, GitLab, Bitbucket, or Microsoft Azure Repos] for your organization's {prod} instance. +* Your administrator sets up an xref:integrate:configuring-oauth-for-git-providers.adoc[OAuth application on GitHub, GitLab, Bitbucket, or Microsoft Azure Repos] for your organization's {prod} instance. * As a workaround, some users create and apply their own {kubernetes} Secrets for their personal xref:using-a-git-provider-access-token.adoc[Git-provider access tokens] or link:https://github.com/devfile/devworkspace-operator/blob/main/docs/additional-configuration.adoc#configuring-devworkspaces-to-use-ssh-keys-for-git-operations[configure SSH keys for Git operations]. .Additional resources -* xref:administration-guide:configuring-oauth-for-git-providers.adoc[Administration Guide: Configuring OAuth for Git providers] +* xref:integrate:configuring-oauth-for-git-providers.adoc[Administration Guide: Configuring OAuth for Git providers] * xref:using-a-git-provider-access-token.adoc[User Guide: Using a Git-provider access token] * link:https://github.com/devfile/devworkspace-operator/blob/main/docs/additional-configuration.adoc#configuring-devworkspaces-to-use-ssh-keys-for-git-operations[Configuring DevWorkspaces to use SSH keys for Git operations] -pass:[] \ No newline at end of file diff --git a/modules/end-user-guide/pages/automatic-token-injection.adoc b/modules/end-user-guide/pages/automatic-token-injection.adoc deleted file mode 100644 index da7caa5b67..0000000000 --- a/modules/end-user-guide/pages/automatic-token-injection.adoc +++ /dev/null @@ -1,23 +0,0 @@ -:_content-type: PROCEDURE -:description: Automatic {orch-name} token injection -:keywords: user-guide, token, injection -:navtitle: Automatic {orch-name} token injection -:page-aliases: .:automatic-token-injection.adoc, overview:automatic-token-injection.adoc - -[id="automatic-token-injection"] -= Automatic {orch-name} token injection - -This section describes how to use the {orch-name} user token that is automatically injected into workspace containers which allows running {prod-short} CLI commands against {orch-name} cluster. - -.Procedure - -. Open the {prod-short} dashboard and start a workspace. - -. Once the workspace is started, open a terminal in the container that contains the {prod-short} CLI. - -. Execute {prod-short} CLI commands which allow you to run commands against {orch-name} cluster. CLI can be used for deploying applications, inspecting and managing cluster resources, and viewing logs. {orch-name} user token will be used during the execution of the commands. - -+ -image::integration/token-injection.png[Token Injection in IDE,link="{imagesdir}/integration/token-injection.png"] - -WARNING: The automatic token injection currently works only on the OpenShift infrastructure. diff --git a/modules/end-user-guide/pages/using-a-git-provider-access-token.adoc b/modules/end-user-guide/pages/using-a-git-provider-access-token.adoc index bcf5f14d37..b9d6c6ea1d 100644 --- a/modules/end-user-guide/pages/using-a-git-provider-access-token.adoc +++ b/modules/end-user-guide/pages/using-a-git-provider-access-token.adoc @@ -7,9 +7,8 @@ [id="using-a-git-provider-access-token"] = Using a Git-provider access token -pass:[] -OAuth for GitHub, GitLab, Bitbucket, or Microsoft Azure Repos needs to be xref:administration-guide:configuring-oauth-for-git-providers.adoc[configured by the administrator] of your organization's {prod-short} instance. If your administrator could not configure it for {prod-short} users, the workaround is for you to use a personal access token. You can configure personal access tokens on the *User Preferences* page of your {prod-short} dashboard: `pass:c,a,q[{prod-url}]/dashboard/#/user-preferences?tab=personal-access-tokens`, or apply it manually as a {kubernetes} Secret in the namespace. +OAuth for GitHub, GitLab, Bitbucket, or Microsoft Azure Repos needs to be xref:integrate:configuring-oauth-for-git-providers.adoc[configured by the administrator] of your organization's {prod-short} instance. If your administrator could not configure it for {prod-short} users, the workaround is for you to use a personal access token. You can configure personal access tokens on the *User Preferences* page of your {prod-short} dashboard: `pass:c,a,q[{prod-url}]/dashboard/#/user-preferences?tab=personal-access-tokens`, or apply it manually as a {kubernetes} Secret in the namespace. Mounting your access token as a Secret enables the {prod-short} Server to access the remote repository that is cloned during workspace creation, including access to the repository's `/.che` and `/.vscode` folders. @@ -147,7 +146,6 @@ The `extraheader` configuration is needed for remote git operations to Azure Dev * xref:administration-guide:deploying-che-with-support-for-git-repositories-with-self-signed-certificates.adoc[Deploying Che with support for Git repositories with self-signed certificates] * link:https://docs.github.com/en/enterprise-cloud@latest/authentication/authenticating-with-saml-single-sign-on/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on[Authorizing a personal access token for use with SAML single sign-on] -pass:[] diff --git a/modules/end-user-guide/partials/proc_listing-workspaces.adoc b/modules/end-user-guide/partials/proc_listing-workspaces.adoc deleted file mode 100644 index 5057e7e860..0000000000 --- a/modules/end-user-guide/partials/proc_listing-workspaces.adoc +++ /dev/null @@ -1,49 +0,0 @@ - -[id="listing-workspaces"] -= Listing all workspaces - -As a user, you can list your workspaces by using the command line. - -.Prerequisites - -* An active `{orch-cli}` session with permissions to `get` the `DevWorkspace` resources in your {orch-namespace} on the cluster. See {orch-cli-link}. - -* You know the relevant {prod-short} user namespace on the cluster. -+ -TIP: You can visit `pass:c,a,q[{prod-url}]/api/kubernetes/namespace` to get your {prod-short} user namespace as `name`. - -* You are in the {prod-short} user namespace on the cluster. -+ -[TIP] -==== -On OpenShift, you can use the command-line `oc` tool to link:https://docs.openshift.com/container-platform/latest/cli_reference/openshift_cli/developer-cli-commands.html#oc-project[display your current namespace or switch to a namespace]. -==== - -.Procedure - -* To list your workspaces, enter the following on a command line: -+ -[source,subs="+attributes"] ----- -$ {orch-cli} get devworkspaces ----- -+ -.Output -==== ----- -NAMESPACE NAME DEVWORKSPACE ID PHASE INFO -user1-dev spring-petclinic workspace6d99e9ffb9784491 Running https://url-to-workspace.com -user1-dev golang-example workspacedf64e4a492cd4701 Stopped Stopped -user1-dev python-hello-world workspace69c26884bbc141f2 Failed Container tooling has state CrashLoopBackOff ----- -==== - -[TIP] -==== -You can view *PHASE* changes live by adding the `--watch` flag to this command. -==== - -[NOTE] -==== -Users with administrative permissions on the cluster can list all workspaces from all {prod-short} users by including the `--all-namespaces` flag. -==== \ No newline at end of file diff --git a/modules/end-user-guide/partials/proc_removing-workspaces.adoc b/modules/end-user-guide/partials/proc_removing-workspaces.adoc deleted file mode 100644 index 07494db078..0000000000 --- a/modules/end-user-guide/partials/proc_removing-workspaces.adoc +++ /dev/null @@ -1,40 +0,0 @@ - -[id="removing-workspaces"] -= Removing workspaces - -You can remove a workspace by simply deleting the `DevWorkspace` custom resource. - -WARNING: Deleting the `DevWorkspace` custom resource will also delete other workspace resources if they were created by {prod-short}: for example, the referenced `DevWorkspaceTemplate` and per-workspace `PersistentVolumeClaims`. - -TIP: Remove workspaces by using the {prod-short} dashboard whenever possible. - -.Prerequisites - -* An active `{orch-cli}` session on the cluster. See {orch-cli-link}. - -* You know the workspace name. -+ -[TIP] -==== -You can find the relevant workspace name in the output of `$ {orch-cli} get devworkspaces`. -==== - -* You know the relevant {prod-short} user namespace on the cluster. -+ -TIP: You can visit `pass:c,a,q[{prod-url}]/api/kubernetes/namespace` to get your {prod-short} user namespace as `name`. - -* You are in the {prod-short} user namespace on the cluster. -+ -[TIP] -==== -On OpenShift, you can use the command-line `oc` tool to link:https://docs.openshift.com/container-platform/latest/cli_reference/openshift_cli/developer-cli-commands.html#oc-project[display your current namespace or switch to a namespace]. -==== - -.Procedure - -* Run the following command to remove a workspace: -+ -[subs="+quotes,attributes"] ----- -$ {orch-cli} delete devworkspace ____ -n ____ ----- diff --git a/modules/end-user-guide/partials/proc_starting-stopped-workspaces.adoc b/modules/end-user-guide/partials/proc_starting-stopped-workspaces.adoc deleted file mode 100644 index 2472b238c4..0000000000 --- a/modules/end-user-guide/partials/proc_starting-stopped-workspaces.adoc +++ /dev/null @@ -1,40 +0,0 @@ - -[id="starting-stopped-workspaces"] -= Starting stopped workspaces - -You can start a stopped workspace by setting the `spec.started` field in the `Devworkspace` custom resource to `true`. - -.Prerequisites - -* An active `{orch-cli}` session on the cluster. See {orch-cli-link}. - -* You know the workspace name. -+ -[TIP] -==== -You can find the relevant workspace name in the output of `$ {orch-cli} get devworkspaces`. -==== - -* You know the relevant {prod-short} user namespace on the cluster. -+ -TIP: You can visit `pass:c,a,q[{prod-url}]/api/kubernetes/namespace` to get your {prod-short} user namespace as `name`. - -* You are in the {prod-short} user namespace on the cluster. -+ -[TIP] -==== -On OpenShift, you can use the command-line `oc` tool to link:https://docs.openshift.com/container-platform/latest/cli_reference/openshift_cli/developer-cli-commands.html#oc-project[display your current namespace or switch to a namespace]. -==== - -.Procedure - -* Run the following command to start a stopped workspace: -+ -[subs="+quotes,attributes"] ----- -$ {orch-cli} patch devworkspace ____ \ --p '{"spec":{"started":true}}' \ ---type=merge -n ____ && \ -{orch-cli} wait --for=jsonpath='{.status.phase}'=Running \ -dw/____ -n ____ ----- diff --git a/modules/end-user-guide/partials/proc_stopping-workspaces.adoc b/modules/end-user-guide/partials/proc_stopping-workspaces.adoc deleted file mode 100644 index 13798ae00c..0000000000 --- a/modules/end-user-guide/partials/proc_stopping-workspaces.adoc +++ /dev/null @@ -1,40 +0,0 @@ - -[id="stopping-workspaces"] -= Stopping workspaces - -You can stop a workspace by setting the `spec.started` field in the `Devworkspace` custom resource to `false`. - -.Prerequisites - -* An active `{orch-cli}` session on the cluster. See {orch-cli-link}. - -* You know the workspace name. -+ -[TIP] -==== -You can find the relevant workspace name in the output of `$ {orch-cli} get devworkspaces`. -==== - -* You know the relevant {prod-short} user namespace on the cluster. -+ -TIP: You can visit `pass:c,a,q[{prod-url}]/api/kubernetes/namespace` to get your {prod-short} user namespace as `name`. - -* You are in the {prod-short} user namespace on the cluster. -+ -[TIP] -==== -On OpenShift, you can use the command-line `oc` tool to link:https://docs.openshift.com/container-platform/latest/cli_reference/openshift_cli/developer-cli-commands.html#oc-project[display your current namespace or switch to a namespace]. -==== - -.Procedure - -* Run the following command to stop a workspace: -+ -[subs="+quotes,attributes"] ----- -$ {orch-cli} patch devworkspace ____ \ --p '{"spec":{"started":false}}' \ ---type=merge -n ____ && \ -{orch-cli} wait --for=jsonpath='{.status.phase}'=Stopped \ -dw/____ -n ____ ----- diff --git a/modules/install/pages/con_next-steps-after-installation.adoc b/modules/install/pages/con_next-steps-after-installation.adoc index e554ee453a..137ffc5e56 100644 --- a/modules/install/pages/con_next-steps-after-installation.adoc +++ b/modules/install/pages/con_next-steps-after-installation.adoc @@ -16,5 +16,5 @@ After a successful installation, a few configuration tasks remain before your te .Additional resources * xref:administration-guide:understanding-the-checluster-custom-resource.adoc[] -* xref:administration-guide:configuring-oauth-for-git-providers.adoc[] +* xref:integrate:configuring-oauth-for-git-providers.adoc[] * xref:end-user-guide:starting-a-workspace-from-a-git-repository-url.adoc[] diff --git a/modules/end-user-guide/images/installation/che-red-hat-application-menu-che-odp.png b/modules/integrate/images/installation/che-red-hat-application-menu-che-odp.png similarity index 100% rename from modules/end-user-guide/images/installation/che-red-hat-application-menu-che-odp.png rename to modules/integrate/images/installation/che-red-hat-application-menu-che-odp.png diff --git a/modules/end-user-guide/images/installation/edit-source-code-button-che-odp.png b/modules/integrate/images/installation/edit-source-code-button-che-odp.png similarity index 100% rename from modules/end-user-guide/images/installation/edit-source-code-button-che-odp.png rename to modules/integrate/images/installation/edit-source-code-button-che-odp.png diff --git a/modules/end-user-guide/images/integration/token-injection.png b/modules/integrate/images/integration/token-injection.png similarity index 100% rename from modules/end-user-guide/images/integration/token-injection.png rename to modules/integrate/images/integration/token-injection.png diff --git a/modules/end-user-guide/images/navigation/navigating-openshift-web-console-from-che-dashboard.png b/modules/integrate/images/navigation/navigating-openshift-web-console-from-che-dashboard.png similarity index 100% rename from modules/end-user-guide/images/navigation/navigating-openshift-web-console-from-che-dashboard.png rename to modules/integrate/images/navigation/navigating-openshift-web-console-from-che-dashboard.png diff --git a/modules/integrate/nav.adoc b/modules/integrate/nav.adoc new file mode 100644 index 0000000000..3097257bee --- /dev/null +++ b/modules/integrate/nav.adoc @@ -0,0 +1,20 @@ +.Integrate +* xref:configuring-oauth-for-git-providers.adoc[] +** xref:configuring-oauth-2-for-github.adoc[] +** xref:configuring-oauth-2-for-gitlab.adoc[] +** xref:configuring-oauth-2-for-a-bitbucket-server.adoc[] +** xref:configuring-oauth-2-for-the-bitbucket-cloud.adoc[] +** xref:configuring-oauth-1-for-a-bitbucket-server.adoc[] +** xref:configuring-oauth-2-for-microsoft-azure-devops-services.adoc[] +* xref:managing-workspaces-with-apis.adoc[] +* xref:integrating-with-kubernetes.adoc[] +** xref:automatic-token-injection.adoc[] +** xref:navigating-che-from-openshift-developer-perspective.adoc[] +** xref:navigating-openshift-web-console-from-che.adoc[] +* xref:enabling-artifact-repositories-in-a-restricted-environment.adoc[] +** xref:enabling-maven-artifact-repositories.adoc[] +** xref:enabling-gradle-artifact-repositories.adoc[] +** xref:enabling-npm-artifact-repositories.adoc[] +** xref:enabling-python-artifact-repositories.adoc[] +** xref:enabling-go-artifact-repositories.adoc[] +** xref:enabling-nuget-artifact-repositories.adoc[] diff --git a/modules/integrate/pages/automatic-token-injection.adoc b/modules/integrate/pages/automatic-token-injection.adoc new file mode 100644 index 0000000000..a49f0e3d24 --- /dev/null +++ b/modules/integrate/pages/automatic-token-injection.adoc @@ -0,0 +1,27 @@ +:_content-type: PROCEDURE +:description: Use automatic {orch-name} token injection +:keywords: user-guide, token, injection +:navtitle: Use automatic {orch-name} token injection +:page-aliases: .:automatic-token-injection.adoc, overview:automatic-token-injection.adoc + +[id="automatic-token-injection"] += Use automatic {orch-name} token injection + +Use the {orch-name} user token that is automatically injected into workspace containers to run `{orch-cli}` and `kubectl` commands against the {orch-name} cluster without explicit login. + +WARNING: The automatic token injection currently works only on the OpenShift infrastructure. + +.Prerequisites + +* You have a running instance of {prod}. + +.Procedure + +. Open the {prod-short} dashboard and start a workspace. + +. After the workspace starts, open a terminal in the workspace container. + +. Run `{orch-cli}` or `kubectl` commands to deploy applications, inspect and manage cluster resources, or view logs. The injected {orch-name} user token authenticates these commands automatically. + ++ +image::integration/token-injection.png[Token Injection in IDE,link="{imagesdir}/integration/token-injection.png"] diff --git a/modules/administration-guide/pages/configuring-oauth-1-for-a-bitbucket-server.adoc b/modules/integrate/pages/configuring-oauth-1-for-a-bitbucket-server.adoc similarity index 86% rename from modules/administration-guide/pages/configuring-oauth-1-for-a-bitbucket-server.adoc rename to modules/integrate/pages/configuring-oauth-1-for-a-bitbucket-server.adoc index b6ef03bc0f..8a364d4054 100644 --- a/modules/administration-guide/pages/configuring-oauth-1-for-a-bitbucket-server.adoc +++ b/modules/integrate/pages/configuring-oauth-1-for-a-bitbucket-server.adoc @@ -1,11 +1,11 @@ :_content-type: ASSEMBLY :description: Configuring OAuth 1.0 for a Bitbucket Server :keywords: configuring-oauth, authorization, bitbucket, bitbucket-server, oauth-1, oauth-1.0 -:navtitle: Configuring OAuth 1.0 for a Bitbucket Server +:navtitle: Connect Bitbucket Server with OAuth 1.0 // :page-aliases: [id="configuring-oauth-1-for-a-bitbucket-server"] -= Configuring OAuth 1.0 for a Bitbucket Server += Connect Bitbucket Server with OAuth 1.0 To enable users to work with a remote Git repository that is hosted on a Bitbucket Server: diff --git a/modules/administration-guide/pages/configuring-oauth-2-for-a-bitbucket-server.adoc b/modules/integrate/pages/configuring-oauth-2-for-a-bitbucket-server.adoc similarity index 87% rename from modules/administration-guide/pages/configuring-oauth-2-for-a-bitbucket-server.adoc rename to modules/integrate/pages/configuring-oauth-2-for-a-bitbucket-server.adoc index 46d2b7e5bc..ad4ec10076 100644 --- a/modules/administration-guide/pages/configuring-oauth-2-for-a-bitbucket-server.adoc +++ b/modules/integrate/pages/configuring-oauth-2-for-a-bitbucket-server.adoc @@ -1,11 +1,11 @@ :_content-type: ASSEMBLY :description: Configuring OAuth 2.0 for a Bitbucket Server :keywords: configuring-oauth, authorization, bitbucket, bitbucket-server, oauth-2, oauth-2.0 -:navtitle: Configuring OAuth 2.0 for a Bitbucket Server +:navtitle: Connect Bitbucket Server with OAuth 2.0 // :page-aliases: [id="configuring-oauth-2-for-a-bitbucket-server"] -= Configuring OAuth 2.0 for a Bitbucket Server += Connect Bitbucket Server with OAuth 2.0 You can use OAuth 2.0 to enable users to work with a remote Git repository that is hosted on a Bitbucket Server: diff --git a/modules/administration-guide/pages/configuring-oauth-2-for-github.adoc b/modules/integrate/pages/configuring-oauth-2-for-github.adoc similarity index 92% rename from modules/administration-guide/pages/configuring-oauth-2-for-github.adoc rename to modules/integrate/pages/configuring-oauth-2-for-github.adoc index ed1587a8fb..2a31cb26b6 100644 --- a/modules/administration-guide/pages/configuring-oauth-2-for-github.adoc +++ b/modules/integrate/pages/configuring-oauth-2-for-github.adoc @@ -1,11 +1,11 @@ :_content-type: ASSEMBLY :description: Configuring OAuth 2.0 for GitHub :keywords: configuring-oauth, authorization, github, oauth-2, oauth-2.0 -:navtitle: Configuring OAuth 2.0 for GitHub +:navtitle: Connect GitHub with OAuth :page-aliases: [id="configuring-oauth-2-for-github"] -= Configuring OAuth 2.0 for GitHub += Connect GitHub with OAuth To enable users to work with a remote Git repository that is hosted on GitHub: diff --git a/modules/administration-guide/pages/configuring-oauth-2-for-gitlab.adoc b/modules/integrate/pages/configuring-oauth-2-for-gitlab.adoc similarity index 88% rename from modules/administration-guide/pages/configuring-oauth-2-for-gitlab.adoc rename to modules/integrate/pages/configuring-oauth-2-for-gitlab.adoc index 0b60e26d41..1acdbaebb7 100644 --- a/modules/administration-guide/pages/configuring-oauth-2-for-gitlab.adoc +++ b/modules/integrate/pages/configuring-oauth-2-for-gitlab.adoc @@ -1,11 +1,11 @@ :_content-type: ASSEMBLY :description: Configuring OAuth 2.0 for GitLab :keywords: configuring-oauth, authorization, gitlab, oauth-2, oauth-2.0 -:navtitle: Configuring OAuth 2.0 for GitLab +:navtitle: Connect GitLab with OAuth :page-aliases: [id="configuring-oauth-2-for-gitlab"] -= Configuring OAuth 2.0 for GitLab += Connect GitLab with OAuth To enable users to work with a remote Git repository that is hosted using a GitLab instance: diff --git a/modules/administration-guide/pages/configuring-oauth-2-for-microsoft-azure-devops-services.adoc b/modules/integrate/pages/configuring-oauth-2-for-microsoft-azure-devops-services.adoc similarity index 88% rename from modules/administration-guide/pages/configuring-oauth-2-for-microsoft-azure-devops-services.adoc rename to modules/integrate/pages/configuring-oauth-2-for-microsoft-azure-devops-services.adoc index 3c0d804c7d..b43cf3a576 100644 --- a/modules/administration-guide/pages/configuring-oauth-2-for-microsoft-azure-devops-services.adoc +++ b/modules/integrate/pages/configuring-oauth-2-for-microsoft-azure-devops-services.adoc @@ -1,11 +1,11 @@ :_content-type: ASSEMBLY :description: Configuring OAuth 2.0 for Microsoft Azure DevOps Services :keywords: configuring-oauth, authorization, microsoft azure devops services, microsoft azure repos, oauth-2, oauth-2.0 -:navtitle: Configuring OAuth 2.0 for Microsoft Azure DevOps Services +:navtitle: Connect Azure DevOps with Microsoft Entra ID :page-aliases: [id="configuring-oauth-2-for-microsoft-azure-devops-services"] -= Configuring OAuth 2.0 for Microsoft Azure DevOps Services += Connect Azure DevOps with Microsoft Entra ID ++++ diff --git a/modules/administration-guide/pages/configuring-oauth-2-for-the-bitbucket-cloud.adoc b/modules/integrate/pages/configuring-oauth-2-for-the-bitbucket-cloud.adoc similarity index 86% rename from modules/administration-guide/pages/configuring-oauth-2-for-the-bitbucket-cloud.adoc rename to modules/integrate/pages/configuring-oauth-2-for-the-bitbucket-cloud.adoc index ff31f339cb..6b826fc3dc 100644 --- a/modules/administration-guide/pages/configuring-oauth-2-for-the-bitbucket-cloud.adoc +++ b/modules/integrate/pages/configuring-oauth-2-for-the-bitbucket-cloud.adoc @@ -1,11 +1,11 @@ :_content-type: ASSEMBLY :description: Configuring OAuth 2.0 for the Bitbucket Cloud :keywords: configuring-oauth, authorization, bitbucket, bitbucket-cloud, cloud, oauth-2, oauth-2.0 -:navtitle: Configuring OAuth 2.0 for the Bitbucket Cloud +:navtitle: Connect Bitbucket Cloud with OAuth // :page-aliases: [id="configuring-oauth-2-for-the-bitbucket-cloud"] -= Configuring OAuth 2.0 for the Bitbucket Cloud += Connect Bitbucket Cloud with OAuth You can enable users to work with a remote Git repository that is hosted in the Bitbucket Cloud: diff --git a/modules/administration-guide/pages/configuring-oauth-for-git-providers.adoc b/modules/integrate/pages/configuring-oauth-for-git-providers.adoc similarity index 91% rename from modules/administration-guide/pages/configuring-oauth-for-git-providers.adoc rename to modules/integrate/pages/configuring-oauth-for-git-providers.adoc index 96429b64f5..b0848fc85d 100644 --- a/modules/administration-guide/pages/configuring-oauth-for-git-providers.adoc +++ b/modules/integrate/pages/configuring-oauth-for-git-providers.adoc @@ -1,11 +1,11 @@ :_content-type: CONCEPT :description: Configuring OAuth for Git providers :keywords: azure, bitbucket, gitlab, github, git -:navtitle: Configuring OAuth for Git providers +:navtitle: Give developers credential-free Git access // :page-aliases: [id="configuring-oauth-for-git-providers"] -= Configuring OAuth for Git providers += Give developers credential-free Git access [NOTE] ==== diff --git a/modules/end-user-guide/pages/enabling-artifact-repositories-in-a-restricted-environment.adoc b/modules/integrate/pages/enabling-artifact-repositories-in-a-restricted-environment.adoc similarity index 85% rename from modules/end-user-guide/pages/enabling-artifact-repositories-in-a-restricted-environment.adoc rename to modules/integrate/pages/enabling-artifact-repositories-in-a-restricted-environment.adoc index f387dceefa..103dd60c9c 100644 --- a/modules/end-user-guide/pages/enabling-artifact-repositories-in-a-restricted-environment.adoc +++ b/modules/integrate/pages/enabling-artifact-repositories-in-a-restricted-environment.adoc @@ -1,11 +1,11 @@ :_content-type: ASSEMBLY :description: Enabling artifact repositories in a restricted environment :keywords: artifact-repositories, artifact-repository, maven, gradle, nuget, python, go, npm -:navtitle: Enabling artifact repositories in a restricted environment +:navtitle: Connect workspaces to your organization's package registries :page-aliases: using-artifact-repositories-in-a-restricted-environment.adoc [id="enabling-artifact-repositories-in-a-restricted-environment"] -= Enabling artifact repositories in a restricted environment += Connect workspaces to your organization's package registries By configuring technology stacks, you can work with artifacts from in-house repositories using self-signed certificates: diff --git a/modules/end-user-guide/pages/enabling-go-artifact-repositories.adoc b/modules/integrate/pages/enabling-go-artifact-repositories.adoc similarity index 74% rename from modules/end-user-guide/pages/enabling-go-artifact-repositories.adoc rename to modules/integrate/pages/enabling-go-artifact-repositories.adoc index f5830e78d3..c7300bafc5 100644 --- a/modules/end-user-guide/pages/enabling-go-artifact-repositories.adoc +++ b/modules/integrate/pages/enabling-go-artifact-repositories.adoc @@ -1,13 +1,13 @@ :_content-type: PROCEDURE -:description: You can enable a Go artifact repository in Go workspaces that run in a restricted environment. +:description: Configure Go to use a module proxy by setting environment variables in your workspaces. :keywords: go, artifact-repository, artifact-repositories -:navtitle: Go +:navtitle: Enable Go artifact repositories :page-aliases: using-go-artifact-repositories.adoc [id="enabling-go-artifact-repositories"] -= Enabling Go artifact repositories += Enable Go artifact repositories -You can enable a Go artifact repository in Go workspaces that run in a restricted environment. +Configure Go to use a module proxy by setting environment variables in your workspaces. .Prerequisites @@ -17,7 +17,7 @@ include::partial$snip_warning-about-applying-a-configmap-that-sets-environment-v .Procedure -. Apply the Secret for the TLS certificate: +. Create a Secret to store the TLS certificate: + [source,yaml,subs="+quotes,+attributes,+macros"] ---- @@ -37,7 +37,7 @@ data: ---- <1> Base64 encoding with disabled line wrapping. -. Apply the ConfigMap to set the following environment variables in the `tools` container: +. Create a ConfigMap to set the following environment variables in the `tools` container: + [source,yaml,subs="+quotes,+attributes,+macros"] ---- diff --git a/modules/end-user-guide/pages/enabling-gradle-artifact-repositories.adoc b/modules/integrate/pages/enabling-gradle-artifact-repositories.adoc similarity index 79% rename from modules/end-user-guide/pages/enabling-gradle-artifact-repositories.adoc rename to modules/integrate/pages/enabling-gradle-artifact-repositories.adoc index 34d117f313..b2afdac54c 100644 --- a/modules/end-user-guide/pages/enabling-gradle-artifact-repositories.adoc +++ b/modules/integrate/pages/enabling-gradle-artifact-repositories.adoc @@ -1,13 +1,13 @@ :_content-type: PROCEDURE -:description: You can enable a Gradle artifact repository in Gradle workspaces that run in a restricted environment. +:description: Enable a Gradle artifact repository so that Gradle workspaces can download plugins and dependencies from your internal registry. :keywords: gradle, artifact-repository, artifact-repositories -:navtitle: Gradle +:navtitle: Enable Gradle artifact repositories :page-aliases: using-gradle-artifact-repositories.adoc [id="enabling-gradle-artifact-repositories"] -= Enabling Gradle artifact repositories += Enable Gradle artifact repositories -You can enable a Gradle artifact repository in Gradle workspaces that run in a restricted environment. +Enable a Gradle artifact repository so that Gradle workspaces can download plugins and dependencies from your internal registry. .Prerequisites @@ -15,7 +15,7 @@ You can enable a Gradle artifact repository in Gradle workspaces that run in a r .Procedure -. Apply the Secret for the TLS certificate: +. Create a Secret to store the TLS certificate: + [source,yaml,subs="+quotes,+attributes,+macros"] ---- @@ -35,7 +35,7 @@ data: ---- <1> Base64 encoding with disabled line wrapping. -. Apply the ConfigMap for the TrustStore initialization script: +. Create a ConfigMap for the TrustStore initialization script: + [source,yaml,subs="+quotes,+attributes,+macros"] ---- @@ -56,7 +56,7 @@ data: keytool -importcert -noprompt -file /home/user/certs/tls.cer -cacerts -storepass changeit ---- -. Apply the ConfigMap for the Gradle init script: +. Create a ConfigMap for the Gradle init script: + [source,yaml,subs="+quotes,+attributes,+macros"] ---- diff --git a/modules/end-user-guide/pages/enabling-maven-artifact-repositories.adoc b/modules/integrate/pages/enabling-maven-artifact-repositories.adoc similarity index 81% rename from modules/end-user-guide/pages/enabling-maven-artifact-repositories.adoc rename to modules/integrate/pages/enabling-maven-artifact-repositories.adoc index 6513e1e039..58c4296ab1 100644 --- a/modules/end-user-guide/pages/enabling-maven-artifact-repositories.adoc +++ b/modules/integrate/pages/enabling-maven-artifact-repositories.adoc @@ -1,13 +1,13 @@ :_content-type: PROCEDURE -:description: You can enable a Maven artifact repository in Maven workspaces that run in a restricted environment. +:description: Enable a Maven artifact repository so that Java workspaces can resolve dependencies from your internal Nexus or Artifactory server. :keywords: maven, artifact-repository, artifact-repositories -:navtitle: Maven +:navtitle: Enable Maven artifact repositories :page-aliases: using-maven-artifact-repositories.adoc [id="enabling-maven-artifact-repositories"] -= Enabling Maven artifact repositories += Enable Maven artifact repositories -You can enable a Maven artifact repository in Maven workspaces that run in a restricted environment. +Enable a Maven artifact repository so that Java workspaces can resolve dependencies from your internal Nexus or Artifactory server. .Prerequisites @@ -16,7 +16,7 @@ You can enable a Maven artifact repository in Maven workspaces that run in a res .Procedure -. In the `____-{prod-id-short}` namespace, apply the Secret for the TLS certificate: +. Create a Secret to store the TLS certificate: + [source,yaml,subs="+quotes,+attributes,+macros"] ---- @@ -36,7 +36,7 @@ data: ---- <1> Base64 encoding with disabled line wrapping. -. In the `____-{prod-id-short}` namespace, apply the ConfigMap to create the `settings.xml` file: +. Create a ConfigMap for the `settings.xml` file: + [source,yaml,subs="+quotes"] ---- @@ -85,9 +85,9 @@ data: ---- -. Optional: When using JBoss EAP-based devfiles, apply a second `settings-xml` ConfigMap in the `____-{prod-id-short}` namespace, and with the same content, a different name, and the `/home/jboss/.m2` mount path. +. Optional: When using JBoss EAP-based devfiles, create a second `settings-xml` ConfigMap with a different name and the `/home/jboss/.m2` mount path. Use the same content as step 3. -. In the `____-{prod-id-short}` namespace, apply the ConfigMap for the TrustStore initialization script: +. Create a ConfigMap for the TrustStore initialization script that matches your Java version: + .Java 8 diff --git a/modules/end-user-guide/pages/enabling-npm-artifact-repositories.adoc b/modules/integrate/pages/enabling-npm-artifact-repositories.adoc similarity index 74% rename from modules/end-user-guide/pages/enabling-npm-artifact-repositories.adoc rename to modules/integrate/pages/enabling-npm-artifact-repositories.adoc index 71138821f5..ed30dc4ad1 100644 --- a/modules/end-user-guide/pages/enabling-npm-artifact-repositories.adoc +++ b/modules/integrate/pages/enabling-npm-artifact-repositories.adoc @@ -1,13 +1,13 @@ :_content-type: PROCEDURE -:description: You can enable an npm artifact repository in npm workspaces that run in a restricted environment. +:description: Enable an npm artifact repository so that Node.js workspaces can install packages from your internal npm registry. :keywords: npm, artifact-repository, artifact-repositories -:navtitle: npm +:navtitle: Enable npm artifact repositories :page-aliases: using-npm-artifact-repositories.adoc [id="enabling-npm-artifact-repositories"] -= Enabling npm artifact repositories += Enable npm artifact repositories -You can enable an npm artifact repository in npm workspaces that run in a restricted environment. +Enable an npm artifact repository so that Node.js workspaces can install packages from your internal npm registry. .Prerequisites @@ -17,7 +17,7 @@ include::partial$snip_warning-about-applying-a-configmap-that-sets-environment-v .Procedure -. Apply the Secret for the TLS certificate: +. Create a Secret to store the TLS certificate: + [source,yaml,subs="+quotes,+attributes,+macros"] ---- @@ -37,7 +37,7 @@ data: ---- <1> Base64 encoding with disabled line wrapping. -. Apply the ConfigMap to set the following environment variables in the `tools` container: +. Create a ConfigMap to set the following environment variables in the `tools` container: + [source,yaml,subs="+quotes,+attributes,+macros"] ---- diff --git a/modules/end-user-guide/pages/enabling-nuget-artifact-repositories.adoc b/modules/integrate/pages/enabling-nuget-artifact-repositories.adoc similarity index 78% rename from modules/end-user-guide/pages/enabling-nuget-artifact-repositories.adoc rename to modules/integrate/pages/enabling-nuget-artifact-repositories.adoc index bec40213b7..b078974087 100644 --- a/modules/end-user-guide/pages/enabling-nuget-artifact-repositories.adoc +++ b/modules/integrate/pages/enabling-nuget-artifact-repositories.adoc @@ -1,13 +1,13 @@ :_content-type: PROCEDURE -:description: You can enable a NuGet artifact repository in NuGet workspaces that run in a restricted environment. +:description: Enable a NuGet artifact repository so that .NET workspaces can restore packages from your internal NuGet feed. :keywords: nuget, artifact-repository, artifact-repositories -:navtitle: NuGet +:navtitle: Enable NuGet artifact repositories :page-aliases: using-nuget-artifact-repositories.adoc [id="enabling-nuget-artifact-repositories"] -= Enabling NuGet artifact repositories += Enable NuGet artifact repositories -You can enable a NuGet artifact repository in NuGet workspaces that run in a restricted environment. +Enable a NuGet artifact repository so that .NET workspaces can restore packages from your internal NuGet feed. .Prerequisites @@ -17,7 +17,7 @@ include::partial$snip_warning-about-applying-a-configmap-that-sets-environment-v .Procedure -. Apply the Secret for the TLS certificate: +. Create a Secret to store the TLS certificate: + [source,yaml,subs="+quotes,+attributes,+macros"] ---- @@ -37,7 +37,7 @@ data: ---- <1> Base64 encoding with disabled line wrapping. -. Apply the ConfigMap to set the environment variable for the path of the TLS certificate file in the `tools` container: +. Create a ConfigMap to set the environment variable for the path of the TLS certificate file in the `tools` container: + [source,yaml,subs="+quotes,+attributes,+macros"] ---- @@ -54,7 +54,7 @@ data: SSL_CERT_FILE: /home/user/certs/tls.cer ---- -. Apply the ConfigMap to create the `nuget.config` file: +. Create a ConfigMap for the `nuget.config` file: + [source,yaml,subs="+quotes,+attributes,+macros"] ---- diff --git a/modules/end-user-guide/pages/enabling-python-artifact-repositories.adoc b/modules/integrate/pages/enabling-python-artifact-repositories.adoc similarity index 74% rename from modules/end-user-guide/pages/enabling-python-artifact-repositories.adoc rename to modules/integrate/pages/enabling-python-artifact-repositories.adoc index ff400c03f4..c61aa4193f 100644 --- a/modules/end-user-guide/pages/enabling-python-artifact-repositories.adoc +++ b/modules/integrate/pages/enabling-python-artifact-repositories.adoc @@ -1,13 +1,13 @@ :_content-type: PROCEDURE -:description: You can enable a Python artifact repository in Python workspaces that run in a restricted environment. +:description: Configure pip to use an internal PyPI mirror by mounting a pip.conf file into your workspaces. :keywords: python, artifact-repository, artifact-repositories -:navtitle: Python +:navtitle: Enable Python artifact repositories :page-aliases: using-python-artifact-repositories.adoc [id="enabling-python-artifact-repositories"] -= Enabling Python artifact repositories += Enable Python artifact repositories -You can enable a Python artifact repository in Python workspaces that run in a restricted environment. +Configure pip to use an internal PyPI mirror by mounting environment variables into your workspaces. .Prerequisites @@ -17,7 +17,7 @@ include::partial$snip_warning-about-applying-a-configmap-that-sets-environment-v .Procedure -. Apply the Secret for the TLS certificate: +. Create a Secret to store the TLS certificate: + [source,yaml,subs="+quotes,+attributes,+macros"] ---- @@ -37,7 +37,7 @@ data: ---- <1> Base64 encoding with disabled line wrapping. -. Apply the ConfigMap to set the following environment variables in the `tools` container: +. Create a ConfigMap to set the following environment variables in the `tools` container: + [source,yaml,subs="+quotes,+attributes,+macros"] ---- diff --git a/modules/end-user-guide/pages/integrating-with-kubernetes.adoc b/modules/integrate/pages/integrating-with-kubernetes.adoc similarity index 78% rename from modules/end-user-guide/pages/integrating-with-kubernetes.adoc rename to modules/integrate/pages/integrating-with-kubernetes.adoc index 69ad1f1c31..8c7c8f5177 100644 --- a/modules/end-user-guide/pages/integrating-with-kubernetes.adoc +++ b/modules/integrate/pages/integrating-with-kubernetes.adoc @@ -1,11 +1,11 @@ :_content-type: ASSEMBLY :description: Integrating with {orch-name} :keywords: overview, integrating with {orch-name} -:navtitle: Integrating with {orch-name} +:navtitle: Use {orch-name} tools with workspaces :page-aliases: [id="integrating-with-kubernetes"] -= Integrating with {orch-name} += Use {orch-name} tools with workspaces * xref:automatic-token-injection.adoc[] * xref:navigating-che-from-openshift-developer-perspective.adoc[] diff --git a/modules/end-user-guide/pages/managing-workspaces-with-apis.adoc b/modules/integrate/pages/managing-workspaces-with-apis.adoc similarity index 81% rename from modules/end-user-guide/pages/managing-workspaces-with-apis.adoc rename to modules/integrate/pages/managing-workspaces-with-apis.adoc index 8e610dd4b5..9284fb6567 100644 --- a/modules/end-user-guide/pages/managing-workspaces-with-apis.adoc +++ b/modules/integrate/pages/managing-workspaces-with-apis.adoc @@ -1,11 +1,13 @@ :_content-type: ASSEMBLY -:navtitle: Managing workspaces with {orch-name} APIs -:description: Managing workspaces with {orch-name} APIs +:navtitle: Manage workspaces from the command line +:description: Manage {prod-short} workspaces with {orch-name} APIs :keywords: api, list workspaces, create workspace, restart workspace, stop workspace, start workspace, remove workspace // :page-aliases: [id="managing-workspaces-with-apis"] -= Managing workspaces with {orch-name} APIs += Manage workspaces from the command line + +Manage {prod-short} workspaces with `{orch-cli}` and `kubectl` to list, create, stop, start, and remove workspaces without using the dashboard. On your organization's {orch-name} cluster, {prod-short} workspaces are represented as `DevWorkspace` custom resources of the same name. As a result, if there is a workspace named `my-workspace` in the {prod-short} dashboard, there is a corresponding `DevWorkspace` custom resource named `my-workspace` in the user's {orch-namespace} on the cluster. diff --git a/modules/end-user-guide/pages/navigating-che-from-openshift-developer-perspective.adoc b/modules/integrate/pages/navigating-che-from-openshift-developer-perspective.adoc similarity index 94% rename from modules/end-user-guide/pages/navigating-che-from-openshift-developer-perspective.adoc rename to modules/integrate/pages/navigating-che-from-openshift-developer-perspective.adoc index 728e4af20a..71ae3636c1 100644 --- a/modules/end-user-guide/pages/navigating-che-from-openshift-developer-perspective.adoc +++ b/modules/integrate/pages/navigating-che-from-openshift-developer-perspective.adoc @@ -1,12 +1,12 @@ :_content-type: ASSEMBLY :description: Navigating {prod-short} from OpenShift Developer Perspective :keywords: overview, accessing-che-from-openshift-developer-perspective -:navtitle: Navigating {prod-short} from OpenShift Developer Perspective +:navtitle: {prod-short} in the OpenShift Developer Perspective :page-aliases: .:accessing-che-from-openshift-developer-perspective.adoc, overview:accessing-che-from-openshift-developer-perspective.adoc, accessing-che-from-openshift-developer-perspective.adoc [id="navigating-{prod-id-short}-from-openshift-developer-perspective"] -= Navigating {prod-short} from OpenShift Developer Perspective += {prod-short} in the OpenShift Developer Perspective The OpenShift Container Platform web console provides two perspectives; the *Administrator* perspective and the *Developer* perspective. diff --git a/modules/end-user-guide/pages/navigating-openshift-web-console-from-che.adoc b/modules/integrate/pages/navigating-openshift-web-console-from-che.adoc similarity index 63% rename from modules/end-user-guide/pages/navigating-openshift-web-console-from-che.adoc rename to modules/integrate/pages/navigating-openshift-web-console-from-che.adoc index 9f439d4a8a..59d916f812 100644 --- a/modules/end-user-guide/pages/navigating-openshift-web-console-from-che.adoc +++ b/modules/integrate/pages/navigating-openshift-web-console-from-che.adoc @@ -1,18 +1,18 @@ :_content-type: PROCEDURE -:description: Navigating OpenShift web console from {prod-short} +:description: Navigate to the {orch-name} web console from {prod-short} :keywords: overview, OpenShift, web console -:navtitle: Navigating OpenShift web console from {prod-short} +:navtitle: Navigate to the {orch-name} web console from {prod-short} :page-aliases: .:accessing-openshift-web-console-from-che.adoc, overview:accessing-openshift-web-console-from-che.adoc, accessing-openshift-web-console-from-che.adoc [id="navigating-openshift-web-console-from-{prod-id-short}"] -= Navigating OpenShift web console from {prod-short} += Navigate to the {orch-name} web console from {prod-short} -This section describes how to access OpenShift web console from {prod-short}. +Navigate to the {orch-name} web console from the {prod-short} dashboard to manage cluster resources, inspect pods, and troubleshoot workspace issues without leaving your workflow. .Prerequisites -* The {prod-short} Operator is available in OpenShift 4. +* You have the {prod-short} Operator available in OpenShift 4. .Procedure diff --git a/modules/end-user-guide/partials/con_openshift-developer-perspective-integration-with-che.adoc b/modules/integrate/partials/con_openshift-developer-perspective-integration-with-che.adoc similarity index 100% rename from modules/end-user-guide/partials/con_openshift-developer-perspective-integration-with-che.adoc rename to modules/integrate/partials/con_openshift-developer-perspective-integration-with-che.adoc diff --git a/modules/end-user-guide/partials/proc_accessing-che-from-red-hat-applications-menu.adoc b/modules/integrate/partials/proc_accessing-che-from-red-hat-applications-menu.adoc similarity index 100% rename from modules/end-user-guide/partials/proc_accessing-che-from-red-hat-applications-menu.adoc rename to modules/integrate/partials/proc_accessing-che-from-red-hat-applications-menu.adoc diff --git a/modules/administration-guide/partials/proc_applying-an-application-link-secret-for-the-bitbucket-server.adoc b/modules/integrate/partials/proc_applying-an-application-link-secret-for-the-bitbucket-server.adoc similarity index 69% rename from modules/administration-guide/partials/proc_applying-an-application-link-secret-for-the-bitbucket-server.adoc rename to modules/integrate/partials/proc_applying-an-application-link-secret-for-the-bitbucket-server.adoc index b7a6d01f72..2acae50c7a 100644 --- a/modules/administration-guide/partials/proc_applying-an-application-link-secret-for-the-bitbucket-server.adoc +++ b/modules/integrate/partials/proc_applying-an-application-link-secret-for-the-bitbucket-server.adoc @@ -1,19 +1,19 @@ :_content-type: PROCEDURE -:description: Applying an application link Secret for the Bitbucket Server +:description: Connect {prod-short} to your Bitbucket Server OAuth 1.0 application :keywords: bitbucket, bitbucket-server, application-link, bitbucket-secret -:navtitle: Applying an application link Secret for the Bitbucket Server +:navtitle: Connect {prod-short} to your Bitbucket Server OAuth 1.0 application // :page-aliases: [id="applying-an-application-link-secret-for-the-bitbucket-server"] -= Applying an application link Secret for the Bitbucket Server += Connect {prod-short} to your Bitbucket Server OAuth 1.0 application -Prepare and apply the application link Secret for the Bitbucket Server. +Connect {prod-short} to your Bitbucket Server OAuth 1.0 application so that developers can access Bitbucket Server repositories from workspaces without re-entering credentials. .Prerequisites -* The application link is set up on the Bitbucket Server. +* You have configured the application link on the Bitbucket Server. -* The following files, which were created when setting up the application link, are prepared: +* You have the following files, which were created when configuring the application link: ** `privatepkcs8-stripped.pem` ** `bitbucket-consumer-key` ** `bitbucket-shared-secret` @@ -58,4 +58,6 @@ ____ EOF ---- -. Verify in the output that the Secret is created. +.Verification + +* Verify that the output displays `secret/bitbucket-oauth-config created`. diff --git a/modules/administration-guide/partials/proc_applying-an-oauth-2-application-link-secret-for-the-bitbucket-server.adoc b/modules/integrate/partials/proc_applying-an-oauth-2-application-link-secret-for-the-bitbucket-server.adoc similarity index 65% rename from modules/administration-guide/partials/proc_applying-an-oauth-2-application-link-secret-for-the-bitbucket-server.adoc rename to modules/integrate/partials/proc_applying-an-oauth-2-application-link-secret-for-the-bitbucket-server.adoc index d451547114..af83fb020a 100644 --- a/modules/administration-guide/partials/proc_applying-an-oauth-2-application-link-secret-for-the-bitbucket-server.adoc +++ b/modules/integrate/partials/proc_applying-an-oauth-2-application-link-secret-for-the-bitbucket-server.adoc @@ -1,19 +1,19 @@ :_content-type: PROCEDURE -:description: Applying an OAuth 2.0 application link Secret for the Bitbucket Server +:description: Connect {prod-short} to your Bitbucket Server OAuth 2.0 application :keywords: bitbucket, bitbucket-server, application-link, bitbucket-secret -:navtitle: Applying an OAuth 2.0 application link Secret for the Bitbucket Server +:navtitle: Connect {prod-short} to your Bitbucket Server OAuth 2.0 application // :page-aliases: [id="applying-an-oauth-2-application-link-secret-for-the-bitbucket-server"] -= Applying an OAuth 2.0 application link Secret for the Bitbucket Server += Connect {prod-short} to your Bitbucket Server OAuth 2.0 application -Prepare and apply the OAuth 2.0 application link Secret for the Bitbucket Server. +Connect {prod-short} to your Bitbucket Server OAuth 2.0 application so that developers can access Bitbucket Server repositories from workspaces without re-entering credentials. .Prerequisites -* The application link is set up on the Bitbucket Server. +* You have configured the OAuth 2.0 application link on the Bitbucket Server. -* The following values, which were generated when setting up the Bitbucket application link, are prepared: +* You have the following values, which were generated when configuring the Bitbucket application link: ** Bitbucket *Client ID* ** Bitbucket *Client secret* @@ -55,4 +55,6 @@ ____ EOF ---- -. Verify in the output that the Secret is created. +.Verification + +* Verify that the output displays `secret/bitbucket-oauth-config created`. diff --git a/modules/administration-guide/partials/proc_applying-an-oauth-consumer-secret-for-the-bitbucket-cloud.adoc b/modules/integrate/partials/proc_applying-an-oauth-consumer-secret-for-the-bitbucket-cloud.adoc similarity index 66% rename from modules/administration-guide/partials/proc_applying-an-oauth-consumer-secret-for-the-bitbucket-cloud.adoc rename to modules/integrate/partials/proc_applying-an-oauth-consumer-secret-for-the-bitbucket-cloud.adoc index e2356c99d5..ece96ff691 100644 --- a/modules/administration-guide/partials/proc_applying-an-oauth-consumer-secret-for-the-bitbucket-cloud.adoc +++ b/modules/integrate/partials/proc_applying-an-oauth-consumer-secret-for-the-bitbucket-cloud.adoc @@ -1,19 +1,19 @@ :_content-type: PROCEDURE -:description: Applying an OAuth consumer Secret for the Bitbucket Cloud +:description: Connect {prod-short} to your Bitbucket Cloud OAuth consumer :keywords: bitbucket, bitbucket-cloud, oauth-consumer, bitbucket-consumer, oauth-consumer-secret, bitbucket-client-secret -:navtitle: Applying an OAuth consumer Secret for the Bitbucket Cloud +:navtitle: Connect {prod-short} to your Bitbucket Cloud OAuth consumer // :page-aliases: [id="applying-an-oauth-consumer-secret-for-the-bitbucket-cloud"] -= Applying an OAuth consumer Secret for the Bitbucket Cloud += Connect {prod-short} to your Bitbucket Cloud OAuth consumer -Prepare and apply an OAuth consumer Secret for the Bitbucket Cloud. +Connect {prod-short} to your Bitbucket Cloud OAuth consumer so that developers can access Bitbucket Cloud repositories from workspaces without re-entering credentials. .Prerequisites -* The OAuth consumer is set up in the Bitbucket Cloud. +* You have configured the OAuth consumer in the Bitbucket Cloud. -* The following values, which were generated when setting up the Bitbucket OAuth consumer, are prepared: +* You have the following values, which were generated when configuring the Bitbucket OAuth consumer: ** Bitbucket OAuth consumer Key ** Bitbucket OAuth consumer Secret @@ -53,4 +53,6 @@ ____ EOF ---- -. Verify in the output that the Secret is created. +.Verification + +* Verify that the output displays `secret/bitbucket-oauth-config created`. diff --git a/modules/administration-guide/partials/proc_applying-the-github-oauth-app-secret.adoc b/modules/integrate/partials/proc_applying-the-github-oauth-app-secret.adoc similarity index 72% rename from modules/administration-guide/partials/proc_applying-the-github-oauth-app-secret.adoc rename to modules/integrate/partials/proc_applying-the-github-oauth-app-secret.adoc index 37c58d2044..271e184849 100644 --- a/modules/administration-guide/partials/proc_applying-the-github-oauth-app-secret.adoc +++ b/modules/integrate/partials/proc_applying-the-github-oauth-app-secret.adoc @@ -1,19 +1,19 @@ :_content-type: PROCEDURE -:description: Applying the GitHub OAuth App Secret +:description: Connect {prod-short} to your GitHub OAuth application :keywords: github-oauth-app, apply, secret, github -:navtitle: Applying the GitHub OAuth App Secret +:navtitle: Connect {prod-short} to your GitHub OAuth application // :page-aliases: [id="applying-the-github-oauth-app-secret"] -= Applying the GitHub OAuth App Secret += Connect {prod-short} to your GitHub OAuth application -Prepare and apply the GitHub OAuth App Secret. +Connect {prod-short} to your GitHub OAuth application so that developers can access GitHub repositories from workspaces without re-entering credentials. .Prerequisites -* Setting up the GitHub OAuth App is completed. +* You have configured the GitHub OAuth App. -* The following values, which were generated when setting up the GitHub OAuth App, are prepared: +* You have the following values, which were generated when configuring the GitHub OAuth App: ** *GitHub OAuth Client ID* ** *GitHub OAuth Client Secret* @@ -57,4 +57,8 @@ ____ EOF ---- -. Verify in the output that the Secret is created. +. Optional: To configure OAuth 2.0 for another GitHub provider, repeat the previous steps and create a second GitHub OAuth Secret with a different name. + +.Verification + +* Verify that the output displays `secret/github-oauth-config created`. diff --git a/modules/administration-guide/partials/proc_applying-the-gitlab-authorized-application-secret.adoc b/modules/integrate/partials/proc_applying-the-gitlab-authorized-application-secret.adoc similarity index 63% rename from modules/administration-guide/partials/proc_applying-the-gitlab-authorized-application-secret.adoc rename to modules/integrate/partials/proc_applying-the-gitlab-authorized-application-secret.adoc index 3e40ee9f82..38464f38db 100644 --- a/modules/administration-guide/partials/proc_applying-the-gitlab-authorized-application-secret.adoc +++ b/modules/integrate/partials/proc_applying-the-gitlab-authorized-application-secret.adoc @@ -1,19 +1,19 @@ :_content-type: PROCEDURE -:description: Applying the GitLab-authorized application Secret +:description: Connect {prod-short} to your GitLab OAuth application :keywords: gitlab, apply, secret, gitlab-application, gitlab-client-secret -:navtitle: Applying the GitLab-authorized application Secret +:navtitle: Connect {prod-short} to your GitLab OAuth application // :page-aliases: [id="applying-the-gitlab-authorized-application-secret"] -= Applying the GitLab-authorized application Secret += Connect {prod-short} to your GitLab OAuth application -Prepare and apply the GitLab-authorized application Secret. +Connect {prod-short} to your GitLab OAuth application so that developers can access GitLab repositories from workspaces without re-entering credentials. .Prerequisites -* Setting up the GitLab authorized application is completed. +* You have configured the GitLab authorized application. -* The following values, which were generated when setting up the GitLab authorized application, are prepared: +* You have the following values, which were generated when configuring the GitLab authorized application: ** *GitLab Application ID* ** *GitLab Client Secret* @@ -55,6 +55,8 @@ ____ EOF ---- -. Verify in the output that the Secret is created. +. Optional: To configure OAuth 2.0 for another GitLab provider, repeat the previous steps and create a second GitLab OAuth Secret with a different name. -To configure OAuth 2.0 for another Gitlab provider, you have to repeat the steps above and create a second Gitlab OAuth Secret with a different name. \ No newline at end of file +.Verification + +* Verify that the output displays `secret/gitlab-oauth-config created`. \ No newline at end of file diff --git a/modules/administration-guide/partials/proc_applying-the-microsoft-azure-devops-services-oauth-app-secret.adoc b/modules/integrate/partials/proc_applying-the-microsoft-azure-devops-services-oauth-app-secret.adoc similarity index 61% rename from modules/administration-guide/partials/proc_applying-the-microsoft-azure-devops-services-oauth-app-secret.adoc rename to modules/integrate/partials/proc_applying-the-microsoft-azure-devops-services-oauth-app-secret.adoc index 52e33117a1..b7c33ecb75 100644 --- a/modules/administration-guide/partials/proc_applying-the-microsoft-azure-devops-services-oauth-app-secret.adoc +++ b/modules/integrate/partials/proc_applying-the-microsoft-azure-devops-services-oauth-app-secret.adoc @@ -1,19 +1,19 @@ :_content-type: PROCEDURE -:description: Applying the Microsoft Entra ID OAuth App Secret +:description: Connect {prod-short} to your Microsoft Entra ID application :keywords: microsoft-azure-devops-entra-id-oauth-app, apply, secret -:navtitle: Applying the Microsoft Entra ID OAuth App Secret +:navtitle: Connect {prod-short} to your Microsoft Entra ID application // :page-aliases: [id="applying-the-microsoft-entra-id-oauth-app-secret"] -= Applying the Microsoft Entra ID OAuth App Secret += Connect {prod-short} to your Microsoft Entra ID application -Prepare and apply the Secret that enables {prod-short} to authenticate with Microsoft Entra ID for Azure DevOps repository access. +Connect {prod-short} to your Microsoft Entra ID application so that developers can access Azure DevOps repositories from workspaces without re-entering credentials. .Prerequisites -* You have set up the Microsoft Entra ID OAuth App. +* You have configured the Microsoft Entra ID OAuth App. -* The following values, which were generated when setting up the Microsoft Entra ID OAuth App, are prepared: +* You have the following values, which were generated when configuring the Microsoft Entra ID OAuth App: ** *Application (client) ID* ** *Directory (tenant) ID* ** *Client Secret* @@ -56,6 +56,13 @@ ____ EOF ---- -. Verify in the output that the Secret is created. +.Verification -. Wait for the rollout of the {prod-short} server components to be completed. \ No newline at end of file +* Verify that the output displays `secret/azure-devops-oauth-config created`. + +* Verify that the rollout of the {prod-short} server components is complete: ++ +[subs="+quotes,+attributes"] +---- +$ {orch-cli} rollout status deployment/che -n {prod-namespace} +---- \ No newline at end of file diff --git a/modules/end-user-guide/partials/proc_creating-workspaces.adoc b/modules/integrate/partials/proc_creating-workspaces.adoc similarity index 84% rename from modules/end-user-guide/partials/proc_creating-workspaces.adoc rename to modules/integrate/partials/proc_creating-workspaces.adoc index abd1d59e8d..a1dd660834 100644 --- a/modules/end-user-guide/partials/proc_creating-workspaces.adoc +++ b/modules/integrate/partials/proc_creating-workspaces.adoc @@ -1,8 +1,8 @@ [id="creating-workspaces"] -= Creating workspaces += Create workspaces -If your use case does not permit use of the {prod-short} dashboard, you can create workspaces with {orch-name} APIs by applying custom resources to the cluster. +If your use case does not permit use of the {prod-short} dashboard, create workspaces with {orch-name} APIs by applying custom resources to the cluster. [NOTE] ==== @@ -25,24 +25,17 @@ Creating workspaces through the {prod-short} dashboard provides better user expe .Prerequisites -* An active `{orch-cli}` session with permissions to create `DevWorkspace` resources in your {orch-namespace} on the cluster. See {orch-cli-link}. +* You have an active `{orch-cli}` session with permissions to create `DevWorkspace` resources in your {orch-namespace} on the cluster. See {orch-cli-link}. -* You know the relevant {prod-short} user namespace on the cluster. -+ -TIP: You can visit `pass:c,a,q[{prod-url}]/api/kubernetes/namespace` to get your {prod-short} user namespace as `name`. +* You know your {prod-short} user namespace on the cluster. Visit `pass:c,a,q[{prod-url}]/api/kubernetes/namespace` to get your {prod-short} user namespace as `name`. -* You are in the {prod-short} user namespace on the cluster. -+ -[TIP] -==== -On OpenShift, you can use the command-line `oc` tool to link:https://docs.openshift.com/container-platform/latest/cli_reference/openshift_cli/developer-cli-commands.html#oc-project[display your current namespace or switch to a namespace]. -==== +* You are in your {prod-short} user namespace on the cluster. On {orch-name}, use `{orch-cli}` to link:https://docs.openshift.com/container-platform/latest/cli_reference/openshift_cli/developer-cli-commands.html#oc-project[display your current namespace or switch to a namespace]. + NOTE: {prod-short} administrators who intend to create workspaces for other users must create the `DevWorkspace` custom resource in a user namespace that is provisioned by {prod-short} or by the administrator. See xref:administration-guide:configuring-namespace-provisioning.adoc[]. .Procedure -. To prepare the `DevWorkspace` custom resource, copy the contents of the target Git repository's devfile. +. Copy the contents of the target Git repository's devfile to prepare the `DevWorkspace` custom resource. + .Copied devfile contents with `schemaVersion: 2.2.0` ==== diff --git a/modules/end-user-guide/partials/proc_disabling-self-signed-certificate-validation.adoc b/modules/integrate/partials/proc_disabling-self-signed-certificate-validation.adoc similarity index 100% rename from modules/end-user-guide/partials/proc_disabling-self-signed-certificate-validation.adoc rename to modules/integrate/partials/proc_disabling-self-signed-certificate-validation.adoc diff --git a/modules/end-user-guide/partials/proc_editing-the-code-of-applications-running-in-openshift-container-platform-using-che.adoc b/modules/integrate/partials/proc_editing-the-code-of-applications-running-in-openshift-container-platform-using-che.adoc similarity index 100% rename from modules/end-user-guide/partials/proc_editing-the-code-of-applications-running-in-openshift-container-platform-using-che.adoc rename to modules/integrate/partials/proc_editing-the-code-of-applications-running-in-openshift-container-platform-using-che.adoc diff --git a/modules/integrate/partials/proc_listing-workspaces.adoc b/modules/integrate/partials/proc_listing-workspaces.adoc new file mode 100644 index 0000000000..a1b5b01f38 --- /dev/null +++ b/modules/integrate/partials/proc_listing-workspaces.adoc @@ -0,0 +1,46 @@ + +[id="listing-workspaces"] += List all workspaces + +List your workspaces from the command line to check their status, identify stopped or failed workspaces, and monitor resource usage across your {prod-short} environment. + +.Prerequisites + +* You have an active `{orch-cli}` session with permissions to `get` the `DevWorkspace` resources in your {orch-namespace} on the cluster. See {orch-cli-link}. + +* You know the relevant {prod-short} user namespace on the cluster. Visit `pass:c,a,q[{prod-url}]/api/kubernetes/namespace` to get your {prod-short} user namespace as `name`. + +* You are in the {prod-short} user namespace on the cluster. On {orch-name}, use `{orch-cli}` to link:https://docs.openshift.com/container-platform/latest/cli_reference/openshift_cli/developer-cli-commands.html#oc-project[display your current namespace or switch to a namespace]. + +.Procedure + +. List your workspaces: ++ +[source,subs="+attributes"] +---- +$ {orch-cli} get devworkspaces +---- ++ +.Output +==== +---- +NAMESPACE NAME DEVWORKSPACE ID PHASE INFO +user1-dev spring-petclinic workspace6d99e9ffb9784491 Running https://url-to-workspace.com +user1-dev golang-example workspacedf64e4a492cd4701 Stopped Stopped +user1-dev python-hello-world workspace69c26884bbc141f2 Failed Container tooling has state CrashLoopBackOff +---- +==== + +. Optional: Add the `--watch` flag to show *PHASE* changes live: ++ +[source,subs="+attributes"] +---- +$ {orch-cli} get devworkspaces --watch +---- + +. Optional: Add the `--all-namespaces` flag to list workspaces from all {prod-short} users. This requires administrative permissions on the cluster. ++ +[source,subs="+attributes"] +---- +$ {orch-cli} get devworkspaces --all-namespaces +---- \ No newline at end of file diff --git a/modules/integrate/partials/proc_removing-workspaces.adoc b/modules/integrate/partials/proc_removing-workspaces.adoc new file mode 100644 index 0000000000..080e8cdbce --- /dev/null +++ b/modules/integrate/partials/proc_removing-workspaces.adoc @@ -0,0 +1,29 @@ + +[id="removing-workspaces"] += Remove workspaces + +Remove a workspace from the command line by deleting its `DevWorkspace` custom resource. The {prod-short} dashboard is the recommended method for routine operations. + +[WARNING] +==== +Deleting the `DevWorkspace` custom resource also deletes other workspace resources if they were created by {prod-short}: for example, the referenced `DevWorkspaceTemplate` and per-workspace `PersistentVolumeClaims`. +==== + +.Prerequisites + +* You have an active `{orch-cli}` session on the cluster. See {orch-cli-link}. + +* You know the workspace name. Run `{orch-cli} get devworkspaces` to list workspace names. + +* You know the relevant {prod-short} user namespace on the cluster. Visit `pass:c,a,q[{prod-url}]/api/kubernetes/namespace` to get your {prod-short} user namespace as `name`. On {orch-name}, use `{orch-cli}` to link:https://docs.openshift.com/container-platform/latest/cli_reference/openshift_cli/developer-cli-commands.html#oc-project[display your current namespace or switch to a namespace]. + +* You are in the {prod-short} user namespace on the cluster. + +.Procedure + +* Run the following command to remove a workspace: ++ +[subs="+quotes,attributes"] +---- +$ {orch-cli} delete devworkspace ____ -n ____ +---- diff --git a/modules/end-user-guide/partials/proc_restoring-node-extra-ca-certs-variable-value.adoc b/modules/integrate/partials/proc_restoring-node-extra-ca-certs-variable-value.adoc similarity index 100% rename from modules/end-user-guide/partials/proc_restoring-node-extra-ca-certs-variable-value.adoc rename to modules/integrate/partials/proc_restoring-node-extra-ca-certs-variable-value.adoc diff --git a/modules/administration-guide/partials/proc_setting-up-an-application-link-on-the-bitbucket-server.adoc b/modules/integrate/partials/proc_setting-up-an-application-link-on-the-bitbucket-server.adoc similarity index 86% rename from modules/administration-guide/partials/proc_setting-up-an-application-link-on-the-bitbucket-server.adoc rename to modules/integrate/partials/proc_setting-up-an-application-link-on-the-bitbucket-server.adoc index 31a8566a1b..df696d1ad9 100644 --- a/modules/administration-guide/partials/proc_setting-up-an-application-link-on-the-bitbucket-server.adoc +++ b/modules/integrate/partials/proc_setting-up-an-application-link-on-the-bitbucket-server.adoc @@ -1,13 +1,13 @@ :_content-type: PROCEDURE -:description: Setting up an application link on the Bitbucket Server +:description: Create an OAuth 1.0 application link on the Bitbucket Server :keywords: bitbucket, bitbucket-server, application-link -:navtitle: Setting up an application link on the Bitbucket Server +:navtitle: Create an OAuth 1.0 application link on the Bitbucket Server // :page-aliases: [id="setting-up-an-application-link-on-the-bitbucket-server"] -= Setting up an application link on the Bitbucket Server += Create an OAuth 1.0 application link on the Bitbucket Server -Set up an application link for OAuth 1.0 on the Bitbucket Server. +Create an OAuth 1.0 application link on the Bitbucket Server so that {prod-short} can authenticate your developers and provide credential-free access to Bitbucket Server repositories. .Prerequisites diff --git a/modules/administration-guide/partials/proc_setting-up-an-oauth-2-application-link-on-the-bitbucket-server.adoc b/modules/integrate/partials/proc_setting-up-an-oauth-2-application-link-on-the-bitbucket-server.adoc similarity index 70% rename from modules/administration-guide/partials/proc_setting-up-an-oauth-2-application-link-on-the-bitbucket-server.adoc rename to modules/integrate/partials/proc_setting-up-an-oauth-2-application-link-on-the-bitbucket-server.adoc index 0090bc0eb5..13872a254f 100644 --- a/modules/administration-guide/partials/proc_setting-up-an-oauth-2-application-link-on-the-bitbucket-server.adoc +++ b/modules/integrate/partials/proc_setting-up-an-oauth-2-application-link-on-the-bitbucket-server.adoc @@ -1,13 +1,13 @@ :_content-type: PROCEDURE -:description: Setting up an OAuth 2.0 application link on the Bitbucket Server +:description: Create an OAuth 2.0 application link on the Bitbucket Server :keywords: bitbucket, bitbucket-server, application-link, oauth2 -:navtitle: Setting up an OAuth 2.0 application link on the Bitbucket Server +:navtitle: Create an OAuth 2.0 application link on the Bitbucket Server // :page-aliases: [id="setting-up-an-oauth-2-application-link-on-the-bitbucket-server"] -= Setting up an OAuth 2.0 application link on the Bitbucket Server += Create an OAuth 2.0 application link on the Bitbucket Server -Set up an OAuth 2.0 application link on the Bitbucket Server. +Create an OAuth 2.0 application link on the Bitbucket Server so that {prod-short} can authenticate your developers and provide credential-free access to Bitbucket Server repositories. .Prerequisites diff --git a/modules/administration-guide/partials/proc_setting-up-an-oauth-consumer-in-the-bitbucket-cloud.adoc b/modules/integrate/partials/proc_setting-up-an-oauth-consumer-in-the-bitbucket-cloud.adoc similarity index 74% rename from modules/administration-guide/partials/proc_setting-up-an-oauth-consumer-in-the-bitbucket-cloud.adoc rename to modules/integrate/partials/proc_setting-up-an-oauth-consumer-in-the-bitbucket-cloud.adoc index ef2c9fd48f..6ea2a2fb77 100644 --- a/modules/administration-guide/partials/proc_setting-up-an-oauth-consumer-in-the-bitbucket-cloud.adoc +++ b/modules/integrate/partials/proc_setting-up-an-oauth-consumer-in-the-bitbucket-cloud.adoc @@ -1,13 +1,13 @@ :_content-type: PROCEDURE -:description: Setting up an OAuth consumer in the Bitbucket Cloud +:description: Create an OAuth consumer in the Bitbucket Cloud :keywords: bitbucket, bitbucket-cloud, oauth-consumer, bitbucket-oauth-consumer, oauth-application -:navtitle: Setting up an OAuth consumer in the Bitbucket Cloud +:navtitle: Create an OAuth consumer in the Bitbucket Cloud // :page-aliases: [id="setting-up-an-oauth-consumer-in-the-bitbucket-cloud"] -= Setting up an OAuth consumer in the Bitbucket Cloud += Create an OAuth consumer in the Bitbucket Cloud -Set up an OAuth consumer for OAuth 2.0 in the Bitbucket Cloud. +Create an OAuth consumer in the Bitbucket Cloud so that {prod-short} can authenticate your developers and provide credential-free access to Bitbucket Cloud repositories. .Prerequisites diff --git a/modules/administration-guide/partials/proc_setting-up-the-github-app.adoc b/modules/integrate/partials/proc_setting-up-the-github-app.adoc similarity index 84% rename from modules/administration-guide/partials/proc_setting-up-the-github-app.adoc rename to modules/integrate/partials/proc_setting-up-the-github-app.adoc index 05d9ce18fc..26e074a55a 100644 --- a/modules/administration-guide/partials/proc_setting-up-the-github-app.adoc +++ b/modules/integrate/partials/proc_setting-up-the-github-app.adoc @@ -1,13 +1,13 @@ :_content-type: PROCEDURE -:description: Setting up the GitHub App +:description: Create a GitHub App for {prod-short} :keywords: github, github-app -:navtitle: Setting up the GitHub App +:navtitle: Create a GitHub App for {prod-short} // :page-aliases: [id="setting-up-the-github-app"] -= Setting up the GitHub App += Create a GitHub App for {prod-short} -Set up a GitHub App to enable users to work with GitHub repositories. +Create a GitHub App to provide finer-grained permissions for repository access from {prod-short} workspaces. .Prerequisites diff --git a/modules/administration-guide/partials/proc_setting-up-the-github-oauth-app.adoc b/modules/integrate/partials/proc_setting-up-the-github-oauth-app.adoc similarity index 67% rename from modules/administration-guide/partials/proc_setting-up-the-github-oauth-app.adoc rename to modules/integrate/partials/proc_setting-up-the-github-oauth-app.adoc index 9c5bd0204b..c0067ad139 100644 --- a/modules/administration-guide/partials/proc_setting-up-the-github-oauth-app.adoc +++ b/modules/integrate/partials/proc_setting-up-the-github-oauth-app.adoc @@ -1,13 +1,13 @@ :_content-type: PROCEDURE -:description: Setting up the GitHub OAuth App +:description: Create a GitHub OAuth application for {prod-short} :keywords: github, github-oauth-app -:navtitle: Setting up the GitHub OAuth App +:navtitle: Create a GitHub OAuth application for {prod-short} // :page-aliases: [id="setting-up-the-github-oauth-app"] -= Setting up the GitHub OAuth App += Create a GitHub OAuth application for {prod-short} -Set up a GitHub OAuth App using OAuth 2.0. +Create an OAuth 2.0 application on GitHub so that {prod-short} can authenticate your developers and provide credential-free access to GitHub repositories. .Prerequisites @@ -15,7 +15,7 @@ Set up a GitHub OAuth App using OAuth 2.0. .Procedure -. Go to link:https://github.com/settings/applications/new[]. +. Go to link:https://github.com/settings/applications/new[the GitHub OAuth application registration page]. //Long version: Click your GitHub avatar menu:Settings[Developer settings > OAuth Apps > Register a new application]. max-cx . Enter the following values: diff --git a/modules/administration-guide/partials/proc_setting-up-the-gitlab-authorized-application.adoc b/modules/integrate/partials/proc_setting-up-the-gitlab-authorized-application.adoc similarity index 74% rename from modules/administration-guide/partials/proc_setting-up-the-gitlab-authorized-application.adoc rename to modules/integrate/partials/proc_setting-up-the-gitlab-authorized-application.adoc index ef52a4b2fd..a0dc117e33 100644 --- a/modules/administration-guide/partials/proc_setting-up-the-gitlab-authorized-application.adoc +++ b/modules/integrate/partials/proc_setting-up-the-gitlab-authorized-application.adoc @@ -1,13 +1,13 @@ :_content-type: PROCEDURE -:description: Setting up the GitLab authorized application +:description: Create a GitLab OAuth application for {prod-short} :keywords: gitlab, gitlab-application, gitlab-authorized-application, authorized-application -:navtitle: Setting up the GitLab authorized application +:navtitle: Create a GitLab OAuth application for {prod-short} // :page-aliases: [id="setting-up-the-gitlab-authorized-application"] -= Setting up the GitLab authorized application += Create a GitLab OAuth application for {prod-short} -Set up a GitLab authorized application using OAuth 2.0. +Create an authorized application on GitLab so that {prod-short} can authenticate your developers and provide credential-free access to GitLab repositories. .Prerequisites diff --git a/modules/administration-guide/partials/proc_setting-up-the-microsoft-azure-devops-services-oauth-app.adoc b/modules/integrate/partials/proc_setting-up-the-microsoft-azure-devops-services-oauth-app.adoc similarity index 85% rename from modules/administration-guide/partials/proc_setting-up-the-microsoft-azure-devops-services-oauth-app.adoc rename to modules/integrate/partials/proc_setting-up-the-microsoft-azure-devops-services-oauth-app.adoc index 862eab9d24..8d4a8f64f9 100644 --- a/modules/administration-guide/partials/proc_setting-up-the-microsoft-azure-devops-services-oauth-app.adoc +++ b/modules/integrate/partials/proc_setting-up-the-microsoft-azure-devops-services-oauth-app.adoc @@ -1,15 +1,15 @@ :_content-type: PROCEDURE -:description: Setting up the Microsoft Entra ID OAuth App +:description: Create a Microsoft Entra ID application for {prod-short} :keywords: azure, devops, oauth -:navtitle: Setting up the Microsoft Entra ID OAuth App +:navtitle: Create a Microsoft Entra ID application for {prod-short} // :page-aliases: pass:[] [id="setting-up-the-microsoft-entra-id-oauth-app"] -= Setting up the Microsoft Entra ID OAuth App += Create a Microsoft Entra ID application for {prod-short} -Set up a Microsoft Entra ID OAuth App to enable {prod-short} users to interact with Azure DevOps Git repositories without re-entering credentials. +Create a Microsoft Entra ID application so that {prod-short} can authenticate your developers and provide credential-free access to Azure DevOps repositories. .Prerequisites diff --git a/modules/integrate/partials/proc_starting-stopped-workspaces.adoc b/modules/integrate/partials/proc_starting-stopped-workspaces.adoc new file mode 100644 index 0000000000..7b17d83f94 --- /dev/null +++ b/modules/integrate/partials/proc_starting-stopped-workspaces.adoc @@ -0,0 +1,28 @@ + +[id="starting-stopped-workspaces"] += Start stopped workspaces + +Start a stopped workspace by setting the `spec.started` field in the `DevWorkspace` custom resource to `true`. + +.Prerequisites + +* You have an active `{orch-cli}` session on the cluster. See {orch-cli-link}. + +* You have the workspace name. Run `{orch-cli} get devworkspaces` to list workspace names. + +* You have the relevant {prod-short} user namespace on the cluster. Visit `pass:c,a,q[{prod-url}]/api/kubernetes/namespace` to get your {prod-short} user namespace as `name`. + +* You are in the {prod-short} user namespace on the cluster. On {orch-name}, use `{orch-cli}` to link:https://docs.openshift.com/container-platform/latest/cli_reference/openshift_cli/developer-cli-commands.html#oc-project[display your current namespace or switch to a namespace]. + +.Procedure + +. Run the following command to start a stopped workspace: ++ +[subs="+quotes,attributes"] +---- +$ {orch-cli} patch devworkspace ____ \ +-p '{"spec":{"started":true}}' \ +--type=merge -n ____ && \ +{orch-cli} wait --for=jsonpath='{.status.phase}'=Running \ +dw/____ -n ____ +---- diff --git a/modules/integrate/partials/proc_stopping-workspaces.adoc b/modules/integrate/partials/proc_stopping-workspaces.adoc new file mode 100644 index 0000000000..143f513993 --- /dev/null +++ b/modules/integrate/partials/proc_stopping-workspaces.adoc @@ -0,0 +1,28 @@ + +[id="stopping-workspaces"] += Stop workspaces + +Stop a workspace by setting the `spec.started` field in the `DevWorkspace` custom resource to `false`. + +.Prerequisites + +* You have an active `{orch-cli}` session on the cluster. See {orch-cli-link}. + +* You have the workspace name. Run `{orch-cli} get devworkspaces` to list workspace names. + +* You have the relevant {prod-short} user namespace on the cluster. Visit `pass:c,a,q[{prod-url}]/api/kubernetes/namespace` to get your {prod-short} user namespace as `name`. + +* You are in the {prod-short} user namespace on the cluster. On {orch-name}, use `{orch-cli}` to link:https://docs.openshift.com/container-platform/latest/cli_reference/openshift_cli/developer-cli-commands.html#oc-project[display your current namespace or switch to a namespace]. + +.Procedure + +. Run the following command to stop a workspace: ++ +[subs="+quotes,attributes"] +---- +$ {orch-cli} patch devworkspace ____ \ +-p '{"spec":{"started":false}}' \ +--type=merge -n ____ && \ +{orch-cli} wait --for=jsonpath='{.status.phase}'=Stopped \ +dw/____ -n ____ +---- diff --git a/modules/end-user-guide/partials/snip_warning-about-applying-a-configmap-that-sets-environment-variables.adoc b/modules/integrate/partials/snip_warning-about-applying-a-configmap-that-sets-environment-variables.adoc similarity index 100% rename from modules/end-user-guide/partials/snip_warning-about-applying-a-configmap-that-sets-environment-variables.adoc rename to modules/integrate/partials/snip_warning-about-applying-a-configmap-that-sets-environment-variables.adoc