Campos do ConfigManagement

Nesta página, explicamos os diferentes campos que podem ser definidos no objeto ConfigManagement. É possível usar esse objeto ao configurar o Config Sync usando comandos kubectl.

Observação: o comando de aplicação da CLI gcloud usa um formato de arquivo diferente do objeto ConfigManagement.

Cuidado: não altere os valores de configuração fora do campo spec.

Configuração para recursos do Config Sync

Chave	Descrição
spec.enableMultiRepo	Se true, ativa as APIs RootSync e RepoSync. Essas APIs fornecem recursos adicionais do Config Sync, como sincronização de vários repositórios e a sincronização das configurações do Kustomize e Helm O padrão é false.
spec.preventDrift	Se true, ativa o webhook de admissão do Config Sync para evitar desvios rejeitando as alterações conflitantes que estão sendo enviadas para clusters ativos. O padrão é false. O Config Sync sempre corrige desvios, independentemente do valor desse campo.
spec.enableLegacyFields (Shutdown in 1.19.0)	Se true, ativa o uso de campos spec.git obsoletos no ConfigManagement enquanto ainda usa o modo de vários repositórios. Definir esse campo gera automaticamente um recurso RootSync no cluster.

Configuração para comportamento do objeto ConfigManagement

Chave	Descrição
spec.clusterName	O nome definido pelo usuário para o cluster usado por ClusterSelectors para agrupar os clusters. Exclusivo em uma instalação do Config Sync. Não é possível configurar esse campo no console do Google Cloud.

Exemplo do objeto ConfigManagement

apiVersion: configmanagement.gke.io/v1
kind: ConfigManagement
metadata:
  name: config-management
spec:
  clusterName: my-cluster
  enableMultiRepo: true

Configuração para repositórios Git (obsoleto)

Cuidado: os campos spec.git do objeto ConfigManagement foram encerrados. Desde a versão 1.19.0, não é possível criar novas configurações que usam os spec.git campos para gerenciar um repositório Git. As configurações atuais do repositório Git que usam os campos spec.git não vão funcionar após a versão 1.19.0. A API RootSync oferece a mesma funcionalidade e outros benefícios, como sincronização de várias origens e observabilidade melhor. Para informações sobre os benefícios e instruções de migração da configuração do Git para o objeto RootSync, consulte Migrar seu objeto ConfigManagement.

Chave	Descrição
spec.git.gcpServiceAccountEmail	A conta de serviço Google Cloud usada para anotar a conta de serviço do Kubernetes do controlador RootSync ou RepoSync. Este campo é usado apenas quando spec.git.secretType é gcpserviceaccount.
spec.git.syncRepo	O URL do repositório Git para usar como fonte. Obrigatório.
spec.git.syncBranch	A ramificação do repositório com que sincronizar. Padrão: master.
spec.git.policyDir	O caminho no repositório Git para o diretório raiz que contém a configuração que você quer sincronizar. Padrão: o diretório raiz do repositório
spec.git.syncWait	A duração de tempo entre sincronizações consecutivas. Padrão: 15 s.
spec.git.syncRev	Revisão Git (tag ou hash) para check-out. Padrão HEAD.
spec.git.secretType	O tipo de secret configurado para acesso ao repositório Git. Um de ssh, cookiefile, token, gcenode, gcpserviceaccount ou none. Obrigatório.
spec.sourceFormat	O formato do seu repositório Git. Pode ser unstructured ou hierarchy. Padrão: hierarchy.

Configuração de proxy para o repositório Git

Se as políticas de segurança da sua organização exigirem o roteamento do tráfego por meio de um proxy HTTP(S), use o URI do proxy para configurar o Config Sync para se comunicar com o host Git. O proxy só é compatível com o tipo de autorização cookiefile, none ou token.

Chave	Descrição
spec.git.proxy.httpProxy	Define uma variável de ambiente HTTP_PROXY usada para acessar o repositório Git.
spec.git.proxy.httpsProxy	Define uma variável de ambiente HTTPS_PROXY usada para acessar o repositório Git.

Se os campos httpProxy e httpsProxy forem especificados, httpProxy será ignorado.

Configuração do Controlador de Políticas (não oferece suporte)

Aviso: não é mais possível configurar o Controlador de Políticas usando o objeto ConfigManagement. Migrar da API ConfigManagement para a API PolicyController para continuar usando o Policy Controller.

Chave	Descrição
spec.policyController.enabled	Se true, ativa o Policy Controller. O padrão é false.
spec.policyController.templateLibraryInstalled	Se true, instala uma biblioteca de modelos de restrição para tipos de política comuns. O padrão é true.
spec.policyController.referentialRulesEnabled	Se true, ativa o suporte para restrições referenciais. Entenda as advertências sobre consistência posterior. O padrão é false.
spec.policyController.auditIntervalSeconds	Período em segundos entre auditorias consecutivas de violações de restrições. Defina como 0 para desativar a auditoria. Padrão: 60.
spec.policyController.logDeniesEnabled	Se true, registra todas as negações e falhas de simulação. O padrão é false.
spec.policyController.mutation.enabled	Se true, permite compatibilidade com mutações O padrão é false.
spec.policyController.exemptableNamespaces	Uma lista de namespaces a serem removidos da aplicação do webhook de admissão do Policy Controller. Todas as violações ainda serão informadas na auditoria. O padrão é uma lista vazia.
spec.policyController.monitoring.backends	Uma lista de back-ends de monitoramento para o Policy Controller exportar métricas. Padrão: [cloudmonitoring, prometheus].