diff --git a/site/content/docs/include/envvars.ja.md b/site/content/docs/include/envvars.ja.md index ef39bdb3c80..d6276e9943c 100644 --- a/site/content/docs/include/envvars.ja.md +++ b/site/content/docs/include/envvars.ja.md @@ -2,3 +2,8 @@ `variables` Map Copilot は Service 名などを常に環境変数としてタスクに対して渡します。本フィールドではそれら以外に追加で渡したい環境変数をキーバーリューのペアで指定します。 + +
+ +`env_file` String +ワークスペースのルートから、メインコンテナに引き渡す環境変数を含むファイルへのパスを指定します。環境変数ファイルの詳細については、[環境変数ファイルの指定に関する考慮事項](https://docs.aws.amazon.com/ja_jp/AmazonECS/latest/developerguide/taskdef-envfiles.html#taskdef-envfiles-considerations)を参照してください。 diff --git a/site/content/docs/include/exec.ja.md b/site/content/docs/include/exec.ja.md index 2ef8267d133..94f49085fae 100644 --- a/site/content/docs/include/exec.ja.md +++ b/site/content/docs/include/exec.ja.md @@ -1,4 +1,7 @@
`exec` Boolean -コンテナ内部でのインタラクティブなコマンド実行機能を有効化します。デフォルト値は `false` です。`$ copilot svc exec` コマンドの利用には、この値に `true` を指定しておく必要があります。 \ No newline at end of file +コンテナ内部でのインタラクティブなコマンド実行機能を有効化します。デフォルト値は `false` です。`$ copilot svc exec` コマンドの利用には、この値に `true` を指定しておく必要があります。 + +!!! info + Windows OS 上で動作するコンテナでは、Exec はサポートされていません。 diff --git a/site/content/docs/include/http-config.ja.md b/site/content/docs/include/http-config.ja.md index 95acfc156fb..657fceeccce 100644 --- a/site/content/docs/include/http-config.ja.md +++ b/site/content/docs/include/http-config.ja.md @@ -1,8 +1,11 @@
-`http` Map +`http` Boolean or Map http セクションは Service と Application Load Balancer の連携に関するパラメーターを含みます。 +Application Load Balancer を無効にするには、`http: false` を指定します。Load-Balanced Web Service では、 +Application Load Balancer または Network Load Balancer の少なくともどちらかが有効である必要があることに注意してください。 + http.`path` String このパスに対するリクエストが Service に転送されます。各 [Load Balanced Web Service](../concepts/services.ja.md#load-balanced-web-service) は、ユニークなパスでリッスンする必要があります。 @@ -63,7 +66,7 @@ http: ``` http.`alias` String or Array of Strings -サービスの HTTPS ドメインエイリアス +Service の HTTPS ドメインエイリアス ```yaml # 文字列で指定する場合 http: @@ -72,3 +75,7 @@ http: http: alias: ["example.com", "v1.example.com"] ``` + +http.`version` String +HTTP(S) のプロトコルバージョン。'grpc', 'http1', 'http2' のいずれかである必要があります。省略した場合は、'http1' とみなされます。 +gRPC を使用する場合、Application にドメインが関連付けられなければならないことに注意してください。 diff --git a/site/content/docs/include/image-config.ja.md b/site/content/docs/include/image-config.ja.md index f90262d0eae..5f1b5cd84c6 100644 --- a/site/content/docs/include/image-config.ja.md +++ b/site/content/docs/include/image-config.ja.md @@ -4,6 +4,8 @@ image セクションは、Docker ビルドに関する設定や公開するポートについてのパラメータを含みます。 image.`build` String or Map +オプションの引数で指定した Dockerfile からコンテナを構築します。後述の [`image.location`](#image-location) フィールドとは排他的な使用となります。 + このフィールドに String（文字列）を指定した場合、Copilot はそれを Dockerfile の場所を示すパスと解釈します。その際、指定したパスのディレクトリ部が Docker のビルドコンテキストであると仮定します。以下は build フィールドに文字列を指定する例です。 ```yaml image: @@ -34,8 +36,9 @@ Copilot はあなたの意図を理解するために最善を尽くしますの Dockerfile からコンテナイメージをビルドする代わりに、既存のコンテナイメージ名の指定も可能です。`image.location` と [`image.build`](#image-build) の同時利用はできません。 `location` フィールドの制約を含む指定方法は Amazon ECS タスク定義の [`image` パラメータ](https://docs.aws.amazon.com/ja_jp/AmazonECS/latest/developerguide/task_definition_parameters.html#container_definition_image)のそれに従います。 -!!! note - Windows コンテナイメージを指定する場合、Manifest に`platform: windows/amd64`を指定する必要があります。 +!!! warning + Windows コンテナイメージを指定する場合、Manifest に `platform: windows/amd64` を指定する必要があります。 + ARM アーキテクチャベースのコンテナイメージを指定する場合、Manifest に `platform: linux/arm64` を指定する必要があります。 image.`credentials` String 任意項目です。プライベートリポジトリの認証情報の ARN。`credentials` フィールドは、Amazon ECS タスク定義の [`credentialsParameter`](https://docs.aws.amazon.com/ja_jp/AmazonECS/latest/developerguide/private-auth.html) と同じです。 diff --git a/site/content/docs/include/image-healthcheck.ja.md b/site/content/docs/include/image-healthcheck.ja.md index b88936d13e2..7f3117e5f22 100644 --- a/site/content/docs/include/image-healthcheck.ja.md +++ b/site/content/docs/include/image-healthcheck.ja.md @@ -14,5 +14,5 @@ image.healthcheck.`timeout` Duration ヘルスチェックの実行開始から失敗とみなすまでに待機する秒単位の期間です。デフォルト値は５秒です。 -image.healthcheck.`start_period` Duration +image.healthcheck.`start_period` Duration ヘルスチェックの実行と失敗がリトライ回数としてカウントされ始める前に、コンテナに対して起動処理を済ませる猶予期間の長さです。秒単位で指定し、デフォルトは０秒です。 diff --git a/site/content/docs/include/nlb.ja.md b/site/content/docs/include/nlb.ja.md new file mode 100644 index 00000000000..9225c07a92a --- /dev/null +++ b/site/content/docs/include/nlb.ja.md @@ -0,0 +1,82 @@ +
+ +`nlb` Map +nlb セクションは Service を Network Load Balancer と統合するためのパラメーターを含みます。 + +Network Load Balancerは、`nlb` フィールドを指定した場合のみ有効になります。Load-Balanced Web Service では、Application Load Balancer と Network Load Balancer のいずれかが有効になっている必要があることに注意してください。 + +nlb.`port` String +必須項目。Network Load Balancer がリッスンするポートとプロトコルを指定します。 + +使用可能なプロトコルは `tcp` と `tls` です。プロトコルを指定しない場合、デフォルトで `tcp` が使用されます。 +設定例: +```yaml +nlb: + port: 80 +``` +`tcp` リクエストをポート 80 で待ち受けるようにするためには、以下のように設定します。 +設定例: +```yaml +nlb: + port: 80/tcp +``` + +簡単に TLS 終端を有効にすることができます。 +設定例: +```yaml +nlb: + port: 443/tls +``` + +nlb.`healthcheck` Map +Network Load Balancer のヘルスチェックの設定を指定します。 +```yaml +nlb: + healthcheck: + port: 80 + healthy_threshold: 3 + unhealthy_threshold: 2 + interval: 15s + timeout: 10s +``` + +nlb.healthcheck.`port` String +ヘルスチェックのリクエストが送信されるポート。ヘルスチェックが、コンテナターゲットポートとは異なるポートで実行される必要がある場合に指定します。 + +nlb.healthcheck.`healthy_threshold` Integer +unhealthy なターゲットを healthy とみなすために必要な、連続したヘルスチェックの成功回数を指定します。デフォルト値は 3 で、設定可能な範囲は、2 〜 10 です。 + +nlb.healthcheck.`unhealthy_threshold` Integer +ターゲットが unhealthy であると判断するまでに必要な、連続したヘルスチェックの失敗回数を指定します。デフォルト値は 3 で、設定可能な範囲は、2 〜 10 です。 + +!!! info + この説明を書いている時点では、[ドキュメント](https://docs.aws.amazon.com/ja_jp/elasticloadbalancing/latest/network/target-group-health-checks.html)によると、Network Load Balancer の 'unhealthy threshold' は 'healthy threshold' と同じである必要があるとされています。 + +nlb.healthcheck.`interval` Duration +個々のターゲットへのヘルスチェックを行う際の、おおよその間隔を秒単位で指定します。設定可能な値は 10s (10 秒) または 30s (30 秒) で、デフォルト値は 30s です。 + +nlb.healthcheck.`timeout` Duration +ターゲットからの応答がない場合、ヘルスチェックが失敗したとみなすまでの時間を秒単位で指定します。デフォルト値は 10s (10 秒)です。 + +nlb.`target_container` String +サイドカーコンテナを指定することで、Service のメインコンテナの代わりにサイドカーでロードバランサからのリクエストを受け取れます。 + +nlb.`target_port` Integer +トラフィックを受信するコンテナのポート。コンテナポートがリスナーポートの `nlb.port` と異なる場合、このフィールドを指定します。 + +nlb.`ssl_policy` String +どのようなプロトコルや暗号をサポートするかを定義するセキュリティポリシーです。詳しくは[このドキュメント](https://docs.aws.amazon.com/ja_jp/elasticloadbalancing/latest/network/create-tls-listener.html#describe-ssl-policies)をご覧ください。 + +nlb.`stickiness` Boolean +スティッキーセッションの有効化、あるいは無効化を指定します。 + +nlb.`alias` String or Array of Strings +Service のドメインエイリアス +```yaml +# 文字列で指定する場合 +nlb: + alias: example.com +# 別の方法として、文字列配列の場合 +nlb: + alias: ["example.com", "v1.example.com"] +``` diff --git a/site/content/docs/include/platform.en.md b/site/content/docs/include/platform.en.md index 3c01219669d..100d5227339 100644 --- a/site/content/docs/include/platform.en.md +++ b/site/content/docs/include/platform.en.md @@ -1,6 +1,6 @@
-`platform` String or Map +`platform` String or Map Operating system and architecture (formatted as `[os]/[arch]`) to pass with `docker build --platform`. For example, `linux/arm64` or `windows/x86_64`. The default is `linux/x86_64`. Override the generated string to build with a different valid `osfamily` or `architecture`. For example, Windows users might change the string diff --git a/site/content/docs/include/publish.ja.md b/site/content/docs/include/publish.ja.md index cbb1cdd0822..4570307de6e 100644 --- a/site/content/docs/include/publish.ja.md +++ b/site/content/docs/include/publish.ja.md @@ -6,10 +6,16 @@ ```yaml publish: topics: - - name: order-events + - name: orderEvents ``` -上記の例では、この Manifest は、`order-events` という名前の SNS トピックを定義しています。Copilot の Environment にデプロイされた、他の Worker Service は `order-events` トピックをサブスクライブできます。 +上記の例では、この Manifest は、Copilot の Environment にデプロイされた他の Worker Service がサブスクライブできる `orderEvents` という名前の SNS トピックを定義しています。`COPILOT_SNS_TOPIC_ARNS` という名前の環境変数が、JSON 文字列としてワークロードに設定されます。 + +JavaScriptでは、次のように記述できます。 +```js +const {orderEvents} = JSON.parse(process.env.COPILOT_SNS_TOPIC_ARNS) +``` +詳しくは、[パブリッシュ / サブスクライブ](../developing/publish-subscribe.ja.md)のページをご覧ください。 publish.`topics` Array of topics [`topic`](#publish-topics-topic) オブジェクトのリスト。 diff --git a/site/content/docs/include/secrets.ja.md b/site/content/docs/include/secrets.ja.md index 97d6794e32b..520fdf7b92d 100644 --- a/site/content/docs/include/secrets.ja.md +++ b/site/content/docs/include/secrets.ja.md @@ -1,4 +1,4 @@
`secrets` Map -[AWS Systems Manager (SSM) パラメータストア](https://docs.aws.amazon.com/ja_jp/systems-manager/latest/userguide/systems-manager-parameter-store.html)から取得する秘密情報を、キーに環境変数名、バリューに SSM パラメータ名をペアで指定します。秘密情報はタスク実行時に安全に取得され、環境変数として設定されます。 +[AWS Systems Manager (SSM) パラメータストア](https://docs.aws.amazon.com/ja_jp/systems-manager/latest/userguide/systems-manager-parameter-store.html)または [AWS Secrets Manager](https://docs.aws.amazon.com/ja_jp/secretsmanager/latest/userguide/intro.html)から環境変数として、Service に安全に渡される秘密値を表すキー・値ペアを指定します。 diff --git a/site/content/docs/manifest/backend-service.en.md b/site/content/docs/manifest/backend-service.en.md index 4958a840267..daa00bdb5bf 100644 --- a/site/content/docs/manifest/backend-service.en.md +++ b/site/content/docs/manifest/backend-service.en.md @@ -2,7 +2,7 @@ List of all available properties for a `'Backend Service'` manifest. To learn ab ???+ note "Sample manifest for an api service" - ```yaml +```yaml # Your service name will be used in naming your resources like log groups, ECS services, etc. name: api type: Backend Service @@ -55,7 +55,7 @@ List of all available properties for a `'Backend Service'` manifest. To learn ab spot: 2 production: count: 2 - ``` +``` `name` String The name of your service. diff --git a/site/content/docs/manifest/backend-service.ja.md b/site/content/docs/manifest/backend-service.ja.md index f8d121d0370..27dc23b50c0 100644 --- a/site/content/docs/manifest/backend-service.ja.md +++ b/site/content/docs/manifest/backend-service.ja.md @@ -46,6 +46,7 @@ network: variables: LOG_LEVEL: info +env_file: log.env secrets: GITHUB_TOKEN: GITHUB_TOKEN @@ -90,6 +91,8 @@ Service は、希望するタスク数を 5 に設定し、Service 内に 5 つ count: spot: 5 ``` +!!! info + ARM アーキテクチャで動作するコンテナでは、Fargate Spot はサポートされていません。
diff --git a/site/content/docs/manifest/lb-web-service.en.md b/site/content/docs/manifest/lb-web-service.en.md index 37695beee23..b1fc1bcda76 100644 --- a/site/content/docs/manifest/lb-web-service.en.md +++ b/site/content/docs/manifest/lb-web-service.en.md @@ -2,7 +2,7 @@ List of all available properties for a `'Load Balanced Web Service'` manifest. T ???+ note "Sample manifest for a frontend service" - ```yaml +```yaml # Your service name will be used in naming your resources like log groups, ECS services, etc. name: frontend type: Load Balanced Web Service @@ -62,7 +62,7 @@ List of all available properties for a `'Load Balanced Web Service'` manifest. T spot: 2 production: count: 2 - ``` +``` `name` String The name of your service. diff --git a/site/content/docs/manifest/lb-web-service.ja.md b/site/content/docs/manifest/lb-web-service.ja.md index 5b29cf1f688..c61d1b23ff9 100644 --- a/site/content/docs/manifest/lb-web-service.ja.md +++ b/site/content/docs/manifest/lb-web-service.ja.md @@ -12,6 +12,7 @@ http: path: '/' healthcheck: path: '/_healthcheck' + success_codes: '200,301' healthy_threshold: 3 unhealthy_threshold: 2 interval: 15s @@ -20,6 +21,10 @@ http: deregistration_delay: 5s stickiness: false allowed_source_ips: ["10.24.34.0/23"] + alias: example.com + +nlb: + port: 443/tls # コンテナと Service の構成 image: @@ -40,6 +45,7 @@ exec: true variables: LOG_LEVEL: info +env_file: log.env secrets: GITHUB_TOKEN: GITHUB_TOKEN @@ -68,6 +74,8 @@ Service のアーキテクチャタイプ。 [Load Balanced Web Service](../conc {% include 'http-config.ja.md' %} +{% include 'nlb.ja.md' %} + {% include 'image-config-with-port.ja.md' %} {% include 'image-healthcheck.ja.md' %} @@ -92,6 +100,8 @@ Service は、希望するタスク数を 5 に設定し、Service 内に 5 つ count: spot: 5 ``` +!!! info + ARM アーキテクチャで動作するコンテナでは、Fargate Spot はサポートされていません。
diff --git a/site/content/docs/manifest/pipeline.en.md b/site/content/docs/manifest/pipeline.en.md index d3d3a3ea9c5..f662ba5d34d 100644 --- a/site/content/docs/manifest/pipeline.en.md +++ b/site/content/docs/manifest/pipeline.en.md @@ -2,7 +2,7 @@ List of all available properties for a Copilot pipeline manifest. To learn more ???+ note "Sample manifest for a pipeline triggered from a GitHub repo" - ```yaml +```yaml name: pipeline-sample-app-frontend version: 1 @@ -26,7 +26,7 @@ List of all available properties for a Copilot pipeline manifest. To learn more - name: prod requires_approval: true - ``` +``` `name` String The name of your pipeline. diff --git a/site/content/docs/manifest/pipeline.ja.md b/site/content/docs/manifest/pipeline.ja.md index 85b34b73c5f..199e56a2e2d 100644 --- a/site/content/docs/manifest/pipeline.ja.md +++ b/site/content/docs/manifest/pipeline.ja.md @@ -54,7 +54,7 @@ Pipeline をトリガーするための GitHub アクセストークンを保持 Copilot v1.4.0 から GitHub リポジトリをソースにする場合のアクセストークンは不要になりました。代わりに Copilot は [AWS CodeStar の GitHub への接続](https://docs.aws.amazon.com/ja_jp/codepipeline/latest/userguide/update-github-action-connections.html)を使って Pipeline をトリガーします。 source.properties.`branch` String -Pipeline をトリガーするリポジトリのブランチ名。 GitHub と CodeCommit の場合デフォルトは `main` で Bitbucket の場合デフォルトは `master` です。 +Pipeline をトリガーするリポジトリのブランチ名。 Copilot は、このフィールドに現在のローカルブランチを自動的に入力します。 source.properties.`repository` String リポジトリの URL 。 diff --git a/site/content/docs/manifest/rd-web-service.en.md b/site/content/docs/manifest/rd-web-service.en.md index 3496e6106c6..b5689e968e8 100644 --- a/site/content/docs/manifest/rd-web-service.en.md +++ b/site/content/docs/manifest/rd-web-service.en.md @@ -2,7 +2,7 @@ List of all available properties for a `'Request-Driven Web Service'` manifest. ???+ note "Sample manifest for a frontend service" - ```yaml +```yaml # Your service name will be used in naming your resources like log groups, App Runner services, etc. name: frontend type: Request-Driven Web Service @@ -36,7 +36,7 @@ List of all available properties for a `'Request-Driven Web Service'` manifest. environments: test: LOG_LEVEL: debug - ``` +``` `name` String The name of your service. diff --git a/site/content/docs/manifest/rd-web-service.ja.md b/site/content/docs/manifest/rd-web-service.ja.md index adb64152e35..e1c404718db 100644 --- a/site/content/docs/manifest/rd-web-service.ja.md +++ b/site/content/docs/manifest/rd-web-service.ja.md @@ -2,10 +2,9 @@ ???+ note "frontend Service のサンプル Manifest" - ```yaml +```yaml # Service 名はロググループや App Runner サービスなどのリソースの命名に利用されます。 name: frontend - # 実行する Service の「アーキテクチャ」 type: Request-Driven Web Service http: @@ -21,10 +20,13 @@ image: build: ./frontend/Dockerfile port: 80 - cpu: 1024 memory: 2048 + network: + vpc: + placement: 'private' + variables: LOG_LEVEL: info @@ -35,7 +37,7 @@ test: variables: LOG_LEVEL: debug - ``` +``` `name` String Service の名前。 @@ -138,8 +140,17 @@ Service のインスタンスに割り当てる CPU ユニット数。指定可
-`platform` String -`docker build --platform` で渡すオペレーティングシステムとアーキテクチャ。（`[os]/[arch]` の形式で指定） +`network` Map +`network` セクションには、Environment の VPC 内の AWS リソースに Service を接続するためのパラメータが含まれています。Service を VPC に接続することで、[サービス検出](../developing/service-discovery.ja.md)を使用して Environment 内の他の Service と通信したり、[`storage init`](../commands/storage-init.ja.md)で Amazon Aurora などの VPC 内のデータベースに接続することができます。 + +network.`vpc` Map +Service からの Egress トラフィックをルーティングする VPC 内のサブネットを指定します。 + +network.vpc.`placement` String +この項目において現在有効なオプションは `'private'` のみです。もし、Service が VPC に接続されないことを期待する場合は、`network` セクションを削除してください。 + +この項目が 'private' の場合、App Runner サービスは VPC のプライベートサブネットを経由して Egress トラフィックをルーティングします。 +Copilot で生成された VPC を使用する場合、Copilot はインターネット接続用の NAT Gateway を Environment に自動的に追加します。 ([VPC の料金](https://aws.amazon.com/jp/vpc/pricing/)をご覧ください。) また、`copilot env init` を実行する際に、NAT ゲートウェイを持つ既存の VPC や、分離されたワークロードのための VPC エンドポイントをインポートすることも可能です。詳しくは、[Environment のリソースをカスタマイズする](../developing/custom-environment-resources.ja.md)をご覧ください。
@@ -149,11 +160,16 @@ Service のインスタンスに割り当てる CPU ユニット数。指定可
`variables` Map -Copilot は Service 名などを常に環境変数としてインスタンスに対して渡します。本フィールドではそれら以外に追加で渡したい環境変数をキーバーリューのペアで指定します。 +Copilot は Service 名などを常に環境変数としてインスタンスに対して渡します。本フィールドではそれら以外に追加で渡したい環境変数をキー・値のペアで指定します。 {% include 'publish.ja.md' %}
+`tags` Map +AWS App Runner リソースとして渡される AWS タグを表すキー・値ペアです。 + +
+ `environments` Map `environments` セクションでは、Manifest 内の任意の設定値を Environment ごとにオーバーライドできます。上部記載の Manifest 例では test Environment における `LOG_LEVEL` 環境変数の値をオーバーライドしています。 diff --git a/site/content/docs/manifest/scheduled-job.en.md b/site/content/docs/manifest/scheduled-job.en.md index c02141d99dc..7053e249fc6 100644 --- a/site/content/docs/manifest/scheduled-job.en.md +++ b/site/content/docs/manifest/scheduled-job.en.md @@ -2,7 +2,7 @@ List of all available properties for a `'Scheduled Job'` manifest. To learn abou ???+ note "Sample manifest for a report generator cronjob" - ```yaml +```yaml # Your job name will be used in naming your resources like log groups, ECS Tasks, etc. name: report-generator type: Scheduled Job @@ -29,7 +29,7 @@ List of all available properties for a `'Scheduled Job'` manifest. To learn abou prod: cpu: 2048 # Larger CPU value for prod environment memory: 4096 - ``` +``` `name` String The name of your job. @@ -103,7 +103,7 @@ Amount of memory in MiB used by the task. See the [Amazon ECS docs](https://docs
-`platform` String +`platform` String Operating system and architecture (formatted as `[os]/[arch]`) to pass with `docker build --platform`. For example, `linux/arm64` or `windows/x86_64`. The default is `linux/x86_64`. Override the generated string to build with a different valid `osfamily` or `architecture`. For example, Windows users might change the string diff --git a/site/content/docs/manifest/scheduled-job.ja.md b/site/content/docs/manifest/scheduled-job.ja.md index 3e0bde235e6..8ab9d213bc9 100644 --- a/site/content/docs/manifest/scheduled-job.ja.md +++ b/site/content/docs/manifest/scheduled-job.ja.md @@ -20,6 +20,7 @@ image: variables: LOG_LEVEL: info +env_file: log.env secrets: GITHUB_TOKEN: GITHUB_TOKEN @@ -48,11 +49,15 @@ Job をトリガするイベントの設定。 定期的に Job をトリガする頻度を指定できます。 サポートする頻度は: -* `"@yearly"` -* `"@monthly"` -* `"@weekly"` -* `"@daily"` -* `"@hourly"` + +| 頻度 | 以下と同一 | `UTC` を用いた可読表記による実行タイミング | +| ------------ | --------------------- | --------------------------------------------- | +| `"@yearly"` | `"cron(0 * * * ? *)"` | 1 月 1 日の午前 0 時 | +| `"@monthly"` | `"cron(0 0 1 * ? *)"` | 毎月 1 日の午前 0 時 | +| `"@weekly"` | `"cron(0 0 ? * 1 *)"` | 毎週日曜日の午前 0 時 | +| `"@daily"` | `"cron(0 0 * * ? *)"` | 毎日午前 0 時 | +| `"@hourly"` | `"cron(0 * * * ? *)"` | 毎時 0 分 | + * `"@every {duration}"` (例: "1m", "5m") * `"rate({duration})"` CloudWatch の[rate 式](https://docs.aws.amazon.com/ja_jp/AmazonCloudWatch/latest/events/ScheduledEvents.html#RateExpressions) の形式 @@ -101,7 +106,18 @@ command: ["ps", "au"]
`platform` String -`docker build --platform` で渡すオペレーティングシステムとアーキテクチャ。（`[os]/[arch]` の形式で指定） +`docker build --platform` で渡すオペレーティングシステムとアーキテクチャ。（`[os]/[arch]` の形式で指定） 例えば、`linux/arm64` や `windows/x86_64` といった値です。デフォルトは `linux/x86_64` です。 + +生成された文字列を上書きして、有効な異なる `osfamily` や `architecture` を明示的に指定してビルドすることができます。例えば Windows ユーザーの場合は、 +```yaml +platform: windows/x86_64 +``` +とするとデフォルトは `WINDOWS_SERVER_2019_CORE` が利用されますが、 Map を使って以下のように指定できます： +```yaml +platform: + osfamily: windows_server_2019_full + architecture: x86_64 +```
diff --git a/site/content/docs/manifest/worker-service.en.md b/site/content/docs/manifest/worker-service.en.md index 465625676fd..ee93392720e 100644 --- a/site/content/docs/manifest/worker-service.en.md +++ b/site/content/docs/manifest/worker-service.en.md @@ -2,7 +2,7 @@ List of all available properties for a `'Worker Service'` manifest. To learn abo ???+ note "Sample manifest for a worker service" - ```yaml +```yaml # Your service name will be used in naming your resources like log groups, ECS services, etc. name: orders-worker type: Worker Service @@ -43,7 +43,7 @@ List of all available properties for a `'Worker Service'` manifest. To learn abo queue_delay: acceptable_latency: 1m msg_processing_time: 250ms - ``` +``` `name` String The name of your service. diff --git a/site/content/docs/manifest/worker-service.ja.md b/site/content/docs/manifest/worker-service.ja.md index 0cb1c3aea0b..197cd99740e 100644 --- a/site/content/docs/manifest/worker-service.ja.md +++ b/site/content/docs/manifest/worker-service.ja.md @@ -2,7 +2,7 @@ ???+ note "Worker Service の Manifest のサンプル" - ```yaml +```yaml # Service 名は、ロググループや ECS サービスなどのリソースの命名に使用されます。 name: orders-worker type: Worker Service @@ -28,6 +28,7 @@ variables: LOG_LEVEL: info + env_file: log.env secrets: GITHUB_TOKEN: GITHUB_TOKEN @@ -42,7 +43,7 @@ queue_delay: acceptable_latency: 1m msg_processing_time: 250ms - ``` +``` `name` String Service の名前。 @@ -123,6 +124,8 @@ Service は、希望するタスク数を 5 に設定し、Service 内に 5 つ count: spot: 5 ``` +!!! info + ARM アーキテクチャで動作するコンテナでは、Fargate Spot はサポートされていません。