Sobre os CRDs do Config Connector

O Config Connector inclui uma coleção de definições de recursos personalizados (CRDs). Cada CRD permite configurar um recurso Google Cloud do Kubernetes. O Config Connector também permite usar vários recursos do Kubernetes para gerenciar recursos do Google Cloud .

Nesta página, apresentamos como o Config Connector usa objetos do Kubernetes e os respectivos metadados.

Objetos do Kubernetes e recursos do Config Connector

Por exemplo, ao criar um objeto do Kubernetes de kind: SQLInstance, o Config Connector cria uma instância do Cloud SQL. Nesta seção, descrevemos como o Config Connector estende os tipos de objetos.

Especificações e status

Cada recurso do Config Connector é um objeto do Kubernetes com um Spec e um Status.

Especificações
O campo spec contém todos os campos que definem o estado desejado de um objeto. Os subcampos de um spec se referem ao recurso Google Cloud associado. Quando você muda um subcampo, o valor do recurso Google Cloud se torna eventualmente consistente com o valor pretendido.
Um exemplo de campo gravável é databaseVersion em um recurso SQLInstance.
Para recursos do Config Connector com spec.labels, os rótulos configurados no campo spec.labels do recurso do Config Connector serão aplicados ao recurso Google Cloud associado. Para mais detalhes, consulte Gerenciar rótulos.
Status
O campo status é somente leitura e contém o estado atual do seu objeto. O Config Connector lê periodicamente informações sobre seu recurso Google Cloud e atualiza o status. Para verificar as mensagens de erro ou a prontidão de um recurso, consulte o Status.Condition.
Um exemplo de campo status somente leitura é o connectionName de um recurso SQLInstance.

Metadados do objeto

Cada recurso do Config Connector inclui um campo metadata. Nesta seção, descrevemos como o Config Connector usa subcampos nos metadados.

Nome
O nome de um recurso do Config Connector. Ele precisa seguir a convenção de nomenclatura de um nome de objeto do Kubernetes. Ele é usado por padrão como o nome do recurso Google Cloud correspondente. Se o campo resourceID for compatível com o recurso do Config Connector, você poderá especificar um nome diferente, que segue a convenção de nomenclatura do recurso Google Cloud, para o recurso Google Cloud correspondente no campo spec.resourceID. Para mais informações, consulte Como gerenciar recursos com o campo resourceID.
Namespace
O namespace em que você cria um recurso do Config Connector determina o projeto que contém o recurso Google Cloud . Para mais informações sobre namespaces, consulte Namespaces e projetos do Kubernetes Google Cloud .
Rótulos
Dependendo do recurso, os rótulos no campo metadata.labels de um recurso do Config Connector podem ser aplicados ao recurso Google Cloud associado. Para mais detalhes, consulte Gerenciar marcadores.
O Config Connector adiciona um rótulo do sistema chamado managed-by-cnrm com um valor de true aos recursos Google Cloud que aceitam rótulos.
Anotações
O Config Connector pode executar outras ações nos seus recursos que não estão definidas no spec. Essas ações são definidas nos subcampos de metadata.annotations. Os valores da anotação precisam ser uma sequência. Os tipos de anotações compatíveis com o Config Connector estão descritos em anotações.

Como gerenciar rótulos

Para recursos Google Cloud que aceitam rótulos, a definição deles depende de o recurso do Config Connector ter um campo spec.labels:

  • Recursos com um campo spec.labels: você precisa gerenciar os rótulos em spec.labels. Os rótulos especificados pelo usuário neste campo são aplicados ao recursoGoogle Cloud .
  • Recursos sem um campo spec.labels: todos os rótulos em metadata.labels, incluindo os especificados pelo usuário e os do sistema, são aplicados ao recurso Google Cloud .

Pastas e recursos hierárquicos

Além de gerenciar recursos em produtos do Google Cloud , o Config Connector permite criar e gerenciar recursos em Google Cloud pastas e organizações. Para mais informações, consulte Namespaces e projetos.

Como usar o RBAC para controle de acesso

O controle de acesso baseado em função (RBAC) do Kubernetes protege seus recursos. É possível controlar a criação de recursos Google Cloud atribuindo permissões de RBAC. Para mais informações, consulte Como proteger o acesso a recursos.

Condição do status

O Config Connector usa uma condição pronta em status.condition para duas finalidades:

  • que indica quando um recurso está pronto. Quando um recurso estiver reconciliado e pronto, o status.condition.status dele será definido como True. Para verificar quando um recurso está pronto, consulte Aguardando que os recursos estejam prontos
  • exibindo erro ou informações adicionais. A condição "pronto" tem os campos Message e Reason que fornecem informações adicionais sobre o status do recurso.

Eventos

Alterações importantes de status dos recursos do Config Connector são visíveis como eventos do Kubernetes. Para mais informações, consulte Como exibir eventos.

Configuração declarativa e consistência posterior

Consulte Reconciliação.

A seguir