Nesta página, explicamos como configurar um servidor de registro de contêiner atual para o Google Distributed Cloud (somente software) para VMware.
Esta página é destinada a administradores, arquitetos e operadores que configuram, monitoram e gerenciam a infraestrutura de tecnologia. Para saber mais sobre papéis comuns e tarefas de exemplo referenciados no conteúdo do Google Cloud , consulte Tarefas e papéis de usuário comuns do GKE.
Visão geral
Por padrão, durante a criação ou o upgrade do cluster, o Google Distributed Cloud
extrai imagens do sistema
de gcr.io/gke-on-prem-release usando a
conta de serviço de acesso ao componente.
Se quiser, forneça seu próprio servidor de registro de contêiner para que as imagens do sistema sejam extraídas do seu servidor de registro particular.
O Google Distributed Cloud não é compatível com registros de contêiner não seguros. Ao iniciar o servidor do Container Registry, é preciso fornecer um certificado e uma chave. O certificado pode ser assinado por uma autoridade de certificação pública (CA, na sigla em inglês) ou autoassinado.
Criar um servidor de registro de contêineres
Para saber como criar um servidor de registro de contêiner, consulte Executar um registro acessível externamente na documentação do Docker.
Configurar o registro
Para usar um registro de contêiner particular, use a ferramenta de linha de comando gkectl ou o Terraform.
gkectl
Adicione a seção
privateRegistryao arquivo de configuração do cluster de administrador antes de criar o cluster.Quando esta seção é preenchida:
Quando você executa o comando
gkectl prepareantes da criação ou do upgrade do cluster, o comando extrai as imagens do arquivo tar especificado no campobundlePathno arquivo de configuração do cluster de administrador e as envia para o servidor de registro particular.Durante a criação ou o upgrade do cluster, as imagens do sistema são extraídas do servidor de registro particular.
Se a rede estiver protegida por um servidor proxy, preencha a seção
proxy.
Terraform
- Siga as etapas na guia do Terraform em Criar um cluster de administrador para preencher o arquivo de configuração do cluster de administrador.
Adicione o seguinte ao arquivo de configuração do cluster de administrador:
private_registry_config { address = "ADDRESS" ca_cert = "CA_CERT" }Substitua:
ADDRESS: o endereço IP ou FQDN (nome de domínio totalmente qualificado) da máquina que executa o registro particular.CA_CERT: os dados do certificado de CA da chave pública, mas com todas as novas linhas substituídas pela string\n.
Execute o comando a seguir para substituir as novas linhas por
\n:awk 'ORS="\\n" {print}' PUBLIC_KEY_PATHSubstitua
PUBLIC_KEY_PATHpelo caminho para a chave pública.Copie a saída do comando anterior e cole-a na variável de marcador de posição
CA_CERT.
Se a rede estiver protegida por um servidor proxy, adicione o seguinte:
proxy { url: "PROXY_SERVER_ADDRESS" no_proxy: "BYPASS_LIST" }Substitua:
PROXY_SERVER_ADDRESS: o endereço HTTP do servidor proxy. Inclua o número da porta mesmo que ele seja igual à porta padrão do esquema.BYPASS_LIST: uma lista separada por vírgulas de endereços IP, intervalos de endereços IP, nomes de host e nomes de domínio que não podem passar pelo servidor proxy.
Exemplo:
url: "http://my-proxy.example.local:80" no_proxy: "192.0.2.0/24,my-host.example.local,198.51.100.0"Quando o Google Distributed Cloud envia uma solicitação para um desses endereços, hosts ou domínios, a solicitação ignora o servidor proxy e é enviada diretamente ao destino.
Siga as etapas na guia do Terraform em Criar um cluster de administrador para verificar o arquivo de configuração e o plano do Terraform e, em seguida, criar o cluster de inicialização.
Quando você executa o comando
gkectl register bootstrap, ogkectlsolicita que você insira o nome de usuário e a senha do registro particular.
Durante a criação do cluster, as imagens do sistema são extraídas do servidor de registro particular.
Limitações com clusters avançados e o pacote completo
Há dois pacotes do Google Distributed Cloud disponíveis: completo e regular. Para determinar
qual pacote está na estação de trabalho de administrador, verifique o campo bundlePath no
arquivo de configuração do cluster de administrador. Se o nome do arquivo terminar em -full, o pacote
completo estará na estação de trabalho do administrador. Se o nome de arquivo não terminar em -full, o pacote normal estará na estação de trabalho do admin.
Se você criou a estação de trabalho de administrador usando o comando gkeadm, ele
cria a VM da estação de trabalho de administrador com o pacote completo e configura o
campo bundlePath no arquivo de configuração do cluster de administrador.
Se o cluster avançado estiver ativado, haverá limitações ao usar o pacote completo com um registro particular, como segue:
Versão 1.31: o pacote completo não é compatível com um registro particular. Para usar um registro particular em um cluster avançado:
- Faça o download do pacote de tamanho normal para sua estação de trabalho de administrador.
- Atualize o nome do arquivo no campo
bundlePathno arquivo de configuração do cluster de administrador.
Versão 1.32: o uso do pacote completo é compatível, mas o comando
gkectl prepareextrai imagens degcr.io/gke-on-prem-releaseem vez do arquivo tar. No entanto, o comando envia as imagens para o registro particular para que as imagens do sistema sejam extraídas do registro particular durante a criação ou o upgrade do cluster.
Diferenças entre clusters normais e avançados
O cluster avançado apresenta várias diferenças importantes em relação aos clusters padrão:
- Quando você usa um registro particular, as imagens parecem ser extraídas de
gcr.io, não do nome do host do seu registro particular. Essa mudança é esperada, mesmo que as imagens sejam extraídas do servidor de registro particular. - As extrações de imagem usam credenciais do arquivo
/etc/containerd/config.tomlem cada máquina que se conecta ao registro particular, em vez do secretprivate-registry-credsdentro do cluster. - Para todas as imagens
gcr.io, o cluster tenta primeiro extrair do registro particular. Se a imagem não estiver no registro particular, o sistema vai extraí-la degcr.iopela Internet. Para interromper esse substituto, configurenoProxyou use regras de firewall para bloquear o tráfego degcr.io.
Para verificar se as imagens são extraídas da origem correta, consulte Verificar se as imagens são extraídas do servidor de registro.
Verificar se as imagens foram extraídas do servidor de registro
A forma de verificar se as imagens estão sendo extraídas do servidor de registro depende da ativação do cluster avançado.
Se o cluster avançado não estiver ativado, execute o seguinte comando:
kubectl --kubeconfig ADMIN_CLUSTER_KUBECONFIG get pods \ --all-namespaces -o jsonpath="{.items[*].spec['initContainers', 'containers'][*].image}"Substitua
ADMIN_CLUSTER_KUBECONFIGpelo caminho do arquivo kubeconfig para o cluster de administrador;A saída desse comando mostra todas as imagens no cluster. Verifique se todas as imagens do Google Distributed Cloud são do seu próprio servidor de registro.
Se o cluster avançado estiver ativado, siga estas etapas:
É possível determinar se
containerdestá extraindo imagens do seu registro local examinando o conteúdo de um arquivo chamadoconfig.toml, conforme mostrado nas seguintes etapas:- Faça login em um nó e examine o conteúdo do arquivo
/etc/containerd/config.toml. Verifique o campo
plugins."io.containerd.grpc.v1.cri".registry.mirrorsdo arquivoconfig.tomlpara ver se o servidor de registro está listado no campoendpoint.Confira abaixo um trecho de um exemplo de arquivo
config.toml.version = 2 root = "/var/lib/containerd" state = "/run/containerd" ... [plugins."io.containerd.grpc.v1.cri".registry] [plugins."io.containerd.grpc.v1.cri".registry.configs] [plugins."io.containerd.grpc.v1.cri".registry.configs."gcr.io"] [plugins."io.containerd.grpc.v1.cri".registry.configs."privateregistry2.io".tls] ca_file = '/etc/containerd/certs.d/privateregistry2.io/ca.crt' [plugins."io.containerd.grpc.v1.cri".registry.mirrors] [plugins."io.containerd.grpc.v1.cri".registry.mirrors."gcr.io"] endpoint = ["http://privateregistry.io", "http://privateregistry2.io"] ...Se o espelho do registro aparecer no campo
endpoint, o nó estará extraindo imagens do espelho do registro, em vez do Artifact Registry.
- Faça login em um nó e examine o conteúdo do arquivo