O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Criar projetos do Harbor

Este documento orienta desenvolvedores e administradores sobre como criar e verificar projetos do Harbor usando o console do GDC ou a CLI gdcloud.

É possível armazenar, proteger e distribuir imagens de contêiner no appliance isolado do Google Distributed Cloud (GDC) organizando-as em projetos do Harbor dentro da instância tear-harbor pré-configurada. No Harbor, um projeto serve como uma unidade lógica para agrupar artefatos relacionados, gerenciar imagens e aplicar políticas, controles de acesso e regras de replicação específicos.

O projeto do sistema tear fornece tear-harbor como a única instância do Harbor disponível, um único registro pré-configurado para todo o seu dispositivo. Assim, não é necessário provisionar, fazer upgrade ou manter instâncias separadas do Harbor para cada projeto do cliente. Essa arquitetura centralizada elimina a sobrecarga de infraestrutura e permite gerenciar namespaces de imagens, controles de acesso e verificação de vulnerabilidades em um registro compartilhado. Para usar esse registro compartilhado em cargas de trabalho em qualquer projeto do cliente, é necessário criar as funções do Harbor no projeto tear e criar os projetos do Harbor diretamente no projeto tear.

Antes de começar

Antes de começar, verifique se você atende aos seguintes requisitos:

Conhecimento recomendado: confira se você conhece os conceitos e a arquitetura abordados na Visão geral do Managed Harbor Service. É essencial entender que o Harbor é um recurso compartilhado hospedado no projeto tear, porque todas as atribuições de função do Harbor e as tarefas de criação de projeto precisam ser direcionadas ao projeto tear.
Inicialize sua identidade do Harbor: faça login na interface do Harbor pelo menos uma vez antes de tentar criar projetos no console. O login inicial inicializa sua identidade com o registro do Harbor. Para mais informações, consulte Receber o URL da instância do Harbor e Inicializar sua identidade do Harbor.

Aviso: tentar criar um projeto do Harbor sem inicializar sua identidade do Harbor pode fazer com que o processo falhe ou fique pendente.

Papel do IAM obrigatório

Para criar um projeto do Harbor, incluindo um que você pretende usar em um projeto do cliente, é necessário ter o papel Criador de projetos do Harbor (harbor-project-creator) do Identity and Access Management (IAM) criado e concedido no projeto tear para acessar a instância tear-harbor. Essa função fornece permissões de criação, recebimento e observação para recursos personalizados do projeto do Harbor na instância tear-harbor no projeto tear, permitindo definir novos namespaces de imagem e estabelecer limites de segurança para seus aplicativos contêinerizados.

Para solicitar acesso ao projeto tear, entre em contato com o administrador do IAM do projeto.

Acessar o URL da instância do Harbor

Para fazer login na interface do Harbor ou usar a CLI gdcloud para gerenciar imagens, você precisa do URL do endpoint externo da instância do registro:

Usando a CLI gdcloud, extraia o URL da instância do Harbor:
```
gdcloud harbor instances describe tear-harbor --project=tear
```
A saída é semelhante à seguinte, que normalmente contém o campo externalEndpoint:
```
externalEndpoint: https://harbor.tear.example.com
```
Copie o URL externalEndpoint para acessar a interface do Harbor pelo navegador e estabelecer a autenticação de confiança do cliente.

Se você não tiver acesso à CLI gdcloud, entre em contato com o operador de infraestrutura (IO) para receber suporte.

Inicializar sua identidade do Harbor

Faça login na interface do Harbor pelo menos uma vez para sincronizar sua identidade. Esse login inicial registra seu perfil de usuário no banco de dados do Harbor para que o sistema reconheça suas permissões:

Em um navegador, acesse o URL do registro.
Faça login usando suas credenciais do GDC.

Criar um projeto do Harbor

Como tear-harbor no projeto tear é a única instância do Harbor disponível e serve como o registro compartilhado para todo o dispositivo, é necessário criar todos os projetos do Harbor no projeto tear, incluindo os que armazenam imagens para cargas de trabalho em outros projetos de clientes. Crie um projeto do Harbor usando o console do GDC ou a CLI gdcloud.

Console

No console do GDC, siga estas etapas no projeto tear:

Selecione o projeto tear.
Clique no link Harbor Container Registry na seção CI/CD do menu de navegação.
Clique em Criar um projeto do Harbor.
Insira o nome do projeto do Harbor.
Opcional: a verificação de vulnerabilidades é ativada por padrão. Para desativar a verificação automática de vulnerabilidades para projetos do Harbor, clique no botão Ativar a verificação de vulnerabilidades para o projeto. Para mais informações, consulte Verificar se há vulnerabilidades.
Clique em Criar. Uma mensagem de confirmação aparece informando que o projeto foi criado.
Faça login na interface do Harbor para confirmar que você pode acessar o projeto do Harbor.

gdcloud

Crie o projeto do Harbor no projeto tear:

gdcloud harbor harbor-projects create HARBOR_PROJECT \
  --project=tear \
  --instance=tear-harbor

Substitua HARBOR_PROJECT pelo nome do projeto do Harbor a ser criado.