Creazione di un'interfaccia di rete cluster

Un'interfaccia di rete cluster è una scheda di rete virtuale che collega l'istanza a una sottorete di rete cluster. È possibile creare un'interfaccia di rete cluster sia durante la creazione di una rete cluster, sia dopo che la rete è stata configurata.

Prima di iniziare

È possibile creare un'interfaccia di rete del cluster tramite console, CLI, API o Terraform.

Creazione di un'interfaccia di rete del cluster nella console

Per creare un'interfaccia di rete cluster nella console, procedere come segue:

  1. Dal browser, apri la console IBM Cloud ed effettua l'accesso al tuo account.

  2. Selezionare l' icona del menu di navigazione, quindi fare clic sull'icona Infrastruttura VPC > Rete > Reti cluster.

  3. Nella pagina Reti cluster per VPC, fare clic sul link del nome della rete cluster in cui si desidera creare un'interfaccia. Viene visualizzata la pagina Panoramica.

  4. Fare clic sulla scheda Interfacce per visualizzare la tabella Interfacce di rete del cluster, quindi fare clic su Crea.

  5. Nel pannello laterale dell'interfaccia Crea, inserisci le seguenti informazioni:

    • Inserire il nome di un'interfaccia.

    • Selezionare la sottorete della rete del cluster.

      Viene selezionato automaticamente un indirizzo IP primario, che potrà essere visualizzato dopo la creazione.

  6. Fai clic su Crea. Viene richiesto l'uso dell'interfaccia di rete del cluster.

Creazione di un'interfaccia di rete cluster dalla CLI

Per creare un'interfaccia di rete cluster dalla CLI, procedere come segue:

  1. Configurare l'ambiente CLI.

  2. Accedi al tuo account tramite la CLI. Dopo aver inserito la password, il sistema richiede l'account e la regione:

    ibmcloud login --sso
    
  3. Per creare un'interfaccia di rete del cluster, inserire il seguente comando:

    ibmcloud is cluster-network-interface-create CLUSTER_NETWORK (--rip RIP | (--rip-address RIP_ADDRESS --rip-auto-delete true | false --rip-name RIP_NAME)) [--subnet SUBNET] [--vpc VPC] [--name NAME] [--output JSON] [-q, --quiet]
    

    Dove:

    CLUSTER_NETWORK
    ID o nome della rete cluster.
    --rip
    ID o nome dell'indirizzo IP riservato a cui associare l'indirizzo IP primario all'interfaccia di rete del cluster.
    --rip-address
    L'indirizzo IP dell'IP riservato da associare all'interfaccia di rete cluster, che non deve essere già riservato nella sottorete.
    --rip-auto-delete
    Indica se questo membro con IP riservato della sottorete di rete del cluster viene eliminato automaticamente quando viene eliminato uno dei due elementi di destinazione oppure quando l'IP riservato della sottorete di rete del cluster viene slegato. Uno dei seguenti: true, false (impostazione predefinita: true).
    --rip-name
    Il nome di questo IP riservato alla sottorete della rete cluster.
    --subnet
    ID o nome della sottorete.
    --vpc
    ID o nome del VPC. È sufficiente specificare la risorsa univoca per nome all’interno di questa VPC.
    --name
    Nome dell'interfaccia di rete del cluster.
    --output
    Specifica il formato di output, è supportato solo JSON. Uno tra: JSON.
    -q, --quiet
    Sopprimi l'output dettagliato.

Esempi di comando

  • Per creare un'interfaccia di rete cluster con IP riservato:

    ibmcloud is cluster-network-interface-create my-cluster-network --name my-cluster-network-interface --subnet my-cluster-network-subnet --rip-name my-cluster-network-interface-reserved-ip
    
  • Per creare un'interfaccia di rete cluster utilizzando un IP riservato da una sottorete di rete cluster esistente:

    ibmcloud is cluster-network-interface-create my-cluster-network --name my-cluster-network-interface --rip my-cluster-network-interface-reserved-ip
    

Creare un'interfaccia di rete del cluster con l'API

Per creare un'interfaccia di rete del cluster con l'API, procedere come segue:

  1. Impostare l'ambiente API con le giuste variabili.

  2. Memorizza eventuali variabili aggiuntive da utilizzare nei comandi API. Ad esempio:

    version (stringa): La versione dell'API, nel formato YYYY-MM-DD.

  3. Quando tutte le variabili sono inizializzate, eseguire il seguente comando per creare un'interfaccia di rete del cluster:

    curl -X POST "$vpc_api_endpoint/v1/cluster_networks/$cluster_network_id/interfaces?version=$today&generation=2" -H "Authorization: Bearer $iam_token" -d '{
          "name": "my-cluster-network-interface",
          "subnet": {
              "id": "0767-7931845c-65c4-4b0a-80cd-7d9c1a6d7930"
          }
        }'
    

Per visualizzare l'insieme completo delle API di rete del cluster, consultare il riferimento API VPC.

Creare un'interfaccia di rete del cluster con Terraform

L'esempio seguente prevede un'interfaccia di rete del cluster utilizzando Terraform:

resource "ibm_is_cluster_network_interface" "is_cluster_network_interface_instance" {
  cluster_network_id            = var.is_cluster_network_interface_cluster_network_id
  name                          = var.is_cluster_network_interface_name
  primary_ip {
    address = "10.1.0.6"
    name    = "my-cluster-network-subnet-reserved-ip"
  }
  subnet = "0767-7931845c-65c4-4b0a-80cd-7d9c1a6d7930"
}

Passi successivi

Per creare istanze di server virtuali e collegarle alle interfacce nella rete del cluster, vedere Creazione di istanze di server virtuali e Collegamento di un'interfaccia di rete del cluster a un'istanza.