Documentação do Oracle Cloud Infrastructure

Adicionando um Artefato do Artifact Registry

Crie uma referência a artefatos localizados em um repositório do Artifact Registry.

No pipeline de build, para armazenar a saída do estágio de Build Gerenciado, você precisa de um repositório do Container Registry ou um repositório do Artifact Registry do OCI.

Crie uma referência de artefato para apontar para o local do repositório que contém a saída do build. Antes de criar uma referência de artefato, você deve ter um projeto do DevOps e ter acesso ao repositório do Artifact Registry. Consulte Acessando o Artifact Registry.

O Oracle Cloud Infrastructure Artifact Registry é um serviço de repositório para armazenar, compartilhar e gerenciar pacotes de desenvolvimento de software.

Você pode criar uma referência a três tipos de artefatos no serviço Artifact Registry: configurações de implantação do grupo de instâncias, artefatos gerais, manifestos do Kubernetes e especificação de comando.

Para acessar DevOps usando a Console, a API REST e a CLI do Oracle Cloud, consulte Acessando DevOps.

    1. Abra o menu de navegação e clique em Serviços do Desenvolvedor. Em DevOps, clique em Projetos.
    2. Na página DevOps Projetos, selecione o projeto ao qual você deseja adicionar um artefato.
    3. Na página de detalhes do projeto, no lado esquerdo, clique em Artefatos.
    4. Na página Artefatos, clique em Adicionar artefato.
    5. No painel Adicionar artefato, forneça os seguintes detalhes:
      1. Digite um nome para o artefato.
      2. Para Tipo, selecione Configuração de implantação do grupo de instâncias, Artefato geral, Manifesto do Kubernetes ou Especificação de comando.

        Um arquivo de configuração de implantação define os artefatos a serem submetidos a download para a instância e o local onde os artefatos devem ser copiados. Para obter mais informações, consulte Configuração de Implantação.

        Um arquivo de especificação de comando contém comandos e etapas definidos pelo usuário que são executados em um pipeline de implantação. Para obter mais informações, consulte Especificação de Comando.

      3. Para Origem do artefato, selecione Repositório do Artifact Registry.

        Para obter mais informações, consulte Artifact Registry.

      4. Para selecionar um repositório do Artifact Registry, clique em Selecionar.
      5. Selecione a região e o compartimento em que o artefato está localizado.
      6. Selecione um repositório na lista disponível.
      7. Selecione o local do artefato. As opções disponíveis são as seguintes:
        • Selecionar Local Existente: Selecione um artefato no repositório escolhido.
        • Definir Local Personalizado: Informe o caminho (local) do artefato que você deseja adicionar e informe a versão do artefato. A versão do artefato também pode ser configurada como um parâmetro. Para obter mais informações, consulte Configurando Parâmetros.
      8. Selecione Permitir parametrização se quiser substituir os placeholders no conteúdo do artefato por valores de argumento fornecidos durante a implantação.

        Para obter mais informações, consulte Configurando Parâmetros.

      9. (Opcional) Para adicionar tags ao artefato, clique em Mostrar opções de tag. Tag é um sistema de metadados que permite organizar e rastrear os recursos de sua tenancy.

        Se você tiver permissões para criar um recurso, também terá permissões para adicionar tags de formato livre a esse recurso.

        Para adicionar uma tag definida, você deverá ter permissões para usar o namespace de tag.

        Para obter mais informações, consulte Tags de Recursos

    6. Clique em Adicionar.

    Uma referência ao artefato no repositório do Artifact Registry é criada.

  • Para criar uma referência de artefato do Artifact Registry, execute o comando create-generic-artifact:

    oci devops deploy-artifact create-generic-artifact

    Parâmetros obrigatórios para o comando create-generic-artifact:

    • --argument-substitution-mode
    • --artifact-path
    • --artifact-version
    • --repository-id
    • --artifact-type
    • --project-id

    Para obter todos os comandos de deploy-artifact:

    oci devops deploy-artifact -h

    Para obter ajuda para o comando create-generic-artifact:

    oci devops deploy-artifact create-generic-artifact -h

  • Para criar uma referência de artefato do Artifact Registry, use a operação CreateDeployArtifact. Para o atributo deployArtifactType, selecione um dos seguintes valores:

    • DEPLOYMENT_SPEC
    • KUBERNETES_MANIFEST
    • GENERIC_FILE