Parte 2: Configurar uma cadeia de ferramentas de CI

Aplicativo

1. Selecione Source Provider como Git Repos and Issue Tracking.
2. O comportamento padrão da cadeia de ferramentas é Usar aplicativo de amostra padrão. Atualmente, a cadeia de ferramentas é compatível com a vinculação apenas aos repositórios Git Repos and Issue Tracking existentes. Se estiver usando o repositório de código-fonte " aplicativo/serviço próprio, consulte:

• Trazendo seu próprio aplicativo para o DevSecOps.
• Configure automaticamente seus pipelines DevSecOps usando o recurso Inferred DevSecOps Pipeline Configuration.

3. Digite um nome exclusivo para Novo nome do repositório.
4. Clique em Continuar.

Inventário

O repositório de inventários registra detalhes de artefatos que são construídos pelas cadeias de ferramentas de CI.

1. Você pode aceitar a configuração padrão fornecida no modelo ou editar a configuração de acordo com suas necessidades.
2. Clique em Continuar.

Problemas

O repositório de questões registra problemas que são encontrados enquanto o pipeline de IC está em execução.

1. Você pode aceitar a configuração padrão fornecida no modelo ou editar a configuração de acordo com suas necessidades.
2. Clique em Continuar

Segredos

Especifique as integrações de cofre secreto a serem adicionadas à sua cadeia de ferramentas usando os botões de alternância. Para obter mais informações, consulte Gerenciando IBM Cloud segredos.

A cadeia de ferramentas de CI suporta segredos Arbitrários e credenciais IAM tipos secretos apenas.

1. Este tutorial usa IBM Cloud® Secrets Manager como o cofre para segredos. Os campos Região, Grupo de recurso e Nome do serviço são preenchidos automaticamente com base em escolhas disponíveis. Selecione os indicadores suspensos para ver as outras opções.
2. Digite seu Secrets Manager nome da instância.
3. Selecione o tipo de autorização.
4. Clique em Continuar.

Armazenamento de evidência

O repositório de evidências armazena todas as evidências e artefatos que são gerados pelo pipeline de CI do DevSecOps.

1. Alterne o controle deslizante do compartimento IBM Cloud Object Storage para armazenar todas as evidências no compartimento IBM Cloud Object Storage que pode ser configurado na próxima página.
2. Aceitar as configurações padrão.
3. Clique em Continuar.

Nuvem Object Storage balde

Você deve ter a instância IBM Cloud® Object Storage e um Cloud Object Storage bucket para atuar como um armário de evidências de conformidade.

1. Os campos Cloud Object Storage instance, Bucket name e Cloud Object Storage endpoint são preenchidos automaticamente.
2. Digite sua chave da API de ID do serviço.
   • Preferencial: Uma chave existente pode ser importada de um cofre de segredos, clicando no ícone de chave.
   • Uma chave existente pode ser copiada e colada.
3. Clique em Continuar.

O campo endpoint é opcional. Recomenda-se selecionar ou fornecer o terminal durante a configuração da cadeia de ferramentas ou durante a execução do pipeline.

Implementar

Configure o cluster Kubernetes de destino onde o aplicativo foi implementado.

1. Use o nome do aplicativo padrão hello-compliance-app.

2. Digite sua chave de API IBM Cloud. A chave da API é usada para interagir com a ferramenta IBM Cloud CLI em várias tarefas.

   • Preferencial: Uma chave existente pode ser importada de um cofre de segredos, clicando no ícone de chave.
   • Uma chave existente pode ser copiada e colada.
   • Uma nova chave pode ser criada a partir daqui, clicando em New +.

   A chave API recém-gerada pode ser imediatamente salva em um cofre de segredos.

3. Se a chave da API for válida e tiver acesso suficiente, o Container Registry, Container Registry namespace, Dev cluster region, Resource group, Cluster name, Cluster namespace são preenchidos automaticamente. Você pode alterar qualquer um desses campos para que correspondam à sua configuração.

4. Clique em Continuar.

Assinatura de artefato

Os artefatos criados pela cadeia de ferramentas e registrados no inventário devem ser assinados antes de serem implantados na produção.

1. Digite a GnuPG chave privada. Como alternativa, você pode criar uma nova chave GPG clicando em NEW. Para obter mais informações, consulte Geração de uma chave GPG.
2. Clique em Continuar.

DevOps Insights

O IBM Cloud DevOps Insights está incluído na cadeia de ferramentas. Visualize seus resultados de testes de pipeline para cada construção, a partir de cada implementação e ambiente.

1. Aceitar a configuração padrão.
2. Clique em Continuar.

SonarQube

Configure o SonarQube como a ferramenta de análise de código estático para a cadeia de ferramentas. O SonarQube fornece uma visão geral do funcionamento geral e da qualidade do seu código-fonte e destaca os problemas encontrados no novo código. Os analisadores de código estático detectam bugs complicados, como desreferências de ponteiro nulo, erros de lógica e vazamentos de recursos para várias linguagens de programação.

1. Aceitar a configuração padrão.
2. Clique em Continuar.

Ferramentas opcionais

Execute o pipeline ci-pr

Para iniciar o ci-pr pipeline, você precisa criar uma solicitação de mesclagem no repositório do aplicativo.

1. Na página da cadeia de ferramentas de CI, clique no bloco ci-pr pipeline. Por padrão, ele é criado com o nome compliance-app-<timestamp>.

2. Crie uma ramificação a partir da ramificação principal.

3. Atualize o código no aplicativo ou adicione um arquivo leia-me e salve as alterações.

4. Clique em Enviar solicitação de mesclagem.

5. Na página da cadeia de ferramentas de CI, clique no bloco pr-pipeline. Verifique se o ci-pr pipeline é acionado pela criação da solicitação de mesclagem.

6. Aguarde a conclusão da execução do ci-pr pipeline. A solicitação de mesclagem correspondente que está em seu repositório de aplicativos está no estado Pending até que todos os estágios do pipeline de PR sejam concluídos com êxito.

7. Depois que a execução do pipeline de PR for bem-sucedida, clique no pipeline para explorar várias etapas que foram concluídas e para visualizar a página.

   

8. Acesse a Solicitação de mesclagem para mesclar a solicitação de modo que suas alterações sejam copiadas para o branch mestre do repositório do aplicativo.

Execute o pipeline de CI

Inicie o pipeline de IC de uma das seguintes formas:

• Automaticamente: após um pipeline de PR bem-sucedido, aprovando e mesclando o PR na ramificação principal.
• Manualmente: Para acionar o pipeline de CI manualmente, selecione o cartão Delivery Pipeline, clique em Run Pipeline (Executar pipeline ) e selecione Manual Trigger (Acionador manual).

Neste tutorial, o pipeline de CI foi acionado depois que você fez o merge das alterações de código na ramificação principal do repositório do aplicativo.

1. Na página da cadeia de ferramentas de CI, clique no bloco ci-pipeline.

2. Clique em Run no nome do seu pipeline. Observe que um pipeline está sendo executado. Aguarde a conclusão da execução do pipeline.

3. Depois que a execução do pipeline de CI for bem-sucedida, clique no pipeline para explorar as etapas concluídas e visualizar a página, conforme mostrado na captura de tela.

   

4. Clique no bloco DevOps Insights para analisar as evidências coletadas na página Quality Dashboard, conforme mostrado na captura de tela.

   

   Você também pode revisar as evidências se o IBM Cloud Object Storage bucket estiver ativado durante a configuração. Para avaliar se há alguma falha na execução do pipeline, você precisa verificar a etapa final do pipeline, que tem um avaliador de pipeline.

Visualizando o aplicativo em execução

Depois de uma execução bem-sucedida de pipeline de CI, o aplicativo de amostra é implementado em seu cluster Kubernetes.

O aplicativo URL pode ser encontrado no final do registro da etapa run stage da tarefa deploy-dev da execução do pipeline de CI. Use o endereço URL para verificar se o aplicativo está em execução.

Customização de pipeline

Os vários pipelines fornecidos nas cadeias de ferramentas de integração contínua e implantação contínua de referência baseiam-se no suporte Continuous Delivery para Tekton Pipelines. Para obter mais informações sobre a personalização do pipeline, consulte Como um usuário personaliza o pipeline?