第3章 config.yaml ファイルのカスタマイズ
以下の手順を使用して、製品および外部サービスを統合する前に config.yaml ファイルをカスタマイズします。このファイルをカスタマイズすると、インストール中に統合と設定が保持されます。
前提条件
- OpenShift Web コンソールにアクセスできる。
- 少なくとも 1 つの外部製品またはサービス (RHACS や Quay など) を統合する予定である。
(オプション) フォークされたソフトウェアカタログリポジトリーの URL。RHTAP は、開発者がアプリケーションのひな型を自動生成できるようにするソフトウェアテンプレートのカタログを提供しています。これらのテンプレートをカスタマイズするには、インストール前にリポジトリーをフォークします。
- ブラウザーで、RHTAP software catalog repository に移動します。
Fork をクリックして、リポジトリーをフォークします。
-
Copy the
mainbranch only というラベルの付いたボックスのチェックを外します。
-
Copy the
-
フォークが作成されたら、その URL をコピーして
private.envファイルに保存します。 - フォークされたリポジトリーで、main をクリックしてブランチ/タグのドロップダウンを開きます。
タグ の下で、RHTAP バージョンに一致するリリースを選択します。
注記アップストリームリポジトリーからの変更を含めるために、フォークを定期的に更新します。
手順
- OpenShift コンソールで、Administrator パースペクティブに切り替えます。
- Workloads > ConfigMaps に移動します。
- Project ドロップダウンリストから、RHTAP を選択します。
-
rhtap-cli-configConfigMap を開きます。 YAML ビューを選択し、
config.yamlパラメーターが定義されている場所に移動します。注記クラスターに必要なサブスクリプションまたは Operator がすでに含まれている場合は、
manageSubscriptionプロパティーをfalseに設定し、インストーラーが新しいサブスクリプションや Operator を作成しないようにすることができます。-
manageSubscription: true(デフォルト): インストーラーは、必要なすべての Operator サブスクリプションを管理およびインストールします。
-
manageSubscription: false: インストーラーは、必要な Operator サブスクリプションがクラスター上にすでに存在することを前提とするため、インストールをスキップします。- プリインストールされている Operator が RHTAP と互換性がある ことを確認します。互換性のないバージョンまたは設定により、インストールが失敗する可能性があります。
必要に応じて次のフィールドを更新します。
カスタムソフトウェアカタログを使用するには、
catalogURLを設定します。redhatDeveloperHub: properties: catalogURL: https://github.com/<your-org>/tssc-sample-templates/blob/releases/all.yamlredhatDeveloperHub: properties: catalogURL: https://github.com/<your-org>/tssc-sample-templates/blob/releases/all.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 外部統合されたコンポーネント (例: ACS、Quay) のインストールを無効にするには、以下を実行します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記外部製品または既存のインスタンスを統合しようとしても、
config.yamlをカスタマイズしないと、Red Hat Trusted Application Pipeline はデフォルトの製品をインストールして使用します。rhtap-cli integrationコマンドを有効にするには、config.yamlをカスタマイズする必要があります。ただし、rhtap-cli integrationのconfig.yamlをカスタマイズしない場合は、インストーラーにより製品がデプロイされ、既存の統合が上書きされます。
Developer Hub で RBAC プラグインを有効にするには、
redhatDeveloperHubセクションでRBACプロパティーを設定します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記adminUsersまたはorgsを省略すると、インストーラーは GitHub アプリケーションの統合時に設定された GitHub ユーザーと組織をデフォルトに設定します。
デフォルトの名前空間の代わりにカスタム名前空間を使用するには、
config.yamlファイルのredhatDeveloperHubセクションでnamespacePrefixesプロパティーを設定します。デフォルトでは、RHTAP はインストール中に 4 つの名前空間を作成します。-
rhtap-app-ci: CI パイプラインワークロード用 rhtap-app-development、rhtap-app-stage、およびrhtap-app-prod: 開発、ステージング、および実稼働環境のデプロイメント用namespacePrefixesプロパティーを使用して、これらの名前空間の接頭辞をカスタマイズし、追加の名前空間セットを定義できます。たとえば、カスタム接頭辞を設定して、my_prefix1-app-ci、my_prefix1-app-development、my_prefix1-app-stage、my_prefix1-app-prodなどの名前空間を生成できます。redhatDeveloperHub: namespacePrefixes: - my_prefix1 - my_prefix2redhatDeveloperHub: namespacePrefixes: - my_prefix1 - my_prefix2Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 必要な変更をすべて完了したら、Save を選択します。
-