Vous pouvez modifier un cluster Connect pour mettre à jour des propriétés telles que le nombre de processeurs virtuels, la mémoire, le réseau et les étiquettes.
Pour modifier un cluster Connect, vous pouvez utiliser la console Google Cloud , la gcloud CLI, la bibliothèque cliente ou l'API Managed Kafka. Vous ne pouvez pas utiliser l'API Apache Kafka Open Source pour mettre à jour un cluster Connect.
Avant de commencer
Toutes les propriétés d'un cluster Connect ne sont pas modifiables. Examinez les propriétés d'un cluster Connect avant de le mettre à jour.
Rôles et autorisations nécessaires
Pour obtenir les autorisations nécessaires pour modifier un cluster Connect, demandez à votre administrateur de vous accorder le rôle IAM Éditeur de cluster Managed Kafka Connect (roles/managedkafka.connectClusterEditor) sur votre projet.
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Ce rôle prédéfini contient les autorisations requises pour modifier un cluster Connect. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Les autorisations suivantes sont requises pour modifier un cluster Connect :
-
Mettez à jour un cluster Connect :
managedkafka.connectClusters.update -
Afficher les connecteurs lorsque vous utilisez la console Google Cloud pour mettre à jour un cluster Connect :
managedkafka.connectors.list
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.
Autorisations du sous-réseau du cluster
Si vous mettez à jour le sous-réseau de nœuds de calcul d'un cluster Connect, l'agent de service Managed Kafka associe le sous-réseau lors de l'opération de mise à jour.
L'autorisation managedkafka.connectClusters.update permet indirectement à un compte principal d'associer n'importe quel sous-réseau que l'agent de service est autorisé à utiliser, même si le compte principal n'est pas directement autorisé à utiliser le sous-réseau.
Modifier un cluster Connect
La mise à jour de certaines propriétés, telles que le processeur et la mémoire, nécessite un redémarrage du cluster.
Les redémarrages de cluster préservent les données, mais peuvent augmenter la latence. Le nombre initial de nœuds de calcul dans le cluster détermine la durée du redémarrage.
Vous pouvez mettre à jour les propriétés de cluster Connect suivantes :
| Propriété | Modifiable |
|---|---|
| vCPU | Oui |
| Mémoire | Oui |
| Réseau | Oui |
| Sous-réseau de nœuds de calcul | Oui |
| Domaines DNS pouvant être résolus | Oui (ajout/suppression) |
| Nom du cluster Connect | Non |
| Cluster Kafka | Non |
| Emplacement | Non |
| Étiquettes | Oui (ajouter/modifier/supprimer) |
| Secrets | Oui (ajout/suppression) |
Console
Dans la console Google Cloud , accédez à la page Connecter des clusters.
Cliquez sur le cluster Connect que vous souhaitez mettre à jour.
La page Détails de la connexion du cluster s'affiche.
Cliquez sur Modifier.
La page Modifier le cluster Kafka Connect s'affiche.
Apportez les modifications nécessaires aux propriétés modifiables.
Cliquez sur Enregistrer.
gcloud
-
Dans la console Google Cloud , activez Cloud Shell.
En bas de la console Google Cloud , une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement de shell dans lequel la Google Cloud CLI est déjà installée, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.
Exécutez la commande
gcloud managed-kafka connect-clusters update:gcloud managed-kafka connect-clusters update CONNECT_CLUSTER_ID \ --location=LOCATION \ [--cpu=CPU --memory=MEMORY | --clear-dns-names \ | --dns-name=DNS_NAME --clear-labels \ | --labels=LABELS --clear-secrets \ | --secret=SECRET [--primary-subnet=WORKER_SUBNET \ [--async]Remplacez les éléments suivants :
- CONNECT_CLUSTER_ID : ID ou nom du cluster Connect. Le nom d'un cluster Connect est immuable.
- LOCATION : emplacement du cluster Connect. L'emplacement d'un cluster Connect est immuable.
- CPU : nombre de processeurs virtuels pour le cluster Connect. La valeur minimale est de 3 vCPU.
- MEMORY : quantité de mémoire pour le cluster Connect. Utilisez les unités "Mo", "Mio", "Go", "Gio", "To" ou "Tio". Par exemple, "10GiB". Vous devez provisionner entre 1 Gio et 8 Gio par vCPU.
- DNS_NAME : nom de domaine DNS du réseau du sous-réseau à rendre visible pour le cluster Connect.
- LABELS : (facultatif) étiquettes à associer au cluster. Pour en savoir plus sur le format des libellés, consultez Libellés. Liste de paires "KEY=VALUE" (clé/valeur) de libellés à ajouter. Les clés doivent commencer par une lettre minuscule et ne contenir que des tirets (-), des traits de soulignement (_), des minuscules et des chiffres. Les valeurs ne doivent contenir que des tirets (-), des traits de soulignement (_), des minuscules et des chiffres.
- SECRET : (facultatif) secrets à charger dans les nœuds de calcul.
Vous devez fournir les versions exactes des secrets de Secret Manager. Les alias ne sont pas acceptés. Vous pouvez charger jusqu'à 32 secrets dans un cluster. Format :
projects/PROJECT_ID/secrets/SECRET_NAME/versions/VERSION_ID WORKER_SUBNET : sous-réseau de nœuds de calcul pour le cluster Connect. Le sous-réseau de nœuds de calcul doit se trouver dans la même région que le cluster Connect.
Le format du sous-réseau est
projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_ID.
Go
Avant d'essayer cet exemple, suivez les instructions de configuration pour Go dans Installer les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Go Managed Service pour Apache Kafka.
Pour vous authentifier auprès de Managed Service pour Apache Kafka, configurez les Identifiants par défaut de l'application (ADC). Pour en savoir plus, consultez Configurer les ADC pour un environnement de développement local.
Java
Avant d'essayer cet exemple, suivez les instructions de configuration pour Java décrites dans Installer les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Java Managed Service pour Apache Kafka.
Pour vous authentifier auprès de Managed Service pour Apache Kafka, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer les ADC pour un environnement de développement local.
Python
Avant d'essayer cet exemple, suivez les instructions de configuration pour Python dans Installer les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Python de Managed Service pour Apache Kafka.
Pour vous authentifier auprès de Managed Service pour Apache Kafka, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer les ADC pour un environnement de développement local.