5.2. サービスアカウントを使用したシークレットの提供

手順

1. secret.yaml ファイルにシークレットの YAML マニフェストを作成します。このマニフェストでは、対象の Git リポジトリーにアクセスするためのユーザー名とパスワード、または GitHub Personal Access Token を指定します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: basic-user-pass 1
     annotations:
       tekton.dev/git-0: https://github.com
   type: kubernetes.io/basic-auth
   stringData:
     username: <username> 2
     password: <password> 3

   1

   シークレットの名前。この例では、basic-user-pass です。

   2

   Git リポジトリーのユーザー名。

   3

   Git リポジトリーのパスワードまたは Personal Access Token

2. サービスアカウントの YAML マニフェストを serviceaccount.yaml ファイルに作成します。このマニフェストで、シークレットをサービスアカウントに関連付けます。

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: build-bot 1
   secrets:
     - name: basic-user-pass 2

   1

   サービスアカウントの名前。この例では、build-bot です。

   2

   シークレットの名前。この例では、basic-user-pass です。

3. run.yaml ファイルにタスク実行またはパイプライン実行の YAML マニフェストを作成し、サービスアカウントをタスク実行またはパイプライン実行に関連付けます。次のいずれかの例を使用します。

   • サービスアカウントを TaskRun リソースに関連付けます。

     apiVersion: tekton.dev/v1
     kind: TaskRun
     metadata:
       name: build-push-task-run-2 1
     spec:
       taskRunTemplate:
         serviceAccountName: build-bot 2
       taskRef:
         name: build-push 3

     1

     タスク実行の名前。この例では、build-push-task-run-2 です。

     2

     サービスアカウントの名前。この例では、build-bot です。

     3

     タスクの名前。この例では、build-push です。

   • サービスアカウントを PipelineRun リソースに関連付けます。

     apiVersion: tekton.dev/v1
     kind: PipelineRun
     metadata:
       name: demo-pipeline 1
       namespace: default
     spec:
       taskRunTemplate:
         serviceAccountName: build-bot 2
       pipelineRef:
         name: demo-pipeline 3

     1

     パイプライン実行の名前。この例では、demo-pipeline です。

     2

     サービスアカウントの名前。この例では、build-bot です。

     3

     パイプラインの名前。この例では、demo-pipeline です。

4. 次のコマンドを入力して、作成した YAML マニフェストを適用します。

   $ oc apply --filename secret.yaml,serviceaccount.yaml,run.yaml

手順

1. SSH 秘密鍵 を生成するか、既存の秘密鍵をコピーします。これは通常 ~/.ssh/id_rsa ファイルで入手できます。

2. secret.yaml ファイルにシークレットの YAML マニフェストを作成します。このマニフェストでは、ssh-privatekey の値を SSH 秘密鍵ファイルの内容に、known_hosts の値を既知のホストファイルの内容に設定します。

   apiVersion: v1
   kind: Secret
   metadata:
     name: ssh-key 1
     annotations:
       tekton.dev/git-0: github.com
   type: kubernetes.io/ssh-auth
   stringData:
     ssh-privatekey: 2
     known_hosts: 3

   1

   SSH 秘密鍵が含まれるシークレットの名前。この例では、ssh-key です。

   2

   SSH 秘密鍵ファイルの内容。

   3

   既知のホストファイルの内容。

   重要

   既知のホストファイルを省略すると、OpenShift Pipelines は任意のサーバーの公開鍵を受け入れます。

3. オプション: アノテーション値の末尾に :<port_number> を追加して、カスタム SSH ポートを指定します。たとえば、tekton.dev/git-0: github.com:2222 などです。

4. サービスアカウントの YAML マニフェストを serviceaccount.yaml ファイルに作成します。このマニフェストで、シークレットをサービスアカウントに関連付けます。

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: build-bot 1
   secrets:
     - name: ssh-key 2

   1

   サービスアカウントの名前。この例では、build-bot です。

   2

   SSH 秘密鍵が含まれるシークレットの名前。この例では、ssh-key です。

5. run.yaml ファイルで、サービスアカウントをタスク実行またはパイプライン実行に関連付けます。次のいずれかの例を使用します。

   • サービスアカウントをタスク実行に関連付けます。

     apiVersion: tekton.dev/v1
     kind: TaskRun
     metadata:
       name: build-push-task-run-2 1
     spec:
       taskRunTemplate:
         serviceAccountName: build-bot 2
       taskRef:
         name: build-push 3

     1

     タスク実行の名前。この例では、build-push-task-run-2 です。

     2

     サービスアカウントの名前。この例では、build-bot です。

     3

     タスクの名前。この例では、build-push です。

   • サービスアカウントをパイプライン実行に関連付けます。

     apiVersion: tekton.dev/v1
     kind: PipelineRun
     metadata:
       name: demo-pipeline 1
       namespace: default
     spec:
       taskRunTemplate:
         serviceAccountName: build-bot 2
       pipelineRef:
         name: demo-pipeline 3

     1

     パイプライン実行の名前。この例では、demo-pipeline です。

     2

     サービスアカウントの名前。この例では、build-bot です。

     3

     パイプラインの名前。この例では、demo-pipeline です。

6. 変更を適用します。

   $ oc apply --filename secret.yaml,serviceaccount.yaml,run.yaml

手順

1. 次のコマンドを入力して、認証情報を含めて、既存の config.json ファイルからコンテナーレジストリー認証シークレットを作成します。

   $ oc create secret generic my-registry-credentials \ 1
     --from-file=config.json=/home/user/credentials/config.json 2

   1

   シークレットの名前。この例では、my-registry-credentials です。

   2

   config.json ファイルのパス名。この例では、/home/user/credentials/config.json です。

2. サービスアカウントの YAML マニフェストを serviceaccount.yaml ファイルに作成します。このマニフェストで、シークレットをサービスアカウントに関連付けます。

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: container-bot 1
   secrets:
     - name: my-registry-credentials 2

   1

   サービスアカウントの名前。この例では、container-bot です。

   2

   SSH 秘密鍵が含まれるシークレットの名前。この例では、my-registry-credentials です。

3. タスク実行またはパイプライン実行の YAML マニフェストを run.yaml ファイルとして作成します。このファイルで、サービスアカウントをタスク実行またはパイプライン実行に関連付けます。次のいずれかの例を使用します。

   • サービスアカウントをタスク実行に関連付けます。

     apiVersion: tekton.dev/v1
     kind: TaskRun
     metadata:
       name: build-container-task-run-2 1
     spec:
       taskRunTemplate:
         serviceAccountName: container-bot 2
       taskRef:
         name: build-container 3

     1

     タスク実行の名前。この例では、build-container-task-run-2 です。

     2

     サービスアカウントの名前。この例では、container-bot です。

     3

     タスクの名前。この例では、build-container です。

   • サービスアカウントをパイプライン実行に関連付けます。

     apiVersion: tekton.dev/v1
     kind: PipelineRun
     metadata:
       name: demo-pipeline 1
       namespace: default
     spec:
       taskRunTemplate:
         serviceAccountName: container-bot 2
       pipelineRef:
         name: demo-pipeline 3

     1

     パイプライン実行の名前。この例では、demo-pipeline です。

     2

     サービスアカウントの名前。この例では、container-bot です。

     3

     パイプラインの名前。この例では、demo-pipeline です。

4. 次のコマンドを入力して変更を適用します。

   $ oc apply --filename serviceaccount.yaml,run.yaml