CoroidSua AI software factory
Documentação

Eventos de implantação e configuração de CI

Conecte o GitHub Actions, o GitLab CI/CD ou outro sistema de CI ao histórico de implantações dos Lançamentos.

Coroid só marca um lançamento como implantado quando o seu CI/CD indica isso. Esta página mostra como um pipeline relata implantações, independentemente de Coroid iniciá-lo ou ele rodar por conta própria.

Coroid

Seu CI/CD

Ambiente

  1. 1.Iniciar para o commit exato
  2. 2.Implantar o commit fixado
  3. 3.Relatório em execução, depois com sucesso ou falha
  4. 4.Monitorar a saúde do sistema com a verificação canary
Uma implantação só é contabilizada após seu pipeline reportar sucesso. A etapa 1 é ignorada quando seu pipeline inicia automaticamente.

Tudo abaixo é configurado por ambiente nas Configurações do projeto Configurações → Lançamentos → Pipeline de implantação. Crie um token de relatório ali. Um Proprietário ou Administrador visualiza esse token uma única vez. Armazene-o como um segredo no pipeline de CI desse ambiente. Coroid guarda apenas o hash, e a substituição do token revoga o anterior imediatamente. O token só pode gerar relatórios para seu projeto e ambiente. Nunca o coloque em um arquivo de repositório ou em uma requisição de navegador.

GitHub Actions e GitLab CI/CD

Se você deseja o Implantar em… botão na página de lançamentos, selecione Coroid inicia um fluxo de trabalho do GitHub Actions ou Coroid inicia um pipeline do GitLab CI/CD nas configurações de Pipeline de implantação do ambiente. Insira o nome exato da tarefa de implantação, o branch ou tag ref, e o nome do arquivo de fluxo de trabalho do GitHub quando aplicável. Esse ref deve apontar para o commit de lançamento no momento da solicitação. O fluxo de trabalho do GitHub recebe coroid_release_id, coroid_attempt_id, coroid_commit_sha, e coroid_environment entradas. GitLab recebe as variáveis equivalentes em letras maiúsculas COROID_* . Use esses valores para implantar e relatar o SHA e a tentativa exatos.

Armazene o token de callback do ambiente nos segredos do GitHub Actions ou nas variáveis mascaradas do GitLab CI/CD. Envie um running evento quando a tarefa de implantação começar e um evento terminal succeeded, failed, ou cancelled evento quando ela terminar. Coroid verifica a execução do provedor, o commit e a tarefa nomeada antes de aceitar o sucesso para um pipeline configurado. A URL da execução do provedor continua sendo o local para inspecionar os logs. O fluxo de trabalho de produção do Coroid Contém um exemplo concreto de Ações do GitHub; adapte os nomes dos segredos e das tarefas ao seu repositório.

Retorno de chamada genérico de CI

Um pipeline externo pode enviar os mesmos eventos sem precisar habilitar o despacho. Autentique-se com o token bearer escopo do ambiente. O endpoint aceita JSON com esta estrutura versionada:

POST /api/v1/release-deployment-events
Authorization: Bearer <environment-callback-token>
Content-Type: application/json
{
  "schemaVersion": 1,
  "eventId": "ci:run-812:production:succeeded",
  "providerRunId": "run-812",
  "projectId": "<project-uuid>",
  "environmentKey": "production",
  "repository": "owner/repository",
  "commitSha": "0123456789abcdef0123456789abcdef01234567",
  "status": "succeeded",
  "occurredAt": "2026-09-24T12:00:00Z",
  "runUrl": "https://ci.example.com/runs/812"
}

Incluir releaseId e attemptId ao relatar uma execução solicitada pelo Coroid. failureReason pode explicar uma execução com falha. Use queued, running, succeeded, failed, ou cancelled para status. Mantenha um providerRunId durante toda a execução e atribua um identificador único a cada transição de estado. eventId. Uma nova tentativa do mesmo evento deve manter seu ID; uma nova execução de CI requer um novo ID de execução. O carimbo de data/hora do evento precisa ser recente. O Coroid verifica o repositório, o ambiente, o commit, o escopo das credenciais e o estado final antes de aplicá-lo; eventos conflitantes são colocados em revisão. Uma implantação válida sem um release preparado pode gerar um release observado, claramente distinto de um candidato aprovado em pré-verificação.

Para um pipeline sem retornos de chamada, o Proprietário ou Administrador pode escolher Registrar implantação externa na página de releases. Informe o ambiente, o commit correspondente, o horário e um motivo ou URL de evidência. A certificação manual resultante registra o resultado sem afirmar que o Coroid executou a CI ou passou por uma etapa de aprovação.