Vercel Deploy

Практические операции с Vercel для уже существующих проектов. Никакой магии в духе «ИИ сам всё построит» — только реальные деплои, управление переменными окружения и работа с логами.

Описание

Этот инструмент предназначен для деплоя и управления проектами в Vercel. Он помогает запускать приложения, настраивать окружение, отслеживать статус деплоев и анализировать логи.

Поддерживаются как production, так и preview-деплои. Это утилита для реальной инфраструктурной работы, а не абстрактных AI-обещаний.

Установка

Установить можно через CLI:

clawhub install vercel-deploy

Настройка Vercel

Для начала потребуется токен Vercel:

• Перейдите в настройки аккаунта Vercel
• Создайте новый токен (например, с именем «OpenClaw»)

Добавьте токен в переменные окружения:

export VERCEL_TOKEN="your-token-here"

Или используйте файл .env:

VERCEL_TOKEN=your-token-here

Основные операции

Деплой проекта

# Preview-деплой
scripts/vercel_deploy.sh --project my-project --preview

# Production-деплой
scripts/vercel_deploy.sh --project my-project --production

Управление переменными окружения

# Список переменных
scripts/vercel_env.sh --project my-project --list

# Добавить переменную
scripts/vercel_env.sh --project my-project --set \
 --key KEY_NAME \
 --value "value" \
 --env production

# Удалить переменную
scripts/vercel_env.sh --project my-project --delete \
 --key KEY_NAME \
 --env production

Проверка статуса деплоя

# Последний деплой
scripts/vercel_status.sh --project my-project

# Конкретный деплой
scripts/vercel_status.sh --deployment dpl_123

Просмотр логов

# Логи деплоя
scripts/vercel_logs.sh --deployment dpl_123

# Runtime-логи функции
scripts/vercel_logs.sh --project my-project --function api/test

Типовые сценарии

Первичный деплой

Перед запуском необходимо задать ключевые переменные окружения, например:

# Адрес контракта
scripts/vercel_env.sh --project my-project --set \
 --key NEXT_PUBLIC_CONTRACT_ADDRESS \
 --value "0x..." \
 --env production

# RPC URL
scripts/vercel_env.sh --project my-project --set \
 --key NEXT_PUBLIC_RPC_URL \
 --value "https://example.org" \
 --env production

После этого выполняется production-деплой и проверяется статус.

Обновление переменных

При изменении конфигурации обновите значения и выполните повторный деплой, чтобы изменения вступили в силу.

Отладка

• Проверьте статус деплоя
• Изучите build-логи
• Убедитесь, что переменные окружения заданы корректно

Рекомендации по безопасности

• Используйте токены с ограниченной областью доступа
• Регулярно обновляйте токены
• Проверяйте логи деплоев
• Никогда не коммитьте секреты в репозиторий

Устранение проблем

Ошибка аутентификации

• Проверьте правильность токена
• Убедитесь, что он не истёк

Проект не найден

• Проверьте имя проекта
• Убедитесь, что у вас есть доступ

Ошибка деплоя

• Изучите логи сборки
• Проверьте переменные окружения
• Убедитесь в отсутствии ошибок в коде