# Emissary-Ingress v3.10.0

2025-07-29 · [元のリリースノート](https://github.com/emissary-ingress/emissary/releases/tag/v3.10.0) · [全体のまとめ](https://ratatosk.io/ja/releases/emissary-ingress/v3.10.0)

破壊的変更 2 · 重大な修正 1 · 機能・改善 1 · 依存関係の更新 3 · その他の変更 5

## アップグレード前の確認事項

### アップグレードガイド

- **新規インストールとアップグレード向けクイックスタート**
  >     See the [Quickstart](https://emissary-ingress.dev/docs/3.10/quick-start/) for more details.

## 破壊的変更 (2)

### 公開YAMLマニフェストでの Ambassador Agent のデフォルトインストール対象からの除外

- 影響対象: 公開YAMLマニフェストを使った Emissary-ingress のインストール

Ambassador Agent は Emissary-ingress に追加機能を提供します。

> - Change: Emissary-ingress will no longer publish YAML manifest with the Ambassador Agent being
>   installed by default. This is an optional component that provides additional features on top of
>   Emissary-ingress and we recommend installing it using the instructions found in the <a
>   href="https://github.com/datawire/ambassador-agenty">Ambassador Agent Repo</a>.

https://github.com/emissary-ingress/emissary/blob/v3.10.0/CHANGELOG.md

### Emissary イメージと Helm チャートの GHCR への掲載

- 影響対象: Emissary イメージまたは Helm チャートのデプロイメント (推定)

Emissary のイメージは DockerHub でホストされていました。このリリースでは、メインイメージの場所として `ghcr.io/emissary-ingress/emissary:3.10.0`、CRD とコントロールプレーンのチャートの場所として `ghcr.io/emissary-ingress/emissary-crds-charts` と `ghcr.io/emissary-ingress/emissary-chart` が記載されています。チャートの以前の場所は記載されていません。

> - Change: The Emissary images are now hosted at GHCR rather than at DockerHub.
>     - The main Emissary image is at `ghcr.io/emissary-ingress/emissary:3.10.0`
>     - The (new) Helm chart for the Emissary CRDs is at `ghcr.io/emissary-ingress/emissary-crds-charts`
>     - The Helm chart for the Emissary control plane is at `ghcr.io/emissary-ingress/emissary-chart`

## 重大な修正 (1)

### `ambex` のルートハッシュ処理における MD5 panic の修正

- 影響対象: `ambex` を使って V3 リスナーを RDS リスナーに変換する Emissary インストール環境 (推定)

FIPS などの暗号機能が制限された環境では、フィルターチェーンのマッチ条件をハッシュ化する際に、`ambex` が `openssl: MD5 failed` で panic することがありました。

> - Change: The `ambex` component of Emissary-ingress now uses `xxhash64` instead of `md5`, since
>   `md5` can cause problems in crypto-restricted environments (e.g. FIPS) ([Remove usage of md5])
> [Remove usage of md5]: https://github.com/emissary-ingress/emissary/pull/5794

https://github.com/emissary-ingress/emissary/blob/v3.10.0/CHANGELOG.md

## 機能・改善 (1)

- Service のエンドポイント解決における `EndpointSlice` 対応

## 依存関係の更新 (3)

ほか3件（いずれもセキュリティへの言及なし）

- `- Feature: This upgrades Emissary-ingress to be built on Envoy v1.28.0 which provides security, performance and feature enhancements. You can read more about them here: <a href="https://www.envoyproxy.io/docs/envoy/v1.28.0/version_history/version_history">Envoy Proxy 1.28.0 Release Notes</a>`
- `- Change: Upgraded Emissary-ingress to the latest release of Golang as part of our general dependency upgrade process.`
- `- Change: Upgraded Emissary-ingress to the latest release of Golang as part of our general dependency upgrade process.`

## その他の変更 (5)

- 公開 YAML マニフェストでの Ambassador Agent のデフォルトインストール廃止
- 正規表現ヘッダーの `Mapping` キャッシュキーに `Mapping` 名を使用
- 正規表現ヘッダーを使う `Mapping` のキャッシュキーに `Mapping` 名を使用
- Envoy v1.28.0 をベースに構築された Emissary-ingress
- 外部認証サービスへのクライアント TLS 情報の引き渡し

---

整理した内容は AI が作成するため誤っている可能性があり、無保証で提供されます。
