Documentação do Oracle Cloud Infrastructure

Implantando em um Grupo de Instâncias

Crie um pipeline para implantar artefatos nos grupos de instâncias.

Pré-requisitos

Os pré-requisitos para implantar artefatos em um grupo de instâncias são os seguintes:

  • Ter um pipeline de implantação, um ambiente de grupo de instâncias para o qual implantar e artefatos. Os artefatos podem ser definidos em linha ou localizados no Artifact Registry.

    A implantação do DevOps suporta a implantação de vários artefatos em um estágio. Para implantação de grupo de instâncias, um arquivo de configuração de implantação define os comandos e executa as etapas para fazer download do artefato do pacote de aplicativos no registro de artefatos especificado e colocar no sistema de arquivos da instância de computação de destino. Consulte Arquivo de Configuração de Implantação.

  • O plug-in Compute Instance Run Command deve estar ativado na instância e em execução. Para ativar o plug-in, siga estas etapas:
    1. Na Console, abra o menu de navegação e clique em Compute. Em Compute, clique em Instâncias.
    2. Selecione uma instância do grupo de instâncias para implantação.
      Observação

      O DevOps suporta apenas implantações de grupo de instâncias no Oracle Linux e CentOS.
    3. Clique na guia Oracle Cloud Agent.

    4. Para o plug-in Compute Instance Run Command, alterne a opção Plug-in Ativado para Ativado.

      Leva até 10 minutos para que a alteração entre em vigor.

      Cuidado

      A funcionalidade que depende do plug-in, como monitoramento, dimensionamento automático, implantação ou gerenciamento do sistema operacional, não funciona quando o plug-in está desativado.
      Cuidado

      Para implantar aplicativos usando o plug-in Compute Instance Run Command, configure corretamente e mantenha políticas de privilégio mínimo. Para obter mais informações, consulte Executando Comandos em uma Instância.

      Para obter informações sobre o gerenciamento de plug-ins, consulte Gerenciando Plug-ins com o Oracle Cloud Agent. Para solucionar problemas, consulte Diagnosticando e Solucionando Problemas do Oracle Cloud Agent.

  • Ter permissão para executar comandos na instância. Consulte a política de IAM (Identity and Access Management) necessária.

Para criar grupos dinâmicos e políticas para pipelines de implantação, consulte Políticas de Pipeline de Implantação. Para obter mais detalhes, consulte Políticas do Serviço IAM do DevOps.

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 implantação.
    3. Para adicionar um estágio ao pipeline, clique no ícone + e selecione Adicionar estágio.
    4. Para o tipo de estágio, selecione Implantar - Grupo de Instâncias 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. Para Ambiente, selecione um grupo de instâncias existente.
    7. Clique em Selecionar Artefato e selecione os artefatos de configuração de implantação do grupo de instâncias disponíveis para implantação.

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

    8. (Opcional) Clique em Selecionar Artefato para adicionar mais artefatos baixados nas instâncias de computação durante a implantação.

      Esses artefatos adicionais não devem ser definidos em linha.

    9. (Opcional) Clique em Selecionar balanceador de carga. O balanceador de carga deve estar disponível na Console.
      1. Selecione a região e o compartimento do balanceador de carga.
      2. Selecione um balanceador de carga na lista disponível.

      O balanceador de carga distribui o tráfego de produção durante a implantação. Para obter mais informações, consulte Gerenciamento de Balanceadores de Carga.

    10. Para adicionar um listener ao balanceador de carga, clique em Selecionar Listener.

      Os listeners verificam se há tráfego de entrada no endereço IP do balanceador de carga. Para obter mais informações, consulte Gerenciamento do Listener.

    11. Para fazer rollback automaticamente para a última versão de release bem-sucedida se a validação falhar, selecione Sim. Para obter mais informações, consulte Fazendo Rollback de uma Implantação.
    12. A política de rollback controla a taxa e o comportamento do rollout da instância em todo o ambiente de destino. Selecione uma das seguintes opções:
      • Rollout por porcentagem: Digite o valor da porcentagem entre 1 e 100. Esse valor controla a porcentagem máxima de instâncias implantadas ou que não estão em execução de cada vez.
      • Rollout por contagem: Digite o valor da contagem. Esse valor controla o número máximo de instâncias implantadas ou que não estão em execução de cada vez.
    13. (Opcional) Para Atraso entre batches, digite uma duração em segundos.
    14. (Opcional) A Política de falha define os critérios de falha para um estágio. Ela pode ser definida com base no número de hosts de computação que falham em um grupo de instâncias. Selecione uma das seguintes opções:
      • Nenhuma
      • Falha por porcentagem: Digite o valor da porcentagem entre 1 e 100. Esse valor define a porcentagem de hosts de computação que falham, após o que o estágio falha.
      • Falha por contagem: Digite o valor da contagem. Esse valor define o número de hosts de computação que falham, após o que o estágio falha.
    15. (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 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

    16. 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.

    Você pode adicionar 100 estágios paralelos ao pipeline de implantação, mas o plug-in Executar Comando suporta apenas cinco comandos em uma instância. Portanto, você deve ter instâncias suficientes para executar 100 implantações de grupo de instâncias paralelas.

    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 estágio do grupo de instâncias, execute o comando create-deploy-compute-instance-group-stage:

    oci devops deploy-stage create-deploy-compute-instance-group-stage

    Parâmetros obrigatórios para o comando create-deploy-compute-instance-group-stage:

    • --compute-instance-group-environment-id
    • --deployment-spec-artifact-id
    • --rollout-policy
    • --pipeline-id
    • --stage-predecessor-collection

    Para obter todos os comandos para deploy-stage:

    oci devops deploy-stage -h

    Para obter ajuda para o comando create-deploy-compute-instance-group-stage:

    oci devops deploy-stage create-deploy-compute-instance-group-stage -h

  • Para criar um estágio de implantação de Grupo de Instâncias para o pipeline, use a operação CreateDeployStage. Para o atributo deployStageType, especifique o valor COMPUTE_INSTANCE_GROUP_ROLLING_DEPLOYMENT.