すべてのプロダクト
Search

このプロダクト

    Container Compute Service:Pod に EIP をアタッチするためのアノテーション

    ドキュメントセンター

    Container Compute Service:Pod に EIP をアタッチするためのアノテーション

    最終更新日:Nov 09, 2025

    Alibaba Cloud Container Service for Kubernetes (ACS) クラスターでは、アノテーションを使用して Elastic IP アドレス (EIP) を Pod にアタッチし、EIP リリース ポリシーを設定できます。

    重要

    この Topic を読む前に、ack-extend-network-controller コンポーネントをインストール済みであり、ACS クラスターで EIP を構成して Pod にアタッチする方法を理解していることを確認してください。

    EIP 機能を有効にするためのアノテーション

    ACS は、アノテーションを使用して EIP 機能を有効にすることをサポートしています。必要に応じて、EIP を自動的に割り当てるか、静的 EIP を Pod に割り当てることができます。

    Pod と EIP を自動的に作成して関連付ける

    重要

    EIP 自動割り当て機能を使用すると、EIP が繰り返しリクエストおよびリリースされる場合があります。たとえば、この問題は、Pod が再作成された場合や、Container Network Interface (CNI) コンポーネントがネットワークの構成に失敗した場合に発生します。この問題を回避するには、EIP インスタンスを指定できます。

    Pod アノテーション

    説明

    network.alibabacloud.com/pod-with-eip

    EIP を自動的に作成し、Pod に関連付けるかどうかを指定します。有効な値：

    • true: EIP を自動的に作成してアタッチします。

    • false: EIP を自動的に作成してアタッチしません。

    network.alibabacloud.com/eip-bandwidth

    EIP の最大帯域幅。単位：Mbit/s。

    network.alibabacloud.com/eip-internet-charge-type

    EIP の従量課金方式。有効な値：

    • PayByTraffic: (デフォルト) トラフィック課金。

    • PayByBandwidth: 帯域幅課金。

    EIP の課金の詳細については、課金概要 を参照してください。

    k8s.aliyun.com/eip-charge-type (以前のバージョンとの互換性)

    network.alibabacloud.com/eip-instance-charge-type

    EIP の課金方式。有効な値：

    • PrePaid: サブスクリプション。

    • PostPaid: 従量課金。

    詳細については、サブスクリプション および 従量課金 を参照してください。

    network.alibabacloud.com/eip-common-bandwidth-package-id

    使用するインターネット共有帯域幅インスタンス。

    network.alibabacloud.com/eip-isp

    EIP の回線タイプ。有効な値：

    • BGP: BGP (マルチ ISP) 回線。

    • BGP_PRO: BGP (マルチ ISP) Pro 回線。

    詳細については、EIP を申請する を参照してください。

    network.alibabacloud.com/eip-public-ip-address-pool-id

    IP アドレスプール。詳細については、IP アドレスプールを作成および管理する を参照してください。

    network.alibabacloud.com/eip-resource-group-id

    EIP が属するリソースグループ。詳細については、EIP を申請する を参照してください。

    network.alibabacloud.com/eip-name

    EIP の名前。詳細については、EIP を申請する を参照してください。

    network.alibabacloud.com/eip-description

    EIP の説明。詳細については、EIP を申請する を参照してください。

    network.alibabacloud.com/eip-security-protection-types

    EIP のセキュリティ保護レベル。複数のレベルを構成する場合は、コンマ (,) で区切ります。詳細については、「EIP のリクエスト」をご参照ください。

    EIP インスタンスの指定

    インスタンス ID を指定して、既存の EIP をアタッチできます。Pod アノテーションは EIP インスタンスの構成を変更しません。指定された Pod に EIP をアタッチするだけです。

    重要

    • この機能は、複数のレプリカを持つコントローラーには適用できません。ステートフルアプリケーションの StatefulSet でのみこの機能を使用することをお勧めします。

    • 1 つの EIP インスタンスを 1 つの Pod にのみアタッチすることをお勧めします。EIP コントローラーは、Pod が終了した後に EIP をデタッチします。この期間中、EIP インスタンスは他のコンテナーでは使用できません。ビジネスの中断を避けるために、Pod と同じ名前の Pod EIP リソースが存在するかどうかを確認して、Pod と EIP がデタッチされているかどうかを判断できます。

    Pod アノテーション

    説明

    network.alibabacloud.com/pod-eip-instanceid

    使用する EIP の ID (例: eip-bp14qxxxxxxx)。詳細については、EIP を申請する を参照してください。

    k8s.aliyun.com/eci-eip-instanceid (Elastic Container Instance との互換性)

    EIP 解除ポリシーを構成するためのアノテーション

    ACS は、アノテーションを使用して Pod EIP のリリース ポリシーを設定することをサポートしています。必要に応じて、Pod と共に EIP をリリースするか、EIP をリリースしないか、EIP の有効期限を設定するかを選択できます。

    重要

    • この機能は、ステートフルアプリケーションの StatefulSet にのみ適用できます。ステートレスアプリケーションのデプロイメントでは使用できません。

    • ID で EIP を指定できます。指定された EIP は解除されません。

    Pod アノテーション

    説明

    network.alibabacloud.com/pod-eip-release-strategy

    EIP 解除ポリシー。有効な値：

    • Follow: (デフォルト) Pod のライフサイクルに従います。

    • Never: Pod EIP を削除しません。不要になった場合は、手動で Pod EIP を削除する必要があります。

    • 有効期限を設定します。たとえば、5m30s は、Pod が削除されてから 5 分 30 秒後に Pod EIP が削除されることを示します。Go フォーマットの時間式がサポートされています。

    説明

    有効期限が設定された再利用ポリシーの場合、ステートフルアプリケーションの Pod が削除された後、Pod EIP は削除される前に一定期間保持されます。この期間中に作成された同じ名前の Pod は、同じ EIP を引き続き使用します。このポリシーは、ステートフルアプリケーションが静的 EIP を必要とするシナリオで、EIP 自動割り当て機能と共に使用できます。