第1章 サンプルソフトウェアテンプレートのカスタマイズ
すぐに使用できるソフトウェアテンプレートをオンプレミス環境向けにカスタマイズする方法を説明します。クラスター管理者は、メタデータや仕様の変更を含め、このプロセスを完全に制御できます。
前提条件
- RHTAP インストールプロセス中に、tssc-sample-templates からフォークされたリポジトリー URL を使用した。
手順
- フォークされたリポジトリーを複製し、Visual Studio Code などの任意のテキストエディターで開きます。
プロジェクトディレクトリー内で プロパティー ファイルを見つけます。このファイルにはカスタマイズ可能なデフォルト値が保存されています。ファイルを編集するために開き、環境に応じて次のキーと値のペアを更新します。
キー 説明 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 プロパティーファイル
ターミナルで generate.sh スクリプトを実行します。このアクションにより、ソフトウェアテンプレートが調整され、デフォルトのホスト値が指定した入力値に置き換わります。
./generate.sh
図1.2 generate.sh スクリプト
変更をコミットしてリポジトリーにプッシュします。これにより、RHDH のテンプレートが自動的に更新されます。あるいは、カスタマイズしたテンプレートの 1 つまたはすべてを RHDH に直接インポートして更新することもできます。
- Git プロバイダーのフォークされたサンプルテンプレートリポジトリーに移動します。
-
単一のテンプレートの場合は、
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 です。 - RHDH プラットフォームに戻ります。
- Create > Register Existing Component を選択します。
- Select URL フィールドに、手順 4b でコピーした適切な URL を貼り付けます。
- Analyze を選択し、Import を選択して RHDH のテンプレートを更新します。
検証
- テンプレートのカスタマイズによる影響を調べるアプリケーションの作成を検討してください。
関連情報
- パイプラインをカスタマイズするには、サンプルパイプラインテンプレートのカスタマイズ を参照してください。