第3章 GitLab パイプラインのカスタマイズとコンテナーイメージの再構築

手順

1. ビルドリソース用のディレクトリーを作成します。ディレクトリーの場所は、ロールに応じて異なります。

   • プラットフォームエンジニア: 組織のデフォルトパイプラインを更新するためにイメージを再構築する場合は、tssc-sample-templates リポジトリーをフォークした場所内にディレクトリーを作成できます。たとえば、rebuild-image です。
   • 開発者: 自分自身の使用または特定のプロジェクト用にイメージを再構築する場合は、競合を避けるために、tssc-sample-templates の組織全体のフォークの外部の場所にディレクトリーを作成してください。

   mkdir rebuild-image

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行し、コンテナーの image の URL をコピーします。

   more ../tssc-sample-templates/skeleton/ci/source-repo/gitlabci/.gitlab-ci.yml
   
   # Example:
   ...
   image: registry.access.redhat.com/rhtap-task-runner/rhtap-task-runner-rhel9:1.5
   ...

   Copy to Clipboard Toggle word wrap

3. 次のコマンドを実行して、既存のパイプラインのコンテンツをローカルにコピーします。

   podman run -v $(pwd):/pwd:z <The_url_you_copied_in_step_2> cp -r /work/rhtap /pwd 

   1

   Copy to Clipboard Toggle word wrap

   1

   このコマンドは、<the_url_you_copied_in_step_2> イメージを使用してコンテナーを起動します。次に、コンテナー内の /work/rhtap からパイプラインファイルを作業ディレクトリー ($(pwd)) にコピーします。さらに、SELinux が有効になっているシステム (Fedora、RHEL、CentOS など) を使用していない場合は、互換性を確保するためにコマンドの :z オプションを削除してください。

4. rhtap ディレクトリーに移動し、必要に応じてパイプラインタスクをカスタマイズします。

5. rebuild-image ディレクトリーに Dockerfile を作成し、次のコンテンツを追加してコンテナーに変更を含めます。さらに、registry.access.redhat.com/rhtap-task-runner/rhtap-task-runner-rhel9:1.5 のベースイメージは、軽量の Universal Base Image (UBI) を提供する ubi/ubi-minimal 上に構築されます。追加のソフトウェアと依存関係をインストールする必要がある場合は、microdnf を使用します。コマンドの例:

   FROM registry.access.redhat.com/rhtap-task-runner/rhtap-task-runner-rhel9:1.5 

   1

   
   
   #Copy the updated pipeline tasks
   
   COPY ./rhtap /work/rhtap 

   2

   
   
   # Example: Install additional software (for example, git)
   RUN microdnf -y install make 

   3

   Copy to Clipboard Toggle word wrap

   1

   既存の rhtap-runner コンテナーを開始点として使用します。

   2

   更新されたパイプラインタスクをローカル rhtap フォルダーからコンテナー内の /work/rhtap ディレクトリーにコピーします。

   3

   microdnf を使用して追加のソフトウェアまたは依存関係をインストールする方法を示します。

6. 次のコマンドで新しいコンテナーイメージをビルドします。

   podman build -f Dockerfile -t quay.io/<namespace>/<new_image_name> 

   1

   Copy to Clipboard Toggle word wrap

   1

   -f Dockerfile は、コンテナーイメージのビルドに使用する Dockerfile を指定します。-f フラグを使用すると、Dockerfile の名前が Dockerfile でない場合や別のディレクトリーにある場合に、Dockerfile を明示的に指定できます。-t quay.io/<namespace>/<new_image_name> は、コンテナーイメージを簡単に識別できるようにタグ (名前) を割り当てます。

7. Quay.io にログインし、更新されたイメージをプッシュします。

   podman login quay.io
   
   # Enter username and password
   
   podman push quay.io/<namespace>/<new_image_name> 

   1

   Copy to Clipboard Toggle word wrap

   1

   これにより、カスタマイズされたコンテナーイメージが Quay.io にアップロードされ、GitLab パイプラインで使用できるようになります。

8. プラットフォームエンジニアのみ: tssc-sample-templates > skeleton > ci > source-repo > gitlabci > .gitlab-ci.yml ファイルに移動し、コンテナーイメージの URL を、先ほど作成した URL に置き換えます。これにより、新しいコンテナーイメージがデフォルトになります。

   image: quay.io/<namespace>/<new_image_name>

   Copy to Clipboard Toggle word wrap

9. 開発者専用: GitLab 内の単一のリポジトリーのコンテナーイメージを更新するには、以下の作業を行います。

   1. ソースリポジトリー > .gitlab-ci.yaml に移動し、コンテナーイメージの URL を先ほど作成した URL に置き換えます。

   image: quay.io/<namespace>/<new_image_name>

   Copy to Clipboard Toggle word wrap
10. 変更をコミットしてプッシュし、更新されたパイプライン設定を適用します。