Documentação do Oracle Cloud Infrastructure

Adicionando um Estágio de Build Gerenciado

Adicione um estágio de Build Gerenciado no pipeline de build.

Você precisa adicionar repositórios de código nesse estágio do build. Os repositórios devem ser configurados antes da adição do estágio de Build Gerenciado. Para criar repositórios, consulte Gerenciando Repositórios de Código.

Antes de adicionar um estágio, você deve ter um pipeline de build.

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. Selecione um projeto e um pipeline de build.
    3. Para adicionar um estágio ao pipeline, clique no ícone + e selecione Adicionar estágio.
    4. Para o tipo de estágio, selecione Build Gerenciado e clique em Próximo.
    5. Digite um nome e uma descrição para o estágio. A adição de uma descrição é opcional.
    6. Selecione a forma do executor de build.

      Você pode selecionar a forma padrão (opção de início rápido) ou pode personalizar selecionando o número obrigatório de OCPUs e a quantidade de memória (em GB). A personalização leva mais tempo para ser provisionada.

    7. Selecione Oracle Linux 7 como imagem de contêiner base.
    8. (Opcional) Para acessar a rede virtual privada:
      1. Selecione uma VCN (Rede Virtual na Nuvem) e uma sub-rede regional na tenancy.
      2. (Opcional) Para restringir o acesso à VCN, você pode selecionar Grupos de segurança de rede (NSGs) nas VCNs.

      A resolução do DNS (Domain Name System) interno de VCNs não é suportada para acesso privado. Use IPs para se comunicar com serviços hospedados na rede privada.

    9. (Opcional) Digite o caminho do arquivo de especificação do build.

      A especificação de build contém as etapas e definições de build que o pipeline de build usa para executar um build.

      Observação

      Esta etapa só será necessária se o arquivo de especificação de build, build_spec.yaml, não estiver localizado no diretório raiz do repositório de código principal.
    10. Selecione o repositório de código principal para o build.
      • Selecione o tipo de conexão e uma conexão para o repositório. Os tipos de conexão suportados são:

        Somente as conexões externas que você já configurou estão disponíveis para seleção. Se não houver conexões, clique no link Criar uma conexão.

      • Se você selecionar GitHub ou GitLab, selecione um repositório.
      • Se você selecionar o Bitbucket Cloud, selecione um espaço de trabalho e um repositório.
      • Se você selecionar o serviço VBS (Visual Builder Studio), selecione um projeto VBS externo e um repositório.
      • Se você selecionar o Bitbucket Server ou o GitLab Server, informe o URL do repositório que contém a origem do build.
      • Selecione ou informe uma ramificação para o repositório de código selecionado.

        O build acontece na ramificação que aciona a execução do build e não na ramificação configurada durante a adição do estágio do build. A ramificação configurada pode ser usada quando a execução do build é acionada manualmente por meio da Console do OCI.

      • Para Nome da Origem do Build, digite um nome exclusivo para a pasta na qual o download do código de origem é feito no executor do build. Exemplos: Source1, Source2.
      • Salve as alterações.
    11. Para adicionar mais repositórios de código, clique em Adicionar Origem de Build e selecione os repositórios.
    12. (Opcional) Digite um valor de timeout (em segundos) para o estágio.
    13. (Opcional) Para adicionar tags ao estágio, clique em Mostrar opções de tag. Tag é um sistema de metadados que permite organizar e rastrear os recursos da tenancy.

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

      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

    14. Para adicionar o estágio ao pipeline, clique em Adicionar.

      Uma visualização do estágio fornece um snapshot da configuração.

    Você pode adicionar os seguintes estágios sequencialmente ou em paralelo ao pipeline:
    • Deliver Artifacts: Armazene os aplicativos de software criados com base no estágio Build Gerenciado nos repositórios do Oracle Cloud Infrastructure (OCI) Artifact Registry ou do OCI Container Registry.
    • Acionar Implantação: Inicie um pipeline de implantação para implantar a saída do pipeline de build.
    • Aguardar: Pause uma duração específica para testar o pipeline de build.

    Você poderá executar o build manualmente ou acionar uma execução de build automaticamente quando confirmar as alterações no repositório de código. A execução manual usa o commit mais recente no repositório de código. Você pode executar o build com base na confirmação específica, observando os detalhes da confirmação.

  • Para criar um pipeline de build, execute o comando create:

    oci devops build-pipeline create --project-id

    Para adicionar um estágio de Build Gerenciado para o pipeline, execute o comando create-build-stage:

    oci devops build-pipeline-stage create-build-stage

    Os parâmetros obrigatórios são:

    • --build-pipeline-id
    • --build-source-collection
    • --image
    • --stage-predecessor-collection

    O parâmetro opcional para configurar a forma do executor de build é:

    --build-runner-config

    Para obter todos os comandos de build-pipeline e build-pipeline-stage:

    oci devops build-pipeline -h
    oci devops build-pipeline-stage -h

    Para obter ajuda para o comando create-build-stage:

    oci devops build-pipeline-stage create-build-stage -h

  • Para criar um pipeline de build, use a operação CreateBuildPipeline.

    Para adicionar um estágio de Build Gerenciado para o pipeline, use a operação CreateBuildPipelineStage. Para o atributo buildPipelineStageType, especifique o valor como BUILD.

    Além da solicitação CreateBuildStageDetails, você deve adicionar um dos atributos fornecidos para personalizar a forma do executor de build:

    .buildRunnerShapeConfig(CustomBuildRunnerShapeConfig.builder().ocpus(<no_of_ocpus>).memoryInGBs(<memory_in_gbs>).build())
    .buildRunnerShapeConfig(DefaultBuildRunnerShapeConfig.builder().build())