第3章 config.yaml ファイルのカスタマイズ
外部製品やサービスを統合する前に config.yaml ファイルをカスタマイズして、インストール中に統合設定を保持します。
前提条件
- OpenShift Web コンソールにアクセスできる。
- 少なくとも 1 つの外部製品またはサービス (RHACS や Quay など) を統合する予定である。
(オプション) フォークされたソフトウェアカタログリポジトリーの URL。RHADS - SSC は、開発者がアプリケーションのひな型を自動生成できるようにするソフトウェアテンプレートのカタログを提供しています。これらのテンプレートをカスタマイズするには、インストール前にリポジトリーをフォークします。
- ブラウザーで、RHADS - SSC ソフトウェアカタログリポジトリー にアクセスします。
Fork をクリックして、リポジトリーをフォークします。
-
Copy the
mainbranch only というラベルの付いたボックスのチェックを外します。
-
Copy the
-
フォークが作成されたら、その URL をコピーして
private.envファイルに保存します。 - フォークされたリポジトリーで、main をクリックしてブランチ/タグのドロップダウンを開きます。
Tags の下で、RHADS - SSC バージョンに一致するリリースを選択します。
注記アップストリームリポジトリーからの変更を含めるために、フォークを定期的に更新します。
手順
- OpenShift コンソールで、Administrator パースペクティブに切り替えます。
- Workloads > ConfigMaps に移動します。
- Project ドロップダウンリストから、RHADS - SSC を選択します。
-
tssc-configConfigMap を開きます。 YAML ビューを選択し、
config.yamlパラメーターが定義されている場所に移動します。注記クラスターにすでに存在する Operator のサブスクリプションを再インストールしないようにするには、
manageSubscription:falseを設定します。-
manageSubscription:true(デフォルト): インストーラーは、必要なすべての Operator サブスクリプションを管理およびインストールします。 -
manageSubscription:false: インストーラーは必要な Operator のサブスクリプションのインストールをスキップします。 - 既存の Operator が RHADS-SSC と互換性がある ことを確認します。互換性のないバージョンではインストールが失敗する可能性があります。
-
config.yaml ファイルの構造
config.yaml ファイルは、次の主要な属性を持つメインの tssc オブジェクトの下に構造化されています。
-
namespace: 主要な操作領域として機能する、デフォルトのインストール namespace (通常はtssc) を定義します。 -
settings: グローバルデプロイメント設定とプロパティーを制御します。 -
products: デプロイメントする製品と機能をリスト表示します。それぞれ、関連付けられたプロパティーを持つ一意の名前で識別されます。 -
dependencies: インストーラーが設定ファイルで定義された順序でデプロイする依存関係を指定します。
tssc.products セクションのカスタマイズ
カスタムソフトウェアカタログを使用するには、
catalogURLを設定します。developerHub: properties: catalogURL: https://github.com/<your-org>/tssc-sample-templates/blob/release-v1.6.x/all.yamlすでに外部に統合されているコンポーネントの自動インストールを無効にするには、以下を実行します。
advancedClusterSecurity: enabled: &rhacsEnabled false namespace: &rhacsNamespace tssc-acs quay: enabled: &quayEnabled false namespace: &quayNamespace tssc-quay注記外部統合が
config.yamlに正しく反映されていない場合、インストーラーはデフォルトのコンポーネントをデプロイします。意図しないプロビジョニングを防ぐためにファイルを更新します。Developer Hub のロールベースのアクセス制御 (RBAC) を有効にするには、以下を実行します。
developerHub: RBAC: enabled: true adminUsers: - yourGitHubUsername - anotherGitHubAdmin orgs: - your-github-org注記adminUsersまたはorgsを定義しない場合、インストーラーは統合時に指定された GitHub 認証情報をデフォルトとして使用します。デフォルトの namespace の接頭辞の代わりにカスタムの namespace の接頭辞を使用するには、
namespacePrefixesプロパティーを設定します。デフォルトでは、RHADS - SSC はインストール中に次の namespace を作成します。-
tssc-app-ci: 継続的インテグレーションパイプラインワークロード用 tssc-app-development、tssc-app-stage、tssc-app-prod: 開発、ステージング、実稼働環境のデプロイメント用これらの namespace の接頭辞をカスタマイズし、追加のセットを定義できます。以下に例を示します。
developerHub: namespacePrefixes: - my_prefix1 # This generates the following namespaces: `my_prefix1-app-ci`, `my_prefix1-app-development`, `my_prefix1-app-stage`, `my_prefix1-app-prod` - my_prefix2 # This generates the following namespaces: `my_prefix2-app-ci`, `my_prefix2-app-development`, `my_prefix2-app-stage`, `my_prefix2-app-prod`-
- 必要な変更をすべて完了したら、Save を選択します。