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

手順

1. すでにある場合は、ホームディレクトリーで .git-credentials ファイルを見つけて開きます。または、このファイルがない場合は、Git クレデンシャルストレージ形式 を使用して、新しい .git-credentials ファイルを保存します。各クレデンシャルは、ファイル内の独自の行に保存されます。

   https://<username>:<token>@<git_server_hostname>

   例6.1 .git-credentials ファイルの行

   https://trailblazer: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@github.com

2. シークレットの .git-credentials ファイルからクレデンシャルを選択します。次の手順のために、選択したクレデンシャルを Base64 にエンコードします。

   ヒント

   • ファイル内のすべての行をエンコードするには:

     $ cat .git-credentials | base64 | tr -d '\n'

   • 選択した行をエンコードするには:

     $ echo -n '<copied_and_pasted_line_from_.git-credentials>' | base64

3. ユーザープロジェクトに新しい OpenShift シークレットを作成します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: git-credentials-secret
     labels:
       controller.devfile.io/git-credential: 'true' 1
       controller.devfile.io/watch-secret: 'true'
     annotations:
       controller.devfile.io/mount-path: /etc/secret 2
   data:
     credentials: <Base64_content_of_.git-credentials> 3

   1

   controller.devfile.io/git-credential ラベルは、シークレットに Git クレデンシャルが含まれていることを示します。

   2

   DevWorkspace コンテナーのカスタム絶対パス。シークレットは、このパスに credentials ファイルとしてマウントされます。デフォルトのパスは / です。

   3

   前の手順で Base64 にエンコードした .git-credentials から選択したコンテンツ。

   ヒント

   ユーザープロジェクトで複数の Git クレデンシャルシークレットを作成して適用できます。それらはすべて、DevWorkspace コンテナーにマウントされる 1 つのシークレットにコピーされます。たとえば、マウントパスを /etc/secret に設定すると、すべての Git クレデンシャルを持つ 1 つのシークレットが /etc/secret/credentials にマウントされます。ユーザープロジェクトのすべての Git クレデンシャルシークレットを同じマウントパスに設定する必要があります。マウントパスは /etc/gitconfig で設定された Git 設定ファイルで自動的に設定されるため、マウントパスを任意のパスに設定できます。

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

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

手順

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

   $ echo -n '<your_access_token>' | base64

2. ユーザープロジェクトで新しい OpenShift シークレットを準備します。

   kind: Secret
   apiVersion: v1
   metadata:
     name: personal-access-token-<your_chosen_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

   あなたの Che ユーザー ID。<che-endpoint>/api/user を取得して、Che ユーザーデータを取得できます。

   2

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

   3

   Git プロバイダーの URL。

   4

   Git プロバイダーのユーザー ID。API ドキュメントに従ってユーザーオブジェクトを取得します。

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

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

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