ワークロードの IP アドレスをプロビジョニングする

組織の内部 Virtual Private Cloud（VPC）またはデフォルト VPC に追加のサブネットを作成して、内部ネットワーキングの要件をサポートします。たとえば、仮想マシン（VM）やコンテナなどの内部ワークロードに十分な IP アドレスがあることを確認するために、VPC サブネットを追加します。

このページでは、順に完了することを想定していないタスクをいくつか説明します。

このページのタスクを完了する前に、サブネットとそのコンセプトの概要については、サブネットと IP アドレスをご覧ください。

このドキュメントは、組織のネットワーク トラフィックの管理を担当するプラットフォーム管理者とアプリケーション オペレーターを対象としています。詳細については、GDC のエアギャップ環境のユーザー グループのドキュメントをご覧ください。

始める前に

サブネットの作成に必要な権限を取得するには、組織 IAM 管理者にサブネット組織管理者（subnet-org-admin）の IAM ロールを付与するよう依頼してください。このロールは Namespace にバインドされていません。

ワークロード用のゾーンブランチ サブネットを作成する

ゾーンのデフォルト VPC の IP アドレスをさらに細分化するには、ゾーンの既存のゾーンルート サブネットからゾーン内部サブネットを作成します。このサブネット タイプは platform Namespace に作成する必要があります。

親のゾーンルート サブネットで使用可能な IP アドレスが不足している場合は、続行する前にグローバル IP アドレス範囲から別のゾーンサブネットを割り当てます。

  • ターミナル ウィンドウで、管理 API サーバーに新しいゾーン サブネットを作成します。

    kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG apply -f - <<EOF
apiVersion: ipam.gdc.goog/v1
kind: Subnet
metadata:
  labels:
    ipam.gdc.goog/vpc: default-vpc
  name: SUBNET_NAME
  namespace: platform
spec:
  ipv4Request:
    prefixLength: CIDR_PREFIX_LENGTH
  networkSpec:
    enableGateway: true
    enableVLANID: false
  parentReference:
    name: PARENT_SUBNET_NAME
    namespace: platform
  type: Branch
EOF

    次のように置き換えます。

    • MANAGEMENT_API_SERVER_KUBECONFIG: 管理 API サーバーの kubeconfig ファイルのパス。詳細については、ゾーン管理 API サーバー リソースをご覧ください。

    • SUBNET_NAME: 新しいネットワーク サブネットの名前。

    • CIDR_PREFIX_LENGTH: 新しいサブネットのプレフィックス長（例: 27）。このフィールドは、親サブネットからそのサイズの次の使用可能な IP アドレス範囲を動的に割り振ります。特定の IP アドレス範囲ではなく、サブネットのサイズのみを考慮する場合は、prefixLength フィールドを使用します。

      特定の IP アドレス範囲を割り当てるには、次の操作を行います。

      1. prefixLength: CIDR_PREFIX_LENGTH 行を削除します。
      2. 代わりに cidr: "YOUR_CIDR_BLOCK" 行（cidr: "10.0.10.0/27" など）を追加します。

      厳密な IP プランに従い、正確で予測可能な IP アドレス範囲を割り当てる必要がある場合は、cidr フィールドを使用します。この範囲は、親サブネット内の有効で利用可能なサブネットである必要があります。

    • PARENT_SUBNET_NAME: 親サブネットの名前（default-vpc-zone0-cidr など）。親サブネットは通常、デフォルト VPC のゾーンルート サブネットです。

    詳細については、Subnet リソースの API リファレンス ドキュメントをご覧ください。

    ゾーン サブネットをさらに分割するか、リーフ サブネットを作成して、内部ワークロードに個々の IP アドレスを直接割り当てることができます。

個々のワークロードのリーフ サブネットを作成する

ワークロードに単一の IP アドレスを割り当てるには、リーフ サブネットを作成する必要があります。このリーフ サブネットにはフィールド値 type: Leaf が必要で、VM やコンテナなどのワークロード リソースと同じプロジェクト Namespace に存在する必要があります。

リーフ サブネットは、単一の IP アドレスを割り当てることを目的としているため、prefixLength 値を 32 に構成する必要があります。parentReference 値は、以前に割り当てられたサブネット（ワークロード用のゾーン ブランチ サブネットを作成するで作成した親ゾーン サブネットなど）を参照します。

  • ターミナル ウィンドウで、管理 API サーバーにリーフ サブネットを作成します。

    kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG apply -f - <<EOF
apiVersion: ipam.gdc.goog/v1
kind: Subnet
metadata:
  labels:
    ipam.gdc.goog/vpc: default-vpc
  name: SUBNET_NAME
  namespace: PROJECT_NAMESPACE
spec:
  ipv4Request:
    prefixLength: 32
  parentReference:
    name: PARENT_SUBNET
    namespace: PARENT_NAMESPACE
  type: Leaf
EOF

    次のように置き換えます。

    • MANAGEMENT_API_SERVER_KUBECONFIG: 管理 API サーバーの kubeconfig ファイルのパス。詳細については、ゾーン管理 API サーバー リソースをご覧ください。
    • SUBNET_NAME: リーフ サブネットの名前。
    • PROJECT_NAMESPACE: ワークロードが配置されているプロジェクトに対応するプロジェクト Namespace。
    • PARENT_SUBNET: このリーフ サブネットが IP アドレスの取得元となる親サブネットの名前。
    • PARENT_NAMESPACE: PROJECT_NAMESPACE または platform の Namespace。

個々の IP アドレスは、VM やコンテナなどの内部ワークロードで使用できるようになりました。ワークロードの IP アドレスを構成する方法の詳細については、静的 IP アドレスまたは動的 IP アドレスを使用して VM を作成するまたはコンテナ ワークロード用に内部ロードバランサを構成するをご覧ください。

グローバル IP アドレス範囲からゾーン サブネットを割り当てる

既存のゾーンルート サブネットの IP アドレス範囲から、ワークロードに十分な IP アドレスが提供されない場合は、グローバル IP アドレス ルート範囲から追加の IP アドレスを割り当てることができます。

グローバル IP アドレス範囲からゾーン サブネットを割り当てるには、platform 名前空間のデフォルト VPC ネットワークに対して次の操作を行います。

  1. ターミナル ウィンドウで、デフォルト VPC のすべてのルート サブネットを記述し、使用可能な CIDR ブロックを確認します。

    kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG describe subnets --namespace platform \
    -l ipam.gdc.goog/vpc=default-vpc,ipam.gdc.goog/usage=network-root-range

    GLOBAL_API_SERVER_KUBECONFIG は、グローバル API サーバーの kubeconfig ファイルのパスに置き換えます。詳細については、グローバル API サーバー リソースをご覧ください。ラベルは定数であり、同じままにする必要があります。

    出力は次のようになります。

    Name:         default-vpc-root-cidr
Namespace:    platform
Labels:       ipam.gdc.goog/allocation-preference=default
              ipam.gdc.goog/subnet-group=default-vpc-root-group
              ipam.gdc.goog/usage=network-root-range
              ipam.gdc.goog/vpc=default-vpc
Annotations:  <none>
API Version:  ipam.global.gdc.goog/v1
Kind:         Subnet
Metadata:
  Creation Timestamp:  2025-06-18T23:05:38Z
  Finalizers:
    global-subnet-finalizer
  Generation:        1
  Resource Version:  439434
  UID:               5ed1c51a-b5ee-473e-a185-8e065a87ae8f
Spec:
  ipv4Request:
    Cidr:                10.252.0.0/14
  Propagation Strategy:  None
  Type:                  Root
Status:
  Children Refs:
    Name:       default-vpc-zone1-root-cidr
    Namespace:  platform
    Type:       SingleSubnet
  Conditions:
    Last Transition Time:  2025-06-18T23:05:38Z
    Message:               IP allocation finished successfully
    Observed Generation:   1
    Reason:                AllocationSucceeded
    Status:                True
    Type:                  Ready
  ipv4Allocation:
    Available CIDRs:
      10.254.0.0/15
      10.253.0.0/16
    Cidr:  10.252.0.0/14
Events:    <none>

    Status.ipv4Allocation.Available CIDRs の値をメモします。これらの値は、次のステップで参照される使用可能な CIDR ブロックです。上記の出力では、CIDR 範囲 10.254.0.0/15 と 10.253.0.0/16 を使用できます。出力に複数のサブネットが表示されることがあります。使用可能なすべての CIDR ブロックとその送信元サブネットをメモします。

  2. 前の手順で取得した最大の利用可能な CIDR ブロックと、ゾーンに必要な CIDR ブロックのサイズを比較します。使用可能な最大の CIDR ブロックが新しいサブネットの割り当てに十分な大きさでない場合は、続行する前に新しいネットワーク ルート範囲のグローバル サブネットを追加します。新しいサブネットの CIDR ブロックを取得する親サブネットをメモします。

    たとえば、/13 CIDR ブロックが必要なのに、使用可能な CIDR に /15 と /16 しか含まれていない場合は、新しいネットワーク ルート範囲のグローバル サブネットを追加する必要があります。/15 サブネットが必要な場合は、既存の /15 CIDR ブロックから新しいゾーン サブネットを割り当てることができます。

  3. グローバル API サーバーに新しいサブネットを作成します。

    kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG apply -f - <<EOF
apiVersion: ipam.global.gdc.goog/v1
kind: Subnet
metadata:
  labels:
    ipam.gdc.goog/vpc: default-vpc
    ipam.gdc.goog/usage: zone-network-root-range
  name: SUBNET_NAME
  namespace: platform
spec:
  ipv4Request:
    prefixLength: CIDR_PREFIX_LENGTH
  zone: ZONE_NAME
  propagationStrategy: SingleZone
  type: Branch
  parentReference:
    name: PARENT_SUBNET_NAME
    namespace: ORG_NAME
EOF

    次のように置き換えます。

    • GLOBAL_API_SERVER_KUBECONFIG: グローバル API サーバーの kubeconfig ファイルへのパス。詳細については、グローバル API サーバー リソースをご覧ください。
    • SUBNET_NAME: 新しいサブネットの名前。
    • CIDR_PREFIX_LENGTH: 動的に割り当てられる新しいサブネットの CIDR プレフィックス長（20 など）。CIDR を静的に設定するには、prefixLength フィールドを cidr フィールドに置き換えてから、CIDR ブロック（10.0.10.0/27 など）を設定します。
    • ZONE_NAME: サブネットを割り当てるゾーン（zone1 など）。
    • PARENT_SUBNET_NAME: 親サブネットの名前（default-vpc-root-cidr など）、または作成した新しいネットワーク ルート範囲のグローバル サブネット。
    • ORG_NAME: 組織の名前。

    詳細については、Subnet リソースの API リファレンス ドキュメントをご覧ください。

  4. ステータス Ready タイプが true であることを確認して、サブネットがグローバル API サーバーで準備完了し、使用可能であることを確認します。

    kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG get subnet --namespace platform \
    SUBNET_NAME --output jsonpath='{.status.conditions[?(@.type=="Ready")].status}'

    出力は次のようになります。

    status:
  conditions:
  - lastTransitionTime: "2025-06-06T07:28:48Z"
    message: IP allocation finished successfully
    observedGeneration: 1
    reason: AllocationSucceeded
    status: "True"
    type: Ready

  5. ゾーン管理 API サーバーにゾーン サブネットが作成され、そのステータス Ready タイプが true であることを確認します。

    kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG get subnet --namespace platform \
    SUBNET_NAME --output jsonpath='{.status.conditions[?(@.type=="Ready")].status}'

    MANAGEMENT_API_SERVER_KUBECONFIG は、管理 API サーバーの kubeconfig ファイルのパスに置き換えます。詳細については、ゾーン管理 API サーバー リソースをご覧ください。

    出力は次のようになります。

    status:
  conditions:
  - lastTransitionTime: "2025-06-06T07:29:34Z"
    message: IP allocation finished successfully
    observedGeneration: 1
    reason: AllocationSucceeded
    status: "True"
    type: Ready

    この新しいゾーン サブネットから、ゾーンの子サブネットをさらに作成するか、内部ワークロードに個々の IP アドレスを直接割り振ることができます。

ゾーン割り当てなしでルート グローバル サブネットを分割する

グローバル サブネットをゾーンに割り当てずにさらに分割するには、グローバル サブネットを作成し、Subnet カスタム リソースで伝播戦略を省略します。この方法は、IP アドレスをゾーンに割り当てることなく、グローバル ルート サブネットからグローバルにアクセス可能な IP アドレス範囲の整理を継続する場合に便利です。

グローバル スコープ内でグローバル ルート サブネットを分割するには、platform 名前空間で次の操作を行います。

  1. ターミナル ウィンドウで、デフォルト VPC のすべてのルート サブネットを記述し、使用可能な CIDR ブロックを確認します。

    kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG describe subnets --namespace platform \
    -l ipam.gdc.goog/vpc=default-vpc,ipam.gdc.goog/usage=network-root-range

    GLOBAL_API_SERVER_KUBECONFIG は、グローバル API サーバーの kubeconfig ファイルのパスに置き換えます。詳細については、グローバル API サーバー リソースをご覧ください。ラベルは定数であり、同じままにする必要があります。

    出力は次のようになります。

    Name:         default-vpc-root-cidr
Namespace:    platform
Labels:       ipam.gdc.goog/allocation-preference=default
              ipam.gdc.goog/subnet-group=default-vpc-root-group
              ipam.gdc.goog/usage=network-root-range
              ipam.gdc.goog/vpc=default-vpc
Annotations:  <none>
API Version:  ipam.global.gdc.goog/v1
Kind:         Subnet
Metadata:
  Creation Timestamp:  2025-06-18T23:05:38Z
  Finalizers:
    global-subnet-finalizer
  Generation:        1
  Resource Version:  439434
  UID:               5ed1c51a-b5ee-473e-a185-8e065a87ae8f
Spec:
  ipv4Request:
    Cidr:                10.252.0.0/14
  Propagation Strategy:  None
  Type:                  Root
Status:
  Children Refs:
    Name:       default-vpc-zone1-root-cidr
    Namespace:  platform
    Type:       SingleSubnet
  Conditions:
    Last Transition Time:  2025-06-18T23:05:38Z
    Message:               IP allocation finished successfully
    Observed Generation:   1
    Reason:                AllocationSucceeded
    Status:                True
    Type:                  Ready
  ipv4Allocation:
    Available CIDRs:
      10.254.0.0/15
      10.253.0.0/16
    Cidr:  10.252.0.0/14
Events:    <none>

    Status.ipv4Allocation.Available CIDRs の値をメモします。これらの値は、次のステップで参照される使用可能な CIDR ブロックです。上記の出力では、CIDR 範囲 10.254.0.0/15 と 10.253.0.0/16 を使用できます。出力には、ルート サブネットの数に応じて複数のサブネットが存在する可能性があります。使用可能なすべての CIDR ブロックと、使用可能な CIDR ブロックがどのサブネットに属しているかをメモします。

  2. 前の手順で取得した最大の利用可能な CIDR ブロックと、新しいグローバル サブネットに必要な CIDR ブロックのサイズを比較します。使用可能な最大の CIDR ブロックが新しいサブネットの割り当てに十分な大きさでない場合は、続行する前に新しいネットワーク ルート範囲のグローバル サブネットを追加します。新しいサブネットの CIDR ブロックを取得する親サブネットをメモします。

    たとえば、/13 CIDR ブロックが必要なのに、使用可能な CIDR に /15 と /16 しか含まれていない場合は、新しいネットワーク ルート範囲のグローバル サブネットを作成する必要があります。/15 サブネットが必要な場合は、既存の /15 CIDR ブロックから新しいグローバル サブネットを割り当てることができます。

  3. グローバル API サーバーに新しいサブネットを作成します。

    kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG apply -f - <<EOF
apiVersion: ipam.global.gdc.goog/v1
kind: Subnet
metadata:
  labels:
    ipam.gdc.goog/vpc: default-vpc
    ipam.gdc.goog/usage: zone-network-root-range
  name: SUBNET_NAME
  namespace: platform
spec:
  ipv4Request:
    prefixLength: CIDR_PREFIX_LENGTH
  propagationStrategy: None
  type: Branch
  parentReference:
    name: PARENT_SUBNET_NAME
    namespace: ORG_NAME
EOF

    次のように置き換えます。

    • GLOBAL_API_SERVER_KUBECONFIG: グローバル API サーバーの kubeconfig ファイルへのパス。詳細については、グローバル API サーバー リソースをご覧ください。
    • SUBNET_NAME: 新しいサブネットの名前。
    • CIDR_PREFIX_LENGTH: 動的に割り当てられる新しいサブネットの CIDR プレフィックス長（20 など）。CIDR を静的に設定するには、prefixLength フィールドを cidr フィールドに置き換えてから、CIDR ブロック（10.0.10.0/27 など）を設定します。
    • PARENT_SUBNET_NAME: 親サブネットの名前（default-vpc-root-cidr など）、または作成した新しいネットワーク ルート範囲のグローバル サブネット。
    • ORG_NAME: 組織の名前。

    詳細については、グローバル Subnet リソースの API リファレンス ドキュメントをご覧ください。

  4. ステータス Ready タイプが true であることを確認して、サブネットがグローバル API サーバーで準備完了し、使用可能であることを確認します。

    kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG get subnet --namespace platform \
    SUBNET_NAME --output jsonpath='{.status.conditions[?(@.type=="Ready")].status}'

    出力は次のようになります。

    status:
  conditions:
  - lastTransitionTime: "2025-06-06T07:28:48Z"
    message: IP allocation finished successfully
    observedGeneration: 1
    reason: AllocationSucceeded
    status: "True"
    type: Ready

デフォルト VPC で組織の新しいグローバル サブネットが使用可能になります。この新しいグローバル親サブネットから特定のゾーンのサブネットを作成できます。

新しいネットワーク ルート範囲のグローバル サブネットを追加する

ipam.gdc.goog/usage: network-root-range ラベルが付いたグローバル サブネットは、ネットワークのすべてのゾーンの CIDR をホストします。CIDR が使い果たされた場合は、グローバル API サーバーに新しいネットワーク ルート範囲サブネットを作成する必要があります。必要に応じて、複数のルート グローバル サブネットを作成できます。

新しいネットワーク ルート範囲サブネットを作成する手順は次のとおりです。

  • ターミナル ウィンドウで、platform 名前空間のデフォルト VPC の新しいネットワーク ルート範囲グローバル サブネットを作成します。

    kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG apply -f - <<EOF
apiVersion: ipam.global.gdc.goog/v1
kind: Subnet
metadata:
  labels:
    ipam.gdc.goog/vpc: default-vpc
    ipam.gdc.goog/usage: network-root-range
  name: SUBNET_NAME
  namespace: platform
spec:
  ipv4Request:
    cidr: NEW_CIDR
  type: Root
EOF

    次のように置き換えます。

    • GLOBAL_API_SERVER_KUBECONFIG: グローバル API サーバーの kubeconfig ファイルへのパス。詳細については、グローバル API サーバー リソースをご覧ください。
    • SUBNET_NAME: 新しいサブネットの名前。
    • NEW_CIDR: サブネットの新しい CIDR。この CIDR は、同じグローバル API サーバー内の ipam.gdc.goog/usage: network-root-range ラベルを持つ既存のサブネットの CIDR と重複できません。

この新しいグローバル ルート範囲サブネットは、グローバル API サーバー内で分割するか、特定のゾーンに割り当てることができます。

次のステップ