CoroidВаша AI программная фабрика
Документация

События развертывания и настройка системы непрерывной интеграции

Подключите GitHub Actions, GitLab CI/CD или другую систему непрерывной интеграции к истории деплоев релизов.

Coroid отмечает деплой релиза только тогда, когда об этом сообщает ваш CI/CD. На этой странице показано, как конвейер отчитывается о деплоях — независимо от того, запускает ли их Coroid или они выполняются самостоятельно.

Coroid

Ваш CI/CD

Окружение

  1. 1.Запустить для точного коммита
  2. 2.Деплой зафиксированный коммит
  3. 3.Отчет Запуск, затем успех или ошибка, с указанием версии, которую развернули.
  4. 4.Отслеживание состояния с проверкой канарийного режима
Деплой считается завершённым только после того, как ваш конвейер сообщит об успехе. Шаг 1 пропускается, если конвейер запускается самостоятельно.

Все нижеперечисленное настраивается для каждой среды в разделе проекта Настройки → Релизы → Конвейер деплоя. Там создайте токен для отчётности. Его увидит только Владелец или Администратор. Сохраните его в качестве секрета в конвейере CI соответствующей среды. Coroid хранит лишь хеш, а замена токена мгновенно аннулирует старый вариант. Токен может отчитываться только за свой проект и среду. Никогда не помещайте его в файл репозитория или запрос браузера.

GitHub Actions и GitLab CI/CD

Если вам нужно Деплой в… кнопку на странице релиза, выберите Coroid запускает рабочий процесс GitHub Actions или Coroid запускает конвейер GitLab CI/CD в настройках конвейера деплоя соответствующей среды. Укажите точное имя задания деплоя, ссылку на ветку или тег, а при необходимости — имя файла рабочего процесса GitHub. Эта ссылка должна указывать на коммит релиза в момент запроса. Рабочий процесс GitHub получает coroid_release_id, coroid_attempt_id, coroid_commit_sha, и coroid_environment входные данные, плюс coroid_version, coroid_build_number и coroid_release_name когда рабочий процесс их объявляет. GitLab получает эквивалентные заглавные COROID_* переменные. Используйте эти значения для деплоя и отчёта о точном хэше и попытке. Укажите версию в своей сборке Показано, как прописать версию в сборке.

Сохраните токен обратного вызова среды в секретах GitHub Actions или маскированных переменных GitLab CI/CD. Отправьте running событие при начале задания деплоя и терминальное succeeded, failed, или cancelled событие при его завершении. Coroid проверяет запуск провайдера, коммит и названное задание перед тем, как признать успех для настроенного конвейера. URL запуска провайдера остаётся местом для просмотра логов. Рабочий процесс продакшена Coroid содержит конкретный пример GitHub Actions; адаптируйте имена секретов и задания под свой репозиторий.

Общий обратный вызов CI

Внешний конвейер может отправлять те же события без включения диспетчеризации. Аутентифицируйтесь с помощью ограниченного токена доступа среды. Эндпоинт принимает запросы JSON в таком версионированном формате:

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"
}

Включите releaseId и attemptId при отчётности о запуске, инициированном Coroid. Добавьте version и buildNumber для фиксации того, что было деплоировано. Для проекта, размещённого на Coroid, repository — это идентификатор проекта. failureReason может объяснить причину сбоя запуска. Используйте queued, running, succeeded, failed, или cancelled для status. Сохраняйте один providerRunId на протяжении всего запуска и присваивайте каждому переходу состояния уникальный eventId. Повторная попытка того же события должна сохранять свой ID; для нового запуска CI требуется новый ID запуска. Метка времени события должна быть актуальной. Coroid проверяет репозиторий, среду, коммит, область действия учётных данных и терминальное состояние перед применением события; противоречивые события направляются на рассмотрение. Допустимый деплой без подготовленного релиза может создать зафиксированный релиз, чётко отличимый от предварительно одобренного кандидата.

Для конвейера без обратных вызовов Владелец или Администратор может выбрать Зафиксировать внешний деплой на странице релиза. Укажите среду, соответствующий коммит, время, причину или URL с доказательствами. Полученное ручное подтверждение фиксирует результат, не утверждая, что Coroid выполнил CI или прошёл контроль.