Recursos

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

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, quando você cria 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 pretendido de um objeto, exceto Labels. Os subcampos de um spec se referem ao recurso Google Cloud associado. Quando você muda um subcampo, o valor do recurso Google Cloud tem consistência posterior com o valor pretendido.
Um exemplo de campo gravável é databaseVersion em um recurso SQLInstance.
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 Cloude atualiza o status. Para verificar as mensagens de erro ou a prontidão de um recurso, consulte 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 de metadados. 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 no recurso do Config Connector, especifique 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 namespace, consulte Namespaces do Kubernetes e Google Cloud projetos.
Rótulos
Os rótulos no campo de metadados de um recurso do Config Connector também são adicionados ao recurso Google Cloud associado.
Além disso, o Config Connector adiciona um rótulo de sistema chamado managed-by-cnrm com um valor de true aos seus recursos Google Cloud .
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 que o Config Connector aceita são descritos em anotações.

Pastas e recursos hierárquicos

Além de gerenciar recursos em Google Cloud produtos, o Config Connector oferece suporte à criação e ao gerenciamento de recursos nas 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 do Google Cloud atribuindo permissões RBAC. Para mais informações, consulte Como proteger o acesso aos 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