O Que É um Trigger Token de Pipeline? Iniciando Runs via API
Um trigger token de pipeline é uma credencial secreta que permite a um sistema externo iniciar um pipeline run por uma chamada de API, sem login na UI.
Às vezes um pipeline precisa começar fora do fluxo normal de push ou PR: outro sistema terminou seu trabalho, um scheduler disparou, ou uma ferramenta de deploy quer iniciar um build. Um trigger token de pipeline autoriza isso. É um segredo que, apresentado com uma requisição de API, diz ao sistema de CI "quem está chamando tem permissão para iniciar este pipeline."
Para que serve um trigger token
Ele autentica inícios programáticos de pipeline. Em vez de uma pessoa clicar em run, um serviço externo envia uma chamada de API carregando o token, e o sistema de CI inicia o run porque o token prova que quem chama está autorizado.
Como ele é usado
- Gere um token com escopo em um projeto ou pipeline.
- Armazene-o como um secret no sistema que faz a chamada.
- Quem chama o inclui na requisição de API de trigger.
- O sistema de CI o valida e inicia o run.
Um exemplo rápido
Uma ferramenta de deploy termina o provisionamento e chama o endpoint de trigger do CI com token=${TRIGGER_TOKEN} e um ref de branch. O sistema de CI verifica o token e enfileira um pipeline run para aquela branch.
Mantendo os trigger tokens seguros
Um trigger token pode iniciar pipelines, então trate-o como qualquer secret: dê escopo estreito, armazene criptografado, nunca faça commit dele e rotacione se for exposto. Um token vazado permite que qualquer um dispare seus pipelines.
Trigger tokens e encadeamento
Trigger tokens são como pipelines downstream e entre projetos se conectam: um pipeline upstream apresenta um token para iniciar um downstream. Eles são a credencial por trás de boa parte da orquestração de pipelines através de fronteiras de projeto.
Principais conclusões
- Um trigger token autoriza iniciar um pipeline por uma chamada de API.
- Sistemas externos o apresentam para iniciar runs sem login na UI.
- Trate-o como um segredo: dê escopo, armazene com segurança e rotacione se vazar.