Création d'une interface réseau de cluster

Une interface réseau de cluster est une carte réseau virtuelle qui connecte votre instance à un sous-réseau de cluster. Vous pouvez créer une interface réseau de cluster soit lors de la création d'un réseau de cluster, soit après le provisionnement du réseau.

Avant de commencer

Vous pouvez créer une interface réseau de cluster à l'aide de la console, de l'interface de programmation, de l'API ou de Terraform.

Création d'une interface réseau de cluster dans la console

Pour créer une interface réseau de cluster dans la console, procédez comme suit :

  1. Dans votre navigateur, ouvrez la console IBM Cloud et connectez-vous à votre compte.

  2. Sélectionnez l' icône du menu Navigation, puis cliquez sur l'icône Infrastructure VPC > Réseau > Réseaux de cluster.

  3. Sur la page Réseaux de clusters pour VPC, cliquez sur le lien du nom du réseau de clusters dans lequel vous souhaitez créer une interface. La page Présentation s'affiche.

  4. Cliquez sur l'onglet Interfaces pour afficher le tableau Interfaces réseau du cluster, puis cliquez sur Créer.

  5. Dans le panneau latéral de l'interface Créer, renseignez les informations suivantes :

    • Entrez un nom d'interface.

    • Sélectionnez le sous-réseau du réseau du cluster.

      Une adresse IP principale est attribuée automatiquement et peut être consultée une fois la création terminée.

  6. Cliquez sur Créer. L'interface réseau du cluster est demandée pour utilisation.

Création d'une interface réseau en cluster à partir de l'interface CLI

Pour créer une interface réseau de cluster à partir de l'interface CLI, procédez comme suit :

  1. Configurez votre environnement d'interface de ligne de commande.

  2. Connectez-vous à votre compte via l'interface CLI. Après avoir saisi le mot de passe, le système vous demande le compte et la région :

    ibmcloud login --sso
    
  3. Pour créer une interface réseau de cluster, entrez la commande suivante :

    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]
    

    Où :

    CLUSTER_NETWORK
    ID ou nom du réseau de cluster.
    --rip
    Identifiant ou nom de l'adresse IP réservée permettant d'associer l'adresse IP principale à l'interface réseau du cluster.
    --rip-address
    L'adresse IP de l'adresse IP réservée à lier à l'interface réseau du cluster, qui ne doit pas déjà être réservée sur le sous-réseau.
    --rip-auto-delete
    Indique si cet élément « IP réservée du sous-réseau du réseau de cluster » est automatiquement supprimé lorsque l'une ou l'autre des cibles est supprimée, ou lorsque l'IP réservée du sous-réseau du réseau de cluster est déliée. L'un des éléments suivants : true, false (par défaut : true).
    --rip-name
    Le nom de cette adresse IP réservée au sous-réseau de ce cluster.
    --subnet
    ID ou nom du sous-réseau.
    --vpc
    ID ou nom du cloud privé virtuel. Il est requis uniquement pour spécifier la ressource unique à l'aide de son nom dans ce cloud privé virtuel.
    --name
    Nom de l'interface réseau du cluster.
    --output
    Spécifiez le format de sortie, seul JSON est pris en charge. Un parmi : JSON.
    -q, --quiet
    Supprimer la sortie prolixe.

Exemples de commande

  • Pour créer une interface réseau en cluster avec une adresse IP réservée :

    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
    
  • Pour créer une interface réseau de cluster à l'aide d'une adresse IP réservée provenant d'un sous-réseau de cluster existant :

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

Création d'une interface réseau de cluster avec l'API

Pour créer une interface réseau de cluster avec l'API, procédez comme suit :

  1. Configurez votre environnement d'API avec les variables appropriées.

  2. Stockez toutes les variables supplémentaires à utiliser dans les commandes de l'API. Exemple :

    version (chaîne): La version de l'API, au format YYYY-MM-DD.

  3. Lorsque toutes les variables sont initialisées, exécutez la commande suivante pour créer une interface réseau de 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"
          }
        }'
    

Pour consulter l'ensemble des API de réseaux de clusters, voir la référence API VPC.

Création d'une interface réseau de cluster avec Terraform

L'exemple suivant prévoit une interface réseau de cluster à l'aide de 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"
}

Etapes suivantes

Pour créer des instances de serveur virtuel et les associer à des interfaces dans votre réseau de cluster, consultez Création d'instances de serveur virtuel et Association d'une interface réseau de cluster à une instance.