第2章 ユーザーのオンボーディング
組織ですでに OpenShift Dev Spaces インスタンスを実行している場合は、新しいワークスペースを開始し、ワークスペースを管理し、ワークスペースから Git サーバーに対して自分自身を認証する方法を学習することで、新しいユーザーとして開始できます。
2.1. Git リポジトリーのクローンを使用して新しいワークスペースを開始
OpenShift Dev Spaces を使用すると、ブラウザーで URL を使用して、Git リポジトリーのクローンを含む新しいワークスペースを開始できます。このようにして、GitHub、GitLab、Bitbucket、または Microsoft Azure DevOps サーバーインスタンスでホストされている Git リポジトリーのクローンを作成できます。
OpenShift Dev Spaces ダッシュボードの Create Workspace ページにある Git Repository URL フィールドを使用して、Git リポジトリーの URL を入力し、新しいワークスペースを開始することもできます。
- GitHub、GiLab、Bitbucket、または Microsoft Azure DevOps 以外の Git サービスからの URL を使用してワークスペースを開始すると、失敗します。
- SSH URL を使用して新しいワークスペースを開始する場合は、SSH キーを伝播する必要があります。詳細は、Git 操作に SSH キーを使用するための DevWorkspaces の設定 を参照してください。
-
SSH URL がプライベートリポジトリーを参照する場合は、
devfile.yaml
コンテンツを取得できるようにアクセストークンを適用する必要があります。これは、SCM 認証ページの受け入れ、または パーソナルアクセストークン 手順の実行のいずれかで実行できます。
プライベートリポジトリーにアクセスできるように、パーソナルアクセストークンを設定します。「Git プロバイダーアクセストークンの使用」を参照してください。
前提条件
- 組織に、OpenShift Dev Spaces の実行中のインスタンスがある。
-
組織の OpenShift Dev Spaces インスタンスの FQDN URL はわかっています:
https://<openshift_dev_spaces_fqdn>
- オプション: Git サーバーへの認証 が設定されています。
Git リポジトリーのメンテナーは、
devfile.yaml
または.devfile.yaml
ファイルを Git リポジトリーのルートディレクトリーに保持します。(代替ファイル名とファイルパスについては、「新しいワークスペースを開始するための URL の任意のパラメーター」 を参照してください。)ヒントdevfile を含まない Git リポジトリーの URL を指定して、新しいワークスペースを開始することもできます。これにより、Universal Developer Image and with Microsoft Visual Studio Code - Open Source をワークスペース IDE として使用するワークスペースが作成されます。
手順
Git リポジトリーのクローンを使用して新しいワークスペースを開始するには、以下を行います。
- オプション: OpenShift Dev Spaces ダッシュボードページにアクセスして、組織の OpenShift Dev Spaces のインスタンスを認証します。
URL にアクセスして、基本的な構文を使用して新しいワークスペースを開始します。
https://<openshift_dev_spaces_fqdn>#<git_repository_url>
ヒントこの URL は、任意のパラメーターを使用して拡張できます。
https://<openshift_dev_spaces_fqdn>#<git_repository_url>?<optional_parameters> 1
- 1
- 「新しいワークスペースを開始するための URL の任意のパラメーター」を参照してください。
ヒントGit+SSH URL を使用して、新しいワークスペースを開始できます。Git 操作に SSH キーを使用するための DevWorkspaces の設定 を参照してください。
例2.1 新しいワークスペースを開始するための URL
-
https://<openshift_dev_spaces_fqdn>#https://github.com/che-samples/cpp-hello-world
-
https://<openshift_dev_spaces_fqdn>#git@github.com:che-samples/cpp-hello-world.git
例2.2 GitHub インスタンスリポジトリーのクローンを使用して、新しいワークスペースを開始するための URL 構文
-
https://<openshift_dev_spaces_fqdn>#https://<github_host>/<user_or_org>/<repository>
は、デフォルトブランチのクローンを使用して、新しいワークスペースを開始します。 -
https://<openshift_dev_spaces_fqdn>#https://<github_host>/<user_or_org>/<repository>/tree/<branch_name>
は、指定されたブランチのクローンを使用して、新しいワークスペースを開始します。 -
https://<openshift_dev_spaces_fqdn>#https://<github_host>/<user_or_org>/<repository>/pull/<pull_request_id>
は、プルリクエストのブランチのクローンを使用して、新しいワークスペースを開始します。 -
https://<openshift_dev_spaces_fqdn>#git@<github_host>:<user_or_org>/<repository>.git
は、Git+SSH URL から新しいワークスペースを開始します。
例2.3 GitLab インスタンスリポジトリーのクローンを使用して、新しいワークスペースを開始するための URL 構文
-
https://<openshift_dev_spaces_fqdn>#https://<gitlab_host>/<user_or_org>/<repository>
は、デフォルトブランチのクローンを使用して、新しいワークスペースを開始します。 -
https://<openshift_dev_spaces_fqdn>#https://<gitlab_host>/<user_or_org>/<repository>/-/tree/<branch_name>
は、指定されたブランチのクローンを使用して、新しいワークスペースを開始します。 -
https://<openshift_dev_spaces_fqdn>#git@<gitlab_host>:<user_or_org>/<repository>.git
は、Git+SSH URL から新しいワークスペースを開始します。
例2.4 BitBucket Server リポジトリーのクローンを使用して新しいワークスペースを開始するための URL 構文
-
https://<openshift_dev_spaces_fqdn>#https://<bb_host>/scm/<project-key>/<repository>.git
は、デフォルトブランチのクローンを使用して、新しいワークスペースを開始します。 -
https://<openshift_dev_spaces_fqdn>#https://<bb_host>/users/<user_slug>/repos/<repository>/
は、リポジトリーがユーザープロファイルの下に作成された場合、デフォルトブランチのクローンを使用して、新しいワークスペースを開始します。 -
https://<openshift_dev_spaces_fqdn>#https://<bb_host>/users/<user-slug>/repos/<repository>/browse?at=refs%2Fheads%2F<branch-name>
は、指定されたブランチのクローンを使用して、新しいワークスペースを開始します。 -
https://<openshift_dev_spaces_fqdn>#git@<bb_host>:<user_slug>/<repository>.git
は、Git+SSH URL から新しいワークスペースを開始します。
例2.5 Microsoft Azure DevOps Git リポジトリーのクローンを使用して新しいワークスペースを開始するための URL 構文
-
https://<openshift_dev_spaces_fqdn>#https://<organization>@dev.azure.com/<organization>/<project>/_git/<repository>
は、デフォルトのブランチのクローンを使用して、新しいワークスペースを開始します。 -
https://<openshift_dev_spaces_fqdn>#https://<organization>@dev.azure.com/<organization>/<project>/_git/<repository>?version=GB<branch>
は、特定のブランチのクローンを使用して、新しいワークスペースを開始します。 -
https://<openshift_dev_spaces_fqdn>#git@ssh.dev.azure.com:v3/<organization>/<project>/<repository>
は、Git+SSH URL から新しいワークスペースを開始します。
ブラウザータブで新しいワークスペースを開始するための URL を入力すると、ワークスペース開始ページが表示されます。
新しいワークスペースの準備ができると、ワークスペース IDE がブラウザータブにロードされます。
Git リポジトリーのクローンは、新しいワークスペースのファイルシステムに存在します。
ワークスペースには、次のような一意の URL があります:
https://<openshift_dev_spaces_fqdn>/<user_name>/<unique_url>