AIKraft/AI/Войти
AIKraft/Skills/Разработка на cloudrun

Разработка на cloudrun

CloudBase Run backend development rules (Function mode/Container mode). Use this skill when deploying backend services that require long connections, multi-language support, custom environments, AI agent development, or migrating existing/GitHub apps that need VPC access to MySQL/PostgreSQL/Redis.

TETencent official Разработка

Что делает навык

Навык определяет правила развертывания и разработки бэкенд-сервисов на CloudBase Run (в режимах Function и Container), помогая выбрать между ним и HTTP-функциями. Он регламентирует настройку сетевых подключений (VPC), управление учетными данными SDK и обработку ошибок при деплое образов.

Когда применять

  • Развертывание сервисов с длительными соединениями (WebSocket, SSE) или требующих стабильного процесса.
  • Миграция существующих приложений с GitHub или сторонних бэкендов, использующих классные драйверы БД (TCP-подключение через VPC).
  • Создание и запуск AI-агентов в режиме Function CloudRun.
  • Настройка доступа к ресурсам CloudBase (PG, NoSQL, Storage) через SDK с корректным управлением ключами API.
  • Отладка сбоев деплоя контейнеров (deploy_failed, readiness probe failed) и анализ логов.

Как работает

  1. Определить режим (Function или Container) на основе требований к логике (долгосрочные соединения, кастомные зависимости) и выбрать CloudBase Run вместо HTTP-функций.
  2. Проверить инициализацию среды CloudRun (вызов manageCloudRun(action="initEnv")) перед первым деплоем.
  3. Решить вопрос доступа к данным: использовать SDK/шлюз (app.rdb(), app.database()) или, при необходимости миграции, настроить VpcConf для TCP-подключения.
  4. Настроить учетные данные: создать API-ключ через manageAppAuth, внедрить его через EnvParams (CLOUDBASE_APIKEY) и убедиться, что код не логирует контекст x-cloudbase-context.
  5. Написать код с учетом особенностей порта (не вызывать app.listen() в Function mode, слушать PORT в Container mode).
  6. При ошибках деплоя использовать SOP для контейнеров и проверять логи через getProcessLog, а не getDeployLog.

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

Разверни бэкенд на CloudBase Run в режиме Container с поддержкой WebSocket и доступом к PostgreSQL через VPC.
Помоги отладить ошибку deploy_failed для образа на CloudBase Run: проверь readiness probe и логи.
Настрой доступ к ресурсам CloudBase (PG и Storage) из сервиса на CloudBase Run, используя SDK и безопасное управление ключами.

Что понадобится

  • Доступ к CLI/SDK CloudBase (команды manageCloudRun, queryCloudRun, createApiKey).
  • Инициализированная среда CloudRun (EnvId, статус normal).
  • Файлы навыков-сиблингов (../cloudbase-platform/references/protocols/sensitive-runtime-data-protection.md, ../cloud-functions/SKILL.md и др.) в локальной структуре.

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «cloudrun-development» из репозитория: # https://github.com/tencentcloudbase/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r cloudrun-development/ ~/.claude/skills/cloudrun-development/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.