第6章 ワークスペースでのクレデンシャルと設定の使用

手順

1. Git プロバイダーの Web サイトでアクセストークンを生成します。

   重要

   パーソナルアクセストークンは機密情報であるため、機密扱いにする必要があります。パスワードのように扱います。認証に問題がある場合は、正しいトークンを使用し、リポジトリーのクローンを作成するための適切なパーミッションがあることを確認してください。

   1. コンピューターのローカルでターミナルを開きます。
   2. パーソナルアクセストークンを使用して、git コマンドでリポジトリーのクローンを作成します。git コマンドの形式は、Git プロバイダーによって異なります。たとえば、GitHub のパーソナルアクセストークンの検証は、以下のコマンドを使用して実行できます。

   git clone https://<PAT>@github.com/username/repo.git

   <PAT> は、パーソナルアクセストークンに、username/repo は適切なリポジトリーパスに置き換えます。トークンが有効で、必要なパーミッションがある場合は、クローンプロセスが正常に実行されるはずです。それ以外の場合、これはパーソナルアクセストークンが正しくない、パーミッションが不十分である、またはその他の問題を示しています。

   重要

   GitHub Enterprise Cloud の場合は、トークンが 組織内での使用が許可されている ことを確認します。

2. Web ブラウザーで https://<openshift_dev_spaces_fqdn>/api/user/id に移動して、OpenShift Dev Spaces ユーザー ID を取得します。

3. 新しい OpenShift シークレットを準備します。

   kind: Secret
   apiVersion: v1
   metadata:
     name: personal-access-token-<your_choice_of_name_for_this_token>
     labels:
       app.kubernetes.io/component: scm-personal-access-token
       app.kubernetes.io/part-of: che.eclipse.org
     annotations:
       che.eclipse.org/che-userid: <devspaces_user_id>1
       che.eclipse.org/scm-personal-access-token-name: <git_provider_name>2
       che.eclipse.org/scm-url: <git_provider_endpoint>3
       che.eclipse.org/scm-organization: <git_provider_organization>4
   stringData:
     token: <Content_of_access_token>
   type: Opaque

   1

   OpenShift Dev Spaces ユーザー ID。

   2

   Git プロバイダー名: github、gitlab、bitbucket-server、または azure-devops。

   3

   Git プロバイダーの URL。

   4

   この行は、Git プロバイダーのユーザー組織である azure-devops のみに適用されます。

4. https://<openshift_dev_spaces_fqdn>/api/kubernetes/namespace にアクセスして、OpenShift Dev Spaces ユーザー namespace を name として取得します。

5. クラスター内の OpenShift Dev Spaces ユーザー namespace に切り替えます。

   ヒント

   OpenShift の場合:

   • oc コマンドラインツールは、クラスター内で現在使用している namespace を返すことができます。これを使用して、現在の namespace を確認できます。

     $ oc project

   • 必要に応じて、コマンドラインで OpenShift Dev Spaces ユーザー namespace に切り替えることができます。

     $ oc project <your_user_namespace>

6. シークレットを適用します。

   ヒント

   OpenShift では、oc コマンドラインツールを使用できます。

   $ oc apply -f - <<EOF
   <Secret_prepared_in_step_5>
   EOF

検証

1. Git プロバイダーがホストする リモート Git リポジトリーの URL を使用して、新しいワークスペースを開始します。
2. 変更を加えて、ワークスペースからリモート Git リポジトリーにプッシュします。