Controlar a aplicação do conector

Para garantir que todas as conexões de banco de dados com uma instância do AlloyDB para PostgreSQL usem a criptografia mTLS e a autorização do Identity and Access Management (IAM), é possível aplicar conexões pelo proxy de autenticação do AlloyDB ou pelos conectores de linguagem do AlloyDB. Também é possível desativar a aplicação do conector em uma instância a qualquer momento. Para informações sobre como exigir conectores ao criar uma instância, consulte Criar uma instância principal.

As instâncias do AlloyDB aceitam conexões em duas portas TCP:

  • Porta 5432, a porta padrão do PostgreSQL que os aplicativos usam para se conectar à instância. Se você estiver usando o pool de conexões gerenciado, a instância também vai detectar conexões com o pool na porta 6432.

  • Porta 5433, que os conectores, incluindo o proxy de autenticação do AlloyDB e os conectores de linguagem do AlloyDB, usam para se conectar à instância.

Os aplicativos se conectam a um conector escolhido no host e na porta locais em que o conector detecta, e esse conector se comunica com a instância do AlloyDB na porta 5433.

Aplicar conectores em uma instância

Console

  1. Acesse a página Clusters.

    Acessar Clusters

  2. Clique em um cluster na coluna Nome do recurso.
  3. Na página Visão geral, acesse a seção Instâncias no seu cluster e clique em Editar instância primária.
  4. No painel Editar instância principal, expanda Opções de configuração avançadas.
  5. Selecione Aplicar mTLS usando conectores AlloyDB.
  6. Clique em Atualizar instância.

gcloud

Para usar a CLI gcloud, você pode instalar e inicializar a Google Cloud CLI ou usar o Cloud Shell.

Use o comando gcloud alloydb instances update com a flag --require-connectors para aplicar conexões de conector em uma instância do AlloyDB:

gcloud alloydb instances update INSTANCE_ID \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    --project=PROJECT_ID \
    --require-connectors

Substitua:

  • INSTANCE_ID: o ID da instância que você está atualizando.
  • REGION_ID: a região em que a instância está localizada.
  • CLUSTER_ID: o ID do cluster em que a instância está localizada.
  • PROJECT_ID: o ID do projeto em que o cluster está localizado.

Se o comando retornar uma mensagem de erro que inclua a frase invalid cluster state MAINTENANCE, o cluster está passando por uma manutenção de rotina. Esse estado impede temporariamente a reconfiguração da instância. Execute o comando novamente depois que o cluster retornar ao estado READY. Para verificar o status do cluster, consulte Ver detalhes do cluster.

Desativar a aplicação do conector em uma instância

Console

  1. Acesse a página Clusters.

    Acessar Clusters

  2. Clique em um cluster na coluna Nome do recurso.
  3. Na página Visão geral, acesse a seção Instâncias no seu cluster e clique em Editar instância primária.
  4. No painel Editar instância principal, expanda Opções de configuração avançadas.
  5. Desmarque a opção Aplicar mTLS usando conectores AlloyDB.
  6. Clique em Atualizar instância.

gcloud

Para usar a CLI gcloud, você pode instalar e inicializar a Google Cloud CLI ou usar o Cloud Shell.

Use o comando gcloud alloydb instances update com a flag --no-require-connectors para desativar a aplicação do conector em uma instância do AlloyDB:

gcloud alloydb instances update INSTANCE_ID \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    --project=PROJECT_ID \
    --no-require-connectors

Substitua:

  • INSTANCE_ID: o ID da instância que você está atualizando.
  • REGION_ID: a região em que a instância está localizada.
  • CLUSTER_ID: o ID do cluster em que a instância está localizada.
  • PROJECT_ID: o ID do projeto em que o cluster está localizado.

A seguir