Перейти к содержимому
Документация

CI/CD с GitHub Actions

Разворачивайте из GitHub Actions с помощью опубликованного CLI, @inquir/compute-cli. Workflow запускает его через npx, авторизуется токеном из секретов репозитория и выполняет те же команды, что и вы локально; если сборка или развёртывание не удались, команда завершается с ненулевым кодом и задача падает.

Учётные данные. В консоли откройте Настройки → API-ключи, создайте токен в блоке Персональные токены доступа (Создать токен) и сохраните его как секрет Actions INQUIR_TOKEN. Slug рабочего пространства запишите в переменную репозитория INQUIR_WORKSPACE. CLI читает оба значения из окружения, в CI ничего не спрашивает и маскирует токен в выводе. Токен действует с правами аккаунта, который его создал, поэтому заведите для CI отдельный токен, выберите срок его действия и отзовите его, когда он станет не нужен.

Развёртывание функции при пуше#

inquir deploy упаковывает каталог, определяет среду выполнения, выводит лог сборки и ждёт результата; --ci включает простой вывод и ненулевой код выхода при ошибке. Закрепите версию CLI, чтобы workflow не менялся без вашего ведома: через npx и в CI CLI сам не обновляется.

deploy.ymlbash
# .github/workflows/deploy.yml — deploy a function with the Inquir CLI on every push to main
name: Deploy to Inquir Compute

on:
  push:
    branches: [main]

permissions:
  contents: read

jobs:
  deploy:
    runs-on: ubuntu-latest
    env:
      INQUIR_TOKEN: ${{ secrets.INQUIR_TOKEN }}         # Personal Access Token
      INQUIR_WORKSPACE: ${{ vars.INQUIR_WORKSPACE }}    # workspace slug
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      # Packages the directory, streams the build log, exits non-zero on failure
      - run: npx --yes @inquir/compute-cli@0.4.4 deploy ./functions/hello --ci

Развёртывание приложения при пуше#

Для контейнерного приложения задача загружает исходники, собирает Dockerfile на платформе и запускает релиз, который должен пройти проверку работоспособности. С флагом --promote релиз сам переходит в продакшен, как только проверка пройдена; для этого нужен токен владельца или администратора рабочего пространства, а API-ключи рабочего пространства переводить в продакшен не могут. Без --promote задача оставит релиз рядом с продакшеном, и его можно перевести в продакшен после проверки.

deploy-app.ymlbash
# .github/workflows/deploy-app.yml — build and release a container application
name: Deploy the web service

on:
  push:
    branches: [main]

permissions:
  contents: read

jobs:
  deploy:
    runs-on: ubuntu-latest
    env:
      INQUIR_TOKEN: ${{ secrets.INQUIR_TOKEN }}         # owner/admin token if you use --promote
      INQUIR_WORKSPACE: ${{ vars.INQUIR_WORKSPACE }}
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      # Builds ./Dockerfile on the platform, waits for the health check and,
      # with --promote, lets the release take production once it is healthy
      - run: npx --yes @inquir/compute-cli@0.4.4 apps deploy web --dir . --promote

Предварительные версии для pull request#

  • Функции: --stage (синоним --environment) разворачивает функцию в именованное окружение вместо продакшена, например --stage preview-pr-N, где N — номер pull request, в workflow на событие pull_request. Окружения, кроме продакшена, удаляются после периода без развёртываний (см. «Квоты и лимиты»).
  • Приложения: разворачивайте без --promote. Релиз работает рядом с продакшеном, а после проверки его переводят в продакшен командой inquir apps promote <releaseId> или кнопкой В продакшен в консоли.
  • Каждый запуск печатает результат; добавьте --json к любой из команд, чтобы на следующем шаге прочитать id релиза или развёртывания.