Red Hat Trusted Application Pipeline のインストール

1. GitHub Personal Access Token を作成します。
2. GitHub アプリケーションを作成します。

手順

1. GitHub の Developer settings ページに移動します。
2. 左側のナビゲーションパネルの Personal access tokens で、Tokens (classic) をクリックします。
3. Generate new token ドロップダウンメニューから、Generate new token (classic) を選択します。プロンプトが表示されたら認証します。
4. 名前を入力し、有効期限を選択して、Select scopes で repo を選択します。これには repo:status から security_events までのすべてのスコープが自動的に含まれます。
5. Generate token をクリックします。GitHub はトークンが表示される新しいページにリダイレクトします。
6. (オプション) 後の手順で再利用できるように、トークンを values.txt などのファイルに保存します。

手順

1. GitHub アプリケーションを作成するには、次のコマンドを実行します。

   bash-5.1$ rhtap-cli integration github-app \
     --create \
     --token="$GH_TOKEN" \
     --org="$GH_ORG_NAME" \
     $GH_APP_NAME

   Copy to Clipboard Toggle word wrap

   以下の変数を置き換えてください。

   • $GH_TOKEN: GitHub の Personal Access Token
   • $GH_ORG_NAME: GitHub の組織名
   • $GH_APP_NAME: GitHub アプリケーションの名前
2. コマンド出力から URL をコピーし、ブラウザーで開きます。
3. Create your GitHub App をクリックします。
4. プロンプトが表示されたら、GitHub に対して認証を行います。
5. Create GitHub App for <your organization> をクリックします。
6. アプリケーションが作成されたら、成功メッセージ内のリンクをクリックして、GitHub 組織にアプリケーションをインストールします。
7. リダイレクトされた GitHub ページで、Install をクリックします。
8. RHTAP に使用している GitHub 組織を選択します。

9. プロンプトが表示されたら、All repositories を選択し、Install をクリックします。

   注記

   この GitHub ページを開いたままにしておくことを推奨します。バナーには、インストール後に RHTAP にアクセスするためのリンク (https://backstage-developer-hub-rhtap… で始まる) が含まれています。

手順

1. RHACS を統合する前に、API トークンと Central エンドポイント URL を取得します。URL にはプロトコル、ホスト名、ポートを含める必要があります。例: https://central-rhacs.example.com:443。

   1. RHACS API トークンの作成 の手順に従ってトークンを生成します。
   2. 後の手順で再利用できるように、トークンを values.txt などのファイルに保存します。
   3. ACS Central エンドポイントを見つけるには、Central エンドポイント URL の設定 の手順に従ってください。
   4. エンドポイント URL を values.txt などのファイルに保存し、後の手順で再利用します。

2. rhtap-cli コンテナーで、次の統合コマンドを実行します。

   bash-5.1$ rhtap-cli integration acs \
     --endpoint="$ACS_ENDPOINT" \
     --token="$ACS_TOKEN"

   Copy to Clipboard Toggle word wrap

   以下の変数を置き換えてください。

   • $ACS_ENDPOINT: RHACS Central エンドポイントの URL
   • $ACS_TOKEN: RHACS API トークン

手順

1. Web ブラウザーで、Quay アカウントにログインします。
2. ページの右上にあるユーザー名をクリックし、Account Settings を選択します。
3. Account Settings ページの Docker CLI Password で、Generate Encrypted Password をクリックします。プロンプトが表示されたら、認証するパスワードを入力します。
4. 同じポップアップで Docker Configuration > View [username]-auth.json をクリックします。"auth": に続く文字列値 (引用符なし) をコピーします。
5. auth の値と Quay ユーザー名を values.txt などのファイルに保存して、Docker 設定の構築時に使用できるようにします。
6. 別のブラウザータブで、Repositories ページ に移動します。
7. Users and Organizations で、RHTAP で使用する組織の名前をクリックします。
8. 左側のナビゲーションで、Applications をクリックします。
9. Create New Application をクリックし、名前を入力します。
10. 作成したアプリケーションの名前をクリックします。
11. 左側のナビゲーションで、Generate Token をクリックします。
12. パーミッション一覧で、View all visible repositories を選択します。
13. Generate Access Token をクリックします。
14. Authorize Application をクリックします。Quay によりアクセストークンが表示されます。そのトークンをコピーします。

1. rhtap-cli コンテナーで次のコマンドを実行し、必要なすべての値をインラインで渡して Quay を RHTAP と統合します。

   bash-5.1$ rhtap-cli integration quay \
     --dockerconfigjson='{"auths":{"quay.io":{"auth":"<auth_token>","email":""}}}' \
     --token="<quay_access_token>" \
     --url="https://quay.io"

   Copy to Clipboard Toggle word wrap

   以下の値を置き換えます。

   • <auth_token>: "auth": の配下にある auth.json ファイル
   • <quay_access_token>: OAuth アプリケーション経由で生成したアクセストークン
   • https://quay.io: Quay インスタンスの URL (self-hosted の場合はカスタム URL を使用)

手順

1. rhtap-cli コンテナーで、次の統合コマンドを実行します。

   bash-5.1$ rhtap-cli integration bitbucket \
     --username="$BB_USERNAME" \
     --app-password="$BB_TOKEN" \
     --host="$BB_URL"

   Copy to Clipboard Toggle word wrap

   以下の変数を置き換えてください。

   • $BB_USERNAME: Bitbucket ユーザー名
   • $BB_TOKEN: Bitbucket アプリケーションのパスワード

   • $BB_URL: Bitbucket ホスト URL (オプション)

     注記

     デフォルトの Bitbucket Cloud ホスト (bitbucket.org) を使用している場合は、--host オプションを省略できます。

手順

1. rhtap-cli コンテナーで、次の統合コマンドを実行します。

   bash-5.1$ rhtap-cli integration gitlab \
     --token="$GL_API_TOKEN" \
     --host="$GL_URL" \
     --group="$GL_GROUP"

   Copy to Clipboard Toggle word wrap

   以下の変数を置き換えてください。

   • $GL_API_TOKEN: GitLab Personal Access Token
   • $GL_URL: GitLab ホスト URL (gitlab.com を使用する場合はこのオプションを省略してください)
   • $GL_GROUP: リポジトリーを含む GitLab グループ名

手順

1. rhtap-cli コンテナーで、次の統合コマンドを実行します。

   bash-5.1$ rhtap-cli integration jenkins \
     --token="$JK_API_TOKEN" \
     --url="$JK_URL" \
     --username="$JK_USERNAME"

   Copy to Clipboard Toggle word wrap

   以下の変数を置き換えてください。

   • $JK_API_TOKEN: Jenkins API トークン
   • $JK_URL: Jenkins インスタンスの URL
   • $JK_USERNAME: Jenkins ユーザー ID

手順

1. rhtap-cli コンテナーで、次の統合コマンドを実行します。

   bash-5.1$ rhtap-cli integration azure \
     --organization="$AZURE_ORGANIZATION" \
     --host="$AZURE_HOST_URL" \
     --token="$AZURE_API_TOKEN" \
     --tenantID="$AZURE_TENANT_ID" \
     --client-id="$AZURE_CLIENT_ID" \
     --client-secret="$AZURE_CLIENT_SECRET"

   Copy to Clipboard Toggle word wrap

   以下の変数を置き換えてください。

   • $AZURE_ORGANIZATION: Azure DevOps の組織名
   • $AZURE_HOST_URL: DevOps ベース URL (デフォルトの dev.azure.com を使用する場合はこのオプションを省略します)
   • $AZURE_API_TOKEN: Personal Access Token
   • $AZURE_TENANT_ID: (オプション) AAD テナント ID
   • $AZURE_CLIENT_ID: (オプション) AAD アプリケーションクライアント ID
   • $AZURE_CLIENT_SECRET: (オプション) AAD アプリケーションクライアントシークレット

手順

1. Artifactory Web UI で、Administration ビューに移動します。
2. 使用するリポジトリーの横にある緑色の Set Up Client/CI Tool ボタンをクリックします。
3. Docker Client を選択します。

4. CLI から認証するには、UI の指示に従います。

   1. UI は、Docker パスワードとして使用されるトークンを生成します。後のステップで再利用できるように、トークンを values.txt などのファイルに保存します。

   2. CLI 経由で JFrog にログインすると、パスワードが ~/.docker/config.json などのファイルに保存されたことを示すメッセージが表示されます。

      注記

      このメッセージが表示されない場合は、後の手順で config.json のコンテンツを手動で生成できます。

5. rhtap-cli コンテナーで、次の統合コマンドを実行します。

   bash-5.1$ rhtap-cli integration artifactory \
     --url="$AF_URL" \
     --dockerconfigjson='$AF_DOCKERCONFIGJSON' \
     --token="$AF_API_TOKEN"

   Copy to Clipboard Toggle word wrap

   以下の変数を置き換えてください。

   • $AF_URL: JFrog インスタンスの URL (例: https://myusername.jfrog.io)
   • $AF_DOCKERCONFIGJSON: パスワードが保存されている config.json ファイルの内容

   • $AF_API_TOKEN: JFrog によって生成されたトークン

     注記

     JSON 構造を保持するには、$AF_DOCKERCONFIGJSON 値を一重引用符で囲むようにしてください。

     CLI によって config.json ファイルが生成されなかった場合は、次の形式を使用して手動でその内容を作成できます。

     {
       "auths": {
         "<URL for your JFrog instance>": {
           "auth": "<base64 format of username:password>",
           "email": ""
         }
       }
     }

     Copy to Clipboard Toggle word wrap

手順

1. RHTAP と同じクラスター上で実行している Quay インスタンスにログインします。
2. rhtap 組織に移動します。
3. Applications > OAuth Applications > Create New Application > Generate Token を選択します。
4. View all visible repositories オプションのボックスをオンにします。
5. Generate Access Token をクリックします。
6. アクセストークンをコピーして保存します。

7. ターミナルで次のコマンドを実行して、rhtap-quay-integration シークレットを更新します。

   export ACCESS_TOKEN=<generated-Quay-token>
   oc patch secret rhtap-quay-integration \
     -n rhtap \
     --type='merge' \
     -p="{\"data\":{\"token\":\"$(echo -n $ACCESS_TOKEN | base64)\"}}"
   rhtap-cli deploy chart/rhtap-dh

   Copy to Clipboard Toggle word wrap

   この手順により、developer-hub-rhtap-env シークレットも自動的に更新されます。