Configurando o JIRA

DevOps Insights chegará ao fim de sua vida útil e será descontinuado em 31 de agosto de 2026. O serviço Continuous Delivery será descontinuado nas seguintes regiões em 12 de fevereiro de 2027: au-syd, ca-tor, us-east. O Code Risk Analyzer também será descontinuado em todas as regiões nessa data. Se uma região não apresentar uso ativo desses recursos, os recursos nessa região poderão ser descontinuados mais cedo e deixar de aceitar novas instâncias. Saiba mais

JIRA é uma ferramenta que rastreia problemas e erros relacionados ao software. A integração de ferramenta JIRA atualiza os problemas de seu projeto sempre que o Jenkins ou o Delivery Pipeline executa uma implementação.

Para que a integração de ferramenta JIRA rastreie seus problemas, deve-se usar Confirmações inteligentes JIRA em suas mensagens de confirmação. Para saber mais sobre o JIRA Smart Commits, consulte “Como usar o Smart Commits ”.

Configure o JIRA para planejar, rastrear e entregar código de qualidade:

  1. 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 JIRA.

  2. Se você já possui uma cadeia de ferramentas e deseja adicionar essa integração de ferramenta a ela, no console do IBM Cloud, clique no ícone de menu ( ícone de hambúrguer ) > Automação de 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.

    a. Clique em Incluir ferramenta.

    b. Na seção Integrações de ferramentas, clique em JIRA.

  3. Se você tiver um projeto JIRA e desejar se conectar a ele, para o tipo JIRA, clique em Existente:

    a. Digite a chave do projeto JIRA para o projeto JIRA. É possível localizar a chave do projeto na URL do projeto JIRA.

    b. Digite a URL da API base para sua instância do JIRA. É possível localizar a URL da API do cabeçalho da instância do JIRA. Clique no ícone Administração e clique em Sistema.

    c. Se você estiver se conectando a uma instância privada do JIRA ou desejar receber informações de rastreabilidade de uma instância pública do JIRA, insira seu nome do usuário e senha do JIRA.

    d. Para rastrear a implementação de mudanças de código para o projeto criando rótulos e comentários para problemas referenciados, marque a caixa de seleção Rastrear a implementação de mudanças de código. Certifique-se de usar a Confirmação inteligente JIRA para referenciar os problemas do JIRA nas confirmações do GitHub. Se você não selecionar essa opção, a integração de ferramenta JIRA ignorará quaisquer confirmações.

  4. Se desejar criar um projeto JIRA, para o tipo JIRA, clique em Novo:

    a. Digite uma chave de projeto JIRA para ser usada para o novo projeto. Essa chave é usada como um identificador exclusivo na URL do projeto.

    b. Digite um nome para o projeto JIRA.

    c. Digite a URL da API base para sua instância do JIRA. É possível localizar a URL da API do cabeçalho da instância do JIRA. Clique no ícone Administração e clique em Sistema.

    d. Digite o nome do usuário para o líder do projeto JIRA que você deseja usar para esse projeto. Para especificar alguém como o líder do projeto JIRA, essa pessoa deve ter a permissão de líder de projeto no JIRA.

    e. Digite o nome do usuário do administrador para essa instância do JIRA.

    f. Digite a senha do administrador para essa instância do JIRA.

    g. Para rastrear a implementação de mudanças de código para o projeto criando rótulos e comentários para problemas referenciados, marque a caixa de seleção Rastrear a implementação de mudanças de código. Certifique-se de usar a Confirmação inteligente JIRA para referenciar os problemas do JIRA nas confirmações do GitHub. Se você não selecionar essa opção, a integração de ferramenta JIRA ignorará quaisquer confirmações.

  5. Clique em Criar integração.

  6. Na página de visão geral da cadeia de ferramentas, na placa Ferramentas de terceiros, clique em JIRA para visualizar o painel para o projeto JIRA ao qual você está conectado.

Configurando o JIRA por meio da API

A integração da ferramenta JIRA suporta os seguintes parâmetros de configuração que você pode usar com a API e os SDKs HTTP da Toolchain ao criar, ler e atualizar integrações de ferramentas.

Você deve especificar a propriedade tool_type_id no corpo da solicitação com o valor jira.

Parâmetros de integração da ferramenta JIRA
Parâmetro Uso Tipo Argumento Terraform Descrição
api_url necessário, atualizável Sequência api_url A API básica URL para sua instância do JIRA.
enable_traceability opcional, atualizável, Default: false Booleano enable_traceability Acompanhe a implantação das alterações no código criando tags, rótulos e comentários em commits, pull requests e issues referenciados.
senha opcional, atualizável Senha token_api O token da API para sua conta JIRA. Opcional para projetos públicos.. É possível usar uma referência de segredo de cadeia de ferramentas para esse parâmetro Para obter mais informações, consulte Protegendo seus dados sensíveis em Continuous Delivery.
chave_do_projeto necessário, atualizável Sequência chave_do_projeto A chave do projeto do JIRA.
nome do usuário opcional, atualizável Sequência nome do usuário O nome do usuário para sua conta JIRA. Opcional para projetos públicos..