

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Envoy イメージ
<a name="envoy"></a>

**重要**  
サポート終了通知: 2026 年 9 月 30 日、 AWS はサポートを終了します AWS App Mesh。2026 年 9 月 30 日以降、 AWS App Mesh コンソールまたは AWS App Mesh リソースにアクセスできなくなります。詳細については、このブログ記事[「 から Amazon ECS Service Connect AWS App Mesh への移行](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect)」を参照してください。

AWS App Mesh は [Envoy ](https://www.envoyproxy.io/)プロキシに基づくサービスメッシュです。

![\[ECS Task/Kubernetes Pod with Proxy and Microservice Container communicating via ports 8080 and 8081.\]](http://docs.aws.amazon.com/ja_jp/app-mesh/latest/userguide/images/proxy.png)


仮想ノードや仮想ゲートウェイなど、App Mesh エンドポイントで表される Amazon ECS タスク、Kubernetes ポッド、または Amazon EC2 インスタンスに Envoy プロキシを追加する必要があります。App Mesh は、最新の脆弱性とパフォーマンスの更新でパッチが適用された Envoy プロキシコンテナイメージを提供します。App Mesh は、新しいイメージが利用可能になる前に、App Mesh 機能セットに対して新しい Envoy プロキシリリースをテストします。

## Envoy イメージバリアント
<a name="envoy-variants"></a>

App Mesh は、Envoy プロキシコンテナイメージの 2 つのバリアントを提供します。両者の違いは、Envoy プロキシが App Mesh データプレーンと通信する方法と、Envoy プロキシが相互に通信する方法です。1 つは標準イメージで、標準の App Mesh サービスエンドポイントと通信します。もう 1 つのバリアントは FIPS に準拠しており、App Mesh FIPS サービスエンドポイントと通信し、App Mesh サービス間の TLS 通信で FIPS 暗号化を適用します。

次のリストから地域別の画像を選択するか、`aws-appmesh-envoy`という名前の[公開リポジトリ](https://gallery.ecr.aws/appmesh/aws-appmesh-envoy)から画像を選択できます。

**重要**  
2023 年 6 月 30 日以降、Envoy イメージ `v1.17.2.0-prod`以降のみが App Mesh と互換性があります。より前の Envoy イメージを使用している現在のお客様は`v1.17.2.0`、既存の使節には引き続き互換性がありますが、最新バージョンへの移行を強くお勧めします。
ベストプラクティスとして、Envoy バージョンを定期的に最新バージョンにアップグレードすることを特にお勧めします。最新の Envoy バージョンのみが、最新のセキュリティパッチ、機能リリース、パフォーマンスの向上で検証されます。
Version `1.17` では、Envoy が大幅に更新されています。詳細については、「[Envoy 1.17 へのアップデート/移行](https://docs.aws.amazon.com/app-mesh/latest/userguide/1.17-migration.html)」を参照してください。
バージョン `1.20.0.1` 以降は `ARM64` と互換性があります。
`IPv6` のサポートには、Envoy バージョン `1.20` 以降が必要です。

**注記**  
FIPS は、米国およびカナダで見つかったリージョンでのみ使用できます。

[サポートされている](https://docs.aws.amazon.com/general/latest/gr/appmesh.html)すべてのリージョンは、*リージョンコードを* `me-south-1`、`ap-east-1`、、、`ap-southeast-3``eu-south-1``il-central-1`、および 以外の任意のリージョンに置き換えることができます`af-south-1`。  
標準  

```
840364872350.dkr.ecr.region-code.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
```
FIPS 準拠  

```
840364872350.dkr.ecr.region-code.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod-fips
```

`me-south-1`  
Standard  

```
772975370895.dkr.ecr.me-south-1.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
```

`ap-east-1`  
Standard  

```
856666278305.dkr.ecr.ap-east-1.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
```

`ap-southeast-3`  
Standard  

```
909464085924.dkr.ecr.ap-southeast-3.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
```

`eu-south-1`  
Standard  

```
422531588944.dkr.ecr.eu-south-1.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
```

`il-central-1`  
Standard  

```
564877687649.dkr.ecr.il-central-1.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
```

`af-south-1`  
Standard  

```
924023996002.dkr.ecr.af-south-1.amazonaws.com/aws-appmesh-envoy:v1.34.13.0-prod
```

`Public repository`  
標準  

```
public.ecr.aws/appmesh/aws-appmesh-envoy:v1.34.13.0-prod
```
FIPS 準拠  

```
public.ecr.aws/appmesh/aws-appmesh-envoy:v1.34.13.0-prod-fips
```

**注記**  
512 CPU ユニットと少なくとも 64 MiB のメモリを Envoy コンテナに割り当てるようお勧めします。Fargate では、設定できる最小メモリ容量は 1024 MiB です。コンテナのインサイトやその他の指標から負荷が高いためにリソースが不足していることが判明した場合には、Envoy コンテナへのリソース割り当てを増やすことができます。

**注記**  
`v1.22.0.0` 以降のすべての `aws-appmesh-envoy` イメージリリースバージョンは、distroless の Docker イメージとしてビルドされます。この変更は、イメージサイズを小さくし、イメージ内に存在する未使用のパッケージが脆弱性にさらされる可能性を減らすことができるようにするためです。aws-appmesh-envoy イメージをベースに構築していて、AL2 ベースパッケージ (yum など) や機能の一部に依存している場合は、`aws-appmesh-envoy` イメージ内からバイナリをコピーして AL2 ベースで新しい Docker イメージをビルドすることをおすすめします。  
このスクリプトを実行して、`aws-appmesh-envoy:v1.22.0.0-prod-al2:` タグ付きのカスタム Docker イメージを生成します。  

```
cat << EOF > Dockerfile
FROM public.ecr.aws/appmesh/aws-appmesh-envoy:v1.22.0.0-prod as envoy

FROM public.ecr.aws/amazonlinux/amazonlinux:2
RUN yum -y update && \
    yum clean all && \
    rm -rf /var/cache/yum

COPY --from=envoy /usr/bin/envoy /usr/bin/envoy
COPY --from=envoy /usr/bin/agent /usr/bin/agent
COPY --from=envoy /aws_appmesh_aggregate_stats.wasm /aws_appmesh_aggregate_stats.wasm

CMD [ "/usr/bin/agent" ]
EOF

docker build -f Dockerfile -t aws-appmesh-envoy:v1.22.0.0-prod-al2 .
```

Amazon ECR でのこのコンテナイメージへのアクセスは、 AWS Identity and Access Management (IAM) によって制御されます。そのため、IAM を使用して Amazon ECR への読み取りアクセス権があることを確認する必要があります。例えば、Amazon ECS を使用する場合、適切なタスク実行ロールを Amazon ECS タスクに割り当てることができます。特定の Amazon ECR リソースへのアクセスを制限する IAM ポリシーを使用する場合は、`aws-appmesh-envoy` リポジトリを識別するリージョン固有の Amazon リソースネーム (ARN) へのアクセスを許可していることを確認する必要があります。例えば、`us-west-2` リージョンの場合は、次のリソースへのアクセスを許可します。`arn:aws:ecr:us-west-2:840364872350:repository/aws-appmesh-envoy`。詳細については、「[Amazon ECR Managed Policies](https://docs.aws.amazon.com/AmazonECR/latest/userguide/ecr_managed_policies.html)」を参照してください。Amazon EC2 インスタンスで Docker を使用している場合は、リポジトリに対して Docker を認証します。詳細については、「[レジストリの認証](https://docs.aws.amazon.com/AmazonECR/latest/userguide/Registries.html#registry_auth)」を参照してください。

上流の Envoy イメージにまだマージされていない Envoy の変更に依存する新しい App Mesh 機能をリリースすることがあります。これらの新しい App Mesh 機能を、Envoy の変更を上流にマージする前に使用するには、App Mesh で提供されている Envoy コンテナイメージを使用する必要があります。変更のリストについては、`Envoy Upstream` というラベルの付いた「[App Mesh GitHub ロードマップの問題](https://github.com/aws/aws-app-mesh-roadmap/labels/Envoy%20Upstream)」を参照してください App Mesh Envoy コンテナイメージを最適なサポートオプションとして使用することをお勧めします。