Anschließen einer Cluster-Netzwerkschnittstelle an eine Instanz

Nachdem Sie eine Instanz erstellt haben, können Sie diese an ein vorhandenes Subnetz der Cluster-Netzwerkinstanz anhängen. Alternativ können Sie Ihr Netzwerk planen, indem Sie zuerst die Cluster-Netzwerkinstanzen erstellen, bevor Sie die anzuschließenden Subnetzinstanzen erstellen.

Vorbereitende Schritte

Sie können Clusternetzwerkschnittstellen mit der CLI, API oder Terraform an eine Instanz anhängen.

Anschließen einer Cluster-Netzwerkschnittstelle an eine Instanz über die CLI

Um eine Schnittstelle über die CLI an eine Instanz anzuschließen, gehen Sie wie folgt vor:

  1. Konfigurieren Sie die Umgebung der Befehlszeilenschnittstelle.

  2. Melden Sie sich über die Befehlszeilenschnittstelle 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 Schnittstelle einer Instanz zuzuordnen, geben Sie den folgenden Befehl ein:

    ibmcloud is instance-cluster-network-attachments INSTANCE --cnac CLUSTER_NETWORK_ATTACHMENT

    Dabei gilt:

    INSTANCE
    ID oder Name der Instanz.
    --output
    Ausgabeformat. Nur JSON wird unterstützt. Einer der folgenden Werte: JSON.
    -q, quiet
    Ausführliche Ausgabe unterdrücken.

Befehlsbeispiele

  • So erstellen Sie die Instanz my-ins-1 mit Clusternetzwerk-Anhängen:

    ibmcloud is instance-create my-ins-1 cli-vpc us-south-2 fx3d-160c1792x9h100 cli-subnet --image ibm-ubuntu-20-04-6-minimal-amd64-5 --cluster-network-attachments '[{"name":"instance-cnac-1","cluster_network_interface":{"id":"7208-18204195-be40-4f12-aaaa-2649e19acb91"}},{"name":"instance-cnac-2","cluster_network_interface":{"id":"7208-cf6023a3-86c7-459f-84b8-536b4f812541"}},{"name":"instance-cnac-3","cluster_network_interface":{"id":"7208-2d55d27c-835c-4566-acbc-da36bcf49da7"}},{"name":"instance-cnac-4","cluster_network_interface":{"id":"7208-161e2919-c505-4e6d-bd49-88e7e0c0f1f3"}},{"name":"instance-cnac-5","cluster_network_interface":{"id":"7208-d700a40e-af61-45ee-b71a-a09203db76bd"}},{"name":"instance-cnac-6","cluster_network_interface":{"id":"7208-c7dbc8b9-6b47-4b83-8649-512e4e8f0a81"}},{"name":"instance-cnac-7","cluster_network_interface":{"id":"7208-f4773e40-49b5-4d44-8c68-7a75513bbf16"}},{"name":"instance-cnac-8","cluster_network_interface":{"id":"7208-46e097b5-c1ea-4669-aafd-7a4cc82d0e02"}}]'

  • So erstellen Sie eine Instanz my-ins-2 mit einer JSON-Datei für Clusternetzwerkanhänge:

    ibmcloud is instance-create my-ins-2 deceiving-strode-dimly-undesirable us-south-2 hx3d-160x1002x8h100 test-subnet --image ibm-ubuntu-20-04-6-minimal-amd64-5 --cluster-network-attachments @~/cnac.json

Anschließen einer Cluster-Netzwerkschnittstelle an eine Instanz mit der API

Um eine Cluster-Netzwerkschnittstelle mithilfe der API an eine Instanz anzuschließen, führen Sie die folgenden Schritte aus:

  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.

  1. Wenn alle Variablen initiiert sind, geben Sie den folgenden Befehl ein, um die Clusternetzwerkschnittstelle an die Instanz anzuschließen:

    curl -X POST "$vpc_api_endpoint/v1/instances/$instance_id/cluster_network_attachments?version=$today&generation=2" -H "Authorization: Bearer $iam_token" -d '{
  "name": "my-cluster-network-attachment",
  "cluster_network_interface": {
    "id": "$cluster_network_interface_id"
  }
}'

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

Anschließen einer Cluster-Netzwerkschnittstelle an eine Instanz mit Terraform

Im folgenden Beispiel wird eine Instanzcluster-Netzwerkanbindung mithilfe von Terraform bereitgestellt:

resource "ibm_is_instance_cluster_network_attachment" "is_instance_cluster_network_attachment_instance" {
  instance = var.is_instance_cluster_network_attachment_instance_id
  before {
    # href = "https://us-south.iaas.cloud.ibm.com/v1/instances/5dd61d72-acaa-47c2-a336-3d849660d010/cluster_network_attachments/0767-fb880975-db45-4459-8548-64e3995ac213" // conflicts with id
    id = "0767-fb880975-db45-4459-8548-64e3995ac213"
  }
  cluster_network_interface {
    # id              = var.is_cluster_network_interface_id // conflicts with other properties
    auto_delete     = var.is_cluster_auto_delete
    name            = var.is_cluster_name
    subnet          = var.is_cluster_subnet_id
    primary_ip {
      address = "192.168.3.4"
      name    = "my-cluster-subnet-reserved-ip-1"
    }
  }
  name = var.is_instance_cluster_network_attachment_name
}