Recursos

O Config Connector inclui uma coleção de definições de recursos personalizados (CRDs). Cada CRD permite-lhe configurar um recurso do Kubernetes. Google CloudO Config Connector também lhe permite tirar partido de várias funcionalidades do Kubernetes para gerir recursos. Google Cloud

Esta página explica como o Config Connector usa objetos Kubernetes e os respetivos metadados.

Objetos do Kubernetes e recursos do Config Connector

Por exemplo, quando cria um objeto Kubernetes de kind: SQLInstance, o Config Connector cria uma instância do Cloud SQL. Esta secção descreve como o Config Connector expande os tipos de objetos.

Especificação e estado

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

Especificação
O campo spec contém todos os campos que definem o estado pretendido de um objeto, com exceção de Labels. Os subcampos de um spec referem-se ao recurso Google Cloud associado. Quando altera um subcampo, o valor do recurso é eventualmente consistente com o valor pretendido. Google Cloud
Um exemplo de um campo gravável é databaseVersion num recurso SQLInstance.
Estado
O campo status é só de leitura e contém o estado atual do seu objeto. O Config Connector lê periodicamente informações sobre o seu Google Cloudrecurso e atualiza o status. Pode verificar as mensagens de erro de um recurso ou a respetiva disponibilidade consultando o Status.Condition.
Um exemplo de campo status só de leitura é o connectionName de um recurso SQLInstance.

Metadados do objeto

Cada recurso do Config Connector inclui um campo metadata. Esta secção descreve como o Config Connector usa subcampos nos metadados.

Nome
O nome de um recurso do Config Connector. Deve seguir a convenção de nomenclatura de um nome de objeto do Kubernetes. É usado por predefinição como o nome do recurso Google Cloud correspondente. Se o campo resourceID for suportado no recurso do Config Connector, pode 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 o artigo Faça a gestão de recursos com o campo resourceID.
Espaço de nomes
O espaço de nomes no qual cria um recurso do Config Connector determina o projeto que contém o recurso. Google Cloud Para mais informações sobre os espaços de nomes, consulte os artigos Espaços de nomes do Kubernetes e Google Cloud Projetos.
Etiquetas
As etiquetas no campo de metadados de um recurso do Config Connector também são adicionadas ao recurso Google Cloud associado.
Além disso, o Config Connector adiciona uma etiqueta do sistema denominada managed-by-cnrm com um valor de true aos seus recursos Google Cloud .
Notas
O Config Connector pode realizar ações adicionais nos seus recursos que não estão definidos no spec. Estas ações são definidas em subcampos de metadata.annotations. Os valores de anotação têm de ser uma string. Os tipos de anotações suportados pelo Config Connector são descritos em anotações.

Pastas e recursos hierárquicos

Além de gerir recursos em Google Cloud produtos, o Config Connector suporta a criação e a gestão de recursos emGoogle Cloud pastas e organizações. Para mais informações, consulte o artigo Espaços de nomes e projetos.

Usar o CABF para o controlo de acesso

O Kubernetes controlo de acesso baseado em funções (CABF) protege os seus recursos. Pode controlar a criação de Google Cloud recursos atribuindo autorizações de RBAC. Para mais informações, consulte o artigo Proteger o acesso aos recursos.

Condição de estado

O Config Connector usa uma condição ready em status.condition para dois fins:

  • indicando quando um recurso está pronto. Quando um recurso é reconciliado e está pronto, o respetivo status.condition.status é definido como True. Para verificar quando um recurso está pronto, consulte o artigo Aguardar que os recursos estejam prontos
  • Apresentar um erro ou informações adicionais. A condição ready tem campos Message e Reason que fornecem informações adicionais sobre o estado do recurso.

Eventos

As alterações importantes ao estado dos recursos do Config Connector são visíveis como eventos do Kubernetes. Para mais informações, consulte o artigo Ver eventos.

Configuração declarativa e consistência eventual

Consulte o artigo Conciliação.

O que se segue?