Puedes editar un clúster de Connect para actualizar propiedades como la cantidad de CPU virtuales, la memoria, la red y las etiquetas.
Para editar un clúster de Connect, puedes usar la consola de Google Cloud , la gcloud CLI, la biblioteca cliente o la API de Managed Kafka. No puedes usar la API de Apache Kafka de código abierto para actualizar un clúster de Connect.
Antes de comenzar
No todas las propiedades de un clúster de Connect se pueden editar. Revisa las propiedades de un clúster de Connect antes de actualizarlo.
Roles y permisos requeridos
Para obtener los permisos que
necesitas para editar un clúster de Connect,
pídele a tu administrador que te otorgue el rol de IAM de
editor de clústeres de Kafka Connect administrado (roles/managedkafka.connectClusterEditor) en tu proyecto.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Este rol predefinido contiene los permisos necesarios para editar un clúster de Connect. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para editar un clúster de Connect:
-
Actualiza un clúster de Connect:
managedkafka.connectClusters.update -
Visualiza los conectores cuando uses la consola de Google Cloud para actualizar un clúster de Connect:
managedkafka.connectors.list
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Permisos de la subred del clúster
Si actualizas la subred de trabajadores de un clúster de Connect, el agente de servicio de Kafka administrado adjunta la subred durante la operación de actualización.
El permiso managedkafka.connectClusters.update permite que una principal adjunte de forma indirecta cualquier subred que el agente de servicio tenga permiso para usar, incluso si la principal no tiene permiso directo para usar la subred.
Edita un clúster de Connect
Para actualizar ciertas propiedades, como la CPU y la memoria, se debe reiniciar el clúster.
Los reinicios del clúster conservan los datos, pero pueden aumentar la latencia. La cantidad inicial de trabajadores en el clúster determina la duración del reinicio.
Puedes actualizar las siguientes propiedades del clúster de Connect:
| Propiedad | Editable |
|---|---|
| CPU virtuales | Sí |
| Memoria | Sí |
| Red | Sí |
| Subred de trabajadores | Sí |
| Dominios del DNS que se pueden resolver | Sí (agregar o borrar) |
| Nombre del clúster de Connect | No |
| Clúster de Kafka | No |
| Ubicación | No |
| Etiquetas | Sí (agregar, editar y borrar) |
| Secrets | Sí (agregar o borrar) |
Console
En la consola de Google Cloud , ve a la página Conectar clústeres.
Haz clic en el clúster de Connect que quieres actualizar.
Se muestra la página Detalles de la conexión del clúster.
Haz clic en Editar.
Aparecerá la página Editar clúster de Kafka Connect.
Realiza los cambios necesarios en las propiedades editables.
Haz clic en Guardar.
gcloud
-
En la consola de Google Cloud , activa Cloud Shell.
En la parte inferior de la consola de Google Cloud , se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.
Ejecuta el comando
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]Reemplaza lo siguiente:
- CONNECT_CLUSTER_ID: Es el ID o el nombre del clúster de Connect. El nombre de un clúster de Connect es inmutable.
- LOCATION: Es la ubicación del clúster de Connect. La ubicación de un clúster de Connect es inmutable.
- CPU: Es la cantidad de CPU virtuales para el clúster de Connect. El valor mínimo es 3 CPUs virtuales.
- MEMORY: Es la cantidad de memoria para el clúster de Connect. Usa las unidades "MB", "MiB", "GB", "GiB", "TB" o "TiB". Por ejemplo, "10GiB". Debes aprovisionar entre 1 GiB y 8 GiB por CPU virtual.
- DNS_NAME: Es el nombre de dominio de DNS de la red de la subred que se hará visible para el clúster de Connect.
- LABELS: Son las etiquetas que se asociarán con el clúster (opcional). Para obtener más información sobre el formato de las etiquetas, consulta Etiquetas. Es la lista de pares CLAVE=VALOR de etiquetas que se agregarán. Las claves deben comenzar con un carácter en minúscula y contener solo guiones (-), guiones bajos (_), caracteres en minúscula y números. Los valores deben contener solo guiones (-), guiones bajos (_), caracteres en minúscula y números.
- SECRET: (Opcional) Son los secretos que se cargarán en los trabajadores.
Se deben proporcionar las versiones exactas de los secretos de Secret Manager,
ya que no se admiten alias. Se pueden cargar hasta 32 Secrets en un
clúster. Formato:
projects/PROJECT_ID/secrets/SECRET_NAME/versions/VERSION_ID WORKER_SUBNET: Es la subred de trabajador para el clúster de Connect. La subred de trabajadores debe estar en la misma región que el clúster de Connect.
El formato de la subred es
projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_ID.
Go
Antes de probar esta muestra, sigue las instrucciones de configuración de Go en Instala las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Go de Managed Service para Apache Kafka.
Para autenticarte en Managed Service para Apache Kafka, configura las credenciales predeterminadas de la aplicación (ADC). Para obtener más información, consulta Configura ADC para un entorno de desarrollo local.
Java
Antes de probar esta muestra, sigue las instrucciones de configuración de Java en Instala las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Java de Managed Service para Apache Kafka.
Para autenticarte en Managed Service para Apache Kafka, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura ADC para un entorno de desarrollo local.
Python
Antes de probar esta muestra, sigue las instrucciones de configuración para Python que se encuentran en Instala las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Python de Managed Service para Apache Kafka.
Para autenticarte en Managed Service para Apache Kafka, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura ADC para un entorno de desarrollo local.