Red Hat Trusted Application Pipeline のカスタマイズ

手順

1. フォークされたリポジトリーを複製し、Visual Studio Code などの任意のテキストエディターで開きます。

2. プロジェクトディレクトリー内で プロパティー ファイルを見つけます。このファイルにはカスタマイズ可能なデフォルト値が保存されています。ファイルを編集するために開き、環境に応じて次のキーと値のペアを更新します。

   キー	説明
   export GITHUB_DEFAULT_HOST	このキーは、オンプレミスの GitHub ホストの完全修飾ドメイン名に設定します。つまり、HTTP プロトコルと .git 拡張子を除外した URL です。たとえば、ithub-github.apps.cluster-ljg9z.sandbox219.opentlc.com です。デフォルトは github.com です。
   export GITLAB_DEFAULT_HOST	このキーは、オンプレミスの GitLab ホストの完全修飾ドメイン名に設定します。つまり、HTTP プロトコルと .git 拡張子を除外した URL です。たとえば、gitlab-gitlab.apps.cluster-ljg9z.sandbox219.opentlc.com です。デフォルトは gitlab.com です。
   export QUAY_DEFAULT_HOST	デフォルトの Quay URL は、HTTP プロトコルを除外した、特定のオンプレミスのイメージレジストリー URL に対応します。たとえば、quay-tv2pb.apps.cluster-tv2pb.sandbox1194.opentlc.com などです。デフォルトの quay ホストは quay.io です。
   export DEFAULT_DEPLOYMENT_NAMESPACE_PREFIX	RHTAP 内のデプロイメントの名前空間接頭辞です。デフォルトは rhtap-app です。 注記 RHTAP インストールプロセス中にデフォルトの trusted-application-pipeline: namespace を変更した場合は、これを更新してください。

   図1.1 プロパティーファイル

   

3. ターミナルで generate.sh スクリプトを実行します。このアクションにより、ソフトウェアテンプレートが調整され、デフォルトのホスト値が指定した入力値に置き換わります。

   Copy to Clipboard Toggle word wrap

   ./generate.sh

   図1.2 generate.sh スクリプト

   

4. 変更をコミットしてリポジトリーにプッシュします。これにより、RHDH のテンプレートが自動的に更新されます。あるいは、カスタマイズしたテンプレートの 1 つまたはすべてを RHDH に直接インポートして更新することもできます。

   1. Git プロバイダーのフォークされたサンプルテンプレートリポジトリーに移動します。
   2. 単一のテンプレートの場合は、templates ディレクトリーから template.yaml を選択します。ブラウザーのアドレスバーから URL をコピーします。たとえば、https://github.com/<username>/tssc-sample-templates/blob/main/templates/devfile-sample-code-with-quarkus-dance/template.yaml です。すべてのテンプレートの場合は、all.yaml を選択し、ブラウザーのアドレスバーからその URL をコピーします。たとえば、https://github.com/<username>/tssc-sample-templates/blob/main/all.yaml です。
   3. RHDH プラットフォームに戻ります。
   4. Create > Register Existing Component を選択します。
   5. Select URL フィールドに、手順 4b でコピーした適切な URL を貼り付けます。
   6. Analyze を選択し、Import を選択して RHDH のテンプレートを更新します。

手順

1. フォークされたサンプルパイプラインリポジトリーの URL にアクセスします。

   1. フォークされたサンプルパイプラインリポジトリーを開きます。
   2. アドレスバーから完全な URL をコピーします。たとえば、https://github.com/<username>/tssc-sample-pipelines です。

2. サンプルテンプレートリポジトリーの pac URL を更新します。

   1. ターミナルを使用して、ローカルに複製されたサンプルテンプレートリポジトリーに移動します。
   2. 次のコマンドを実行します。{fork_url} は手順 1 でコピーした URL に置き換え、{branch_name} は目的のブランチ名 (main など) に置き換えます。
   Copy to Clipboard Toggle word wrap

   ./scripts/update-tekton-definition {fork_url} {branch_name}
   
   # For example, .scripts/update-tekton-definition https://github.com/<username>/tssc-sample-pipelines main

3. 変更を確認し、コミットしてプッシュします。

   1. サンプルテンプレートリポジトリー内の更新したファイルを確認します。
   2. 適切なメッセージとともに変更をコミットします。
   3. コミットした変更を、フォークされたリポジトリーにプッシュします。

手順

1. Webhook URL とシークレットトークンを取得します。

   1. 管理者権限で OpenShift Web コンソール にログインします。
   2. rhtap プロジェクトに移動し、Pipelines を展開して、PipelineRuns を選択します。
   3. rhtap-pe-info-<> パイプラインの実行を見つけて、Logs タブを選択します。
   注記

   これらのログには、GitLab 設定に必要な Webhook URL とシークレットトークンが含まれます。

2. GitLab で Webhook を設定します。

   1. GitLab リポジトリー内で、Settings > Webhooks に移動します。
   2. URL フィールドに、手順 1 でコピーした Webhook URL を入力します。
   3. Secret Token フィールドに、手順 1 でコピーしたシークレットトークンを入力します。

   4. Trigger セクションでは、次の操作を行います。

      1. Push events を選択します。
      2. Merge request events を選択します。
   5. Add Webhook をクリックします。

検証

1. コードの変更を GitLab リポジトリーにプッシュします。
2. RHDH の CI タブに移動します。
3. コードプッシュに対してパイプラインの実行がトリガーされていることを確認します。