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 de Lançamentos.

O Coroid só marca uma implantação como realizada quando seu CI/CD indica isso. Esta página mostra como um pipeline relata implantações, independentemente de o 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, incluindo a versão que foi implantada.
  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çãoCrie um token de relatório ali. Apenas um Proprietário ou Administrador pode vê-lo uma vez. Armazene-o como segredo no pipeline de CI desse ambiente. O Coroid guarda apenas o hash, e trocar o token revoga imediatamente o antigo. O token só pode relatar dados do respectivo projeto e ambiente. Nunca o coloque em arquivos de repositório ou requisições de navegador.

O GitHub Actions e o GitLab CI/CD

Se você quiser o Implantar em… botão na página de Lançamentos, selecione O Coroid inicia um fluxo de trabalho do GitHub Actions ou O Coroid inicia um pipeline do GitLab CI/CD nas configurações do pipeline de implantação do ambiente. Insira o nome exato da tarefa de implantação, a referência de branch ou tag e o nome do arquivo de fluxo de trabalho do GitHub quando aplicável. Essa referência 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, além de coroid_version, coroid_build_number e coroid_release_name quando o fluxo de trabalho os declara. O GitLab recebe as variáveis em maiúsculas equivalentes COROID_* variáveis. Use esses valores para implantar e relatar o SHA e a tentativa exatos. Coloque a versão na sua compilação mostra como inserir a versão na compilação.

Armazene o token de retorno de chamada 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. O 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 do GitHub Actions; 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 o 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"
}

Inclua releaseId e attemptId ao relatar uma execução solicitada pelo Coroid. Adicione version e buildNumber para registrar o que foi implantado. Para um projeto hospedado no Coroid, repository é o ID do projeto. failureReason pode explicar uma execução falha. Use queued, running, succeeded, failed, ou cancelled para statusMantenha um providerRunId durante toda a execução e atribua um ID único a cada transição de estado eventId. Uma nova tentativa do mesmo evento deve manter seu ID; uma nova execução de CI precisa de um novo ID de execução. O carimbo de data/hora do evento deve ser recente. O Coroid verifica o repositório, o ambiente, o commit, o escopo das credenciais e o estado terminal antes de aplicá-lo; eventos conflitantes são mantidos para revisão. Uma implantação válida sem um lançamento preparado pode criar um lançamento observado, claramente separado de um candidato aprovado em pré-verificação.

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