Consulte os conectores compatíveis com a integração de aplicativos.
Gatilho do Jira Cloud
O gatilho do Jira Cloud é um gatilho de evento do conector que permite invocar uma integração com base nos eventos do Jira Cloud aos quais você se inscreveu na sua conexão com o Jira Cloud.
Antes de começar
Se você planeja criar ou configurar uma nova conexão para o gatilho Jira do Cloud, verifique se tem o seguinte papel do IAM no projeto:
- Administrador do conector (
roles/connectors.admin
)
Para informações sobre como conceder papéis, consulte Gerenciar acesso.
Conceda os seguintes papéis do IAM à conta de serviço que você quer usar para o gatilho do Jira Cloud:
- Invocador do Application Integration (
roles/integrations.integrationInvoker
)
Para informações sobre como conceder papéis a uma conta de serviço, consulte Gerenciar o acesso a contas de serviço.
Adicionar o gatilho do Jira Cloud
Para adicionar um gatilho Jira do Cloud à sua integração, siga estas etapas:
- No console do Google Cloud, acesse a página Application Integration.
- No menu de navegação, clique em Integrações.
A página Lista de integrações aparece listando todas as integrações disponíveis no projeto do Google Cloud.
- Selecione uma integração ou clique em Criar integração para criar uma nova.
Caso você esteja criando uma nova integração, siga estas etapas:
- Insira um nome e uma descrição no painel Criar integração.
- Selecione uma região para a integração.
- Selecione uma conta de serviço para a integração. Você pode mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel Resumo da integração na barra de ferramentas da integração.
- Clique em Criar.
Isso abre a integração na página do editor de integração.
- Na barra de navegação do editor de integração, clique em Gatilhos para ver a lista de gatilhos disponíveis.
- Clique e coloque o elemento Gatilho do Jira Cloud no editor de integração.
Para configurar o gatilho do Jira Cloud, use uma conexão do Jira Cloud disponível no Integration Connectors ou crie uma nova conexão do Jira Cloud usando a opção de criação de conexão inline.
Configurar o gatilho do Jira Cloud usando uma conexão atual
É possível configurar o gatilho do Jira Cloud usando uma conexão do Jira Cloud existente no Integration Connectors. O gatilho Jira Cloud é um acionador de evento do conector. Portanto, só é possível usar uma conexão do Jira Cloud com a assinatura de eventos ativada para configurar o gatilho.
Para saber como configurar um gatilho do Jira Cloud usando uma nova conexão do Jira Cloud, consulte Configurar o gatilho do Jira Cloud usando uma nova conexão.
Para configurar um gatilho do Jira Cloud usando uma conexão do Jira Cloud, siga estas etapas:
- Clique no elemento Jira Cloud trigger no editor de integração para abrir o painel de configuração do gatilho.
- Clique em Configurar gatilho.
- Informe os seguintes detalhes de configuração na página Editor de gatilho de evento do conector:
- Região: selecione a região da sua conexão do Jira Cloud.
- Conexão:selecione a conexão do Jira Cloud que você quer usar.
A integração de aplicativos só mostra as conexões do Jira Cloud que estão ativas e têm uma assinatura de eventos ativada.
- Tipo de assinatura de evento:selecione o tipo de assinatura de evento que aciona a integração. Para saber mais sobre os tipos de assinatura de evento compatíveis com esse acionador, consulte Tipos de assinatura de evento compatíveis.
- Conta de serviço: selecione uma conta de serviço com os papéis do IAM necessários para o acionador do Jira Cloud.
- Clique em Concluído para concluir a configuração do acionador e fechar a página.
Configurar o acionador do Jira Cloud usando uma nova conexão
Para configurar o acionador do Jira Cloud usando uma nova conexão do Jira Cloud, siga estas etapas:
- Clique no elemento Jira Cloud trigger no editor de integração para abrir o painel de configuração do gatilho.
- Clique em Configurar acionador.
- Ignore o campo Região.
- Clique em Conexão e selecione a opção Criar conexão no menu suspenso.
- Conclua as etapas a seguir no painel Criar conexão:
- Na etapa Local, escolha o local da nova conexão do Jira Cloud:
- Região: selecione uma região na lista suspensa.
- Clique em Próxima.
- Na etapa Detalhes da conexão, forneça detalhes sobre a nova conexão do Jira Cloud:
- Versão do conector:escolha uma versão disponível do conector do Jira Cloud na lista suspensa.
- Nome da conexão: insira um nome para a conexão do Jira Cloud.
- (Opcional) Descrição: insira uma descrição para a conexão.
- (Opcional) Ativar o Cloud Logging: marque esta caixa de seleção para armazenar todos os dados de registro da conexão.
- Conta de serviço: selecione uma conta de serviço com os papéis do IAM necessários para a conexão do Jira Cloud.
- Ativar a assinatura de eventos: selecione para criar e ativar uma nova assinatura de eventos para a conexão do Jira Cloud. É possível ativar apenas as assinaturas de eventos ou incluir também entidades, operações e ações de conexão.
- (Opcional) Expanda Configurações avançadas para definir as configurações do nó de conexão.
Para mais informações sobre as configurações do nó de conexão para o Jira Cloud, consulte a documentação Conexão do Jira Cloud.
- (Opcional) Clique em + Adicionar rótulo para adicionar um rótulo à conexão na forma de um par de chave-valor.
- Clique em Próxima.
-
Na etapa Destinos, forneça os detalhes da conta do Jira Cloud:
- Destination Type:selecione Host address.
- Host:digite o nome do host ou o endereço IP da sua conta do Jira Cloud.
- Clique em Próxima.
-
Na etapa de Autenticação, insira os detalhes de autenticação da conta do Jira Cloud:
- Nome de usuário:digite o nome de usuário para acessar o endereço de destino fornecido.
- Token de API:selecione o secret do Secret Manager que contém o token de API associado ao nome de usuário do Jira Cloud.
- Versão do secret:selecione uma versão do secret.
- Clique em Próxima.
Para saber mais sobre como configurar a autenticação, consulte Configurar a autenticação.
-
Na etapa Detalhes da assinatura de eventos, forneça detalhes da conta do Jira Cloud em que as assinaturas de eventos serão criadas.
- Tipo de destino: selecione Endereço do host.
- Host: insira o URL de registro da sua conta do Jira Cloud. Serão criadas inscrições em eventos para esse URL.
- Nome de usuário:digite o nome de usuário para acessar o URL de registro fornecido.
- Token de API:selecione a chave secreta do Secret Manager com o token de API associado ao nome de usuário.
- Versão do secret: selecione uma versão do secret.
- Clique em Próxima.
- Revisão: analise os detalhes da conexão do Jira Cloud fornecidos.
- Clique em Criar para concluir a criação de uma nova conexão com o Jira Cloud.
- Na etapa Local, escolha o local da nova conexão do Jira Cloud:
- Tipo de assinatura de evento: selecione o tipo de assinatura de evento que aciona a integração. Para saber mais sobre os tipos de assinatura de evento compatíveis com esse acionador, consulte Tipos de assinatura de evento compatíveis.
- Clique em Concluído e feche a página.
Saída do gatilho
O gatilho Jira do Cloud leva alguns minutos para concluir a configuração da assinatura do evento. É possível conferir o status da assinatura do evento no painel de configuração do acionador em Detalhes da assinatura do evento.
O gatilho Jira Cloud indica o status de uma assinatura de evento usando os seguintes estados:
Creating
: indica que o acionador está se inscrevendo na assinatura de eventos.Active
: indica que o acionador foi inscrito em uma assinatura de evento.Error
: indica que há um problema com a assinatura de evento configurada.
Além do status da assinatura do evento, a seção Detalhes da assinatura do evento também mostra outros detalhes, como região de conexão, nome da conexão, nome da assinatura do evento e muito mais.
A imagem abaixo mostra um exemplo de layout do painel de configuração do gatilho do Jira Cloud:
Acionar variável de saída
Para cada evento, o gatilho Jira do Cloud gera uma variável de saída ConnectorEventPayload
que pode ser usada nas tarefas downstream. A variável de saída está no formato JSON e contém o esquema de payload de saída do Jira Cloud.
Conferir as assinaturas de eventos
Para visualizar e gerenciar todas as assinaturas de eventos associadas a uma conexão no Integration Connectors, faça o seguinte:
- Acesse Integration Connectors > Conexões.
- Clique na conexão em que você quer ver as assinaturas.
- Clique na guia Inscrições de eventos.
Isso mostra todas as assinaturas de eventos da conexão.
Editar gatilho do Jira Cloud
É possível editar um acionador do Jira do Cloud para mudar ou atualizar a configuração da conexão e os detalhes da assinatura do evento.
Para editar um acionador do Jira Cloud, siga estas etapas:
- Clique no elemento gatilho do Jira Cloud no editor de integração para abrir o painel de configuração do gatilho.
- Clique em Configurar o gatilho do Jira Cloud.
- Faça o seguinte na página Editor do acionador de evento do conector:
- Para manter a assinatura de eventos configurada anteriormente, clique em Reter. Caso contrário, clique em Excluir.
- Atualize a configuração da conexão e os detalhes de inscrição no evento conforme desejado.
- Clique em Concluído.
Confira os detalhes atualizados da conexão e da assinatura do evento no painel de configuração do acionador em Detalhes da assinatura do evento.
Tipos de assinatura de evento com suporte
Você pode usar o gatilho do Jira Cloud para invocar uma integração para os seguintes tipos de assinatura de eventos:
Tipos de assinatura de eventos | Descrição |
---|---|
attachment_created
|
Um anexo é criado para um tíquete do Jira. |
attachment_deleted
|
O anexo associado a um tíquete do Jira é excluído. |
board_created
|
Um quadro do Jira é criado. |
board_deleted
|
Um quadro do Jira foi excluído. |
comment_created
|
Um comentário é adicionado ao tíquete do Jira. |
comment_deleted
|
um comentário em um tíquete do Jira é excluído. |
comment_updated
|
Um comentário em um tíquete do Jira é atualizado. |
filter_created
|
Um novo filtro do Jira foi criado. |
filter_deleted
|
Um filtro do Jira foi excluído. |
filter_updated
|
Um filtro do Jira existente foi atualizado. |
issue_created
|
Um novo problema no Jira foi criado. |
issue_deleted
|
Um problema no Jira foi excluído. |
issue_updated
|
Um problema do Jira é atualizado. |
issuelink_created
|
Um novo link de problema é criado para uma instância do Jira. |
issuelink_deleted
|
O link do problema de uma instância do Jira foi excluído. |
option_issuelinks_changed
|
Um link de problema de uma instância do Jira é alterado ou atualizado. |
option_subtasks_changed
|
As subtarefas de um problema são atualizadas ou alteradas. |
option_voting_changed
|
O número de votos para um problema do Jira mudar. |
option_watching_changed
|
Os observadores ou a lista de usuários adicionados para assistir a um problema do Jira foram alterados. |
project_created
|
Um novo projeto é criado. |
project_deleted
|
Um projeto foi excluído. |
project_restored_deleted
|
Um projeto excluído é restaurado. |
project_soft_deleted
|
Um projeto é excluído para não ficar visível para nenhum usuário, incluindo administradores que usam a interface do produto ou a API. |
project_updated
|
Os detalhes do projeto são atualizados. |
sprint_closed
|
O sprint está encerrado. |
sprint_created
|
Um sprint é criado. |
sprint_deleted
|
Um sprint é excluído. |
sprint_updated
|
Os detalhes de um sprint são alterados ou atualizados. |
user_created
|
Um usuário é criado. |
user_updated
|
Os detalhes de um usuário são alterados ou atualizados. |
worklog_created
|
Uma entrada de registro de trabalho é adicionada. |
worklog_deleted
|
Uma entrada de registro de trabalho é excluída. |
worklog_updated
|
Uma entrada de registro de trabalho é alterada ou atualizada. |
Cotas e limites
Para informações sobre o assunto, consulte Cotas e limites.
A seguir
- Saiba mais sobre todas as tarefas e acionadores.
- Saiba como testar e publicar uma integração.
- Saiba mais sobre o tratamento de erros.
- Saiba mais sobre os registros de execução de integração.