Documentation Oracle Cloud Infrastructure

Mise à jour d'un cluster

Mettez à jour les détails d'un cluster dans Streaming avec Apache Kafka.

Vous pouvez apporter les modifications suivantes à un cluster :

  • mettre à jour le nom et la description,
  • Ajouter ou retirer des brokers
  • Mettre à jour le certificat mTLS
Important

Mise à jour de sous-réseaux à l'aide de l'API et de l'interface de ligne de commande
Lorsqu'un cluster utilise plusieurs sous-réseaux, vous pouvez les mettre à jour via l'API et l'interface de ligne de commande avec les exigences suivantes :
  • Réseaux cloud virtuels uniques et même région : chaque sous-réseau doit se trouver dans un VCN différent. La fourniture de plusieurs sous-réseaux à partir du même VCN entraîne une erreur. De plus, tous les réseaux cloud virtuels doivent se trouver dans la même région.
  • Nombre suffisant d'adresses IP disponibles : chaque sous-réseau doit disposer d'un nombre suffisant d'adresses IP libres. Par exemple, un cluster à 3 brokers nécessite au moins 4 adresses IP disponibles.
  • Comportement de mise à jour important : la mise à jour des sous-réseaux d'un cluster est une opération de remplacement complet. La liste que vous fournissez remplace l'ensemble de la configuration existante. Incluez tous les sous-réseaux existants que vous souhaitez conserver.
  • Ajoutez les stratégies requises pour tous les sous-réseaux : par exemple, si la liste de sous-réseaux inclut subnet1 et subnet2, et que subnet1 se trouve dans le compartiment A et que subnet2 se trouve dans le compartiment B, assurez-vous que Streaming avec le service Apache Kafka dispose également des droits d'accès nécessaires pour créer des adresses privées dans le compartiment B (et pas uniquement dans le compartiment A). Reportez-vous aux stratégies suivantes.
Remarque

Accès inter-location

La diffusion en continu avec Apache Kafka prend en charge l'accès inter-locations. Reportez-vous à Stratégies d'accès inter-location.

Les stratégies suivantes doivent être incluses pour tous les compartiments de sous-réseau :

allow service rawfka to use vnics in compartment <compartment-name>
                
allow service rawfka to {SUBNET_READ} in compartment <compartment-name>
                
allow service rawfka to use network-security-groups 
in compartment <compartment>
                
allow service rawfka to use subnets in compartment <compartment-name>

Pour toutes les stratégies requises, reportez-vous à Stratégies IAM requises.

    1. Sur la page de liste Clusters Kafka, recherchez le cluster avec lequel vous voulez travailler. Si vous avez besoin d'aide pour trouver la page de liste ou le cluster, reportez-vous à Liste des clusters.
    2. Dans le menu Actions (trois points) du cluster, sélectionnez Modifier le cluster.
    3. (Facultatif) Mettez à jour le nom, ou la description.
    4. (Facultatif) Mettez à jour le nombre de brokers ou d'OCPU par broker.
    5. (Facultatif) Mettez à jour le certificat mTLS.
    6. Sélectionnez Mettre à jour.

  • Utilisez la commande cluster update et les paramètres requis pour mettre à jour un cluster :

    oci kafka cluster update --kafka-cluster-id <kafka- cluster-ocid>

    Si vous disposez de plusieurs sous-réseaux, incluez tous les OCID de sous-réseaux dans la commande cluster update. Par exemple, pour deux sous-réseaux, exécutez la commande suivante :

    oci kafka cluster update --kafka-cluster-id <kafka-cluster-ocid> 
--access-subnets [ { "subnets": [ "<subnet-1-ocid>", "<subnet-2-ocid>"] } ]

    Afin d'obtenir la liste complète des indicateurs et des options de variable pour les commandes d'interface de ligne de commande, reportez-vous à Référence de commande d'interface de ligne de commande.

  • Exécutez l'opération UpdateKafkaCluster pour mettre à jour un cluster.