Erstellen öffentlicher IPv6-Adressbereiche und Zuordnung zu einem VNI (Beta)

Öffentliche IPv6-Adressbereiche sind eine Beta-Funktion, die ausgewählten Kunden zu Evaluierungs- und Testzwecken zur Verfügung steht. Der Zugriff ist auf Konten beschränkt, die auf der Whitelist stehen.

Sie können einen öffentlichen IPv6-Adressbereich aus einem autorisierten IPv6-CIDR erstellen und diesen an eine virtuelle Netzwerkschnittstelle (VNI) binden. Nach der Zuordnung wird der Datenverkehr für jede IP-Adresse in diesem Bereich automatisch an die VNI weitergeleitet.

Sie können öffentliche IPv6-Adressbereiche über die Konsole, die CLI, die API und Terraform erstellen und zuweisen.

Vorbereitende Schritte

  • In der Zielzone muss ein für IPv6 autorisierter CIDR vorhanden sein. Siehe Erstellen von IPv6-autorisierten CIDRs.
  • Ein VNI muss sich in derselben Zone befinden wie das autorisierte CIDR.
  • Stellen Sie sicher, dass Sie über die Berechtigungen zum Erstellen und Aktualisieren der IAM-Aktion is.public-address-range-authorized-cidr.authorized-cidr.create sowie des standardmäßigen öffentlichen Adressbereichs verfügen.
  • Überprüfen Sie die Planungsaspekte für öffentliche IPv6-Adressbereiche.

Nachdem ein öffentlicher Adressbereich an eine VNI gebunden wurde, bleibt der Bereich aus dem autorisierten CIDR zugewiesen, auch wenn die Bindung aufgehoben wird. Durch das Löschen des Bereichs wird der Adressraum wieder an den autorisierten CIDR freigegeben.

Erstellen eines öffentlichen IPv6-Adressbereichs in der Konsole

Um einen öffentlichen IPv6-Adressbereich in der IBM Cloud-Konsole zu erstellen, führen Sie die folgenden Schritte aus:

  1. Wählen Sie in der IBM Cloud-Konsole das Navigationsmenü-Symbol aus und klicken Sie anschließend auf das Symbol Infrastruktur VPC > Netzwerk > Öffentliche Adressbereiche.
  2. Klicken Sie auf der Registerkarte Öffentliche Adressbereiche auf Erstellen oder klicken Sie im Menü Aktionen (Aktionssymbol neben einem autorisierten CIDR auf der Registerkarte IPv6-autorisierte CIDRs auf Öffentlichen Adressbereich erstellen.
  3. Wählen Sie als **IP-Version **IPv6 aus.
  4. Wählen Sie den Standort aus, an dem Sie den öffentlichen Adressbereich erstellen möchten.
  5. Füllen Sie im Abschnitt Details die folgenden Felder aus:
    • Name: Geben Sie einen Namen für den öffentlichen Adressbereich ein oder lassen Sie das Feld leer, damit nach der Erstellung automatisch ein Name generiert wird.
    • Ressourcengruppe: Wählen Sie eine Ressourcengruppe aus.
    • Tags: Optional: Fügen Sie Tags hinzu, um Ihre Ressourcen besser zu organisieren.
    • Zugelassener CIDR: Wählen Sie den zugelassenen IPv6-CIDR aus, aus dem die Zuweisung erfolgen soll. Wenn für die ausgewählte Zone kein autorisierter CIDR vorhanden ist, wird in dem Feld Kein CIDR verfügbar angezeigt, und der Rest des Formulars ist deaktiviert. Klicken Sie auf Autorisierten CIDR erstellen, um das Fenster zur Erstellung eines autorisierten CIDR zu öffnen, ohne diesen Ablauf zu verlassen. Nachdem der autorisierte CIDR erstellt wurde, wird das Feld Autorisierter CIDR automatisch mit dem neuen CIDR ausgefüllt und das Formular wird wieder aktiviert. Anschließend können Sie die restlichen Felder ausfüllen und auf Erstellen klicken.
    • Reservierungsmethode: Wählen Sie aus, wie der IP-Bereich zugewiesen werden soll:
      • Wählen Sie einen Bereich für mich aus: IBM wählt einen verfügbaren Block der angegebenen Größe aus dem autorisierten CIDR-Bereich aus. Wählen Sie die Größe (Präfixlänge) aus den folgenden Optionen aus: /128 (1 Adresse), /127 (2 Adressen), /126 (4 Adressen), /120 (256 Adressen), /112 (65.536 Adressen), /96 (mehr als 4 Milliarden Adressen) oder /64 (voll autorisiertes CIDR).
      • Zur Verdeutlichung: Geben Sie einen bestimmten CIDR-Block in das Feld IP-Adressbereich ein. Der Block muss innerhalb des verfügbaren Adressraums des ausgewählten autorisierten CIDR liegen.
  6. Optional: Wählen Sie im Abschnitt Bindung eine virtuelle Netzwerkschnittstelle aus, an die der Bereich sofort gebunden werden soll. Sie können den Bereich auch erst nach der Erstellung zuweisen.
  7. Klicken Sie auf Erstellen.

Der Bereich wird erstellt und in der Liste der öffentlichen Adressbereiche neben bereits vorhandenen IPv4-Bereichen angezeigt. IPv6-Bereiche werden anhand ihres IPv6-CIDR in der Spalte IP-Bereich identifiziert und zeigen in der Spalte Zieltyp den VNI an. Wenn Sie eine VNI ausgewählt haben, wird als Status Gebunden angezeigt. Wenn Sie keine VNI ausgewählt haben, wird als Status Unbound angezeigt.

Erstellen eines öffentlichen IPv6-Adressbereichs über die CLI

Um einen öffentlichen IPv6-Adressbereich über die Befehlszeile zu erstellen, führen Sie die folgenden Schritte aus:

  1. Konfigurieren Sie die Umgebung der Befehlszeilenschnittstelle.

  2. Melden Sie sich bei Ihrer CLI-Umgebung an:

    ibmcloud login --sso
    
  3. Führen Sie einen der folgenden Befehle aus:

    ibmcloud is public-address-range-create
      (--authorized-cidr AUTHORIZED_CIDR --network-prefix-length NETWORK_PREFIX_LENGTH | --cidr CIDR)
      [--name NAME] [--vni VNI]
      [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME]
      [--output JSON] [-q, --quiet]
    

    Dabei gilt:

    --authorized-cidr
    Die ID oder der Name des autorisierten IPv6-CIDR, aus dem dieser öffentliche Adressbereich zugewiesen werden soll. IBM wählt einen verfügbaren Block mit der angegebenen Präfixlänge aus. Erforderlich --network-prefix-length.
    --network-prefix-length
    Die Präfixlänge des zuzuweisenden IPv6-Blocks. Unterstützte Werte: 64 – 128. Erfordert --authorized-cidr.
    --cidr
    Ein genauer IPv6-CIDR-Block, der zugewiesen werden soll. Es muss sich um einen nicht zugewiesenen Block innerhalb eines autorisierten CIDR in Ihrem Konto handeln. Schließt sich gegenseitig aus --authorized-cidr.
    --name
    Ein Name für den öffentlichen Adressbereich. Namen, die mit beginnen, ibm- sind reserviert.
    --vni
    Die ID oder der Name des VNI, an den dieser Bereich gebunden werden soll. Die VNI muss sich in derselben Zone wie die autorisierte CIDR befinden.
    --resource-group-id
    ID der Ressourcengruppe. Schließt sich gegenseitig aus --resource-group-name.
    --resource-group-name
    Name der Ressourcengruppe. Schließt sich gegenseitig aus --resource-group-id.

Befehlsbeispiele

Erstellen Sie einen öffentlichen IPv6-Adressbereich aus einem autorisierten CIDR, lassen Sie IBM einen Block /112 auswählen und binden Sie diesen an eine VNI:

ibmcloud is public-address-range-create --authorized-cidr my-ipv6-auth-cidr --network-prefix-length 112 --name my-ipv6-par --vni my-vni

Erstellen Sie einen öffentlichen IPv6-Adressbereich mit einem bestimmten CIDR-Block (unbound):

ibmcloud is public-address-range-create --cidr 2001:db8:85a3::8a2e:0:0/112 --name my-ipv6-par-specific

Erstellen eines öffentlichen IPv6-Adressbereichs mit der API

Richten Sie zunächst Ihre API-Umgebung ein, bevor Sie beginnen.

Wählen Sie eine der folgenden Optionen aus:

  • Erstellen Sie einen öffentlichen IPv6-Adressbereich aus einem autorisierten CIDR, der an eine VNI gebunden ist ( IBM wählt den Block aus):

    curl -sX POST \
    "$vpc_api_endpoint/v1/public_address_ranges?version=$api_version&generation=2" \
    -H "Authorization: Bearer $iam_token" \
    -H "Content-Type: application/json" \
    -d '{
          "name": "my-ipv6-par",
          "authorized_cidr": { "id": "'$authorized_cidr_id'" },
          "network_prefix_length": 112,
          "target": {
             "virtual_network_interface": { "id": "'$vni_id'" }
          }
       }'
    
  • Erstellen eines öffentlichen IPv6-Adressbereichs aus einem bestimmten CIDR-Block, ungebunden:

    curl -sX POST \
    "$vpc_api_endpoint/v1/public_address_ranges?version=$api_version&generation=2" \
    -H "Authorization: Bearer $iam_token" \
    -H "Content-Type: application/json" \
    -d '{
          "name": "my-ipv6-par",
          "cidr": "2001:db8:85a3::8a2e:0:0/112"
       }'
    

Erstellen eines öffentlichen IPv6-Adressbereichs mit Terraform

So erstellen Sie einen öffentlichen IPv6-Adressbereich aus einem autorisierten CIDR, der an eine VNI gebunden ist:

resource "ibm_is_public_address_range" "my_ipv6_par" {
  name                  = "my-ipv6-par"
  network_prefix_length = 112
  authorized_cidr {
    id = ibm_is_public_address_range_authorized_cidr.my_ipv6_auth_cidr.id
  }
  target {
    virtual_network_interface {
      id = ibm_is_virtual_network_interface.my_vni.id
    }
  }
}

Zuordnung eines öffentlichen IPv6-Adressbereichs zu einer VNI

Sie können einen bestehenden, noch nicht zugewiesenen öffentlichen IPv6-Adressbereich an eine VNI binden oder einen Adressbereich von einer VNI auf eine andere VNI verschieben. Die VNI muss sich in derselben Zone befinden wie der autorisierte CIDR-Bereich, aus dem der Bereich zugewiesen wurde.

Sie müssen die Bindung nicht erst aufheben, wenn Sie zu einer anderen VNI wechseln. Der Bereich wird automatisch von seiner aktuellen VNI gelöst und an die neue gebunden.

Einbindung in die Konsole

  1. Wählen Sie in der IBM Cloud-Konsole das Navigationsmenü-Symbol aus und klicken Sie anschließend auf das Symbol Infrastruktur VPC > Netzwerk > Öffentliche Adressbereiche.
  2. Markieren Sie die Zeile des nicht zugewiesenen öffentlichen IPv6 Adressbereichs und klicken Sie dann im Menü Maßnahmen Bind auf Aktionssymbol.
  3. Im Bereich Öffentliche Adressbereiche von Bind sind die Felder IP-Bereich und Standort schreibgeschützt. Wählen Sie aus der Liste der virtuellen Netzwerkschnittstellen die VNI aus, die sich in derselben Zone wie das autorisierte CIDR befindet.
    • Wenn der gewünschte VNI nicht aufgeführt ist, klicken Sie auf das Aktualisierungssymbol neben der Liste, um diese zu aktualisieren.
    • Wenn in der Zone noch keine VNI vorhanden ist, klicken Sie auf Virtuelle Netzwerkschnittstelle erstellen, um eine anzulegen. Weitere Informationen finden Sie unter Erstellen einer virtuellen Netzwerkschnittstelle.
  4. Klicken Sie auf Zuordnen.

Nachdem der Bereich gebunden wurde, wird in der Spalte Status der Wert Gebunden angezeigt, und in den Spalten Zielressource und Zieltyp werden der VNI-Name und die VNI angezeigt.

Wechsel zu einer anderen VNI in der Konsole

  1. Wählen Sie in der IBM Cloud-Konsole das Navigationsmenü-Symbol aus und klicken Sie anschließend auf das Symbol Infrastruktur VPC > Netzwerk > Öffentliche Adressbereiche.
  2. Markieren Sie die Zeile des zugewiesenen öffentlichen IPv6 Adressbereichs und klicken Sie dann im Menü Maßnahmen Bearbeiten auf Aktionssymbol.
  3. Wählen Sie im Bereich Öffentlichen Adressbereich bearbeiten eine andere VNI aus der Liste Virtuelle Netzwerkschnittstelle aus.
  4. Klicken Sie auf Zuordnen.

Einbindung über die CLI

ibmcloud is public-address-range-update PUBLIC_ADDRESS_RANGE --vni VNI [--output JSON] [-q, --quiet]

Beispiel:

ibmcloud is public-address-range-update my-ipv6-par --vni my-vni

Anbindung an die API

curl -sX PATCH \
  "$vpc_api_endpoint/v1/public_address_ranges/$par_id?version=$api_version&generation=2" \
  -H "Authorization: Bearer $iam_token" \
  -H "Content-Type: application/json" \
  -d '{
        "target": {
           "virtual_network_interface": { "id": "'$vni_id'" }
        }
     }'

Integration mit Terraform

Aktualisieren Sie den Block target in Ihrer Ressourcenkonfiguration:

resource "ibm_is_public_address_range" "my_ipv6_par" {
  name                  = "my-ipv6-par"
  network_prefix_length = 112
  authorized_cidr {
    id = ibm_is_public_address_range_authorized_cidr.my_ipv6_auth_cidr.id
  }
  target {
    virtual_network_interface {
      id = ibm_is_virtual_network_interface.my_vni.id
    }
  }
}

Aufheben der Zuordnung eines öffentlichen IPv6-Adressbereichs

Nach der Aufhebung der Zuordnung bleibt der Adressbereich weiterhin aus dem autorisierten CIDR-Bereich zugewiesen und kann erneut an eine beliebige VNI in derselben Zone gebunden werden.

Aufhebung der Verknüpfung in der Konsole

  1. Wählen Sie in der IBM Cloud-Konsole das Navigationsmenü-Symbol aus und klicken Sie anschließend auf das Symbol Infrastruktur VPC > Netzwerk > Öffentliche Adressbereiche.
  2. Markieren Sie die Zeile mit dem öffentlichen IPv6-Adressbereich und klicken Sie dann im Menü AktionenaufEntbinden.
  3. Klicken Sie auf Aufheben, um zu bestätigen.

Entkopplung von der CLI

ibmcloud is public-address-range-update my-ipv6-par --reset-target

Entkopplung über die API

curl -sX PATCH \
  "$vpc_api_endpoint/v1/public_address_ranges/$par_id?version=$api_version&generation=2" \
  -H "Authorization: Bearer $iam_token" \
  -H "Content-Type: application/json" \
  -d '{ "target": null }'