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

手順

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

2. アクセストークンを Base64 にエンコードします。

   ヒント

   オペレーティングシステムに base64 コマンドラインツールがインストールされている場合は、次のコマンドラインを使用できます。

   $ echo -n '<your_access_token_string>' | base64

3. Web ブラウザーで "https://devspaces-<openshift_deployment_name>.<domain_name>"/api/user アクセスし、レスポンスから id 値をコピーします。これは、OpenShift Dev Spaces ユーザー ID です。

4. Git プロバイダーの API ドキュメントに従って、Git プロバイダーのユーザー ID を取得します。

   • GitHub: ユーザーを取得します。レスポンスの id 値を参照してください。
   • GitLab: ユーザーの一覧表示: 通常のユーザー の場合は、username フィルターを使用します: /users?username=:username。レスポンスの id 値を参照してください。
   • Bitbucket Server: ユーザーを取得します。レスポンスの id 値を参照してください。

5. 新しい 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-userid: '<git_provider_user_id>'4
       che.eclipse.org/scm-username: <git_provider_username>
   data:
     token: <Base64_encoded_access_token>
   type: Opaque

   1

   OpenShift Dev Spaces ユーザー ID。

   2

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

   3

   Git プロバイダーの URL。

   4

   Git プロバイダーのユーザー ID。

6. "https://devspaces-<openshift_deployment_name>.<domain_name>"/api/kubernetes/namespace にアクセスして、OpenShift Dev Spaces ユーザーの namespace を name として取得します。

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

   ヒント

   OpenShift の場合:

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

     $ oc project

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

     $ oc project <your_user_namespace>

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

   ヒント

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

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

検証

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