> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/ru/docs/tools-and-integrations/github-actions.md).

# GitHub Actions

Разверните сборку игрового сервера из GitHub Actions: создайте версию приложения, выполните smoke-тест на реальном развертывании и продвиньте её с помощью Edgegap Deploy Action.

Это [Действие Edgegap Deploy](https://github.com/edgegap/deploy-action) обрабатывает сторону релиза на Edgegap после того, как ваш workflow отправит новый образ игрового сервера.

1. **Создаёт версию приложения** для нового тега образа. Он копирует порты, ресурсы, переменные окружения, максимальную длительность и политику перезапуска из существующей версии, так что меняется только образ. Сначала Edgegap проверяет, что может загрузить образ.
2. **Проводит smoke-тест (необязательно).** Он разворачивает новую версию рядом с выбранной вами локацией, ждёт, пока она станет Ready, и завершает задачу с ошибкой, если сервер падает или перезапускается в течение окна теста. Затем он останавливает развёртывание, а также останавливает его, если задача отменена.
3. **Продвигает её (необязательно).** Он указывает существующую версию, например `prod`, на новый образ. Ваш [матчмейкер](https://docs.edgegap.com/ru/learn/matchmeiking.md) или бэкенд продолжает развёртывание `prod`, поэтому он получает новую сборку без изменения конфигурации.

Каждый запуск записывает сводку задачи, показывающую созданную версию, где выполнялся smoke-тест, её порты и, при ошибке, последние строки журнала сервера. Он также может записывать GitHub Deployment.

## 🚀 Начало работы

**Создайте первую версию самостоятельно**, в панели управления, с помощью плагина или через [интеграцию MCP](https://docs.edgegap.com/ru/docs/integraciya-mcp.md), и разверните её один раз, чтобы убедиться, что она работает. Действие копирует настройки этой версии в каждую новую.

**Добавьте три секрета репозитория:**

| Секрет                      | Где его найти                                                                       |
| --------------------------- | ----------------------------------------------------------------------------------- |
| `EDGEGAP_API_TOKEN`         | [Настройки пользователя / Токены](https://app.edgegap.com/user-settings?tab=tokens) |
| `EDGEGAP_REGISTRY_USERNAME` | [Реестр контейнеров](https://app.edgegap.com/registry-management/repositories/list) |
| `EDGEGAP_REGISTRY_TOKEN`    | [Реестр контейнеров](https://app.edgegap.com/registry-management/repositories/list) |

{% hint style="info" %}
API Edgegap никогда не возвращает логин реестра версии или значения секретных переменных окружения, поэтому действие не может скопировать их. Оно запрашивает их как входные данные и завершается с ошибкой до создания чего-либо, если чего-то не хватает.
{% endhint %}

**Добавьте действие после сборки образа:**

```yaml
name: Развертывание игрового сервера
on:
  push:
    branches: [main]
permissions:
  contents: read
  deployments: write
concurrency: edgegap-deploy

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - id: image
        run: |
          echo "name=registry.edgegap.com/my-project/my-game" >> "$GITHUB_OUTPUT"
          echo "tag=$(date -u +%Y%m%d-%H%M)-${GITHUB_SHA::7}" >> "$GITHUB_OUTPUT"

      - uses: docker/login-action@v3
        with:
          registry: registry.edgegap.com
          username: ${{ secrets.EDGEGAP_REGISTRY_USERNAME }}
          password: ${{ secrets.EDGEGAP_REGISTRY_TOKEN }}

      - uses: docker/build-push-action@v6
        with:
          push: true
          platforms: linux/amd64
          tags: ${{ steps.image.outputs.name }}:${{ steps.image.outputs.tag }}

      - uses: edgegap/deploy-action@v0
        with:
          api-token: ${{ secrets.EDGEGAP_API_TOKEN }}
          application: my-game
          image: ${{ steps.image.outputs.name }}
          tag: ${{ steps.image.outputs.tag }}
          registry-username: ${{ secrets.EDGEGAP_REGISTRY_USERNAME }}
          registry-token: ${{ secrets.EDGEGAP_REGISTRY_TOKEN }}
          base-version: prod
          smoke-test: true
          smoke-near: "50.11,8.68"
          promote-version: prod
```

Используйте уникальный тег образа для каждой сборки, никогда `latest`: Edgegap кэширует образы по тегу. Когда вы не называете новую версию, действие называет её по времени UTC (`YYYYMMDD-HHMM`).

## ⚙️ Параметры

| Вход              | По умолчанию     | Используется для                                                                         |
| ----------------- | ---------------- | ---------------------------------------------------------------------------------------- |
| `base-version`    | последняя версия | выбрать, настройки какой версии копируются                                               |
| `версия`          | время UTC        | дать имя новой версии; повторный запуск с тем же именем и образом использует её повторно |
| `секреты версии`  |                  | задайте секретные переменные окружения, по одной `KEY=VALUE` на строку                   |
| `smoke-test`      | `false`          | развернуть новую версию и проверить, что она остаётся доступной                          |
| `smoke-near`      | Нью-Йорк         | разместить тестовое развёртывание: `широта,долгота` или публичный IP                     |
| `smoke-duration`  | `60s`            | как долго сервер должен оставаться Ready без перезапуска                                 |
| `startup-timeout` | `5m`             | сколько может занять первый запуск (большие образы в первый раз загружаются медленно)    |
| `promote-version` |                  | указать существующей версии новый образ после успешного прохождения всего                |

Это [README действия](https://github.com/edgegap/deploy-action#inputs) перечисляет все входы и выходы, включая `fqdn` и `порты`. Используйте их, чтобы запустить тест игрового клиента на последующем шаге.

## 💡 Полезно знать

* **Откат** означает повторный запуск workflow с предыдущим тегом образа и тем же `promote-version`.
* **При продвижении меняется только образ.** Порты, ресурсы и переменные окружения продвигаемой версии остаются без изменений. Если сборке нужны новые, сначала измените их в панели управления.
* **Smoke-тест — это настоящее развёртывание.** Оно тарифицируется примерно за минуту, а на бесплатном тарифе использует ваше единственное одновременное развёртывание.
* **Неудачная сборка всё равно оставляет версию.** Без `promote-version`, её никто не развернёт, если только не запросить это по имени.
* **Закрепите действие** за релизом (`edgegap/deploy-action@v0.1.0`) или SHA коммита, если хотите просматривать обновления до того, как они получат ваш API-токен.
