Documentação do Oracle Cloud Infrastructure

Criando um Repositório

Descubra como criar um repositório no Container Registry.

Depois de criar um repositório, você pode enviar uma imagem para ele usando a CLI do Docker (consulte Enviando Imagens Usando a CLI do Docker). Todas as imagens que você envia subsequentemente para o registro que incluem o mesmo nome de repositório são agrupadas nesse repositório.

Criar um repositório antes de enviar uma imagem é o workflow usual, mas nem sempre é necessário. Se você não estiver autorizado a gerenciar repositórios no compartimento raiz da tenancy, sempre envie uma imagem para um repositório existente. No entanto, se você estiver autorizado a enviar imagens para o compartimento raiz da tenancy e pretende fazer isso, não será necessário um repositório existente.

Ao enviar uma imagem, você normalmente usa um comando no formato docker push <registry-domain>/<tenancy-namespace>/<repo-name>:<version>. No entanto, se você selecionar a opção Criar repositório no primeiro push no compartimento raiz e enviar uma imagem com um comando que inclua o nome de um repositório que ainda não existe, um novo repositório privado será criado automaticamente no compartimento raiz.

Por exemplo, se você informar o comando docker push ocir.us-ashburn-1.oci.oraclecloud.com/ansh81vru1zp/project02/acme-web-app:7.5.2 e o repositório project02/acme-web-app não existir, um repositório privado chamado project02/acme-web-app será criado automaticamente no compartimento raiz.

Você deve pertencer ao grupo Administradores da tenancy ou ter recebido a permissão REPOSITORY_MANAGE na tenancy para criar automaticamente o repositório privado no compartimento raiz da tenancy. Consulte Políticas para Controlar o Acesso ao Repositório.

    1. Na página da lista Registro de Contêiner, selecione Criar repositório. Se precisar de ajuda para localizar a página da lista, consulte Listando Repositórios.
    2. Especifique as informações a seguir:

      • Criar no compartimento: O compartimento no qual criar o repositório. Você pode selecionar qualquer compartimento no qual tenha permissão para trabalhar.

      • Acesso: Se o repositório é um repositório público ou um repositório privado. Você só poderá tornar o repositório público se você pertencer ao grupo Administradores da tenancy ou tiver recebido a permissão REPOSITORY_MANAGE. Observe estes pontos:

        • Se você tornar o repositório público, qualquer usuário com acesso à Internet e conhecimento do URL apropriado poderá extrair imagens do repositório.

        • Se tornar o repositório privado, você (junto com os usuários que pertencem ao grupo Administradores da tenancy) poderá executar qualquer operação no repositório.

      • Nome do repositório: Um nome de sua escolha para o repositório. O nome informado deve ser exclusivo entre todos os compartimentos da tenancy. Evite digitar informações confidenciais.

      • Tags: Opcionalmente, uma ou mais tags de formato livre ou tags definidas a serem aplicadas ao repositório. Para aplicar uma tag definida, você deverá ter permissões para usar o namespace de tags. Se você não tiver certeza se deve aplicar tags, ignore essa opção (você poderá aplicar tags posteriormente) ou pergunte ao administrador. Para obter mais informações, consulte Aplicando Tags de Formato Livre e Tags Definidas a Repositórios, Imagens e Assinaturas de Imagem.

    3. Selecione Criar.
    4. (Opcional) Para criar automaticamente novos repositórios privados no compartimento raiz da tenancy quando os comandos docker push não incluírem o nome de um repositório existente, siga estas etapas:

      1. Selecione Definições.

      2. Selecione Criar repositório no primeiro envio no compartimento raiz.

  • Use o comando oci Artefatos Container Repository Create e os parâmetros necessários para criar um repositório:

    oci artifacts container repository create --display-name <repo-name> --compartment-id <compartment_ocid> [OPTIONS]

    Por exemplo:

    oci artifacts container repository create --display-name project01/acme-web-app --compartment-id ocid1.compartment.oc1..aaaaaaaarvdfa72n...

    Para obter uma lista completa de flags e opções de variáveis para comandos da CLI, consulte a Referência de Linha de Comando.

  • Execute a operação CreateContainerRepository para criar um repositório.