サイドカー

サイドカーは主となるコンテナと共に実行され補助的な役割を担うコンテナのことです。サイドカーの役割はロギングや設定ファイルの取得、リクエストのプロキシ処理などの周辺的なタスクを実行することです。

AWS はまた ECS サービスとシームレスに組み合わせられるいくつかのプラグインを提供しており、FireLens や AWS X-Ray、AWS App Mesh など多岐に渡ります。

Manifest の中で storage フィールドを使って主となるコンテナ用の EFS ボリュームを定義した場合、定義した任意のサイドカーコンテナはそのボリュームをマウントできます。

Copilot でサイドカーを追加するには？

Copilot の Manifest でサイドカーを追加したい場合、サイドカーコンテナを直接定義するあるいはサイドカーパターンを利用する方法があります。

Attention

Request-Driven Web Service はサイドカーの利用をサポートしていません。

サイドカーコンテナを直接定義する

サイドカーコンテナイメージの URL を指定する必要があります。オプションで公開するポートやプライベートレジストリの認証パラメータを指定できます。

sidecars:
  <sidecar name>:
    # 公開するポート (オプション)
    port: <port number>
    # サイドカーコンテナイメージの URL (必須)
    image: <image url>
    # プライベートレジストリの認証情報を保存している秘密情報の ARN (オプション)
    credentialsParameter: <credential>
    # サイドカーコンテナの環境変数 (オプション)
    variables: <env var>
    # サイドカーコンテナで用いる秘密情報 (オプション)
    secrets: <secret>
    # サービスレベルで指定する EFS ボリュームのマウントパス (オプション)
    mount_points:
      - # サイドカーからマウントするときのソースボリューム (必須)
        source_volume: <named volume>
        # サイドカーからボリュームをマウントするときのパス (必須)
        path: <path>
        # サイドカーにボリュームに対する読み込みのみを許可するかどうか (デフォルトでは true)
        read_only: <bool>
    # コンテナに付与する Docker ラベル (オプション)
    labels:
      {label key} : <label value>
    # このコンテナに適用するコンテナの依存関係 (オプション)
    depends_on:
      {container name}: <condition>

port Integer
コンテナの公開するポート番号。(任意項目)

image String
サイドカーコンテナのイメージ URL。(必須項目)

credentialsParameter String
プライベートレジストリの認証情報を保存している秘密情報の ARN。(任意項目)

variables Map
サイドカーコンテナの環境変数。(任意項目)

secrets Map
サイドカーコンテナで用いる秘密情報。(任意項目)

mount_points Array of Maps
サービスレベルで指定する EFS ボリュームのマウントパス。(任意項目)

mount_points.source_volume String
サイドカーからマウントするときのソースボリューム。(必須項目)

mount_points.path String
サイドカーからボリュームをマウントするときのパス。(必須項目)

mount_points.read_only Boolean
サイドカーにボリュームに対する読み込みのみを許可するかどうか。(デフォルトでは true)

labels Map
コンテナに付与する Docker ラベル。(任意項目)

depends_on Map
このコンテナに適用するコンテナの依存関係。(任意項目)

entrypoint String or Array of Strings
サイドカーのデフォルトのエントリポイントをオーバーライドします。

# 文字列で指定する場合
entrypoint: "/bin/entrypoint --p1 --p2"
# 別の方法として、文字列配列の場合
entrypoint: ["/bin/entrypoint", "--p1", "--p2"]

command String or Array of Strings
サイドカーのデフォルトコマンドを上書きします。

# 文字列で指定する場合
command: ps au
# 別の方法として、文字列配列の場合
command: ["ps", "au"]

実行例

以下は Load Balanced Web Service の Manifest で nginx サイドカーコンテナを指定する例です。

name: api
type: Load Balanced Web Service

image:
  build: api/Dockerfile
  port: 3000

http:
  path: 'api'
  healthcheck: '/api/health-check'
  # ロードバランサーのターゲットコンテナは Service のコンテナの代わりにサイドカーの'nginx'を指定しています。
  targetContainer: 'nginx'

cpu: 256
memory: 512
count: 1

sidecars:
  nginx:
    port: 80
    image: 1234567890.dkr.ecr.us-west-2.amazonaws.com/reverse-proxy:revision_1
    variables:
      NGINX_PORT: 80

以下は Service とサイドカーコンテナ両方で EFS ボリュームを用いる Manifest の一部です。

storage:
  volumes:
    myEFSVolume:
      path: '/etc/mount1'
      read_only: false
      efs:
        id: fs-1234567

sidecars:
  nginx:
    port: 80
    image: 1234567890.dkr.ecr.us-west-2.amazonaws.com/reverse-proxy:revision_1
    variables:
      NGINX_PORT: 80
    mount_points:
      - source_volume: myEFSVolume
        path: '/etc/mount1'

サイドカーパターン

サイドカーパターンは Copilot であらかじめ定義されたサイドカーの構成です。現在サポートされているパターンは FireLens だけですが将来的にさらにパターンを追加していく予定です！

logging:
  # Fluent Bitのイメージ (オプション。デフォルトでは "amazon/aws-for-fluent-bit:latest" を使用)
  image: <image URL>
  # Firelens ログドライバーにログを送信するときの設定 (オプション)
  destination:
    <config key>: <config value>
  # ログに ECS メタデータを含むかどうか (オプション。デフォルトでは true )
  enableMetadata: <true|false>
  # ログの設定に渡すシークレット (オプション)
  secretOptions:
    <key>: <value>
  # カスタムの Fluent Bit イメージ内の設定ファイルのフルパス
  configFilePath: <config file path>

例えば以下のように設定できます。

logging:
  destination:
    Name: cloudwatch
    region: us-west-2
    log_group_name: /copilot/sidecar-test-hello
    log_stream_prefix: copilot/

FireLens がログを転送するためにタスクロールに対して必要なアクセス許可を追加で与える必要があるかもしれません。Addon のなかで許可を追加できます。例えば以下のように設定できます。

Resources:
  FireLensPolicy:
    Type: AWS::IAM::ManagedPolicy
    Properties:
      PolicyDocument:
        Version: 2012-10-17
        Statement:
        - Effect: Allow
          Action:
          - logs:CreateLogStream
          - logs:CreateLogGroup
          - logs:DescribeLogStreams
          - logs:PutLogEvents
          Resource: "<resource ARN>"
Outputs:
  FireLensPolicyArn:
    Description: An addon ManagedPolicy gets used by the ECS task role
    Value: !Ref FireLensPolicy

Info

FireLens ログドライバーは主となるコンテナのログを様々な宛先へルーティングできる一方で、 svc logs コマンドは CloudWatch Logs で Copilot Service のために作成したロググループに送信された場合のみログをトラックできます。

Info

この機能をより簡単かつパワフルにする予定です！現時点ではサイドカーはリモートイメージの利用のみをサポートしており、ユーザーはローカルのサイドカーイメージをビルドしてプッシュする必要があります。しかしローカルのイメージや Dockerfile をサポートする予定です。さらに FireLens 自身については主となるコンテナだけでなく他のサイドカーのログもルーティングできるようになる予定です。