サービスコンテナ

を追加 containers 設定 YAML の最上位にあるプロパティ。

コンテナの ID を設定します。

設定内で一意である必要があります。ID はステップまたはステップバンドルでコンテナを指すときに使用されます

containers:
  postgres:

コンテナに必要なプロパティを設定します。それらは以下のとおりです。

containers:
  postgres:
    type: service
    image: postgres:16

オプションで、でポートマッピングを設定します [HostPort01]:[ContainerPort01] フォーマット。

ポートパブリッシングとポートマッピングの詳細については、 Docker の公式ドキュメント。

containers:
  postgres:
    type: service
    image: postgres:16
    ports: 
    - 5432:5432

オプションで、Docker 認証情報を設定します。

認証情報は docker login コマンドに使用されます。以下を設定できます。

containers:
  postgres:
    type: service
    image: postgres:16
    credentials:
      username: $DOCKER_USERNAME
      password: $DOCKER_PASSWORD
      server: us-central1-docker.pkg.dev

オプションで、 options 追加の Docker コンテナリソースオプションを設定するためのプロパティ:に渡されるパラメータ docker container create コマンド。

この例では、サービスは次のように構成されています ヘルスチェック。

containers:
  postgres
    type: service
    image: postgres:16
    options: >-
      --health-cmd pg_isready
      --health-interval 10s
      --health-timeout 5s
      --health-retries 5

使用可能なすべてのオプションのリストについては、 Docker ドキュメンテーション。

を追加 service_containers 必要なステップまたはステップバンドルのプロパティとコンテナ名。YAML 配列構文を使用して複数のサービスコンテナを追加できます

サービスコンテナをステップに追加:

workflows:
  ci:
    steps:
    - git-clone: {}
    - script:
        service_containers:
        - postgres
        - redis

サービスコンテナを Step バンドルに追加します。

workflows:
  ci:
    steps:
    - git-clone: {}
    - script: {}
    - bundle::test-bundle-id:
        service_containers:
        - postgres
        - redis

サービスコンテナはすでに実行されているが、コンテナのクリーンインスタンスでサービスを実行したい場合は、次のように設定します。 recreate プロパティへ true 。

デフォルトでは、Step または Step バンドルは、すでに実行中のコンテナがあればそれを使用します。プロパティを使用してデフォルトの動作を変更してください。

workflows:
  ci:
    steps:
    - git-clone: {}
    - script:
        service_containers:
        - postgres
    - bundle::test-bundle-id:
        service_containers:
        - postgres
            recreate: true
        - redis