第2章 ユーザーのオンボーディング
組織ですでに OpenShift Dev Spaces インスタンスを実行している場合は、新しいワークスペースを開始し、ワークスペースを管理し、ワークスペースから Git サーバーに対して自分自身を認証する方法を学習することで、新しいユーザーとして開始できます。
2.1. Git リポジトリーのクローンを使用して新しいワークスペースを開始
ブラウザーで OpenShift Dev Spaces を操作するには、複数の URL が必要です。
- 以下のすべての URL の一部として使用される組織の OpenShift Dev Spaces インスタンスの URL
- ワークスペースコントロールパネルを備えた OpenShift Dev Spaces ダッシュボードの ワークスペース ページの URL
- 新しいワークスペースを開始するための URL
- 使用中のワークスペースの URL
OpenShift Dev Spaces を使用すると、ブラウザーで URL にアクセスして、Git リポジトリーのクローンを含む新しいワークスペースを開始できます。このようにして、GitHub、GitLab インスタンス、または Bitbucket サーバーでホストされている Git リポジトリーのクローンを作成できます。
OpenShift Dev Spaces ダッシュボードの Create Workspace ページにある Git Repo URL \ フィールドを使用して、Git リポジトリーの URL を入力し、新しいワークスペースを開始することもできます。
前提条件
- 組織に、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 の任意のパラメーター」を参照してください。
例2.1 新しいワークスペースを開始するための URL
https://<openshift_dev_spaces_fqdn>#https://github.com/che-samples/cpp-hello-world例2.2 GitHub でホストされているリポジトリーのクローンを使用して新しいワークスペースを開始するための URL 構文
GitHub と GitLab を使用すると、クローンを作成するリポジトリーの特定のブランチの URL を使用することもできます。
-
https://<openshift_dev_spaces_fqdn>#https://github.com/<user_or_org>/<repository>は、デフォルトブランチのクローンを使用して新しいワークスペースを開始します。 -
https://<openshift_dev_spaces_fqdn>#https://github.com/<user_or_org>/<repository>/tree/<branch_name>は、指定されたブランチのクローンを使用して新規ワークスペースを開始します。 -
https://<openshift_dev_spaces_fqdn>#https://github.com/<user_or_org>/<repository>/pull/<pull_request_id>は、プルリクエストのブランチのクローンを使用して新しいワークスペースを開始します。
例2.3 BitBucket Server リポジトリーのクローンを使用して新しいワークスペースを開始するための URL 構文
-
https://<openshift_dev_spaces_fqdn>#https://<bb-host>/scm/<project-key>/<repository_name>.gitは、デフォルトブランチのクローンを使用して新しいワークスペースを開始します。 -
https://<openshift_dev_spaces_fqdn>#https://<bb-host>/users/<user-slug>/repos/<repo-name>/は、リポジトリーがユーザープロファイルの下に作成されます。 -
https://<openshift_dev_spaces_fqdn>#https://<bb-host>/users/<user-slug>/repos/<repo-name>/browse?at=refs%2Fheads%2F<branch-name>は、開始します指定されたブランチのクローンを含む新しいワークスペース。
ブラウザータブで新しいワークスペースを開始するための URL を入力すると、ワークスペース開始ページが表示されます。新しいワークスペースの準備ができると、ワークスペース IDE がブラウザーにロードされます。Git リポジトリーのクローンは、新しいワークスペースのファイルシステムに存在します。ワークスペースには固有の URL があります:
https://<openshift_dev_spaces_fqdn>#workspace<unique_url>。
これはアドレスバーではできませんが、ブラウザーのブックマークマネージャーを使用して、新しいワークスペースをブックマークとして開始するための URL を追加できます。
- Mozilla Firefox では、☰ > Bookmarks > Manage bookmarks > Bookmarks Toolbar > Organize > Add bookmark に移動します。
- Google Chrome で、⋮ > Bookmarks > Bookmark manager > Bookmarks bar > ⋮ > Add new bookmark に移動します。
