Recursos
O Config Connector inclui uma coleção de Definições de Recursos Personalizados (CRDs). Cada CRD permite configurar um recurso do Google Cloud no Kubernetes. O Config Connector também permite aproveitar vários recursos do Kubernetes para gerenciar os 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, 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
Spec
e Status
.
- Spec
- O campo
spec
contém todos os campos que definem o estado pretendido de um objeto, excetoLabels
. Os subcampos de umspec
se referem ao recurso associado do Google Cloud. Quando você altera um subcampo, o valor do recurso do 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 do Google Cloud e atualiza ostatus
. Para verificar as mensagens de erro ou a prontidão de um recurso, consulteStatus.Condition
. - Um campo
status
somente leitura é oconnectionName
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 do 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 do Google Cloud, para o recurso correspondente do Google Cloud no campospec.resourceID
. Para mais informações, consulte Como gerenciar recursos com o camporesourceID
. - Namespace
- O namespace em que você cria um recurso do Config Connector determina o projeto que contém o recurso do Google Cloud. Para mais informações sobre namespaces, consulte Namespaces do Kubernetes e Projetos do Google Cloud.
- Rótulos
- Os rótulos no campo de metadados de um recurso do Config Connector também são adicionados ao recurso associado do Google Cloud.
- Além disso, o Config Connector adiciona um rótulo de sistema chamado
managed-by-cnrm
com um valor detrue
aos seus recursos do 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 demetadata.annotations
. Os valores da anotação precisam ser uma sequência. Os tipos de anotações compatíveis com o Config Connector são descritos em anotações.
Pastas e recursos hierárquicos
Além de gerenciar recursos nos produtos Google Cloud, o Config Connector oferece suporte à criação e ao gerenciamento de recursos nas Pastas e organizações do Google Cloud. Para mais informações, consulte Namespaces e projetos.
Como usar o RBAC para controle de acesso
O Controle de Acesso Baseado em Papel (RBAC) do Kubernetes protege seus recursos. Controle a criação dos 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 comoTrue
. 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
eReason
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
- Introdução ao Config Connector
- Aprenda sobre os Recursos que o Config Connector configura.