From 15c5a99f51eed46c7f3e67b7331140082a74bf50 Mon Sep 17 00:00:00 2001 From: shingos Date: Tue, 8 Mar 2022 07:42:55 +0900 Subject: [PATCH 01/38] docs(ja): periodic update (v1.15) --- site/content/docs/include/envvars.ja.md | 5 +++++ 1 file changed, 5 insertions(+) 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)を参照してください。 From 14051bee529c82c9010f04eaf0bbce5b3e7b79c9 Mon Sep 17 00:00:00 2001 From: shingos Date: Tue, 8 Mar 2022 07:51:58 +0900 Subject: [PATCH 02/38] docs(ja): periodic update --- site/content/docs/include/envvars.ja.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/site/content/docs/include/envvars.ja.md b/site/content/docs/include/envvars.ja.md index d6276e9943c..770e04d44e1 100644 --- a/site/content/docs/include/envvars.ja.md +++ b/site/content/docs/include/envvars.ja.md @@ -1,9 +1,9 @@
-`variables` Map +`variables` Map Copilot は Service 名などを常に環境変数としてタスクに対して渡します。本フィールドではそれら以外に追加で渡したい環境変数をキーバーリューのペアで指定します。
-`env_file` String +`env_file` String ワークスペースのルートから、メインコンテナに引き渡す環境変数を含むファイルへのパスを指定します。環境変数ファイルの詳細については、[環境変数ファイルの指定に関する考慮事項](https://docs.aws.amazon.com/ja_jp/AmazonECS/latest/developerguide/taskdef-envfiles.html#taskdef-envfiles-considerations)を参照してください。 From 09be87b92fa78a67ae4b1ef257325496d28b541e Mon Sep 17 00:00:00 2001 From: shingos Date: Tue, 8 Mar 2022 09:09:24 +0900 Subject: [PATCH 03/38] docs(ja): periodic update --- site/content/docs/include/exec.ja.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) 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 はサポートされていません。 From b757e92c31d8634adaac0ca94763a538ff27ea9a Mon Sep 17 00:00:00 2001 From: shingos Date: Tue, 8 Mar 2022 09:19:36 +0900 Subject: [PATCH 04/38] docs(ja): periodic update --- site/content/docs/include/http-config.ja.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/site/content/docs/include/http-config.ja.md b/site/content/docs/include/http-config.ja.md index 95acfc156fb..5781602ed4e 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) は、ユニークなパスでリッスンする必要があります。 @@ -72,3 +75,7 @@ http: http: alias: ["example.com", "v1.example.com"] ``` + +http.`version` String +HTTP(S) のプロトコルバージョン。'grpc', 'http1', 'http2' のいずれかである必要があります。省略された場合は、'http1' とみなされます。 +gRPC を使用する場合、Application にドメインが関連付けられなければならないことに注意してください。 From 411cb3607d361ae7b62f7703e2fe4e96911032dc Mon Sep 17 00:00:00 2001 From: shingos Date: Wed, 9 Mar 2022 14:05:58 +0900 Subject: [PATCH 05/38] docs(ja): periodic update --- site/content/docs/include/http-config.ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/content/docs/include/http-config.ja.md b/site/content/docs/include/http-config.ja.md index 5781602ed4e..34c41029e92 100644 --- a/site/content/docs/include/http-config.ja.md +++ b/site/content/docs/include/http-config.ja.md @@ -77,5 +77,5 @@ http: ``` http.`version` String -HTTP(S) のプロトコルバージョン。'grpc', 'http1', 'http2' のいずれかである必要があります。省略された場合は、'http1' とみなされます。 +HTTP(S) のプロトコルバージョン。'grpc', 'http1', 'http2' のいずれかである必要があります。省略した場合は、'http1' とみなされます。 gRPC を使用する場合、Application にドメインが関連付けられなければならないことに注意してください。 From b803706fb7b43fb324d5bcd13d96323768ec8e77 Mon Sep 17 00:00:00 2001 From: shingos Date: Wed, 9 Mar 2022 14:17:05 +0900 Subject: [PATCH 06/38] docs(ja): periodic update --- site/content/docs/include/image-config.ja.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) 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) と同じです。 From 0b02e47750eeeff9dc3cddae797f193dbf437616 Mon Sep 17 00:00:00 2001 From: shingos Date: Wed, 9 Mar 2022 14:19:22 +0900 Subject: [PATCH 07/38] docs(ja): periodic update --- site/content/docs/include/image-healthcheck.ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 ヘルスチェックの実行と失敗がリトライ回数としてカウントされ始める前に、コンテナに対して起動処理を済ませる猶予期間の長さです。秒単位で指定し、デフォルトは０秒です。 From 081761588c70126e92367d3db3fa8fcb0c269eaf Mon Sep 17 00:00:00 2001 From: shingos Date: Wed, 9 Mar 2022 14:21:07 +0900 Subject: [PATCH 08/38] docs(ja): periodic update --- site/content/docs/include/envvars.ja.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/site/content/docs/include/envvars.ja.md b/site/content/docs/include/envvars.ja.md index 770e04d44e1..d6276e9943c 100644 --- a/site/content/docs/include/envvars.ja.md +++ b/site/content/docs/include/envvars.ja.md @@ -1,9 +1,9 @@
-`variables` Map +`variables` Map Copilot は Service 名などを常に環境変数としてタスクに対して渡します。本フィールドではそれら以外に追加で渡したい環境変数をキーバーリューのペアで指定します。
-`env_file` String +`env_file` String ワークスペースのルートから、メインコンテナに引き渡す環境変数を含むファイルへのパスを指定します。環境変数ファイルの詳細については、[環境変数ファイルの指定に関する考慮事項](https://docs.aws.amazon.com/ja_jp/AmazonECS/latest/developerguide/taskdef-envfiles.html#taskdef-envfiles-considerations)を参照してください。 From 367615dcaac0bdea6808053d114fb061cb825724 Mon Sep 17 00:00:00 2001 From: shingos Date: Wed, 9 Mar 2022 15:05:07 +0900 Subject: [PATCH 09/38] docs(ja): periodic update --- site/content/docs/include/nlb.ja.md | 82 +++++++++++++++++++++++++++++ 1 file changed, 82 insertions(+) create mode 100644 site/content/docs/include/nlb.ja.md diff --git a/site/content/docs/include/nlb.ja.md b/site/content/docs/include/nlb.ja.md new file mode 100644 index 00000000000..145401c359a --- /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 で、設定可能な範囲は、２ 〜 １0 です。 + +nlb.healthcheck.`unhealthy_threshold` Integer +ターゲットが unhealthy であると判断するまでに必要な、連続したヘルスチェックの失敗回数を指定します。デフォルト値は 3 で、設定可能な範囲は、２ 〜 １0 です。 + +!!! 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 +個々のターゲットへのヘルスチェックを行う際の、おおよその間隔を秒単位で指定します。設定可能な値は 10 秒 (10s) または 30 秒 (30s) で、デフォルト値は 30 秒 (30s) です。 + +nlb.healthcheck.`timeout` Duration +ターゲットからの応答がない場合、ヘルスチェックが失敗したとみなすまでの時間を秒単位で指定します。デフォルト値は 10 秒 (10s) です。 + +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 +# String version. +nlb: + alias: example.com +# Alteratively, as an array of strings. +nlb: + alias: ["example.com", "v1.example.com"] +``` From e7f16a218eb02c818e289cef99bdb2150d50c7fc Mon Sep 17 00:00:00 2001 From: shingos Date: Wed, 9 Mar 2022 15:07:29 +0900 Subject: [PATCH 10/38] docs(ja): periodic update --- site/content/docs/include/nlb.ja.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/site/content/docs/include/nlb.ja.md b/site/content/docs/include/nlb.ja.md index 145401c359a..7239a53d979 100644 --- a/site/content/docs/include/nlb.ja.md +++ b/site/content/docs/include/nlb.ja.md @@ -73,10 +73,10 @@ unhealthy なターゲットを healthy とみなすために必要な、連続 nlb.`alias` String or Array of Strings Service のドメインエイリアス ```yaml -# String version. +# 文字列で指定する場合 nlb: alias: example.com -# Alteratively, as an array of strings. +# 別の方法として、文字列配列の場合 nlb: alias: ["example.com", "v1.example.com"] ``` From a9afed7e857ed47fdbb1f83637b5b5bccefa20ce Mon Sep 17 00:00:00 2001 From: shingos Date: Wed, 9 Mar 2022 15:08:21 +0900 Subject: [PATCH 11/38] docs(ja): periodic update --- site/content/docs/include/nlb.ja.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/site/content/docs/include/nlb.ja.md b/site/content/docs/include/nlb.ja.md index 7239a53d979..c1b9fd9ed88 100644 --- a/site/content/docs/include/nlb.ja.md +++ b/site/content/docs/include/nlb.ja.md @@ -44,10 +44,10 @@ nlb: ヘルスチェックのリクエストが送信されるポート。ヘルスチェックが、コンテナターゲットポートとは異なるポートで実行される必要がある場合に指定します。 nlb.healthcheck.`healthy_threshold` Integer -unhealthy なターゲットを healthy とみなすために必要な、連続したヘルスチェックの成功回数を指定します。デフォルト値は 3 で、設定可能な範囲は、２ 〜 １0 です。 +unhealthy なターゲットを healthy とみなすために必要な、連続したヘルスチェックの成功回数を指定します。デフォルト値は 3 で、設定可能な範囲は、2 〜 １0 です。 nlb.healthcheck.`unhealthy_threshold` Integer -ターゲットが unhealthy であると判断するまでに必要な、連続したヘルスチェックの失敗回数を指定します。デフォルト値は 3 で、設定可能な範囲は、２ 〜 １0 です。 +ターゲットが unhealthy であると判断するまでに必要な、連続したヘルスチェックの失敗回数を指定します。デフォルト値は 3 で、設定可能な範囲は、2 〜 １0 です。 !!! info この説明を書いている時点では、[ドキュメント](https://docs.aws.amazon.com/ja_jp/elasticloadbalancing/latest/network/target-group-health-checks.html)によると、Network Load Balancer の 'unhealthy threshold' は 'healthy threshold' と同じである必要があるとされています。 From 92138161e3c2a451429d9070680eaf007b2f84f8 Mon Sep 17 00:00:00 2001 From: shingos Date: Wed, 9 Mar 2022 15:09:01 +0900 Subject: [PATCH 12/38] docs(ja): periodic update --- site/content/docs/include/nlb.ja.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/site/content/docs/include/nlb.ja.md b/site/content/docs/include/nlb.ja.md index c1b9fd9ed88..72f65df8d11 100644 --- a/site/content/docs/include/nlb.ja.md +++ b/site/content/docs/include/nlb.ja.md @@ -44,10 +44,10 @@ nlb: ヘルスチェックのリクエストが送信されるポート。ヘルスチェックが、コンテナターゲットポートとは異なるポートで実行される必要がある場合に指定します。 nlb.healthcheck.`healthy_threshold` Integer -unhealthy なターゲットを healthy とみなすために必要な、連続したヘルスチェックの成功回数を指定します。デフォルト値は 3 で、設定可能な範囲は、2 〜 １0 です。 +unhealthy なターゲットを healthy とみなすために必要な、連続したヘルスチェックの成功回数を指定します。デフォルト値は 3 で、設定可能な範囲は、2 〜 10 です。 nlb.healthcheck.`unhealthy_threshold` Integer -ターゲットが unhealthy であると判断するまでに必要な、連続したヘルスチェックの失敗回数を指定します。デフォルト値は 3 で、設定可能な範囲は、2 〜 １0 です。 +ターゲットが 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' と同じである必要があるとされています。 From 72f8b13f5dde152432a1fc7a2411ccddac935173 Mon Sep 17 00:00:00 2001 From: shingos Date: Wed, 9 Mar 2022 15:18:43 +0900 Subject: [PATCH 13/38] docs(ja): periodic update --- site/content/docs/include/http-config.ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/content/docs/include/http-config.ja.md b/site/content/docs/include/http-config.ja.md index 34c41029e92..657fceeccce 100644 --- a/site/content/docs/include/http-config.ja.md +++ b/site/content/docs/include/http-config.ja.md @@ -66,7 +66,7 @@ http: ``` http.`alias` String or Array of Strings -サービスの HTTPS ドメインエイリアス +Service の HTTPS ドメインエイリアス ```yaml # 文字列で指定する場合 http: From 9c45104b51ea59f268050acc85472e5b07a9cb4e Mon Sep 17 00:00:00 2001 From: shingos Date: Wed, 9 Mar 2022 15:21:30 +0900 Subject: [PATCH 14/38] docs(ja): periodic update Adding white spaces for line breaks --- site/content/docs/include/platform.en.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 From 51a4303aa787da15240e60c46eed352fe198102e Mon Sep 17 00:00:00 2001 From: shingos Date: Wed, 9 Mar 2022 15:40:57 +0900 Subject: [PATCH 15/38] docs(ja): periodic update --- site/content/docs/include/publish.ja.md | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/site/content/docs/include/publish.ja.md b/site/content/docs/include/publish.ja.md index cbb1cdd0822..7c1f6676b67 100644 --- a/site/content/docs/include/publish.ja.md +++ b/site/content/docs/include/publish.ja.md @@ -6,10 +6,18 @@ ```yaml publish: topics: - - name: order-events + - name: orderEvents ``` -上記の例では、この Manifest は、`order-events` という名前の SNS トピックを定義しています。Copilot の Environment にデプロイされた、他の Worker Service は `order-events` トピックをサブスクライブできます。 +上記の例では、この Manifest は、`orderEvents` という名前の 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) +``` +For more details, see the [pub/sub](../developing/publish-subscribe.en.md) page. +詳しくは、[パブリッシュ / サブスクライブ](../developing/publish-subscribe.ja.md)のページをご覧ください。 publish.`topics` Array of topics [`topic`](#publish-topics-topic) オブジェクトのリスト。 From c20bfd1e588f8ad19c9e99f8f50d80a90455a8ff Mon Sep 17 00:00:00 2001 From: shingos Date: Wed, 9 Mar 2022 15:42:10 +0900 Subject: [PATCH 16/38] docs(ja): periodic update --- site/content/docs/include/publish.ja.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/site/content/docs/include/publish.ja.md b/site/content/docs/include/publish.ja.md index 7c1f6676b67..4570307de6e 100644 --- a/site/content/docs/include/publish.ja.md +++ b/site/content/docs/include/publish.ja.md @@ -9,14 +9,12 @@ publish: - name: orderEvents ``` -上記の例では、この Manifest は、`orderEvents` という名前の SNS トピックを定義しています。Copilot の Environment にデプロイされた、他の Worker Service は `order-events` トピックをサブスクライブできます。 -上記の例では、この Manifest は、Copilot の Environment にデプロイされた他の Worker Service がサブスクライブできる `orderEvents` という名前の SNS トピックを定義しています。`COPILOT_SNS_TOPIC_ARNS` という名前の環境変数が、JSON 文字列としてワークロードに設定されます。 +上記の例では、この Manifest は、Copilot の Environment にデプロイされた他の Worker Service がサブスクライブできる `orderEvents` という名前の SNS トピックを定義しています。`COPILOT_SNS_TOPIC_ARNS` という名前の環境変数が、JSON 文字列としてワークロードに設定されます。 -JavaScriptでは、次のように記述できます： +JavaScriptでは、次のように記述できます。 ```js const {orderEvents} = JSON.parse(process.env.COPILOT_SNS_TOPIC_ARNS) ``` -For more details, see the [pub/sub](../developing/publish-subscribe.en.md) page. 詳しくは、[パブリッシュ / サブスクライブ](../developing/publish-subscribe.ja.md)のページをご覧ください。 publish.`topics` Array of topics From 8c07ab281553a0b6660684ae50dfd7f606ce4ef3 Mon Sep 17 00:00:00 2001 From: shingos Date: Wed, 9 Mar 2022 16:01:03 +0900 Subject: [PATCH 17/38] docs(ja): periodic update --- site/content/docs/include/secrets.ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 に安全に渡される秘密値を表すキー・値ペアを指定します。 From fe12e48fb4ef87087dc8898cdd3c424c5f02093c Mon Sep 17 00:00:00 2001 From: shingos Date: Thu, 10 Mar 2022 14:44:29 +0900 Subject: [PATCH 18/38] docs(ja): periodic update --- site/content/docs/manifest/backend-service.ja.md | 3 +++ 1 file changed, 3 insertions(+) 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 はサポートされていません。
From f365e8cd3e63e2c1cd03606456fd7fcacd7c4965 Mon Sep 17 00:00:00 2001 From: shingos Date: Thu, 10 Mar 2022 14:54:15 +0900 Subject: [PATCH 19/38] docs(ja): periodic update --- site/content/docs/manifest/lb-web-service.ja.md | 10 ++++++++++ 1 file changed, 10 insertions(+) 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 はサポートされていません。
From 8e88c8388d38d9f9c97f6c12f5e072cffe3bdfda Mon Sep 17 00:00:00 2001 From: shingos Date: Thu, 10 Mar 2022 15:02:43 +0900 Subject: [PATCH 20/38] docs(ja): periodic update Corrected a flaw in the code block marker. --- site/content/docs/manifest/pipeline.en.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) 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. From 1d20a609c49d98b6fcd197452f2e13d53d4ed009 Mon Sep 17 00:00:00 2001 From: shingos Date: Thu, 10 Mar 2022 15:02:45 +0900 Subject: [PATCH 21/38] docs(ja): periodic update Corrected a flaw in the code block marker. --- site/content/docs/manifest/lb-web-service.en.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) 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. From c9859b6fbeffa58c1ce7f45f803962b9a0944c23 Mon Sep 17 00:00:00 2001 From: shingos Date: Thu, 10 Mar 2022 15:02:48 +0900 Subject: [PATCH 22/38] docs(ja): periodic update Corrected a flaw in the code block marker. --- site/content/docs/manifest/backend-service.en.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) 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. From ad9e3d2d14973c4923672db55ab82760e9b06ec5 Mon Sep 17 00:00:00 2001 From: shingos Date: Thu, 10 Mar 2022 15:02:52 +0900 Subject: [PATCH 23/38] docs(ja): periodic update --- site/content/docs/manifest/pipeline.ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 。 From 76f803c8076400c336eb9503833a64577775c2e7 Mon Sep 17 00:00:00 2001 From: shingos Date: Thu, 10 Mar 2022 15:13:14 +0900 Subject: [PATCH 24/38] docs(ja): periodic update Corrected a flaw in the code block marker. --- site/content/docs/manifest/rd-web-service.en.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) 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. From 254b57e3c1b89290e30d03d77ba386eb45acacd8 Mon Sep 17 00:00:00 2001 From: shingos Date: Fri, 11 Mar 2022 10:14:10 +0900 Subject: [PATCH 25/38] docs(ja): periodic update --- .../docs/manifest/rd-web-service.ja.md | 30 ++++++++++++++----- 1 file changed, 23 insertions(+), 7 deletions(-) diff --git a/site/content/docs/manifest/rd-web-service.ja.md b/site/content/docs/manifest/rd-web-service.ja.md index adb64152e35..fba894af240 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 を VPC に接続することで、[サービス検出](../commands/storage-init.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 や、分離されたワークロードのための VP Cエンドポイントをインポートすることも可能です。詳しくは、[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` 環境変数の値をオーバーライドしています。 From 7352dd73ca38c3f13fb2a85088184df96ad3127b Mon Sep 17 00:00:00 2001 From: shingos Date: Fri, 11 Mar 2022 10:15:19 +0900 Subject: [PATCH 26/38] docs(ja): periodic update Corrected a flaw in the code block marker. --- site/content/docs/manifest/scheduled-job.en.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/site/content/docs/manifest/scheduled-job.en.md b/site/content/docs/manifest/scheduled-job.en.md index c02141d99dc..a3ccae38170 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. From be9bd52f6bc8143576c2b56b6f986a2086672839 Mon Sep 17 00:00:00 2001 From: shingos Date: Fri, 11 Mar 2022 10:28:07 +0900 Subject: [PATCH 27/38] docs(ja): periodic update Adding white spaces for line breaks --- site/content/docs/manifest/scheduled-job.en.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/content/docs/manifest/scheduled-job.en.md b/site/content/docs/manifest/scheduled-job.en.md index a3ccae38170..7053e249fc6 100644 --- a/site/content/docs/manifest/scheduled-job.en.md +++ b/site/content/docs/manifest/scheduled-job.en.md @@ -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 From acfc32057dc9247c00c230d9cd83dc3061a08efa Mon Sep 17 00:00:00 2001 From: shingos Date: Fri, 11 Mar 2022 10:42:43 +0900 Subject: [PATCH 28/38] docs(ja): periodic update --- .../content/docs/manifest/scheduled-job.ja.md | 28 +++++++++++++++---- 1 file changed, 22 insertions(+), 6 deletions(-) diff --git a/site/content/docs/manifest/scheduled-job.ja.md b/site/content/docs/manifest/scheduled-job.ja.md index 3e0bde235e6..99738909488 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` ですが、以下のような値を使用できます： +```yaml +platform: + osfamily: windows_server_2019_full + architecture: x86_64 +```
From 851b30babaab69db8671ad0734eb37b66ac054da Mon Sep 17 00:00:00 2001 From: shingos Date: Fri, 11 Mar 2022 10:43:18 +0900 Subject: [PATCH 29/38] docs(ja): periodic update --- site/content/docs/manifest/scheduled-job.ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/content/docs/manifest/scheduled-job.ja.md b/site/content/docs/manifest/scheduled-job.ja.md index 99738909488..e1b99155248 100644 --- a/site/content/docs/manifest/scheduled-job.ja.md +++ b/site/content/docs/manifest/scheduled-job.ja.md @@ -50,7 +50,7 @@ Job をトリガするイベントの設定。 サポートする頻度は: -| 頻度 | 以下と同一 | 実行タイミングを `UTC` を用いた可読表記すると | +| 頻度 | 以下と同一 | 実行タイミングを `UTC` を用いた可読表記 | | ------------ | --------------------- | --------------------------------------------- | | `"@yearly"` | `"cron(0 * * * ? *)"` | 1 月 1 日の午前 0 時 | | `"@monthly"` | `"cron(0 0 1 * ? *)"` | 毎月 1 日の午前 0 時 | From 4e4c4e1c2df233ffec1ff93dd52fa68ed5eb1bdb Mon Sep 17 00:00:00 2001 From: shingos Date: Fri, 11 Mar 2022 10:44:01 +0900 Subject: [PATCH 30/38] docs(ja): periodic update --- site/content/docs/manifest/scheduled-job.ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/content/docs/manifest/scheduled-job.ja.md b/site/content/docs/manifest/scheduled-job.ja.md index e1b99155248..730d402b501 100644 --- a/site/content/docs/manifest/scheduled-job.ja.md +++ b/site/content/docs/manifest/scheduled-job.ja.md @@ -50,7 +50,7 @@ Job をトリガするイベントの設定。 サポートする頻度は: -| 頻度 | 以下と同一 | 実行タイミングを `UTC` を用いた可読表記 | +| 頻度 | 以下と同一 | `UTC` を用いた可読表記による実行タイミング | | ------------ | --------------------- | --------------------------------------------- | | `"@yearly"` | `"cron(0 * * * ? *)"` | 1 月 1 日の午前 0 時 | | `"@monthly"` | `"cron(0 0 1 * ? *)"` | 毎月 1 日の午前 0 時 | From 7564ada0b0b4dd60bc5fa43357be64fe0c4f9342 Mon Sep 17 00:00:00 2001 From: shingos Date: Fri, 11 Mar 2022 10:45:16 +0900 Subject: [PATCH 31/38] docs(ja): periodic update Adding white spaces for line breaks --- site/content/docs/manifest/worker-service.en.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) 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. From c1a78d90ecdfe4cd00e1bd9236e55e8dbb6714ad Mon Sep 17 00:00:00 2001 From: shingos Date: Fri, 11 Mar 2022 10:47:40 +0900 Subject: [PATCH 32/38] docs(ja): periodic update --- site/content/docs/manifest/worker-service.ja.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) 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 はサポートされていません。
From 700b135d7cba518f631c30b2b9e867178e6c6d5b Mon Sep 17 00:00:00 2001 From: shingos Date: Fri, 11 Mar 2022 10:51:36 +0900 Subject: [PATCH 33/38] docs(ja): periodic update --- site/content/docs/manifest/scheduled-job.ja.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/site/content/docs/manifest/scheduled-job.ja.md b/site/content/docs/manifest/scheduled-job.ja.md index 730d402b501..8ab9d213bc9 100644 --- a/site/content/docs/manifest/scheduled-job.ja.md +++ b/site/content/docs/manifest/scheduled-job.ja.md @@ -108,11 +108,11 @@ command: ["ps", "au"] `platform` String `docker build --platform` で渡すオペレーティングシステムとアーキテクチャ。（`[os]/[arch]` の形式で指定） 例えば、`linux/arm64` や `windows/x86_64` といった値です。デフォルトは `linux/x86_64` です。 -生成された文字列を上書きして、有効な異なる `osfamily` や `architecture` を指定してビルドすることができます。例えば Windows ユーザーの場合は、 +生成された文字列を上書きして、有効な異なる `osfamily` や `architecture` を明示的に指定してビルドすることができます。例えば Windows ユーザーの場合は、 ```yaml platform: windows/x86_64 ``` -とするとデフォルトは `WINDOWS_SERVER_2019_CORE` ですが、以下のような値を使用できます： +とするとデフォルトは `WINDOWS_SERVER_2019_CORE` が利用されますが、 Map を使って以下のように指定できます： ```yaml platform: osfamily: windows_server_2019_full From bf0d70514d4e491f1b768c2035871a19a3c724b4 Mon Sep 17 00:00:00 2001 From: shingos Date: Tue, 15 Mar 2022 14:03:36 +0900 Subject: [PATCH 34/38] docs(ja): periodic update --- site/content/docs/include/nlb.ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/content/docs/include/nlb.ja.md b/site/content/docs/include/nlb.ja.md index 72f65df8d11..72a431bb1d4 100644 --- a/site/content/docs/include/nlb.ja.md +++ b/site/content/docs/include/nlb.ja.md @@ -1,7 +1,7 @@
`nlb` Map -nlbセクションには、Service を Network Load Balancer と統合するためのパラメータが含まれています。 +nlb セクションは Service を Network Load Balancer と統合するためのパラメーターを含みます。 Network Load Balancerは、`nlb` フィールドを指定した場合のみ有効になります。Load-Balanced Web Service では、Application Load Balancer と Network Load Balancer のいずれかが有効になっている必要があることに注意してください。 From 8c1f670cf3f49d92bec2ee94d745a0df768b527c Mon Sep 17 00:00:00 2001 From: shingos Date: Tue, 15 Mar 2022 14:08:19 +0900 Subject: [PATCH 35/38] docs(ja): periodic update --- site/content/docs/include/nlb.ja.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/site/content/docs/include/nlb.ja.md b/site/content/docs/include/nlb.ja.md index 72a431bb1d4..9225c07a92a 100644 --- a/site/content/docs/include/nlb.ja.md +++ b/site/content/docs/include/nlb.ja.md @@ -53,10 +53,10 @@ unhealthy なターゲットを healthy とみなすために必要な、連続 この説明を書いている時点では、[ドキュメント](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 -個々のターゲットへのヘルスチェックを行う際の、おおよその間隔を秒単位で指定します。設定可能な値は 10 秒 (10s) または 30 秒 (30s) で、デフォルト値は 30 秒 (30s) です。 +個々のターゲットへのヘルスチェックを行う際の、おおよその間隔を秒単位で指定します。設定可能な値は 10s (10 秒) または 30s (30 秒) で、デフォルト値は 30s です。 nlb.healthcheck.`timeout` Duration -ターゲットからの応答がない場合、ヘルスチェックが失敗したとみなすまでの時間を秒単位で指定します。デフォルト値は 10 秒 (10s) です。 +ターゲットからの応答がない場合、ヘルスチェックが失敗したとみなすまでの時間を秒単位で指定します。デフォルト値は 10s (10 秒)です。 nlb.`target_container` String サイドカーコンテナを指定することで、Service のメインコンテナの代わりにサイドカーでロードバランサからのリクエストを受け取れます。 From d9494500f152fd7a8c1576ad2aedb410f7968af1 Mon Sep 17 00:00:00 2001 From: shingos Date: Tue, 15 Mar 2022 14:14:30 +0900 Subject: [PATCH 36/38] docs(ja): periodic update --- site/content/docs/manifest/rd-web-service.ja.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/site/content/docs/manifest/rd-web-service.ja.md b/site/content/docs/manifest/rd-web-service.ja.md index fba894af240..28335a6acd8 100644 --- a/site/content/docs/manifest/rd-web-service.ja.md +++ b/site/content/docs/manifest/rd-web-service.ja.md @@ -141,7 +141,7 @@ Service のインスタンスに割り当てる CPU ユニット数。指定可
`network` Map -`network` セクションには、Environment の VPC 内の AWS リソースにサービスを接続するためのパラメータが含まれています。Service を VPC に接続することで、[サービス検出](../commands/storage-init.ja.md)を使用して Environment 内の他の Service と通信したり、[`storage init`](../commands/storage-init.ja.md)で Amazon Aurora などの VPC 内のデータベースに接続することができます。 +`network` セクションには、Environment の VPC 内の AWS リソースにサービスを接続するためのパラメータが含まれています。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 内のサブネットを指定します。 @@ -150,7 +150,7 @@ Service からの Egress トラフィックをルーティングする VPC 内 この項目において現在有効なオプションは `'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 や、分離されたワークロードのための VP Cエンドポイントをインポートすることも可能です。詳しくは、[Environment のリソースをカスタマイズする](../developing/custom-environment-resources.ja.md)をご覧ください。 +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)をご覧ください。
From f693cd91da7dd44b1f84d4a12e414b8d0ba782f5 Mon Sep 17 00:00:00 2001 From: shingos Date: Tue, 15 Mar 2022 20:21:13 +0900 Subject: [PATCH 37/38] docs(ja): periodic update --- site/content/docs/manifest/rd-web-service.ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/content/docs/manifest/rd-web-service.ja.md b/site/content/docs/manifest/rd-web-service.ja.md index 28335a6acd8..41f1c5a8e3e 100644 --- a/site/content/docs/manifest/rd-web-service.ja.md +++ b/site/content/docs/manifest/rd-web-service.ja.md @@ -149,7 +149,7 @@ Service からの Egress トラフィックをルーティングする VPC 内 network.vpc.`placement` String この項目において現在有効なオプションは `'private'` のみです。もし、Service が VPC に接続されないことを期待する場合は、`network` セクションを削除してください。 -この項目が 'private' の場合、App Runner サービスは VPC のプライベートサブネットを経由して egress トラフィックをルーティングします。 +この項目が '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)をご覧ください。
From cfdf38f6eaa57b58c4c6199d6f2130120b1757b4 Mon Sep 17 00:00:00 2001 From: shingos Date: Tue, 15 Mar 2022 20:25:48 +0900 Subject: [PATCH 38/38] docs(ja): periodic update --- site/content/docs/manifest/rd-web-service.ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/content/docs/manifest/rd-web-service.ja.md b/site/content/docs/manifest/rd-web-service.ja.md index 41f1c5a8e3e..e1c404718db 100644 --- a/site/content/docs/manifest/rd-web-service.ja.md +++ b/site/content/docs/manifest/rd-web-service.ja.md @@ -141,7 +141,7 @@ Service のインスタンスに割り当てる CPU ユニット数。指定可
`network` Map -`network` セクションには、Environment の VPC 内の AWS リソースにサービスを接続するためのパラメータが含まれています。Service を VPC に接続することで、[サービス検出](../developing/service-discovery.ja.md)を使用して Environment 内の他の Service と通信したり、[`storage init`](../commands/storage-init.ja.md)で Amazon Aurora などの VPC 内のデータベースに接続することができます。 +`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 内のサブネットを指定します。