Configurando o Jenkins
Jenkins é uma ferramenta de software livre baseada no servidor que constrói e testa software continuamente, apoiando as práticas de integração contínua e entrega contínua.
Antes de criar uma integração de ferramenta do Jenkins, deve-se ter um servidor do Jenkins.
Com a integração de ferramenta Jenkins, é possível enviar notificações de tarefas do Jenkins para outras ferramentas em sua cadeia de ferramentas, como Slack e PagerDuty. Para rastrear o código em implementações, é possível incluir mensagens de implementação nas confirmações do Git e em seus problemas Git ou JIRA relacionados. É possível também visualizar suas implementações na página Conexões da cadeia de ferramentas. É possível alimentar resultados de teste para o DevOps Insights, incluir portas de qualidade automatizadas e rastrear seu risco de implementação.
Configure o Jenkins para automatizar a construção, o teste e a implementação contínuos de seus apps:
-
Se você estiver configurando essa integração de ferramenta durante a criação da cadeia de ferramentas, na seção Integrações configuráveis, clique em Jenkins.
-
Se você tiver uma cadeia de ferramentas e estiver adicionando essa integração de ferramentas a ela, no console IBM Cloud, clique no ícone
Menu > Automação da plataforma > Cadeias de ferramentas. Na página Cadeias de ferramentas, clique na cadeia de ferramentas para abrir a sua página de Visão geral. Como alternativa, na página Visão Geral do seu app, no cartão Entrega contínua, clique em Visualizar a cadeia de ferramentas. Em seguida, clique em Visão geral.
a. Clique em Incluir ferramenta.
b. Na seção Integrações de ferramentas, clique em Jenkins.
-
Digite o nome que você deseja exibir para essa integração de ferramenta no cartão Jenkins em sua cadeia de ferramentas.
-
Digite a URL do servidor Jenkins que você deseja abrir ao clicar no cartão do Jenkins de sua cadeia de ferramentas.
-
Copie o webhook da cadeia de ferramentas gerada.
-
No servidor Jenkins, conclua estas etapas:
a. Instale o plug-in do IBM Cloud DevOps.
b. Configure Jenkins para notificar as cadeias de ferramentas.
c. Retorne para a página Configurar a integração para a integração de ferramenta Jenkins.
-
Clique em Criar integração.
-
Na página de visão geral da cadeia de ferramentas, na placa Ferramentas de terceiros, clique em Jenkins para visualizar o servidor Jenkins.
Configuração do Jenkins usando a API
A integração da ferramenta Jenkins suporta os seguintes parâmetros de configuração que você pode usar com a API HTTP API e SDKs quando você criar, reade update integrações de ferramentas.
Você deve especificar a propriedade tool_type_id
no corpo da solicitação com o valor jenkins
.
Parâmetro | Uso | Tipo | Argumento de Terraform | Descrição |
---|---|---|---|---|
api_token | opcional, atualizável | Senha | api_token | O token API para usar para chamadas de API REST Jenkins para que DevOps Insights possa coletar dados de Jenkins. Você pode encontrar o token da API na página Configuração de sua instância Jenkins. Você pode usar uma referência secreta de cadeia de ferramentas para este parâmetro. Para obter mais informações sobre referências secretas, consulte Protegendo seus dados sensíveis em Continuous Delivery. |
api_user_name | opcional, atualizável | Sequência | api_user_name | O username para usar com o token API do servidor Jenkins, que é necessário para que DevOps Insights possa coletar dados de Jenkins. Você pode encontrar seu nome de usuário API na página Configuração de sua instância Jenkins. |
Dashboard_url | necessário, atualizável | Sequência | Dashboard_url | A URL do painel do servidor Jenkins para esta integração de ferramenta. Na UI gráfica, o navegador vai para este painel ao clicar no cartão de integração da ferramenta Jenkins. |
nome | necessário, atualizável | Sequência | nome | O nome dessa integração de ferramenta. |
webhook_url | opcional, atualizável | Sequência | webhook_url | O webhook para usar em seus Jenkins empregos para enviar notificações para outras ferramentas em sua cadeia de ferramentas. |