Erstellen einer Cluster-Netzwerkschnittstelle

Eine Cluster-Netzwerkschnittstelle ist eine virtuelle Netzwerkkarte, die Ihre Instanz mit einem Cluster-Netzwerk-Subnetz verbindet. Sie können eine Cluster-Netzwerkschnittstelle entweder während der Erstellung eines Cluster-Netzwerks oder nach der Bereitstellung des Netzwerks erstellen.

Vorbereitende Schritte

Sie können eine Cluster-Netzwerkschnittstelle über die Konsole, CLI, API oder Terraform erstellen.

Erstellen einer Clusternetzwerkschnittstelle in der Konsole

Um eine Cluster-Netzwerkschnittstelle in der Konsole zu erstellen, führen Sie die folgenden Schritte aus:

  1. Öffnen Sie in Ihrem Browser die „ IBM Cloud “-Konsole und melden Sie sich bei Ihrem Konto an.

  2. Wählen Sie das Menüsymbol des Navigationsmenüs aus und klicken Sie dann auf das Symbol Infrastruktur- VPC > Netzwerk > Clusternetzwerke.

  3. Klicken Sie auf der Seite Cluster-Netzwerke für VPC auf den Link des Clusternetzwerks, für das Sie eine Schnittstelle erstellen möchten. Die Übersichtsseite wird angezeigt.

  4. Klicken Sie auf die Registerkarte „Schnittstellen“, um die Tabelle „Cluster-Netzwerkschnittstellen“ anzuzeigen, und klicken Sie dann auf „ Erstellen “.

  5. Geben Sie im Seitenbereich „Erstellen“ die folgenden Informationen ein:

    • Geben Sie einen Schnittstellennamen ein.

    • Wählen Sie das Subnetz des Cluster-Netzwerks aus.

      Eine primäre IP-Adresse wird für Sie ausgewählt und kann nach der Erstellung eingesehen werden.

  6. Klicken Sie auf Erstellen. Die Netzwerkschnittstelle des Clusters wird zur Verwendung angefordert.

Erstellen einer Cluster-Netzwerkschnittstelle über die CLI

Um eine Cluster-Netzwerkschnittstelle über die CLI zu erstellen, gehen Sie wie folgt vor:

  1. Konfigurieren Sie die Umgebung der Befehlszeilenschnittstelle.

  2. Melden Sie sich über die CLI bei Ihrem Konto an. Nachdem Sie das Passwort eingegeben haben, fordert das System Sie zur Eingabe des Kontos und der Region auf:

    ibmcloud login --sso
    
  3. Um eine Cluster-Netzwerkschnittstelle zu erstellen, geben Sie den folgenden Befehl ein:

    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]
    

    Dabei gilt:

    CLUSTER_NETWORK
    ID oder Name für das Clusternetz.
    --rip
    ID oder Name der reservierten IP-Adresse, um die primäre IP-Adresse an die Netzwerk-Schnittstelle des Clusters zu binden.
    --rip-address
    Die IP-Adresse der reservierten IP zur Bindung an die Clusternetzschnittstelle, die jedoch im Teilnetz noch nicht reserviert sein darf.
    --rip-auto-delete
    Gibt an, ob dieses Mitglied des für das Cluster-Netzwerk-Subnetz reservierten IP-Bereichs automatisch gelöscht wird, wenn eines der beiden Ziele gelöscht wird oder die für das Cluster-Netzwerk-Subnetz reservierte IP-Adresse freigegeben wird. Eines von: true, false (Standard: true).
    --rip-name
    Der Name dieses für das Cluster-Netzwerk reservierten IP-Subnetzes.
    --subnet
    ID oder Name für das Teilnetz.
    --vpc
    ID oder Name der VPC. Die eindeutige Ressource muss nur innerhalb dieser VPC nach Name angegeben werden.
    --name
    Name der Netzwerk-Schnittstelle des Clusters.
    --output
    Ausgabeformat. Nur JSON wird unterstützt. Einer der folgenden Werte: JSON.
    -q, --quiet
    Ausführliche Ausgabe unterdrücken.

Befehlsbeispiele

  • So erstellen Sie eine Cluster-Netzwerkschnittstelle mit reservierter IP-Adresse:

    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
    
  • So erstellen Sie eine Cluster-Netzwerkschnittstelle unter Verwendung einer reservierten IP-Adresse aus einem vorhandenen Cluster-Netzwerk-Subnetz:

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

Erstellen einer Clusternetzwerkschnittstelle mit der API

Gehen Sie folgendermaßen vor, um eine Clusternetzwerkschnittstelle mit der API zu erstellen:

  1. Richten Sie Ihre API-Umgebung mit den richtigen Variablen ein.

  2. Speichern Sie alle zusätzlichen Variablen, die in den API-Befehlen verwendet werden. Zum Beispiel:

    version (Zeichenkette): Die API-Version, im Format YYYY-MM-DD.

  3. Wenn alle Variablen initiiert sind, führen Sie den folgenden Befehl aus, um eine Clusternetzwerkschnittstelle zu erstellen:

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

Den vollständigen Satz von Cluster-Netzwerk-APIs finden Sie in der VPC-API-Referenz.

Erstellen einer Cluster-Netzwerkschnittstelle mit Terraform

Im folgenden Beispiel wird eine Cluster-Netzwerkschnittstelle mithilfe von Terraform eingerichtet:

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

Nächste Schritte

Informationen zum Erstellen virtueller Serverinstanzen und zum Anhängen dieser Instanzen an Schnittstellen in Ihrem Clusternetzwerk finden Sie unter Erstellen virtueller Serverinstanzen und Anhängen einer Clusternetzwerkschnittstelle an eine Instanz.