Conteúdo relacionado

• Introdução ao Continuous Delivery
• Introdução aos clusters
• Introdução a cadeias de ferramentas

Configure o nome e a região da cadeia de ferramentas

Revise as informações padrão para as configurações da cadeia de ferramentas. O nome da cadeia de ferramentas as identifica em IBM Cloud. Certifique-se de que o nome da cadeia de ferramentas seja exclusivo dentro de suas cadeias de ferramentas para a mesma região e grupo de recursos no IBM Cloud.

A região da cadeia de ferramentas pode ser diferente da região de cluster e registro.

Selecione a estratégia de implementação

A cadeia de ferramentas cria um Pipeline de implementação contínua para a implementação da imagem do Docker do aplicativo no IBM Cloud® Kubernetes Service. Selecione a estratégia de implementação que deseja utilizar. Dependendo da estratégia de implementação escolhida (Contínua, Azul-verde ou Canary), pode ser necessário fornecer mais detalhes.

1. Clique na estratégia de implementação que deseja utilizar para a cadeia de ferramentas.

   

2. Clique em Continuar.

Configurar o repositório de código-fonte do aplicativo

Na etapa Aplicativo, por padrão, são exibidas as opções recomendadas para o repositório de código-fonte do aplicativo. Para visualizar todas as opções disponíveis para a integração do Git subjacente, clique em Opções avançadas. Por padrão, a cadeia de ferramentas usa a mostra padrão, que clona o aplicativo de amostra como um repositório Git Repos and Issue Tracking hospedado pela IBM

É possível alterar o nome do repositório do aplicativo. A região do repositório permanece a mesma da cadeia de ferramentas.

O modelo da cadeia de ferramentas fornece um exemplo de aplicativo Spring do tipo “ Java™ ” que utiliza uma compilação com o Maven. Caso queira vincular um repositório de Aplicativos existente à cadeia de ferramentas, selecione Trazer um aplicativo próprio e especifique a URL do repositório. A cadeia de ferramentas suporta a vinculação apenas a repositórios Git Repos and Issue Tracking existentes.

Por padrão, o modelo do repositório de aplicativo é clonado para a organização de Git Repos and Issue Tracking. Para alterar a organização, ative as Opções avançadas e especifique o proprietário do repositório.

Configurar o repositório de inventário

O repositório de inventário registra os detalhes dos artefatos construídos pelas cadeias de ferramentas de integração contínua. Você pode criar um novo repositório de inventário que seja um clone do modelo de repositório de inventário ou usar um repositório de inventário já existente que seja compartilhado entre as cadeias de ferramentas.

Por padrão, o modelo do repositório de inventário é clonado para sua organização de Git Repos and Issue Tracking. Para alterar a organização, selecione Opções avançadas e especifique o proprietário do repositório.

Armazenamento seguro de segredos

Várias ferramentas contidas nessa cadeia de ferramentas requerem segredos, como uma chave de API do IBM Cloud. Você deve armazenar com segurança todos os segredos em uma área segura e fazer referência a eles de acordo com as exigências da cadeia de ferramentas.

Com o IBM Cloud, é possível escolher entre várias ofertas de gerenciamento de segredos e de proteção de dados, que ajudam a proteger seus dados sensíveis, centralizando o segredo. Na etapa Segredos, é possível especificar quais integrações de áreas seguras de segredos devem ser incluídas ou removidas da cadeia de ferramentas. Para obter mais informações sobre a inclusão e remoção de integrações de área segura, incluindo pré-requisitos e sobre o uso de dicas, consulte Gerenciando segredos do IBM Cloud.

Ao usar as sugestões de um modelo, a cadeia de ferramentas é preenchida automaticamente com segredos pré-configurados; não é necessário selecionar manualmente os segredos das integrações de áreas seguras conectadas à cadeia de ferramentas.

Este tutorial usa o IBM Secrets Manager como área segura de segredos.

O IBM Secrets Manager armazena e aplica com segurança os segredos, como chaves de API , assinaturas de imagens ou credenciais HashiCorp que fazem parte da cadeia de ferramentas.

Para obter mais informações sobre como gerenciar seus segredos em IBM Key Protect ou HashiCorp,, consulte Segredos.

Configurar detalhes de VPC

Configure a cadeia de ferramentas especificando informações sobre VPC e sobre Instâncias de servidor virtual (VSI).

As informações de VPC e VSI foram fornecidas utilizando o IBM Cloud® Schematics e o Terraform ao selecionar a estratégia de implementação a ser utilizada.

• Região da nuvem privada virtual: selecione a região na qual a VPC foi fornecida.
• Nome da nuvem privada virtual: selecione a VPC que foi fornecida utilizando o modelo Terraform. As opções incluem todas as VPCs disponíveis na região selecionada.
• Nome do usuário para instâncias de VPC: especifique o nome do usuário configurado ao fornecer a instância de VPC. Todas as VSIs na VPC precisam de um nome de usuário e de uma chave SSH para efetuar login e implementar essa instância.
• Chave SSH com codificação base64 para as instâncias de VPC: especifique a chave SSH privada, em formato codificado em base64, para a chave SSH pública configurada ao fornecer as instâncias de VPC.

Configurar detalhes do host Bastion

O modelo do Terraform também cria uma VSI a ser usada como um host Bastion. Utilizando um host Bastion, é possível se conectar com segurança às VSIs contidas na VPC para a execução de tarefas de implementação e manutenção. O host Bastion se conecta às VSIs por meio de SSH, utilizando as credenciais (nome de usuário e chave SSH) configuradas nos detalhes da VPC.

A cadeia de ferramentas exige que se efetue login nas VSIs contidas na VPC para implementar o binário do aplicativo, iniciar e parar o aplicativo e fazer download da dependência de terceiros para execução do aplicativo. Todas essas tarefas são executadas utilizando o Tunelamento de SSH com o host Bastion. A cadeia de ferramentas utiliza para o login no host Bastion as mesmas credenciais utilizadas pelo host Bastion para a conexão com as VSIs.

• Host Bastion: selecione a VSI que é fornecida como host Bastion pelo modelo do Terraform.

Configurar detalhes do Balanceador de carga

O aplicativo de amostra implementado nas VSIs da VPC exibe uma página da web simples na porta 8080. Para disponibilizar o aplicativo na Internet, utilizando um nome DNS, e fazer o balanceamento de carga do tráfego entre as várias VSIs que executam o aplicativo, o modelo do Terraform fornece um Balanceador de carga do aplicativo. Todas as VSIs que executam o aplicativo compõem o conjunto de back-end dos servidores do Balanceador de carga.

A cadeia de ferramentas utiliza os detalhes do Balanceador de carga e dois conjuntos de back-end para configurar e redirecionar o tráfego de aplicativos em tempo real durante o processo de implementação azul-verde. O conjunto de back-end azul e o conjunto de back-end verde contêm o mesmo número de VSIs. A qualquer momento, apenas um dos conjuntos atende ativamente o tráfego em tempo real, enquanto o outro permanece inativo, executando uma versão mais antiga do aplicativo. A cada implementação, o Balanceador de carga troca ou alterna o conjunto de back-end que atende o tráfego em tempo real. Se em um momento o conjunto de back-end azul está ativo, na próxima implementação, o aplicativo é implementado nas VSIs do conjunto de back-end verde, que fica ativo, enquanto o conjunto de back-end azul torna-se passivo.

Configure a cadeia de ferramentas especificando informações sobre o Balanceador de carga:

• Nome do Balanceador de carga: selecione o balanceador de carga do aplicativo fornecido pelo modelo do Terraform.
• Nome do conjunto de back-end azul: selecione o conjunto de back-end azul fornecido pelo modelo do Terraform para o Balanceador de carga.
• Nome do conjunto de back-end verde: selecione o conjunto de back-end verde fornecido pelo modelo do Terraform para o Balanceador de carga.

Depois de preencher os detalhes para as etapas do deployment target, prossiga para a etapa seguinte.

Configurar o armazenamento de artefatos

Qualquer mudança na origem aciona o pipeline de integração contínua. Quando uma execução de integração contínua é bem sucedida, um artefato de construção ou binário é criado e salvo no armazenamento temporário e, em seguida, implementado nas VSIs de destino.

É possível usar o IBM Cloud Object Storage para armazenar artefatos de construção temporários na cadeia de ferramentas. O pipeline de integração contínua constrói o arquivo .jar executável para o Spring Java App de amostra.

Como alternativa, é possível usar o Artifactory, caso você tenha sua própria instância do Artifactory.

Explorar os pipelines

É possível explorar os pipelines para entender o fluxo da cadeia de ferramentas e as diferentes operações que são executadas em cada um deles. A cadeia de ferramentas recém-criada contém três pipelines:

• Pipeline de solicitação pull: executado quando um desenvolvedor mescla as mudanças de sua ramificação de desenvolvimento à ramificação principal ou a qualquer outra ramificação no repositório. O pipeline de solicitação pull executa o Teste de unidade e as Varreduras estáticas no código-fonte do aplicativo.
• Pipeline de integração contínua: executado ao mesclar uma mudança na ramificação principal do repositório de Código-fonte do aplicativo. O pipeline de integração contínua executa o Teste de unidade, a Cobertura de código e Varreduras estáticas no Código-fonte do aplicativo, a verificação do CIS e a verificação da Lista de materiais (BOM). O pipeline de entrega contínua também gera os artefatos de construção binários e os transfere por upload para o IBM Cloud® Kubernetes Service, conforme configurado na cadeia de ferramentas. Além disso, o pipeline de integração contínua gera os metadados dos artefatos de construção, armazenando-os no repositório de Inventário.
• Pipeline de implementação contínua: implementa artefatos de construção no ambiente de implementação. Para conferir se a implementação do aplicativo foi bem-sucedida, o pipeline executa a verificação de funcionamento. Este pipeline deve ser acionado manualmente após a conclusão bem-sucedida do pipeline de integração contínua. Dependendo da estratégia de implementação selecionada, mais acionadores podem ser incluídos no pipeline de integração contínua.

Executar a solicitação pull e os pipelines de integração contínua.

Para iniciar o pipeline de solicitação pull, crie uma solicitação de mesclagem no repositório do aplicativo:

1. Na página de visão geral da cadeia de ferramentas, na placa Repositórios, clique no repositório do apps compliance-app-<timestamp>.
2. No repositório principal, crie uma ramificação.
3. Atualize parte do código no aplicativo de nó de amostra ou no arquivo leia-me e salve essas mudanças.
4. Envie a solicitação de mesclagem.
5. Na página de visão geral da cadeia de ferramentas, na placa Repositórios, clique no repositório pr-pipeline para iniciar o pipeline de solicitação pull. A solicitação de mesclagem correspondente em seu repositório de aplicativo permanecerá no estado pendente até que o pipeline de solicitação pull seja concluído com êxito.
6. Após a conclusão bem-sucedida, é possível selecionar o pipeline de solicitação pull para explorar as etapas concluídas.

Para iniciar o pipeline de integração contínua, mescle a solicitação de mesclagem de integração contínua no repositório de aplicativos:

1. Acesse a solicitação de mesclagem.
2. Faça a mesclagem da solicitação para que as mudanças sejam copiadas para a ramificação principal do repositório de aplicativos. O pipeline de integração contínua é acionado automaticamente.
3. Na página de visão geral da cadeia de ferramentas de integração contínua, na placa Repositórios, clique no repositório ci-pipeline para iniciar o pipeline de integração contínua.
4. Após a execução bem-sucedida do pipeline de integração contínua, é possível clicar na execução de pipeline para explorar as etapas concluídas.

Para avaliar a existência de possíveis falhas na execução do pipeline, consulte a etapa final do pipeline, que possui um avaliador de pipeline.

Explorar o pipeline de entrega contínua

Os pipelines de solicitação pull e de integração contínua são comuns em todas as estratégias de implementação. O design do pipeline de entrega contínua e as mudanças de implementação são baseados na estratégia de implementação selecionada anteriormente neste tutorial

Este tutorial demonstra o funcionamento da estratégia de implementação azul-verde, utilizando o aplicativo de amostra.

Explorar a implantação azul-verde

A opção de implementação azul-verde usada neste tutorial demonstra como utilizar uma estratégia de implementação com o Serviço do Continuous Delivery para execução da carga de trabalho de produção na VPC. O pipeline de entrega contínua fornece três acionadores para a implementação azul-verde. Um pipeline de entrega contínua pode ser iniciado de uma das seguintes maneiras:

• Acionamento manual do pipeline de entrega contínua.
• Acionamento automático do pipeline de entrega contínua após cada ação de Merge no repositório de inventário. Após a mesclagem, deve-se acionar manualmente a execução do pipeline de entrega contínua.
• Alterne entre as implementações azul e verde para automatizar o retrocesso.

Este tutorial demonstra o funcionamento da estratégia de implementação azul-verde, utilizando o aplicativo de amostra.

1. Execute o acionador manual do pipeline de entrega contínua para implementar a primeira versão do aplicativo.

   

2. Localize a URL do aplicativo na etapa release do pipeline de entrega contínua e clique na URL para verificar se o aplicativo está em execução.

   

3. Atualize o código do aplicativo e confirme suas mudanças. Para o aplicativo de amostra, atualize a mensagem de boas-vindas:

   a. Na página de visão geral da cadeia de ferramentas, na placa Repositórios, clique no repositório do app de amostra.

   b. Atualize a mensagem de boas-vindas no arquivo utils.js.

   c. Espere até que a execução do pipeline de integração contínua seja concluída com êxito.

4. Execute o acionador manual do pipeline de entrega contínua e espere até que a execução do pipeline de entrega contínua seja concluída com êxito.

5. Verifique novamente a URL do aplicativo para confirmar se o aplicativo atualizado está implementado. Ambas as versões do aplicativo estão em execução simultaneamente. Todo o tráfego de rede está fluindo para o aplicativo atualizado.

6. Para testar o retrocesso, execute o acionador do switch-blue-green a partir do pipeline de entrega contínua. Espere até que a execução do pipeline do acionador do comutador seja concluída com êxito.

   

7. Verifique novamente a URL do aplicativo para confirmar se a versão anterior do aplicativo é exibida.

É possível executar várias vezes o acionador do comutador para alternar entre as versões anterior e mais recente do aplicativo.