Documentação do Oracle Cloud Infrastructure

Adicionando um Estágio do Shell

O estágio do shell permite executar comandos personalizados no pipeline de implantação. Esse estágio pode ser adicionado a qualquer momento no pipeline de implantação.

Você deve preparar um arquivo YAML de especificação de comando contendo todas as etapas que deseja executar durante a implantação. A especificação de comando é executada em um host de instância de contêiner no compartimento e na sub-rede selecionados em sua tenancy. Você tem a opção de escolher outra configuração de instância antes da implantação. Consulte Detalhes de Runtime de Imagem do Contêiner do Shell. Quando você executar o pipeline de implantação, poderá ver a execução das etapas definidas na especificação de comando na saída e nos logs do pipeline. Para obter a sintaxe e um exemplo da especificação de comando, consulte Especificação de Comando.

Principais Benefícios da Adição de um Estágio do Shell

  • Automatize implantações em plataformas do OCI, como malha de serviços e instâncias de contêiner, usando a CLI do OCI e outras ferramentas pré-instaladas. Consulte Detalhes de Runtime de Imagem do Contêiner do Shell.

    A CLI do OCI é pré-autenticada para usar o controlador de recursos do pipeline para acessar os recursos do OCI.

  • Execute uma migração de esquema usando as ferramentas de linha de comando, como SQLcl (Oracle SQL Developer Command Line).
  • Use quaisquer parâmetros de pipeline fazendo referência a eles na especificação. Substitua também parâmetros e variáveis durante a execução da implantação.
  • Execute testes de integração em artefatos antes de implantar na produção.
  • Personalize o workflow do serviço DevOps. Por exemplo, você pode esperar que alguns recursos estejam prontos para que o pipeline implante recursos adicionais.

Antes de criar o pipeline, você deve ter um projeto do serviço DevOps e um artefato de especificação de comando. Os artefatos podem ser definidos em linha ou localizados no Artifact Registry.

    1. Abra o menu de navegação e clique em Serviços do Desenvolvedor. Em DevOps, clique em Projetos.
    2. Selecione um projeto e clique em Criar pipeline.
    3. Digite um nome e uma descrição para o pipeline. A adição de uma descrição é opcional.
    4. Para Tipo de pipeline, selecione Criar um pipeline de implantação.
    5. Clique em Criar pipeline.
    6. Para adicionar um estágio ao novo pipeline, clique no ícone + e selecione Adicionar estágio.
    7. Selecione Integrações - Shell e clique em Próximo.
    8. Digite um nome e uma descrição opcional para o estágio.
    9. Clique em Selecionar Artefato e selecione o artefato de especificação de comando disponível para implantação.

    10. Selecione o compartimento para criar a instância do contêiner em que a especificação é executada.

      Você pode manter o compartimento padrão que é exibido.

    11. Selecione um domínio de disponibilidade.

    12. Selecione uma forma para a instância do contêiner entre as opções fornecidas. Você também pode selecionar o número de OCPUs e a quantidade de memória da instância.

      Haverá cobrança pela instância de contêiner (com base na forma de computação selecionada) durante a implantação, considerando o modelo de preços para instâncias de contêiner. Consulte Preço do Serviço Container Instances.

      1. Selecione uma VCN (Rede Virtual na Nuvem) e uma sub-rede regional na tenancy. Você pode selecionar sub-rede pública ou privada.

        Quando o comando é executado, uma VNIC (placa de interface de rede virtual) é criada na sub-rede selecionada. Certifique-se de que a sub-rede tenha um caminho de rede para o serviço OCI Container Registry. Se qualquer comando precisar gerenciar outros recursos do OCI, isso também deverá ser tratado para garantir que o caminho da rede e a política sejam configurados corretamente.

      2. (Opcional) Para restringir o acesso à sua VCN, você pode selecionar Grupos de segurança de rede (NSGs) em suas VCNs.
      3. (Opcional) Digite um valor de timeout (em segundos) para o estágio.
    13. (Opcional) Para adicionar tags ao pipeline, 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 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.

    Adicione mais estágios de forma sequencial ou paralela ao pipeline, conforme necessário. Para implantar a saída de build no ambiente de destino, execute o pipeline de implantação.

    Para acionar automaticamente uma implantação no pipeline de build, você pode adicionar um estágio Acionar Implantação ao pipeline de build.

  • Para criar um pipeline de implantação, execute o comando create:

    oci devops deploy-pipeline create --project-id

    Para criar um estágio do Shell, execute o comando create-shell-stage:

    oci devops deploy-stage create-shell-stage

    Parâmetros obrigatórios para o comando create-shell-stage:

    • --pipeline-id
    • --stage-predecessor-collection
    • --command-spec-artifact-id
    • --container-config

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

    oci devops deploy-pipeline -h
    oci devops deploy-stage -h

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

    oci devops deploy-stage create-shell-stage -h

  • Para criar um pipeline de implantação, use a operação CreateDeployPipeline.

    Para adicionar um Estágio do shell ao pipeline, use a operação CreateDeployStage. Para o atributo deployStageType, especifique o valor SHELL.