IBM Cloud Docs
Erstellen eines Clusternetzwerk-Subnetzes

Erstellen eines Clusternetzwerk-Subnetzes

Ein Clusternetz-Subnetz ist ein Subnetz innerhalb eines Clusternetzes. Es ähnelt zwar einem VPC-Subnetz, bietet aber weniger Funktionen. Sie können jedoch den CIDR des Subnetzes definieren und reservierte IPs für das Subnetz des Clusternetzwerks konfigurieren. Diese reservierten IPs enthalten von Ihnen festgelegte Adressen und verfügen über eine automatische Löschfunktion, die der Funktion der reservierten IPs für VPC-Subnetze ähnelt.

Vorbereitende Schritte

Überprüfen Sie Planungsüberlegungen und bekannte Probleme.

Sie können ein Clusternetzwerk-Subnetz mit der Konsole, CLI, API oder Terraform erstellen.

Erstellen eines Clusternetzwerk-Subnetzes in der Konsole

Gehen Sie folgendermaßen vor, um in der Konsole ein Subnetz innerhalb eines Netzwerk-Clusters zu erstellen:

  1. Öffnen Sie in Ihrem Browser die Konsole IBM Cloud 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 ein Subnetz erstellen möchten. Die Seite Übersicht wird angezeigt.

  4. Klicken Sie auf die Registerkarte Teilnetze, um die Tabelle der Teilnetze des Clusternetzwerks anzuzeigen, und klicken Sie dann auf Erstellen +.

  5. Füllen Sie die Informationen im Seitenbereich Subnetz erstellen aus, und klicken Sie dann auf Erstellen.

    • Geben Sie einen Subnetznamen ein.
    • Überprüfen Sie das Adresspräfix. Bei Bedarf ändern.
    • Wählen Sie die Anzahl der gesamten IP-Adressen (Standard ist 256).
    • Überprüfen Sie den angegebenen IP-Bereich. Bei Bedarf ändern.
    • Überprüfen Sie den angegebenen Adressraum. Passen Sie den IP-Bereich nach Bedarf an.

Das Subnetz des Clusternetzwerks wird zur Verwendung angefordert.

Erstellen eines Clusternetzwerk-Subnetzes mit der CLI

Führen Sie die folgenden Schritte aus, um in der Befehlszeilenschnittstelle ein Clusternetzwerk-Subnetz zu erstellen:

  1. Konfigurieren Sie die Umgebung der Befehlszeilenschnittstelle.

  2. Melden Sie sich über die CLI bei Ihrem Konto an. Nachdem Sie das Kennwort eingegeben haben, fordert das System Sie auf, das Konto und die Region anzugeben, die Sie verwenden möchten:

    ibmcloud login --sso
    
  3. Um ein Clusternetzwerk-Subnetz zu erstellen, geben Sie den folgenden Befehl ein:

    ibmcloud is cluster-network-subnet-create CLUSTER_NETWORK (--total-ipv4-address-count TOTAL_IPV4_ADDRESS_COUNT | --ipv4-cidr-block IPV4_CIDR_BLOCK) [--name NAME] [--ip-version IP_VERSION] [--output JSON] [-q, --quiet]
    

    Dabei gilt:

    CLUSTER_NETWORK
    ID oder Name für das Clusternetz.
    --total-ipv4-address-count
    Die Gesamtzahl der erforderlichen IPv4-Adressen. Muss eine Potenz von 2 sein.
    --ipv4-cidr-block
    Der IPv4-Bereich des Clusternetz-Teilnetzes, ausgedrückt im CIDR-Format.
    --name
    Der Name für dieses Clusternetz-Teilnetz.
    --output
    Ausgabeformat. Nur JSON wird unterstützt. Einer der folgenden Werte: JSON.
    -q, --quiet
    Ausführliche Ausgabe unterdrücken.

Befehlsbeispiel

So erstellen Sie ein Clusternetz-Subnetz mit dem Namen cli-cn-sub-1 für das Clusternetz cli-cn-1:

ibmcloud is cluster-network-subnet-create cli-cn-1 --name cli-cn-sub-1 --total-ipv4-address-count 32

Erstellen eines Clusternetzwerk-Subnetzes mit der API

Führen Sie die folgenden Schritte aus, um ein Clusternetzwerk-Subnetz mit der API zu erstellen:

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

  2. Speichern Sie weitere Variablen; die in den API-Befehlen verwendet werden sollen. 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 das Subnetz des Clusters zu erstellen:

    curl -X POST "$vpc_api_endpoint/v1/cluster_networks/$cluster_network_id/subnets?version=$today&generation=2" -H "Authorization: Bearer $iam_token" -d '{
          "name": "my-cluster-network-subnet",
          "total_ipv4_address_count": 2048
        }'
    

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

Erstellen eines Clusternetzwerk-Subnetzes mit Terraform

Im folgenden Beispiel wird ein Clusternetzwerk-Subnetz mithilfe von Terraform eingerichtet:

resource "ibm_is_cluster_network_subnet" "is_cluster_network_subnet_instance" {
  cluster_network_id        = var.is_cluster_network_subnet_cluster_network_id
  ip_version                = var.is_cluster_network_subnet_ip_version
  name                      = var.is_cluster_network_subnet_name
  total_ipv4_address_count  = var.is_cluster_network_subnet_total_ipv4_address_count
  // ipv4_cidr_block = var.is_cluster_network_subnet_ipv4_cidr_block #conflicts with total_ipv4_address_count
}