Creazione di intervalli di indirizzi pubblici IPv6 e associazione a un VNI (beta)

Gli intervalli di indirizzi IPv6 pubblici sono una funzionalità in versione beta disponibile a scopo di valutazione e test per alcuni clienti selezionati. L'accesso è limitato agli account presenti nell'elenco delle autorizzazioni.

È possibile creare un intervallo di indirizzi pubblici IPv6 a partire da un CIDR autorizzato IPv6 e associarlo a un'interfaccia di rete virtuale (VNI). Dopo il binding, il traffico destinato a qualsiasi indirizzo IP compreso nell'intervallo viene instradato automaticamente al VNI.

È possibile creare e associare intervalli di indirizzi pubblici IPv6 tramite la console, la CLI, l'API e Terraform.

Prima di iniziare

  • Nella zona di destinazione deve essere presente un CIDR autorizzato per l' IPv6. Vedi Creazione di CIDR autorizzati per l' IPv6.
  • Un VNI deve trovarsi nella stessa zona del CIDR autorizzato.
  • Assicurati di disporre delle autorizzazioni per l'azione IAM is.public-address-range-authorized-cidr.authorized-cidr.create e per la creazione e l'aggiornamento dell'intervallo di indirizzi pubblici standard.
  • Esamina le considerazioni relative alla pianificazione degli intervalli di indirizzi pubblici IPv6.

Dopo aver associato un intervallo di indirizzi pubblici a un VNI, l'intervallo rimane assegnato dal CIDR autorizzato anche quando l'associazione viene rimossa. L'eliminazione dell'intervallo restituisce lo spazio di indirizzi al CIDR autorizzato.

Creazione di un intervallo di indirizzi pubblici IPv6 nella console

Per creare un intervallo di indirizzi pubblici IPv6 nella console IBM Cloud, procedere come segue:

  1. Dalla console IBM Cloud, selezionare l' icona del menu di navigazione, quindi fare clic sull'icona VPC dell'infrastruttura > Rete > Intervalli di indirizzi pubblici.
  2. Fare clic su Crea nella scheda Intervalli di indirizzi pubblici oppure fare clic su Crea intervallo di indirizzi pubblici dal menu Azioni (icona accanto a un CIDR autorizzato nella scheda CIDR autorizzati IPv6.
  3. Per la versione IP, selezionare IPv6.
  4. Selezionare la posizione in cui si desidera creare l'intervallo di indirizzi pubblici.
  5. Nella sezione Dettagli, compilare i seguenti campi:
    • Nome: inserire un nome per l'intervallo di indirizzi pubblici oppure lasciare il campo vuoto per generare automaticamente un nome dopo la creazione.
    • Gruppo di risorse: selezionare un gruppo di risorse.
    • Tag: Facoltativo: aggiungi dei tag per organizzare al meglio le tue risorse.
    • CIDR autorizzato: selezionare il CIDR IPv6 autorizzato da cui effettuare l'assegnazione. Se non esiste alcun CIDR autorizzato per la zona selezionata, il campo mostra il messaggio Nessun CIDR disponibile e il resto del modulo risulta disabilitato. Fare clic su Crea CIDR autorizzato per aprire il pannello di creazione del CIDR autorizzato senza uscire da questa procedura. Una volta creato il CIDR autorizzato, il campo CIDR autorizzato viene automaticamente compilato con il nuovo CIDR e il modulo viene riattivato. A questo punto è possibile compilare i campi rimanenti e fare clic su Crea.
    • Metodo di prenotazione: selezionare la modalità di assegnazione dell'intervallo di indirizzi IP:
      • Seleziona un intervallo per me: IBM seleziona un blocco disponibile della dimensione specificata dal CIDR autorizzato. Selezionare la dimensione (lunghezza del prefisso) tra le seguenti opzioni: /128 (1 indirizzo), /127 (2 indirizzi), /126 (4 indirizzi), /120 (256 indirizzi), /112 (65.536 indirizzi), /96 (oltre 4 miliardi di indirizzi) o /64 (CIDR completo autorizzato).
      • Preciso: inserire un blocco CIDR specifico nel campo Intervallo di indirizzi IP. Il blocco deve rientrare nello spazio di indirizzamento disponibile del CIDR autorizzato selezionato.
  6. Facoltativo: nella sezione Binding, selezionare un'interfaccia di rete virtuale a cui associare immediatamente l'intervallo. È inoltre possibile definire l'intervallo in un secondo momento, dopo la creazione.
  7. Fai clic su Crea.

L'intervallo viene creato e visualizzato nell'elenco degli intervalli di indirizzi pubblici insieme agli eventuali intervalli IPv4 esistenti. Gli intervalli IPv6 sono identificati dal proprio CIDR IPv6 nella colonna Intervallo IP e riportano il VNI nella colonna Tipo di destinazione. Se è stato selezionato un VNI, lo stato risulta Bound. Se non è stato selezionato un VNI, lo stato risulta Unbound.

Creazione di un intervallo di indirizzi pubblici IPv6 dalla CLI

Per creare un intervallo di indirizzi pubblici IPv6 dalla riga di comando, procedere come segue:

  1. Configura il tuo ambiente CLI.

  2. Accedi al tuo ambiente CLI:

    ibmcloud login --sso
    
  3. Eseguire uno dei seguenti comandi:

    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]
    

    Dove:

    --authorized-cidr
    L'ID o il nome del CIDR autorizzato per l' IPv6 da cui allocare questo intervallo di indirizzi pubblici. IBM seleziona un blocco disponibile della lunghezza specificata per il prefisso. Richiede --network-prefix-length.
    --network-prefix-length
    La lunghezza del prefisso del blocco IPv6 da assegnare. Valori supportati: 64 – 128. Richiede --authorized-cidr.
    --cidr
    Un blocco CIDR IPv6 preciso da assegnare. Deve trattarsi di un blocco non assegnato all’interno di un CIDR autorizzato nel proprio account. Si esclude a vicenda con --authorized-cidr.
    --name
    Un nome per l'intervallo di indirizzi pubblici. I nomi che iniziano con ibm- sono riservati.
    --vni
    L'ID o il nome del VNI a cui associare questo intervallo. Il VNI deve trovarsi nella stessa zona del CIDR autorizzato.
    --resource-group-id
    ID del gruppo di risorse. Si esclude a vicenda con --resource-group-name.
    --resource-group-name
    Nome del gruppo di risorse. Si esclude a vicenda con --resource-group-id.

Esempi di comando

Creare un intervallo di indirizzi pubblici IPv6 a partire da un CIDR autorizzato, lasciare che IBM selezioni un blocco /112 e associarlo a un VNI:

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

Creare un intervallo di indirizzi pubblici IPv6 con un blocco CIDR specifico (unbound):

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

Creazione di un intervallo di indirizzi pubblici IPv6 tramite l'API

Prima di iniziare, configura il tuo ambiente API.

Selezionare una delle seguenti opzioni:

  • Creare un intervallo di indirizzi pubblici IPv6 a partire da un CIDR autorizzato, associato a un VNI (il blocco viene selezionato da IBM ):

    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'" }
          }
       }'
    
  • Creare un intervallo di indirizzi pubblici IPv6 a partire da un blocco CIDR specifico, senza vincoli:

    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"
       }'
    

Creazione di un intervallo di indirizzi pubblici IPv6 con Terraform

Per creare un intervallo di indirizzi pubblici IPv6 a partire da un CIDR autorizzato, associato a un VNI:

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
    }
  }
}

Associazione di un intervallo di indirizzi pubblici IPv6 a un VNI

È possibile associare un intervallo di indirizzi pubblici IPv6 esistente non ancora associato a un VNI, oppure spostare un intervallo da un VNI a un altro. Il VNI deve trovarsi nella stessa zona del CIDR autorizzato da cui è stato assegnato l'intervallo.

Non è necessario annullare prima il collegamento quando si passa a un VNI diverso. L'intervallo viene automaticamente slegato dal VNI corrente e associato a quello nuovo.

Configurazione nella console

  1. Dalla console IBM Cloud, selezionare l' icona del menu di navigazione, quindi fare clic sull'icona VPC dell'infrastruttura > Rete > Intervalli di indirizzi pubblici.
  2. Evidenziare la riga dell'intervallo di indirizzi pubblici IPv6 non associati, quindi fare clic su Assegna dal menu Azioni (icona.
  3. Nel pannello Intervallo di indirizzi pubblici Bind, i campi Intervallo IP e Posizione sono di sola lettura. Dall'elenco delle interfacce di rete virtuali ( VNI), selezionare la VNI nella stessa zona del CIDR autorizzato.
    • Se il VNI che cerchi non è presente nell'elenco, fai clic sull'icona di aggiornamento accanto all'elenco per aggiornarlo.
    • Se nella zona non è presente alcuna VNI, fare clic su Crea interfaccia di rete virtuale per crearne una. Per ulteriori informazioni, consultare la sezione Creazione di un'interfaccia di rete virtuale.
  4. Fai clic su Attach.

Una volta associato l'intervallo, la colonna Stato mostra Associato, mentre le colonne Risorsa di destinazione e Tipo di destinazione mostrano il nome VNI e il VNI.

Passaggio a un VNI diverso nella console

  1. Dalla console IBM Cloud, selezionare l' icona del menu di navigazione, quindi fare clic sull'icona VPC dell'infrastruttura > Rete > Intervalli di indirizzi pubblici.
  2. Evidenziare la riga relativa all'intervallo di indirizzi pubblici IPv6 vincolati, quindi fare clic su Modifica dal menu Azioni (icona.
  3. Nel pannello Modifica intervallo di indirizzi pubblici, selezionare un VNI diverso dall'elenco Interfaccia di rete virtuale.
  4. Fai clic su Attach.

Vincolanti dalla CLI

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

Esempio:

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

Integrazione con l'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'" }
        }
     }'

Integrazione con Terraform

Aggiorna il blocco target nella configurazione delle risorse:

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
    }
  }
}

Rimozione dei vincoli su un intervallo di indirizzi pubblici IPv6

Dopo lo slegamento, l'intervallo rimane allocato dal CIDR autorizzato e può essere nuovamente associato a qualsiasi VNI nella stessa zona.

Rimozione dei vincoli nella console

  1. Dalla console IBM Cloud, selezionare l' icona del menu di navigazione, quindi fare clic sull'icona VPC dell'infrastruttura > Rete > Intervalli di indirizzi pubblici.
  2. Evidenziare la riga relativa all'intervallo di indirizzi pubblici IPv6, quindi fare clic su Scollega dal menu Azioni (icona.
  3. Fare clic su Scollega per confermare.

Scollegamento dalla CLI

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

Disassociazione tramite l'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 }'