É possível editar um cluster do Connect para atualizar propriedades como o número de vCPUs, memória, rede e rótulos.
Para editar um cluster do Connect, use o Google Cloud Console, a CLI gcloud, a biblioteca de cliente ou a API Managed Kafka. Não é possível usar a API Apache Kafka de código aberto para atualizar um cluster do Connect.
Antes de começar
Nem todas as propriedades de um cluster do Connect são editáveis. Revise as propriedades de um cluster do Connect antes de atualizar.
Papéis e permissões necessárias
Para receber as permissões necessárias
para editar um cluster do Connect,
peça ao administrador para conceder a você o
papel do IAM de editor de cluster do Managed Kafka Connect (roles/managedkafka.connectClusterEditor) no projeto.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Esse papel predefinido contém as permissões necessárias para editar um cluster do Connect. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As seguintes permissões são necessárias para editar um cluster do Connect:
-
Atualize um cluster do Connect:
managedkafka.connectClusters.update -
Conectores de visualização ao usar o console do Google Cloud para atualizar um cluster do Connect:
managedkafka.connectors.list
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
Permissões de sub-rede do cluster
Se você atualizar a sub-rede de worker de um cluster do Connect, o agente de serviço do Kafka gerenciado vai anexar a sub-rede durante a operação de atualização.
A permissão managedkafka.connectClusters.update permite indiretamente que um principal
anexe qualquer sub-rede que o agente de serviço tenha permissão para usar, mesmo que o
principal não tenha permissão direta para usar a sub-rede.
Editar um cluster do Connect
A atualização de algumas propriedades, como CPU e memória, exige a reinicialização do cluster.
As reinicializações de cluster preservam os dados, mas podem aumentar a latência. O número inicial de workers no cluster determina a duração da reinicialização.
É possível atualizar as seguintes propriedades do cluster do Connect:
| Propriedade | Editável |
|---|---|
| vCPUs | Sim |
| Memória | Sim |
| Rede | Sim |
| Sub-rede de worker | Sim |
| Domínios DNS solucionáveis | Sim (adicionar/excluir) |
| Nome do cluster Connect | Não |
| Cluster Kafka | Não |
| Local | Não |
| Rótulos | Sim (adicionar/editar/excluir) |
| Secrets | Sim (adicionar/excluir) |
Console
No console do Google Cloud , acesse a página Clusters do Connect.
Clique no cluster do Connect que você quer atualizar.
A página Detalhes do cluster do Connect é exibida.
Clique em Editar.
A página Editar cluster do Kafka Connect é exibida.
Faça as mudanças necessárias nas propriedades editáveis.
Clique em Salvar.
gcloud
-
No console do Google Cloud , ative o Cloud Shell.
Na parte de baixo do console do Google Cloud , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.
Execute o 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]Substitua:
- CONNECT_CLUSTER_ID: o ID ou nome do cluster do Connect. O nome de um cluster do Connect é imutável.
- LOCATION: o local do cluster do Connect. O local de um cluster do Connect é imutável.
- CPU: o número de vCPUs do cluster do Connect. O valor mínimo é de 3 vCPUs.
- MEMORY: a quantidade de memória do cluster do Connect. Use as unidades "MB", "MiB", "GB", "GiB", "TB" ou "TiB". Por exemplo, "10GiB". É preciso provisionar entre 1 GiB e 8 GiB por vCPU.
- DNS_NAME: nome de domínio DNS da rede da sub-rede que será visível para o cluster do Connect.
- LABELS: (opcional) rótulos para associar ao cluster. Para mais informações sobre o formato dos rótulos, consulte Rótulos. Lista de pares de rótulos KEY=VALUE a serem adicionados. As chaves precisam começar com um caractere minúsculo e conter apenas hifens (-), sublinhados (_), caracteres minúsculos e números. Os valores precisam conter apenas hifens (-), sublinhados (_), caracteres minúsculos e números.
- SECRET: (opcional) secrets a serem carregados nos workers.
As versões exatas do secret do Secret Manager precisam ser fornecidas.
Não há suporte para aliases. É possível carregar até 32 secrets em um
cluster. Formato:
projects/PROJECT_ID/secrets/SECRET_NAME/versions/VERSION_ID WORKER_SUBNET: a sub-rede de worker do cluster do Connect. A sub-rede de worker precisa estar na mesma região do cluster do Connect.
O formato da sub-rede é
projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_ID.
Go
Antes de testar este exemplo, siga as instruções de configuração do Go em Instalar as bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Go do Serviço Gerenciado para Apache Kafka.
Para autenticar no Serviço Gerenciado para Apache Kafka, configure o Application Default Credentials(ADC). Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.
Java
Antes de testar esta amostra, siga as instruções de configuração do Java em Instalar as bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Java do Serviço Gerenciado para Apache Kafka.
Para se autenticar no Serviço Gerenciado para Apache Kafka, configure o Application Default Credentials. Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.
Python
Antes de testar este exemplo, siga as instruções de configuração do Python em Instalar as bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Python do Serviço Gerenciado para Apache Kafka.
Para se autenticar no Serviço Gerenciado para Apache Kafka, configure o Application Default Credentials. Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.