Envoy 1.17 へのアップデート/移行

重要

サポート終了通知: 2026 年 9 月 30 日、 AWS は のサポートを終了します AWS App Mesh。2026 年 9 月 30 日以降、 AWS App Mesh コンソールまたは AWS App Mesh リソースにアクセスできなくなります。詳細については、このブログ記事の「 から Amazon ECS Service Connect AWS App Mesh への移行」を参照してください。

を使用したシークレット検出サービス SPIRE

App Mesh で SPIRE (SPIFFE Runtime Environment) を使用して信頼証明書をサービスに配布する場合は、少なくとも 0.12.0 バージョンの SPIRE エージェント (2020 年 12 月リリース) を使用していることを確認します。これは、Envoy バージョン 1.16 以降をサポートできる最初のバージョンです。

正規表現の変更

Envoy 以降1.17、App Mesh は、デフォルトでRE2正規表現エンジンを使用するように Envoy を設定します。この変更は、ほとんどのユーザーに対して明白ですが、ルートまたはゲートウェイルートでの一致では、正規表現での先読みまたは後方参照は許可されなくなります。

正と負の先読み取り

正 - 正の先読みは、?= で始まる括弧で囲まれた式です。

(?=example)

これらは、文字列置換を行うときに最も有用です。なぜなら、文字を一致の一部として消費することなく、文字列を一致させることができるからです。App Mesh では、正規表現による文字列置換がサポートされていないため、これらを通常の一致に置き換えることをお勧めします。

(example)

負 - 負の先読みは、?! で始まる括弧で囲まれた式です。

ex(?!amp)le

括弧で囲まれた式は、式の一部が特定の入力と一致しないことを表明するために使用されます。ほとんどの場合、これらはゼロ数値に置き換えることができます。

ex(amp){0}le

式自体が文字クラスである場合は、クラス全体を単純に否定し、? を使用してオプションとしてマークを付けることができます。

prefix(?![0-9])suffix => prefix[^0-9]?suffix

ユースケースによっては、これを処理するためにルートを変更することもできます。

{
    "routeSpec": {
        "priority": 0,
        "httpRoute": {
            "match": {
                "headers": [
                    {
                        "name": "x-my-example-header",
                        "match": {
                            "regex": "^prefix(?!suffix)"
                        }
                    }
                ]
            }
        }
    }
}

{
    "routeSpec": {
        "priority": 1,
        "httpRoute": {
            "match": {
                "headers": [
                    {
                        "name": "x-my-example-header",
                        "match": {
                            "regex": "^prefix"
                        }
                    }
                ]
            }
        }
    }
} 

最初のルート一致は、「プレフィックス」で始まり、その後に「サフィックス」が続かないヘッダーを探します。2番目のルートは、「サフィックス」で終わるヘッダーを含め、「プレフィックス」で始まる他のすべてのヘッダーと一致するように機能します。代わりに、負の先読みを削除する方法として、これらを逆にすることができます。

{
    "routeSpec": {
        "priority": 0,
        "httpRoute": {
            "match": {
                "headers": [
                    {
                        "name": "x-my-example-header",
                        "match": {
                            "regex": "^prefix.*?suffix"
                        }
                    }
                ]
            }
        }
    }
}

{
    "routeSpec": {
        "priority": 1,
        "httpRoute": {
            "match": {
                "headers": [
                    {
                        "name": "x-my-example-header",
                        "match": {
                            "regex": "^prefix"
                        }
                    }
                ]
            }
        }
    }
}

ここでは、ルートを逆にして「suffix」で終わるヘッダーに高い優先順位を与え、「prefix」で始まる他のすべてのヘッダーは、優先順位の低いルートで一致します。

後方参照

後方参照は、前のカッコで囲まれたグループを繰り返すことで、短い式を記述する方法です。これらには、次の形式があります。

(group1)(group2)\1

後方参照 \ に続く数値は、式内の n 番目の括弧で囲まれたグループのプレースホルダとして機能します。この例では、\1 は、2回目の (group1) 書き込みの代替方法として使用されています。

(group1)(group2)(group1)

上記の例のように、後方参照を参照するグループに置き換えるだけで、これらを削除することができます。