第2章 サンプルソフトウェアテンプレートの概要

手順

1. RHDH ポータルで propagate アイコンを選択して、セルフサービスページに移動します。
2. 適切なテンプレート（例：Quarkus Java - Trusted Application Pipeline）を選択します。

3. Application Information ビューの以下のフォームフィールドでテンプレートを設定します（手順 1 of 4）。

   1. Name フィールドにアプリケーション名を入力します。この名前には、小文字(a-z)、数字(0-9)、およびダッシュ(-)を含めることができます。ただし、小文字の英数字で開始および終了する必要があります。有効な名前の例は my-name または abc-123 です。長さは 1 から 63 文字までである必要があります。
   2. Owner ドロップダウンリストから適切な RHDH コンポーネントの所有者を選択します。デフォルト値は user:guest です。所有者を登録していない場合は、デフォルトの user:guest を選択したままにします。アプリケーションの所有権をカスタマイズするには、guest をユーザー名に置き換えます。
   3. Next を選択します。システムは、アプリケーションリポジトリー情報フォームを表示します（手順 2 ~ 4）。

4. git リポジトリー情報を設定します。

   1. Host Type ドロップダウンリストからリポジトリーホストタイプを選択します。

      • GitHub
      • GitLab
      • Bitbucket
   2. Repository Name フィールドに、A-Z、a-z、0-9、アンダースコア(_)、およびダッシュ(-)文字を使用してリポジトリー名を入力します。システムは、ホストリポジトリーサーバー上に作成するリポジトリーにこの名前を使用します。
   3. Repository Default Branch フィールドに、リポジトリーのデフォルトブランチ名を入力します。デフォルトは main ですが、別のブランチ名を指定することもできます。
   4. Repository Owner フィールドに Git リポジトリーを所有する組織内のユーザー名、組織名、またはプロジェクトを指定します。

   5. Repository Server フィールドに Git リポジトリーサーバーのドメイン名を入力します。

      Expand

      Git リポジトリーサーバー	説明
      GitHub	ホストタイプ に GitHub を選択した場合、このフィールドには github.com が事前に設定されています。ただし、HTTP プロトコルや .git 拡張子なしでオンプレミスのホスト URL を入力することはできます。たとえば、github-github.apps.<custer_name>.<domain_name> です。
      GitLab	ホストタイプ に GitLab を選択した場合、このフィールドには gitlab.com が事前に設定されます。ただし、HTTP プロトコルや .git 拡張子なしでオンプレミスのホスト URL を入力することはできます。たとえば、gitlab-gitlab.apps.<custer_name>.<domain_name>.
      Bitbucket	このフィールドには bitbucket.org が事前に入力されています。

      Show more

   6. Bitbucket の次のフィールドを設定します。

      1. Workspace フィールドに、プロジェクトが含まれるワークスペースの名前を入力します。
      2. Project フィールドにプロジェクトのキーを入力します。プロジェクトキーは、Bitbucket のプロジェクト名の横にあります。

   7. CI Provider ドロップダウンリストからシステムがアプリケーションのビルド、テスト、およびデプロイに使用する継続的インテグレーション(CI)ツールを選択します。

      Expand

      Git リポジトリーホスト	利用可能な CI プロバイダー
      Bitbucket	Jenkins (SLSA 2) Tekton (SLSA 3) Azure Pipelines (SLSA2) (テクノロジープレビュー)
      GitHub	Jenkins (SLSA 2) GitHub Actions (SLSA 2) Tekton (SLSA 3) Azure Pipelines (SLSA2) (テクノロジープレビュー)
      GitLab	Jenkins (SLSA 2) GitLab CI (SLSA 2) Tekton (SLSA 3)

      Show more
   重要
   • Tekton CI で Bitbucket をソースリポジトリーとして使用する場合は、Bitbucket に Webhook を追加する 必要があります。
   • Tekton CI で GitLab をソースリポジトリーとして使用する場合は、GitLab に Webhook を追加する 必要があります。
   • GitHub Actions を使用する場合は、GitHub で必要なシークレットを設定する 必要があります。
   • GitLab CI を使用する場合は、GitLab で必要なシークレットを設定する 必要があります。
   • Azure Pipelines を使用する場合は、Azure で必要なシークレットを設定する 必要があります。
   • Jenkins を使用する場合は、アプリケーションを Jenkins に追加する 必要があります。
   8. Azure Pipelines が CI プロバイダーの場合、RHADS - SSC が Azure Project フィールドにパイプラインを実行する Azure プロジェクトの名前を入力します。
   9. Next を選択します。システムに Deployment Information フォーム（ステップ 3 of 4）が表示されます。

5. デプロイメント情報を設定します。

   1. Image Registry フィールドに、HTTP プロトコルなしでイメージレジストリー URL を指定します。サポートされているレジストリーには、Quay (例: quay.io)、JFrog Artifactory (例: tssc.jfrog.io)、Sonatype Nexus Repository (例: nexus.mycompany.com) などがあります。
   2. Image Organization フィールドにイメージ組織名を入力します。

   3. Image Name フィールドに、小文字、数字、および区切り文字のみを使用してイメージ名を入力します。区切り文字には、ピリオド (.)、最大 2 つのアンダースコア (_)、または 1 つ以上のハイフン (-) が含まれます。たとえば、my-app_1.2 と入力します。

      注記

      名前の先頭と末尾が区切り文字にならないようにする必要があります。

   4. Deployment Namespace フィールドに、アプリケーションをデプロイする namespace またはクラスターの接頭辞を入力します。デフォルト値は tssc-app です。RHads: tssc-app を接頭辞として使用する場合、SSC は名前空間を tssc-app-development、tssc-app-stage、および tssc-app-prod として作成します。
   注記

   tssc-app は、デフォルトのデプロイメント namespace の接頭辞です。この接頭辞はカスタマイズできます。デフォルトのデプロイメント namespace の接頭辞をカスタマイズする方法の詳細は、サンプルソフトウェアテンプレートのカスタマイズ を参照してください。

   5. 追加したすべての情報（手順 4）を確認するには、Review を選択します。

   6. Create を選択します。RHADS - SSC は、次のようなアプリケーションのインフラストラクチャーとデプロイメントパイプラインをセットアップするための自動タスクを開始します。

      • リポジトリーの作成と設定: GitOps リポジトリーとソースリポジトリーを含む、指定したホスティングサービスに新しいリポジトリーを作成します。
      • namespace の作成: 開発、ステージング、および実稼働環境の namespace を生成します。
      • GitOps 統合： Red Hat OpenShift GitOps (GitOps) (a.k.a.、Argo CD)リソースを作成して設定し、開発、ステージング、および実稼働環境の namespace 全体でアプリケーションのデプロイメントをオーケストレーションします。
      • パイプライン定義: パイプライン定義を追加し、アプリケーションの構築、テスト、およびデプロイのための "コードとしてのパイプライン" モデルを提供します。