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 implementar a imagem do Docker do aplicativo no grupo de clusters definido em Satellite.

1. Clique em Vários clusters via Satellite para implementar o seu aplicativo usando Satellite.

   

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 de cadeia de ferramentas fornece um aplicativo do Aplicativo Hello Containers. 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.

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.

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

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.

Há um acionador do Git Repos and Issue Tracking configurado para acionar um pipeline de entrega contínua automático, mas que, por padrão, fica desativado. É possível habilitar esse acionador após promover uma mudança pela primeira vez.