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

Текст

---
name: render-deploy
description: Развёртывает приложения на Render - анализирует кодовую базу, создаёт Blueprint-файлы render.yaml и выдаёт ссылки для перехода в Dashboard. Используй, когда пользователь хочет развернуть, захостить, опубликовать или настроить своё приложение на облачной платформе Render.
---

Развёртывание на Render

Render поддерживает сервисы, привязанные к Git, и сервисы из готового образа Docker.

Этот скилл описывает процессы для Git:

1. Метод Blueprint — создание render.yaml для развёртывания по принципу «инфраструктура как код» (Infrastructure-as-Code)
2. Прямое создание — мгновенное создание сервисов через инструменты MCP

Blueprint может запускать и готовый образ Docker через runtime: image, но файл render.yaml всё равно должен лежать в Git-репозитории.

Если Git-удалённого репозитория (remote) нет, остановись и попроси пользователя:

• создать и отправить Git-репозиторий (он может быть минимальным, если нужен только Blueprint), либо
• использовать Render Dashboard или API для развёртывания готового образа Docker (MCP не умеет создавать сервисы на основе образа).

Предварительные условия

• Если песочница блокирует сетевые вызовы развёртывания, перезапусти команду с sandbox_permissions=require_escalated.
• Развёртывание может занять несколько минут. Задавай подходящие значения тайм-аута.

Когда использовать этот скилл

Включай этот скилл, когда пользователь хочет:

• Развернуть приложение на Render
• Создать файл Blueprint render.yaml
• Настроить развёртывание своего проекта на Render
• Захостить или опубликовать своё приложение на облачной платформе Render
• Создать базы данных, задания cron или другие ресурсы Render

Быстрый путь (новые пользователи)

Перед глубоким анализом задай эти короткие вопросы, чтобы снизить трение:

1. Спроси, хотят ли они развернуть из Git-репозитория или из готового образа Docker.
2. Спроси, должен ли Render создать всё, что нужно приложению (исходя из того, что вероятно следует из описания пользователя), или только само приложение, а свою инфраструктуру они подключат сами. Если зависимости неясны, задай короткий уточняющий вопрос: нужны ли база данных, воркеры, cron или другие сервисы.

Затем действуй по подходящему методу ниже.

Выбор источника

Путь через Git-репозиторий: обязателен и для Blueprint, и для прямого создания. Репозиторий должен быть отправлен на GitHub, GitLab или Bitbucket.

Путь через готовый образ Docker: Render поддерживает его через сервисы на основе образа. MCP его не поддерживает; используй Dashboard или API. Узнай:

• URL образа (реестр и тег)
• Авторизацию в реестре (если он приватный)
• Тип сервиса (web/worker) и порт

Если пользователь выбирает образ Docker, проведи его по процессу развёртывания образа в Render Dashboard или попроси добавить Git-репозиторий (чтобы можно было использовать Blueprint с runtime: image).

Выбор метода развёртывания (Git-репозиторий)

Для обоих методов нужен Git-репозиторий, отправленный на GitHub, GitLab или Bitbucket. (При runtime: image репозиторий может быть минимальным и содержать только render.yaml.)

Правило выбора метода

По умолчанию используй это правило, если пользователь не попросил конкретный метод. Сначала проанализируй кодовую базу; спрашивай только если цель развёртывания неясна (например, база данных, воркеры, cron).

Используй прямое создание (MCP), когда выполняется ВСЁ из перечисленного:

• Один сервис (одно веб-приложение или один статический сайт)
• Нет отдельных сервисов worker/cron
• Нет подключённых баз данных или Key Value
• Только простые переменные окружения (без общих групп переменных)

Если этот путь подходит, а MCP ещё не настроен, остановись и проведи пользователя через настройку MCP, прежде чем продолжать.

Используй Blueprint, когда выполняется ХОТЯ БЫ ОДНО из перечисленного:

• Несколько сервисов (web и worker, API и фронтенд и т. д.)
• Нужны базы данных, Redis/Key Value или другие хранилища данных
• Есть задания cron, фоновые воркеры или приватные сервисы
• Нужна воспроизводимая IaC или файл render.yaml в репозитории
• Монорепозиторий или многоокружение, где нужна единая конфигурация

Если не уверен, задай короткий уточняющий вопрос, но для надёжности выбирай Blueprint по умолчанию. Для одного сервиса настоятельно предпочитай прямое создание через MCP и при необходимости проведи пользователя через настройку MCP.

Проверка предварительных условий

В начале развёртывания по порядку проверь следующее:

1. Подтверди источник (Git или Docker)

Если используешь методы на основе Git (Blueprint или прямое создание), репозиторий должен быть отправлен на GitHub/GitLab/Bitbucket. Blueprint, ссылающийся на готовый образ, всё равно требует Git-репозитория с render.yaml.

git remote -v

• Если удалённого репозитория нет, остановись и попроси пользователя создать и отправить репозиторий или перейти на развёртывание образа Docker.

2. Проверь доступность инструментов MCP (предпочтительно для одного сервиса)

Инструменты MCP дают лучший результат. Проверь, доступны ли они, попробовав выполнить:

list_services()

Если инструменты MCP доступны, для большинства операций установку CLI можно пропустить.

3. Проверь установку Render CLI (для проверки Blueprint)

render --version

Если он не установлен, предложи установить:

• macOS: brew install render
• Linux/macOS: curl -fsSL https://raw.githubusercontent.com/render-oss/cli/main/bin/install.sh | sh

4. Настройка MCP (если MCP не настроен)

Если list_services() завершается ошибкой, потому что MCP не настроен, спроси, хотят ли они настроить MCP (предпочтительно) или продолжить через запасной вариант с CLI. Если они выбирают MCP, спроси, каким ИИ-инструментом они пользуются, и дай подходящую инструкцию ниже. Всегда используй их ключ API.

Cursor

Проведи пользователя по этим шагам:

1. Получи ключ API Render:

https://dashboard.render.com/u/*/settings#api-keys

1. Добавь это в ~/.cursor/mcp.json (замени <YOUR_API_KEY>):

{
  "mcpServers": {
    "render": {
      "url": "https://mcp.render.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

1. Перезапусти Cursor и повтори list_services().

Claude Code

Проведи пользователя по этим шагам:

1. Получи ключ API Render:

https://dashboard.render.com/u/*/settings#api-keys

1. Добавь MCP-сервер в Claude Code (замени <YOUR_API_KEY>):

claude mcp add --transport http render https://mcp.render.com/mcp --header "Authorization: Bearer <YOUR_API_KEY>"

1. Перезапусти Claude Code и повтори list_services().

Codex

Проведи пользователя по этим шагам:

1. Получи ключ API Render:

https://dashboard.render.com/u/*/settings#api-keys

1. Задай его в оболочке:

export RENDER_API_KEY="<YOUR_API_KEY>"

1. Добавь MCP-сервер через Codex CLI:

codex mcp add render --url https://mcp.render.com/mcp --bearer-token-env-var RENDER_API_KEY

1. Перезапусти Codex и повтори list_services().

Другие инструменты

Если пользователь работает в другом ИИ-приложении, направь его к документации Render по MCP для этого инструмента — там описаны шаги настройки и способ установки.

Выбор рабочего пространства

После настройки MCP попроси пользователя задать активное рабочее пространство Render запросом вроде:

Установи моё рабочее пространство Render: [WORKSPACE_NAME]

5. Проверь аутентификацию (только для запасного варианта с CLI)

Если MCP недоступен, используй CLI и убедись, что у тебя есть доступ к аккаунту:

# Check if user is logged in (use -o json for non-interactive mode)
render whoami -o json

Если render whoami завершается ошибкой или возвращает пустые данные, CLI не аутентифицирован. CLI не всегда сам предлагает войти, поэтому явно попроси пользователя пройти аутентификацию:

Если не настроено ни то ни другое, спроси пользователя, какой способ он предпочитает:

• Ключ API (CLI): export RENDER_API_KEY="rnd_xxxxx" (получить на https://dashboard.render.com/u/*/settings#api-keys)
• Вход: render login (открывает браузер для OAuth)

6. Проверь контекст рабочего пространства

Проверь активное рабочее пространство:

get_selected_workspace()

Или через CLI:

render workspace current -o json

Чтобы вывести список доступных рабочих пространств:

list_workspaces()

Если пользователю нужно сменить рабочее пространство, он должен сделать это через Dashboard или CLI (render workspace set).

Когда предварительные условия выполнены, переходи к процессу развёртывания.

Метод 1: развёртывание через Blueprint (рекомендуется для сложных приложений)

Процесс с Blueprint

Шаг 1: проанализируй кодовую базу

Проанализируй кодовую базу и определи фреймворк и среду выполнения, команды сборки и запуска, необходимые переменные окружения, хранилища данных и привязку к порту. Используй подробные чек-листы из [references/codebase-analysis.md](references/codebase-analysis.md).

Шаг 2: создай render.yaml

Создай файл Blueprint render.yaml в соответствии со спецификацией Blueprint.

Полная спецификация: [references/blueprint-spec.md](references/blueprint-spec.md)

Ключевые моменты:

• Всегда используй plan: free, если пользователь не указал иное
• Включай ВСЕ переменные окружения, которые нужны приложению
• Секреты помечай sync: false (пользователь заполняет их в Dashboard)
• Используй подходящий тип сервиса: web, worker, cron, static или pserv
• Используй подходящую среду выполнения: [references/runtimes.md](references/runtimes.md)

Базовая структура:

services:
  - type: web
    name: my-app
    runtime: node
    plan: free
    buildCommand: npm ci
    startCommand: npm start
    envVars:
      - key: DATABASE_URL
        fromDatabase:
          name: postgres
          property: connectionString
      - key: JWT_SECRET
        sync: false  # User fills in Dashboard

databases:
  - name: postgres
    databaseName: myapp_db
    plan: free

Типы сервисов:

• web: HTTP-сервисы, API, веб-приложения (доступны публично)
• worker: обработчики фоновых заданий (публично недоступны)
• cron: задачи по расписанию cron
• static: статические сайты (HTML/CSS/JS через CDN)
• pserv: приватные сервисы (только для внутреннего использования внутри одного аккаунта)

Подробности о типах сервисов: [references/service-types.md](references/service-types.md) Варианты сред выполнения: [references/runtimes.md](references/runtimes.md) Примеры шаблонов: [assets/](assets/)

Шаг 2.5: ближайшие следующие шаги (давай всегда)

После создания render.yaml всегда давай пользователю короткий явный чек-лист и сразу запускай проверку, если CLI доступен:

1. Аутентификация (CLI): выполни render whoami -o json (если вход не выполнен, выполни render login или задай RENDER_API_KEY)
2. Проверка (рекомендуется): выполни render blueprints validate
3. Если CLI не установлен, предложи установить его и дай команду.
4. Коммит и отправка: git add render.yaml && git commit -m "Add Render deployment configuration" && git push origin main
5. Открой Dashboard: используй ссылку-переход для Blueprint и при запросе пройди OAuth через Git
6. Заполни секреты: задай переменные окружения, помеченные sync: false
7. Разверни: нажми «Apply» и следи за развёртыванием

Шаг 3: проверь конфигурацию

Проверь файл render.yaml, чтобы поймать ошибки до развёртывания. Если CLI установлен, запускай команды сам; обращайся к пользователю, только если CLI отсутствует:

render whoami -o json  # Ensure CLI is authenticated (won't always prompt)
render blueprints validate

Исправь все ошибки проверки, прежде чем идти дальше. Частые проблемы:

• Не хватает обязательных полей (name, type, runtime)
• Недопустимые значения runtime
• Неверный синтаксис YAML
• Недопустимые ссылки на переменные окружения

Руководство по конфигурации: [references/configuration-guide.md](references/configuration-guide.md)

Шаг 4: коммит и отправка

ВАЖНО: перед развёртыванием файл render.yaml нужно влить в репозиторий.

Убедись, что файл render.yaml закоммичен и отправлен в Git-репозиторий:

git add render.yaml
git commit -m "Add Render deployment configuration"
git push origin main

Если Git-репозитория ещё нет, остановись здесь и помоги пользователю создать репозиторий на GitHub/GitLab/Bitbucket, добавить его как origin и отправить код, прежде чем продолжать.

Почему это важно: ссылка в Dashboard считывает render.yaml из твоего репозитория. Если файл не влит и не отправлен, Render не найдёт конфигурацию, и развёртывание не удастся.

Прежде чем переходить к следующему шагу, убедись, что файл есть в удалённом репозитории.

Шаг 5: создай ссылку-переход

Получи URL Git-репозитория:

git remote get-url origin

Команда вернёт URL у твоего Git-провайдера. Если URL в формате SSH, преобразуй его в HTTPS:

Правило преобразования: замени git@<host>: на https://<host>/ и убери суффикс .git.

Составь ссылку-переход в Dashboard, используя HTTPS-адрес репозитория:

https://dashboard.render.com/blueprint/new?repo=<REPOSITORY_URL>

Пример:

https://dashboard.render.com/blueprint/new?repo=https://github.com/username/repo-name

Шаг 6: проведи пользователя

КРИТИЧНО: убедись, что пользователь влил и отправил файл render.yaml в свой репозиторий, прежде чем он нажмёт на ссылку-переход. Если файла в репозитории нет, Render не сможет прочитать конфигурацию Blueprint, и развёртывание не удастся.

Дай пользователю ссылку-переход с такими инструкциями:

1. Убедись, что render.yaml влит — проверь, что файл есть в твоём репозитории на GitHub/GitLab/Bitbucket
2. Нажми на ссылку-переход, чтобы открыть Render Dashboard
3. При запросе пройди OAuth у Git-провайдера
4. Назови Blueprint (или оставь имя по умолчанию из render.yaml)
5. Заполни секретные переменные окружения (помеченные sync: false)
6. Проверь конфигурацию сервисов и баз данных
7. Нажми «Apply», чтобы развернуть

Развёртывание начнётся автоматически. Пользователи могут следить за ходом в Render Dashboard.

Шаг 7: проверь развёртывание

После того как пользователь развернул проект через Dashboard, убедись, что всё работает.

Проверь статус развёртывания через MCP:

list_deploys(serviceId: "<service-id>", limit: 1)

Ищи status: "live" — он подтверждает успешное развёртывание.

Проверь ошибки времени выполнения (подожди 2–3 минуты после развёртывания):

list_logs(resource: ["<service-id>"], level: ["error"], limit: 20)

Проверь метрики состояния сервиса:

get_metrics(
  resourceId: "<service-id>",
  metricTypes: ["http_request_count", "cpu_usage", "memory_usage"]
)

Если найдены ошибки, переходи к разделу Проверка после развёртывания и базовый разбор проблем ниже.

Метод 2: прямое создание сервиса (быстрое развёртывание одного сервиса)

Для простого развёртывания без Infrastructure-as-Code создавай сервисы напрямую через инструменты MCP.

Когда использовать прямое создание

• Один веб-сервис или статический сайт
• Быстрые прототипы и демо
• Когда файл render.yaml в репозитории не нужен
• Добавление баз данных или заданий cron в существующие проекты

Предварительные условия для прямого создания

Репозиторий должен быть отправлен Git-провайдеру. Render клонирует репозиторий, чтобы собрать и развернуть сервисы.

git remote -v  # Verify remote exists
git push origin main  # Ensure code is pushed

Поддерживаемые провайдеры: GitHub, GitLab, Bitbucket

Если удалённого репозитория нет, остановись и попроси пользователя создать и отправить репозиторий или перейти на развёртывание образа Docker.

Примечание: MCP не поддерживает создание сервисов на основе образа. Для развёртывания готового образа Docker используй Dashboard или API.

Процесс прямого создания

Используй краткие шаги ниже, а полные примеры команд MCP и последующую настройку смотри в [references/direct-creation.md](references/direct-creation.md).

Шаг 1: проанализируй кодовую базу

Используй [references/codebase-analysis.md](references/codebase-analysis.md), чтобы определить среду выполнения, команды сборки и запуска, переменные окружения и хранилища данных.

Шаг 2: создай ресурсы через MCP

Создай сервис (web или static) и все необходимые базы данных или хранилища «ключ — значение». Смотри [references/direct-creation.md](references/direct-creation.md).

Если MCP возвращает ошибку об отсутствии учётных данных Git или доступа к репозиторию, остановись и помоги пользователю подключить своего Git-провайдера в Render Dashboard, затем повтори попытку.

Шаг 3: настрой переменные окружения

После создания добавь нужные переменные окружения через MCP. Смотри [references/direct-creation.md](references/direct-creation.md).

Напомни пользователю, что секреты можно задать в Dashboard, если он не хочет передавать их через MCP.

Шаг 4: проверь развёртывание

Проверь статус развёртывания, журналы и метрики. Смотри [references/direct-creation.md](references/direct-creation.md).

Об обнаружении сервисов, подробностях конфигурации, быстрых командах и типичных проблемах смотри [references/deployment-details.md](references/deployment-details.md).

Проверка после развёртывания и базовый разбор проблем (для всех методов)

Делай это коротко и повторяемо. Если какая-либо проверка не проходит, исправь причину до повторного развёртывания.

1. Убедись, что последнее развёртывание в статусе live и принимает трафик
2. Обратись к эндпоинту проверки состояния (или к корню) и убедись, что приходит ответ 200
3. Просмотри свежие журналы ошибок в поисках чёткого признака сбоя
4. Проверь нужные переменные окружения и привязку к порту (0.0.0.0:$PORT)

Подробный чек-лист и команды: [references/post-deploy-checks.md](references/post-deploy-checks.md)

Если сервис не запускается или проверки состояния заканчиваются тайм-аутом, воспользуйся базовым руководством по разбору проблем: [references/troubleshooting-basics.md](references/troubleshooting-basics.md)

Устранение неполадок

Расширенный сетевой доступ

Если развёртывание не удаётся из-за сетевых проблем (тайм-ауты, ошибки DNS, сброс соединений), перезапусти развёртывание с расширенными правами (используй sandbox_permissions=require_escalated). Развёртывание требует расширенного сетевого доступа, когда сеть в песочнице блокирует исходящие запросы.

Пример того, что сказать пользователю:

Для развёртывания на Render нужен расширенный сетевой доступ. Я могу перезапустить команду с расширенными правами — продолжить?

Необязательно: если нужна более глубокая диагностика (метрики, проверки БД, каталог ошибок), предложи установить скилл render-debug. Он не нужен для основного процесса развёртывания.

Перевод: iiuniversitet. Оригинал: https://github.com/openai/skills/tree/main/skills/.curated/render-deploy, лицензия Apache-2.0. Изменения: перевод на русский язык.