Transit Gateway と Gateway Load Balancer を network function attachment で直接つないでみた

Transit Gateway と Gateway Load Balancer を network function attachment で直接つないでみた

AWS Transit Gateway の network function attachment(Gateway Load Balancer タイプ)で、GWLB エンドポイント用のサブネットとルートテーブルを作らずに通信をアプライアンスへ通せました。GENEVE パケットに付くコンテキストも確認しています。
2026.11.20

はじめに

2026年11月17日に、Transit Gateway の network function attachment が Gateway Load Balancer タイプに対応しました。

https://aws.amazon.com/about-aws/whats-new/2026/11/transit-gateway-gwlb-integration/

この attachment を使うと、Transit Gateway(TGW)を Gateway Load Balancer(GWLB)のエンドポイントサービスへ直接接続できます。GWLB エンドポイントは、指定した AZ に TGW が作成し、管理します。この記事では、同一アカウントで attachment を作成して通信を確認し、コンテキストの共有を試します。

検証環境

  • リージョン: 東京(ap-northeast-1)
  • aws-cli: 2.41.1
  • 構成: TGW とエンドポイントサービスは同じアカウント
  • Network Manager API: ホームリージョンの us-west-2 を指定

AZ は AZ ID で示します。このアカウントでの対応は次のとおりです。

AZ ID AZ 名
apne1-az4 ap-northeast-1a
apne1-az1 ap-northeast-1c

構成は次のとおりです。

構成要素 内容
検査 VPC 10.200.0.0/24。GWLB 用サブネット2つ(apne1-az4、apne1-az1)、アプライアンス用サブネット1つ(apne1-az4)。GWLB エンドポイント用のサブネットとルートテーブルは作成しない。TGW への VPC アタッチメントなし
spoke VPC A、B 10.201.0.0/24 と 10.202.0.0/24。それぞれ TGW に VPC アタッチメントで接続
GWLB クロスゾーン有効。ターゲットグループは GENEVE 6081、ヘルスチェックは TCP 8080
エンドポイントサービス 承諾不要
TGW 既定ルートテーブルの関連付けと伝播は無効。Encryption Support は disabled

ファイアウォール製品の代わりに、GENEVE パケットを受けて返すだけの Python スクリプトを EC2 で動かしました。

アプライアンスの仕様とスクリプト
  • UDP 6081 で受けた GENEVE パケットのヘッダー(オプションを含む)を JSON Lines で記録する
  • 受けたパケットをそのまま GWLB へ返す
  • TCP 8080 でヘルスチェックに応答する
#!/usr/bin/env python3
import http.server, json, socket, threading, time

LOG = "/var/log/geneve-reflector.jsonl"

def parse(data):
    b0 = data[0]
    optlen = (b0 & 0x3F) * 4
    rec = {
        "ver": b0 >> 6,
        "opt_len_bytes": optlen,
        "flags": data[1],
        "proto": hex(int.from_bytes(data[2:4], "big")),
        "vni": int.from_bytes(data[4:7], "big"),
        "options_hex": data[8:8 + optlen].hex(),
        "tlvs": [],
    }
    opts = data[8:8 + optlen]
    i = 0
    while i + 4 <= len(opts):
        cls = int.from_bytes(opts[i:i + 2], "big")
        typ = opts[i + 2]
        ln = (opts[i + 3] & 0x1F) * 4
        rec["tlvs"].append({"class": hex(cls), "type": typ, "len": ln,
                            "data": opts[i + 4:i + 4 + ln].hex()})
        i += 4 + ln
    inner = data[8 + optlen:]
    if rec["proto"] == "0x800" and len(inner) >= 20:
        rec["inner"] = {"src": socket.inet_ntoa(inner[12:16]),
                        "dst": socket.inet_ntoa(inner[16:20]),
                        "ip_proto": inner[9]}
    return rec

class H(http.server.BaseHTTPRequestHandler):
    def do_GET(self):
        self.send_response(200); self.end_headers(); self.wfile.write(b"ok\n")
    def log_message(self, *a):
        pass

threading.Thread(target=lambda: http.server.HTTPServer(("0.0.0.0", 8080), H).serve_forever(),
                 daemon=True).start()

s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
s.bind(("0.0.0.0", 6081))
with open(LOG, "a", buffering=1) as f:
    while True:
        data, addr = s.recvfrom(65535)
        try:
            rec = parse(data)
        except Exception as e:  # 解析できなくても転送は続ける
            rec = {"error": str(e)}
        rec["ts"] = time.strftime("%Y-%m-%dT%H:%M:%S%z")
        rec["from"] = "%s:%d" % addr
        rec["bytes"] = len(data)
        f.write(json.dumps(rec) + "\n")
        s.sendto(data, (addr[0], 6081))  # 宛先ポートは 6081 のまま返す(GWLB の送信元ポートへ返さない)

attachment の作成

作成と状態遷移

TGW の Encryption Support が disabled である必要があります。TGW の ID、エンドポイントサービスのサービス名、GWLB エンドポイントを作る AZ を指定して作成します。

aws ec2 create-transit-gateway-network-function-attachment \
  --transit-gateway-id <tgw-id> \
  --service-name <service-name> \
  --availability-zone-ids apne1-az4

状態は次のコマンドを使って5〜10秒間隔でポーリングし、各状態を最初に観測した時点を記録しました。

aws ec2 describe-transit-gateway-network-function-attachments \
  --transit-gateway-attachment-ids <attachment-id> \
  --query "TransitGatewayNetworkFunctionAttachments[0].State" --output text
作成 API の呼び出しからの経過 状態
0秒 initiatingRequest(作成 API の応答)
約56秒 pendingAcceptance
約3分15秒 pending
約6分20秒 available

TGW が作ったエンドポイント

TGW が作った GWLB エンドポイントは、エンドポイントサービス側のエンドポイント接続に表示されます。attachment の作成前は、エンドポイント接続は空でした。

aws ec2 describe-vpc-endpoint-connections \
  --filters Name=service-id,Values=<vpce-svc-id>
{
    "VpcEndpointConnections": [
        {
            "ServiceId": "vpce-svc-0123456789abcdef0",
            "VpcEndpointState": "available",
            "CreationTimestamp": "2026-11-19T18:52:42.625000+00:00",
            "GatewayLoadBalancerArns": [
                "arn:aws:elasticloadbalancing:ap-northeast-1:111122223333:loadbalancer/gwy/tgwv-gwlb/1234567890abcdef"
            ],
            "IpAddressType": "ipv4",
            "VpcEndpointConnectionId": "vpce-con-0123456789abcdef0",
            "Tags": [],
            "VpcEndpointRegion": "ap-northeast-1",
            "TransitGatewayAttachmentId": "tgw-attach-0123456789abcdef0",
            "TransitGatewayAttachmentOwner": "111122223333"
        }
    ]
}

attachment の作成前後に、次のコマンドで検査 VPC のサブネットとルートテーブルの数を確認しました。どちらの時点も、サブネットは3つ、ルートテーブルは2つでした。

aws ec2 describe-subnets --filters Name=vpc-id,Values=<inspection-vpc-id> \
  --query 'length(Subnets)'
aws ec2 describe-route-tables --filters Name=vpc-id,Values=<inspection-vpc-id> \
  --query 'length(RouteTables)'

ルーティング

TGW ルートテーブル

TGW のルートテーブルは、spoke 用(spoke-rt)と検査用(inspect-rt)の2つを作りました。

  • spoke-rt: spoke VPC A、B のアタッチメントを関連付け、宛先 0.0.0.0/0 を network function attachment へ向けるスタティックルートを追加する
  • inspect-rt: network function attachment を関連付け、spoke VPC A、B のアタッチメントのルートを伝播させる
# spoke-rt と inspect-rt を作る
aws ec2 create-transit-gateway-route-table --transit-gateway-id <tgw-id>
aws ec2 create-transit-gateway-route-table --transit-gateway-id <tgw-id>

# 関連付け
aws ec2 associate-transit-gateway-route-table \
  --transit-gateway-route-table-id <spoke-rt-id> \
  --transit-gateway-attachment-id <spoke-a-attachment-id>
aws ec2 associate-transit-gateway-route-table \
  --transit-gateway-route-table-id <spoke-rt-id> \
  --transit-gateway-attachment-id <spoke-b-attachment-id>
aws ec2 associate-transit-gateway-route-table \
  --transit-gateway-route-table-id <inspect-rt-id> \
  --transit-gateway-attachment-id <nf-attachment-id>

# spoke のルートを inspect-rt へ伝播
aws ec2 enable-transit-gateway-route-table-propagation \
  --transit-gateway-route-table-id <inspect-rt-id> \
  --transit-gateway-attachment-id <spoke-a-attachment-id>
aws ec2 enable-transit-gateway-route-table-propagation \
  --transit-gateway-route-table-id <inspect-rt-id> \
  --transit-gateway-attachment-id <spoke-b-attachment-id>

# spoke-rt の 0.0.0.0/0 を network function attachment へ
aws ec2 create-transit-gateway-route \
  --transit-gateway-route-table-id <spoke-rt-id> \
  --destination-cidr-block 0.0.0.0/0 \
  --transit-gateway-attachment-id <nf-attachment-id>

スタティックルートを作成した API の応答では、network function attachment の ResourceType が network-function になります。

{
    "Route": {
        "DestinationCidrBlock": "0.0.0.0/0",
        "TransitGatewayAttachments": [
            {
                "ResourceId": "com.amazonaws.vpce.ap-northeast-1.vpce-svc-0123456789abcdef0",
                "TransitGatewayAttachmentId": "tgw-attach-0123456789abcdef0",
                "ResourceType": "network-function"
            }
        ],
        "Type": "static",
        "State": "active"
    }
}

inspect-rt には、spoke VPC A(10.201.0.0/24)と B(10.202.0.0/24)の CIDR が登録されました。これらは伝播ルート(Type が propagated)です。spoke VPC 側のルートテーブルには、相手 VPC の CIDR を TGW へ向けるルートを置いています。

aws ec2 create-route --route-table-id <spoke-a-vpc-rtb-id> \
  --destination-cidr-block 10.202.0.0/24 --transit-gateway-id <tgw-id>
aws ec2 create-route --route-table-id <spoke-b-vpc-rtb-id> \
  --destination-cidr-block 10.201.0.0/24 --transit-gateway-id <tgw-id>

通信の確認

TGW ルートテーブルの関連付けが associated になってから、spoke の EC2 から ping -c 3 -W 2 <相手のIP> を実行しました。A から B、B から A のどちらも3往復が通りました。

# spoke A(10.201.0.10)から B へ
--- 10.202.0.9 ping statistics ---
3 packets transmitted, 3 received, 0% packet loss, time 2003ms

# spoke B(10.202.0.9)から A へ
--- 10.201.0.10 ping statistics ---
3 packets transmitted, 3 received, 0% packet loss, time 2004ms

通信がアプライアンスを通ったことは、アプライアンスのログで確認しました。A から B への ping 3往復の間に、アプライアンスは GENEVE パケットを6個受けました。内側の IP パケットの内訳は、10.201.0.10 から 10.202.0.9 への要求が3個、10.202.0.9 から 10.201.0.10 への応答が3個でした。外側の送信元 IP アドレスは、どれも 10.200.0.10(GWLB 用サブネットの IP)でした。

コンテキスト共有

コンテキストストアの作成

コンテキストは、トラフィックの送信元の VPC、サブネット、セキュリティグループ、アタッチメントを表す情報です。コンテキストを共有するには、Network Manager でグローバルネットワークを作り、TGW を登録し、コンテキストストアを作って TGW に関連付けます。

aws networkmanager create-global-network --region us-west-2

aws networkmanager register-transit-gateway --region us-west-2 \
  --global-network-id <global-network-id> \
  --transit-gateway-arn <tgw-arn>

aws networkmanager create-context-store --region us-west-2 \
  --global-network-id <global-network-id>

aws networkmanager associate-context-store --region us-west-2 \
  --context-store-id <context-store-id> \
  --transit-gateway-arn <tgw-arn>

関連付けは ASSOCIATING から約5分で ASSOCIATED になりました。

list-contexts の出力

関連付けの後に、list-contexts でコンテキストを取得しました。

aws networkmanager list-contexts --region us-west-2 \
  --context-store-id <context-store-id>

今回は22レコードが返りました。登録されていたのは、spoke 側の VPC、サブネット、セキュリティグループ、VPC アタッチメントと、network function attachment、そのエンドポイントサービス名でした。ContextType のうち SegmentId はセキュリティグループ、ResourceId は VPC と network function のサービス名に当たります。

GENEVE パケットに付くコンテキスト

関連付け後に A から B、B から A へ ping -c 2 を実行し、アプライアンスで取得したキャプチャを tcpdump -r <pcap> -nn -vv で読みました。次は、最初の要求パケットの外側(UDP と GENEVE オプション)と内側(ICMP)の行です。

    10.200.0.10.60462 > 10.200.0.21.6081: [udp sum ok] Geneve, Flags [none], vni 0x0, options [class Unknown (0x108) type 0x16 len 28 data 12345678 9abcdef0 08a10010 a00018a0 0008a000 010008a0, class Unknown (0x108) type 0x1 len 12 data 349e29e1 7e57216f, class Unknown (0x108) type 0x2 len 12 data 00000000 00000000, class Unknown (0x108) type 0x3 len 8 data 7c636988]
    10.201.0.10 > 10.202.0.9: ICMP echo request, id 61081, seq 1, length 64

関連付け前は class 0x108 の TLV が4つ(type 0x15、0x1、0x2、0x3)で、オプション長は44バイトでした。関連付け後は type 0x15(データ8バイト)が type 0x16(データ24バイト)に置き換わり、オプション長は60バイトになりました。tcpdump 4.99.1 はこのオプションを解釈せず、class Unknown (0x108) と表示します。

type 0x16 のデータ24バイトを、A から B と B から A の2方向について list-contexts の ContextId と照合した結果が次の表です。spoke VPC ごとにセキュリティグループは1つです。バイト配置の公開仕様は見つからなかったため、配置は実測からの推定です。

バイト位置 項目 A から B のパケット B から A のパケット
0〜7 コンテキストストア ID の下位16桁 context-store-0123456789abcdef0 同じ
8〜9 用途不明 08a1 08a1
10〜12 アタッチメント 0010a0 → tgw-attach-0a1b2c3d4e5f67890(spoke A) 0018a0 → tgw-attach-0f9e8d7c6b5a43210(spoke B)
13〜15 VPC 0018a0 → vpc-0aaaa1111bbbb2222(spoke A) 0010a0 → vpc-0cccc3333dddd4444(spoke B)
16〜18 サブネット 0008a0 → subnet-0111122223333aaaa(spoke A) 0010a0 → subnet-0444455556666bbbb(spoke B)
19〜20 AZ 0001 → apne1-az4 0001 → apne1-az4
21〜23 セキュリティグループ 0008a0 → sg-0aaaa0000bbbb1111(spoke A) 0010a0 → sg-0cccc2222dddd3333(spoke B)

どちらの方向でも、アタッチメント、VPC、サブネット、AZ、セキュリティグループの ContextId が、送信元のリソースと一致しました。含まれていたのは送信元のコンテキストだけです。AZ は2バイトのうち下位1バイトを AvailabilityZone の ContextId として照合しています。

照合には、次のスクリプトを使いました。resolve-context.py として保存し、list-contexts の出力 JSON とアプライアンスのログ(geneve-reflector.jsonl)を引数に渡します。

python3 resolve-context.py <list-contexts の JSON> <geneve-reflector.jsonl>
resolve-context.py
#!/usr/bin/env python3
"""アプライアンスが受けた GENEVE オプション(class 0x0108, type 0x16)の ContextId を、
list-contexts の出力と照合して、リソースの名前に解決する。

使い方: resolve-context.py <list-contexts の JSON> <geneve-reflector.jsonl>

バイト配置は公開仕様が見当たらないため、実測から推定したもの:
  type 0x16 の data は 24 バイト
    [0:8]   コンテキストストア ID の下位 16 桁(context-store-0 + 16 桁)
    [8:10]  不明(2 バイト。観測では 08 a1 で固定)
    [10:13] 送信元の attachment の ContextId(3 バイト)
    [13:16] 送信元の VPC の ContextId
    [16:19] 送信元の subnet の ContextId
    [19:21] 送信元の AZ の ContextId(2 バイト)
    [21:24] 送信元のセキュリティグループの ContextId
subnet と SG の ContextId は、この環境では値が同じため、2 つの位置の取り違えは区別できない。
"""
import json
import sys

def load_json(path):
    text = open(path).read()
    start = text.index("{")
    end = text.rindex("}") + 1
    return json.loads(text[start:end])

def load_lines(path):
    out = []
    for line in open(path):
        line = line.strip()
        if line.startswith("{"):
            out.append(json.loads(line))
    return out

ctx = load_json(sys.argv[1])["Contexts"]
by = {}
for c in ctx:
    by.setdefault((c["ContextType"], c["ContextId"]), []).append(c)

def name(ctype, cid):
    hits = by.get((ctype, cid), [])
    return [h["PublicId"] for h in hits] or ["(not found)"]

seen = set()
for rec in load_lines(sys.argv[2]):
    for t in rec["tlvs"]:
        if t["type"] != 22:
            continue
        d = bytes.fromhex(t["data"])
        key = (rec["inner"]["src"], t["data"])
        if key in seen:
            continue
        seen.add(key)
        att, vpc, sub = d[10:13].hex(), d[13:16].hex(), d[16:19].hex()
        az, sg = d[19:21].hex(), d[21:24].hex()
        print("inner src %s -> dst %s" % (rec["inner"]["src"], rec["inner"]["dst"]))
        print("  context store : context-store-0%s" % d[0:8].hex())
        print("  attachment %s: %s" % (att, name("Attachment", att)))
        print("  vpc        %s: %s" % (vpc, name("ResourceId", vpc)))
        print("  subnet     %s: %s" % (sub, name("Subnet", sub)))
        print("  az         %s: %s" % (az, name("AvailabilityZone", az[-2:])))
        print("  sg         %s: %s" % (sg, name("SegmentId", sg)))

まとめ

network function attachment が GWLB タイプに対応し、ファイアウォールなどの前面に置いた GWLB のエンドポイントサービスへ、TGW から直接接続できるようになりました。

検査 VPC の管理、特に GWLB エンドポイント用のサブネットとルートテーブルの維持が負担になっている場合は、今回のアップデートをお試しください。

この記事をシェアする

AWSのお困り事はクラスメソッドへ

関連記事