Use o Serviço Gerenciado do Harbor (MHS, na sigla em inglês) do Google Distributed Cloud (GDC) com isolamento físico para criar uma instância de registro do Harbor em cada projeto. Uma instância de registro do Harbor serve como um repositório central para armazenar e gerenciar imagens de contêiner em um ambiente nativo da nuvem. Ele amplia os recursos da distribuição de código aberto do Docker. As seguintes restrições são aplicadas:
- É possível criar no máximo uma instância por projeto.
- As instâncias são isoladas e não compartilham dados ou recursos de computação.
Antes de começar
Se você for responsável por criar instâncias de registro do Harbor, entre em contato com o administrador do projeto do IAM para solicitar o papel de Administrador de instâncias do Harbor (harbor-instance-admin), que permite receber, listar, assistir, criar, atualizar, corrigir e excluir instâncias do Harbor, repositórios de backup, planos de backup, backups e restaurações em um namespace de projeto. Esse papel inclui as permissões necessárias para provisionar novas instâncias do Harbor.
Criar uma instância de registro do Harbor
Crie uma instância de registro do Harbor no console do GDC ou na CLI gdcloud.
Console
No console do GDC, siga estas etapas:
- No menu de navegação, na seção CI/CD, clique em Harbor Container Registry.
- Clique em Criar instância.
- No campo Nome da instância, insira um nome para a instância.
- Opcional: na seção Projetos, para criar um projeto padrão para essa instância do Harbor, clique no botão Criar um projeto padrão ao criar esta instância para a posição de ativado e faça o seguinte:
- No campo Nome do projeto, digite um nome.
- Leia os Termos de Serviço do Harbor gerenciado e marque a caixa de seleção se concordar com eles.
- Clique em Criar. O Status mostra Em andamento, e o Nome mostra um link externo com o nome da instância do Harbor recém-criada.
- Depois que a instância for criada e o Status mostrar Pronto, clique no link externo na página para acessar a UI da Web da instância do Harbor.
gdcloud
Crie a instância de registro do Harbor:
gdcloud harbor instances create INSTANCE \
--project=PROJECT
Substitua:
INSTANCE: nome da instânciaPROJECT: o nome do projeto do GDC em que a instância será criada.
Confiança do nó do cluster para instâncias de registro do Harbor
Quando uma instância do registro do Harbor está pronta, o GDC configura automaticamente os nós de clusters compartilhados e padrão do Kubernetes na sua organização para confiar no certificado TLS da instância, que é emitido pela autoridade certificadora raiz (CA) confiável da sua organização. Para extrair imagens da instância, não é necessário instalar a CA raiz nem mudar a configuração do ambiente de execução do contêiner nos nós do cluster.
A configuração automática tem o seguinte comportamento:
- Tempo de atualização do nó: o GDC adiciona a instância à configuração de registro particular de cada cluster e, em seguida, atualiza cada nó no cluster. Um nó só pode extrair imagens da instância depois que a atualização é concluída nesse nó, o que pode levar até 60 minutos em todos os nós.
- Clusters novos e entre zonas: o GDC também configura os clusters criados depois que a instância está pronta e os clusters em outras zonas da organização.
- Nome do host confiável: os nós confiam apenas no nome do host da instância, que é o
URL da instância sem o prefixo
https://, comoharbor-1-my-project.org-1.zone1.google.gdc.test. Encontre o URL da instância no link da instância do console do GDC ou no campostatus.urlda resposta ao comandogdcloud harbor instances describe. Use o nome do host da instância nas referências de imagem, comoINSTANCE_HOSTNAME/HARBOR_PROJECT/IMAGE:TAG, em queHARBOR_PROJECTé o projeto do Harbor que armazena a imagem. - Cliente do Docker da estação de trabalho: a confiança automática se aplica apenas aos nós do cluster. Para enviar ou extrair imagens com o Docker da sua estação de trabalho, configure o cliente local do Docker para confiar na CA raiz. Para mais informações, consulte Configurar o Docker para confiar na CA raiz do Harbor.
Se os nós do cluster não confiarem na instância, consulte Resolver erros de certificado ao extrair imagens.
Resolver problemas de certificado ao extrair imagens
Se os nós do cluster não confiarem no certificado do nome do host em uma referência de imagem, os pods não poderão extrair a imagem. Os pods mostram o status ErrImagePull ou
ImagePullBackOff, e os eventos do pod mostram um erro semelhante ao
seguinte:
failed to pull and unpack image "INSTANCE_HOSTNAME/HARBOR_PROJECT/IMAGE:TAG": ... x509: certificate signed by unknown authority
Para resolver erros de certificado, você precisa do seguinte:
- O papel de Leitor de instâncias do Harbor (
harbor-instance-viewer) ou Administrador de instâncias do Harbor (harbor-instance-admin) no projeto do GDC que contém a instância. - Um papel que permite visualizar eventos de pod e excluir pods no cluster
afetado:
- Para um cluster compartilhado, o papel de Administrador de namespace (
namespace-admin) no namespace do projeto da carga de trabalho. - Para um cluster padrão, o papel de Desenvolvedor de cluster
(
cluster-developer) no projeto que contém o cluster.
- Para um cluster compartilhado, o papel de Administrador de namespace (
- Um arquivo kubeconfig para o cluster do Kubernetes afetado:
- Para um cluster compartilhado, consulte Fazer login.
- Para um cluster padrão, consulte Gerenciar o acesso a clusters padrão.
Para resolver esse problema, siga estas etapas:
Confira os eventos do pod e o nó que o executa:
kubectl --kubeconfig CLUSTER_KUBECONFIG \ -n NAMESPACE describe pod POD_NAMESubstitua:
CLUSTER_KUBECONFIG: o caminho para o arquivo kubeconfig do cluster do Kubernetes afetado.NAMESPACE: o namespace do pod. Para um cluster compartilhado, esse é um namespace de projeto.POD_NAME: o nome do pod.
Na saída, o campo
Nodemostra o nó que executa o pod, e a seçãoEventsmostra a mensagem de erro e a referência da imagem.Verifique se a instância está pronta e não tem códigos de erro:
- No console do GDC, verifique se o Status da instância mostra Pronto. Mesmo que o Status mostre Pronto, use a CLI gdcloud para verificar se há códigos do erro.
Use a CLI gdcloud para verificar o status da instância e os códigos do erro:
gdcloud harbor instances describe INSTANCE \ --project=PROJECTSubstitua:
INSTANCE: o nome da instância do registro do Harbor.PROJECT: o nome do projeto do GDC que contém a instância.
Na saída, verifique se a condição com
type: Readyna listastatus.conditionstemstatus: "True". O resultado será assim:# Several lines of code are omitted here. status: conditions: - message: HarborInstance reconciled reason: Reconciled status: "True" type: Ready # Several lines of code are omitted here. url: https://harbor-1-my-project.org-1.zone1.google.gdc.test
Se o Status permanecer Em andamento ou mostrar Desconhecido ou Erro, ou se a condição
Readynão tiverstatus: "True", entre em contato com o operador de infraestrutura (IO). Se a seçãostatusda saídagdcloud harbor instances describecontiver um campoerrorStatuscom códigos do erro, comoHAAS0008, entre em contato com o pedido de inserção, mesmo que a condiçãoReadysejaTrue. Inclua os códigos do erro e as mensagens.Verifique se a referência da imagem na carga de trabalho usa o nome do host da instância exatamente como aparece no URL da instância, sem o prefixo
https://. Os nós não confiam em outros nomes para a instância, como um endereço IP. Se a referência de imagem usar um nome diferente, atualize-a para usar o nome do host da instância e, em seguida, reimplante a carga de trabalho.Se menos de 60 minutos tiverem se passado desde que a instância mostrou o status Pronto ou desde que você criou o cluster, o que ocorrer por último, aguarde o GDC terminar de atualizar os nós do cluster:
- Atualizações parciais de nós: se as extrações de imagem forem bem-sucedidas em alguns nós e falharem em outros, a atualização ainda estará em andamento.
- Backups e restaurações: as atualizações de nós aguardam enquanto um backup ou uma restauração da instância está em andamento. Inicie o período de 60 minutos após a conclusão do backup ou da restauração.
- Clusters novos ou entre zonas: para clusters criados após a instância estar pronta e para clusters em uma zona diferente da instância, o status Pronto da instância não mostra se os nós do cluster estão atualizados.
Depois que a atualização do nó for concluída, verifique se a carga de trabalho pode extrair a imagem. O Kubernetes tenta novamente as extrações de imagem com falha de forma automática. Para tentar novamente imediatamente, exclua o pod com falha para que o controlador, como um
Deployment, o recrie:kubectl --kubeconfig CLUSTER_KUBECONFIG \ -n NAMESPACE delete pod POD_NAMESe nenhum controlador gerenciar o pod, recrie-o. Para confirmar se o problema foi resolvido, verifique se o novo pod mostra o status
Runningem vez deErrImagePullouImagePullBackOff:kubectl --kubeconfig CLUSTER_KUBECONFIG \ -n NAMESPACE get podsSe o erro continuar por mais de 60 minutos depois que a instância mostrar o status Pronto ou depois que você criar o cluster, o que ocorrer por último, entre em contato com o IO. Forneça as seguintes informações:
- A organização e a zona da instância e do cluster afetado
- O nome da instância e o projeto do GDC que contém a instância
- O nome do cluster do Kubernetes afetado, se é um cluster compartilhado ou padrão e, para um cluster padrão, o projeto que contém o cluster.
- A referência de imagem completa e a mensagem de erro completa dos eventos do pod
- Os nomes dos nós em que as extrações de imagem falham e se as extrações de imagem são bem-sucedidas em outros nós.
- Quando a instância mostrou o status Pronto, quando você criou o cluster e se um backup ou uma restauração da instância estava em andamento.
- A seção
statusda saídagdcloud harbor instances describe, incluindo todos os códigos do erroerrorStatus.
A seguir
Depois que a instância do registro do Harbor estiver pronta, você poderá criar projetos para hospedar suas coleções de imagens ou gerenciar as instâncias atuais: