:コンテナイメージのビルドと Container Registry へのプッシュ

手順

1. パイプライン向けに専用実行環境を構成し、仮想プライベートクラウド（VPC）および NAS ファイルシステムをバインドします。

2. イメージプリフェッチ機能を用いて、ベースイメージを NAS ファイルシステムにキャッシュします。

3. イメージビルド時に NAS キャッシュディレクトリを参照します。

プリフェッチとビルドを統合したタスク

以下の YAML は、単一タスク内でベースイメージのプリフェッチとビルドを実行します。

kind: Pipeline
name: "image-build-use-cache-pipeline"
description: 'demo pipeline'
labels:
  myLabel: image-build-use-cache
spec:
  templateSpec:
    context:
      data:
        runnerConfig:
          regionId: cn-hangzhou
          logConfig:
            project: demo-project
            logstore: demo-logstore
          # VPC は Enterprise Edition インスタンスに接続されている必要があります。
          vpcConfig:
            securityGroupId: sg-xxxx
            vSwitchIds:
              - vsw-xxx
            vpcId: vpc-xxxx
          # インスタンスの仕様。
          cpu: 8
          memory: 32768
          diskSize: 10240
          # ビルドのタイムアウト時間 (秒)。
          timeout: 1800
    tasks:
      - name: build-push
        context:
          data:
            displayName: image build
            enable: true
            build:
              dockerfile: code/Dockerfile
              # タグに _accelerated を追加してイメージのアクセラレーションを有効化します。
              image: demo-registry-vpc.cn-hangzhou.aliyuncs.com/pipeline***/demo***:debug_accelerated
              # Container Registry Enterprise Edition インスタンス ID。
              instanceID: cri-xxxx
        taskTemplate: build-image-task
        runAfters: []

キャッシュヒットが発生した場合、ビルドログには Found manifest at ... と出力されます。

プリフェッチとビルドを分離したタスク

イメージプリフェッチとイメージビルドを、依存関係を持つ独立したタスクとして実行します。

- name: only-warm
  context:
    data:
      enable: true
      # ベースイメージをキャッシュにプリフェッチ。
      warm:
        images:
        - registry-vpc.cn-hangzhou.aliyuncs.com/pipeline-demo/base-image-1:debug
        - registry-vpc.cn-hangzhou.aliyuncs.com/pipeline-demo/base-image-2:debug
        cacheDir: "/mnt/image-cache"
        # Container Registry Enterprise Edition インスタンスを指定します。
        instanceID: cri-xxxx
  taskTemplate: build-image-task
  runAfters: []
- name: only-build
  context:
    data:
      enable: true
      build:
        dockerfile: code/Dockerfile
        image: registry-vpc.cn-hangzhou.aliyuncs.com/pipeline-demo/demo-repo:latest
        # プリフェッチタスクのキャッシュを参照します。
        cacheDir: "/mnt/image-cache"
  taskTemplate: build-image-task
  runAfters: [only-warm]

ネットワークアクセスの構成

Enterprise Edition インスタンスを用いたイメージビルドを実行する前に、ネットワークアクセスを構成してください。

• インターネット経由のアクセス：デフォルトでは無効です。インターネット経由のアクセスを許可するには、パブリック IP アドレスホワイトリストを構成してください。「インターネット経由のアクセスの構成」をご参照ください。

• VPC 経由のアクセス：Elastic Compute Service（ECS）インスタンスと Container Registry Enterprise Edition インスタンスを同一 VPC 内で接続するために、アクセス制御リスト（ACL）を構成してください。「VPC ACL の構成」をご参照ください。

手順

1. パイプライン向けに専用実行環境を構成し、Container Registry Enterprise Edition インスタンスに接続された VPC をバインドします。Enterprise Edition インスタンスと同じ VPC および vSwitch を使用するか、異なる VPC の場合は VPC ACL を構成してください。「VPC ACL の構成」をご参照ください。

2. build.instanceID フィールドに Enterprise Edition インスタンス ID を指定します。

3. （推奨）イメージリポジトリでイメージ加速を有効化し、イメージタグに _accelerated を付与します。パイプラインのイメージビルドタスクは、オリジナルイメージを自動的にプッシュし、加速イメージの変換完了を待機します。「コンテナイメージのリソースを必要に応じてロード」をご参照ください。

サンプル YAML

kind: Pipeline
name: "image-build-use-cache-pipeline"
description: 'demo pipeline'
labels:
  myLabel: image-build-use-cache
spec:
  templateSpec:
    context:
      data:
        runnerConfig:
          regionId: cn-hangzhou
          logConfig:
            project: demo-project
            logstore: demo-logstore
          # VPC は Enterprise Edition インスタンスと接続されている必要があります。
          vpcConfig:
            securityGroupId: sg-xxxx
            vSwitchIds:
              - vsw-xxx
            vpcId: vpc-xxxx
          # インスタンス仕様。
          cpu: 8
          memory: 32768
          diskSize: 10240
          # ビルドタイムアウト（秒単位）。
          timeout: 1800
    tasks:
      - name: build-push
        context:
          data:
            displayName: image build
            enable: true
            build:
              dockerfile: code/Dockerfile
              # タグに _accelerated を付与してイメージ加速を有効化します。
              image: demo-registry-vpc.cn-hangzhou.aliyuncs.com/pipeline***/demo***:debug_accelerated
              # Container Registry Enterprise Edition インスタンス ID。
              instanceID: cri-xxxx
        taskTemplate: build-image-task
        runAfters: []

コミット ID を用いたイメージタグ付け

1. ビルドステージ：組み込み変数 <% .git.shortCommitId %>（HEAD コミット ID の先頭 7 文字）をイメージタグとして付与します。

      image: registry-vpc.cn-hangzhou.aliyuncs.com/demo/demo-image:<% .git.shortCommitId %>

2. デプロイステージ：環境変数 GIT_COMMIT を、値 <% .git.shortCommitId %> で注入します。

3. s.yaml：環境変数を ${env(GIT_COMMIT)} で参照し、イメージタグを動的に設定します。

組み込み YAML 変数の詳細については、「YAML ファイルによるパイプラインの記述」をご参照ください。

パイプライン YAML

# パイプラインを実行するためにコミットします。
kind: Pipeline
# 一意な命名のためにコミット ID とタイムスタンプを含めます。
name: "p-<% .git.shortCommitId %>-<% .currentTimestampMs %>"
description: 'demo pipeline'
# ラベルはパイプライン検索のフィルター条件として機能します。
# Serverless Application Center は、パイプライン実行のコミット時に他のラベルも追加します。
labels:
  myLabel: my-cicd-example
spec:
  context:
    data:
      appName: <% .appName %>
  templateSpec:
    context:
      data:
        envName: <% .envName %>
        deployFile: s.yaml
    tasks:
      # イメージビルドタスク。
      - name: build-image
        context:
          data:
            displayName: image build
            enable: true
            build:
              dockerfile: code/Dockerfile
              # 現在のコミット SHA をタグとして付与します。
              image: registry-vpc.cn-hangzhou.aliyuncs.com/demo/demo-image:<% .git.shortCommitId %>
        taskTemplate: build-image-task
        runAfters: []
      # デプロイタスク。
      - name: build-and-deploy
        context:
          data:
            displayName: デプロイメント
            enable: true
            # コミット SHA を環境変数として注入します。
            envVars:
              GIT_COMMIT: <% .git.shortCommitId %>
            steps:
              - plugin: "@serverless-cd/checkout"
              - plugin: "@serverless-cd/s-setup"
              - plugin: "@serverless-cd/s-deploy"
        taskTemplate: serverless-runner-task
        runAfters:
          - name: build-push

s.yaml におけるコミットタグの参照

GIT_COMMIT 環境変数を s.yaml で使用し、コンテナイメージタグを動的に設定します。

edition: 3.0.0
name: demo
access: 'default'  # キー別名。

resources:
  function:
    component: fc3
    props:
      region: 'cn-hangzhou'
      functionName: demo
      runtime: custom-container
      customContainerConfig:
        # コミットに基づくイメージタグを動的に参照します。
        image: registry-vpc.cn-hangzhou.aliyuncs.com/demo***/demo-ima***:${env(GIT_COMMIT)}
        port: 9000
      memorySize: 4096
      timeout: 3600