Jenkins の設定

手順

1. Web ブラウザーで Jenkins インスタンスを開き、管理者の認証情報でログインします。
2. Jenkins ダッシュボードの右上隅にあるユーザー名を選択します。
3. 左側のサイドバーから Credentials を選択します。
4. 認証情報を追加する適切なドメインを選択します。通常は、Global credentials (unrestricted) です。
5. Add Credentials を選択します。
6. Kind ドロップダウンリストから、Secret text を選択します。
7. Scope ドロップダウンリストのデフォルト値は Global (Jenkins) のままにします。
8. Secret フィールドに ACS API トークンを入力します。
9. ID フィールドに ROX_API_TOKEN を入力します。
10. Description フィールドには、認証情報の適切な説明を入力します。

11. 以下の認証情報に対して、手順 5 - 10 を繰り返します。

    Expand

    変数	説明
    1 つのイメージレジストリーに対してのみイメージレジストリー認証情報を提供します。
    QUAY_IO_CREDS_USR	Quay.io リポジトリーにアクセスするためのユーザー名。
    QUAY_IO_CREDS_PSW	Quay.io リポジトリーにアクセスするためのパスワード。
    ARTIFACTORY_IO_CREDS_USR	JFrog Artifactory リポジトリーにアクセスするためのユーザー名。
    ARTIFACTORY_IO_CREDS_PSW	JFrog Artifactory リポジトリーにアクセスするためのパスワード。
    NEXUS_IO_CREDS_USR	Sonatype Nexus リポジトリーにアクセスするためのユーザー名。
    NEXUS_IO_CREDS_PSW	Sonatype Nexus リポジトリーにアクセスするためのパスワード。
    Jenkins がローカル以外の OpenShift インスタンスで実行され、Rekor サービスと TUF サービスが異なるクラスター上にある場合は、これらの変数を設定します。
    REKOR_HOST	Rekor サーバーの URL。
    TUF_MIRROR	TUF サービスの URL。
    Jenkins の GitOps 設定
    GITOPS_AUTH_PASSWORD	新しくビルドされたイメージの GitOps リポジトリーを更新するためにシステムが使用するトークン。
    GITOPS_AUTH_USERNAME (任意)	Jenkins が GitLab と連携するために必要なパラメーター。また、Jenkinsfile でこのパラメーターを含む行のコメントを解除する必要があります (GITOPS_AUTH_USERNAME = credentials('GITOPS_AUTH_USERNAME')。デフォルトでは、この行はコメントアウトされています。
    ACS タスクに必要な変数
    ROX_CENTRAL_ENDPOINT	ROX Central サーバーのエンドポイント。
    ROX_API_TOKEN	ROX サーバーにアクセスするための API トークン。
    SBOM タスクに必要な変数
    COSIGN_SECRET_PASSWORD	Cosign 署名鍵のパスワード。
    COSIGN_SECRET_KEY	Cosign の秘密鍵。
    COSIGN_PUBLIC_KEY	Cosign の公開鍵。
    TRUSTIFICATION_BOMBASTIC_API_URL	SBOM 生成で使用される Trustification Bombastic API の URL。
    TRUSTIFICATION_OIDC_ISSUER_URL	Trustification Bombastic API と対話する際の認証に使用される OIDC 発行者 URL。
    TRUSTIFICATION_OIDC_CLIENT_ID	OIDC を使用して Trustification Bombastic API に認証するためのクライアント ID。
    TRUSTIFICATION_OIDC_CLIENT_SECRET	Trustification Bombastic API への認証にクライアント ID と一緒に使用されるクライアントシークレット。
    TRUSTIFICATION_SUPPORTED_CYCLONEDX_VERSION	システムがサポートして生成する CycloneDX SBOM バージョンを指定します。

    Show more

12. 最後に実行したパイプラインを再実行します。

    1. または、GitHub でアプリケーションのソースリポジトリーに切り替えて、小さな変更を加え、コミットして新しいパイプラインの実行をトリガーします。

手順

1. Jenkins インスタンスにログインします。
2. Jenkins ダッシュボードから、New Item を選択します。

3. パイプラインジョブの名前を入力し、Pipeline プロジェクト (例: secure-jenkins) を選択します。

   注記

   パイプラインジョブの名前は、Jenkins CI を追加するアプリケーションの名前と一致する必要があります。名前が一致しないと、パイプラインは Jenkins 上で実行しれますが、RHDH には表示されません。

   1. (オプション) 別のパイプライン名を使用する場合は、ソースリポジトリーの catalog-info.yaml ファイルの jenkins.io/job-full-name フィールドを、選択したパイプライン名に更新します。
4. OK を選択してジョブを作成します。
5. Configure > General ページで Pipeline セクションに移動し、Definition ドロップダウンリストから Pipeline script from SCM を選択します。
6. SCM ドロップダウンリストから Git を選択します。

7. Repository URL フィールドに、Jenkins ソースリポジトリーの URL を入力します。

   1. Red Hat Developer Hub プラットフォームのカタログから適切なアプリケーションを選択します。
   2. Overview タブに移動し、View Source を選択して、アプリケーションのソースコードが格納されているリポジトリーを開きます。
8. Branches to build セクションで、*/main と入力します。
9. Save を選択します。システムは live-jenkins (ジョブの名前) ページを表示します。

10. Build Now を選択します。システムはビルドパイプラインを開始します。ビルドが完了するまで待機します。

    1. Stage View セクションで、Pipeline Overview を選択し、パイプライン実行を視覚化します。
    2. Pipeline Console を選択して、パイプライン実行の各ステージのライブログを確認します。

1. カタログから適切なアプリケーションまたはコンポーネントを選択します。

   • CI タブに移動して、Jenkins プロジェクトを表示します。適切な Jenkins ジョブは、Actions 列を使用して、ジョブの表示、再実行、および履歴の表示を行うことができます。システムは、最新の実行のステータスを含むジョブの概要を表示します。
   • CD タブに移動し、適切なカードを選択して、コミットメッセージ、作成者名、ArgoCD と GitOps により管理されるデプロイメント履歴などのデプロイメントの詳細を表示します。
   • カタログの Kind ドロップダウンリストから Resource を選択します。システムは Jenkins GitOps ジョブを表示します。適切な GitOps リソースを選択して確認します。
   • Topology タブに移動して、デプロイメント namespace 内でのアプリケーションのデプロイメントを視覚化します。