Развертывание на Railway

Railway предлагает простой процесс развертывания для узлов Kora с автоматическим SSL, управлением доменами и встроенным мониторингом. Это руководство проведет вас через настройку узла Kora на Railway с помощью простого Docker-образа и Railway CLI.

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

• Аккаунт Railway
• Установленный Railway CLI
• Solana CLI для создания приватного ключа
• Solana RPC Endpoint

Шаг 1: Подготовка файлов для развертывания

Создайте новую директорию для вашего узла Kora:

mkdir my-kora-node
cd my-kora-node

Добавьте примеры файлов в вашу директорию:

• kora.toml
• signers.toml
• Dockerfile

Теперь ваша директория должна выглядеть так:

my-kora-node/
├── kora.toml
├── signers.toml
└── Dockerfile

Шаг 2: Развертывание на Railway

Из директории вашего проекта выполните вход в Railway

# Login to Railway
railway login

Следуйте инструкциям на экране для входа в ваш аккаунт.

Инициализируйте проект Railway в вашей директории.

railway init

Railway предложит вам:

1. Создать новый проект или выбрать существующий
2. Выбрать имя проекта (например, "my-kora-node")

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

# Deploy the application
railway up

Это выполнит:

• Загрузку ваших файлов на Railway
• Сборку Docker-образа
• Развертывание вашего приложения

Ожидаемый результат:

Build time: 121.81 seconds
Deploy complete
Starting Container

Отлично! Всё настроено! Вероятно, вы заметите ошибку в логах ("error: a value is required for --rpc-url <RPC_URL> but none was supplied "). Это происходит потому, что мы ещё не настроили переменные окружения — давайте сделаем это дальше.

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

Откройте панель управления Railway на railway.app и перейдите к вашему проекту. В проекте нажмите "Settings" > "Variables"

Переменные окружения Railway для Kora

Добавьте следующие переменные окружения:

Предупреждение о безопасности: Ваш приватный ключ имеет доступ к SOL для оплаты комиссий. Используйте выделенную пару ключей для вашего узла Kora и пополняйте её только тем количеством SOL, которое вы готовы потратить на комиссии за транзакции. Дополнительную информацию о подписантах см. в Руководстве по подписантам.

Получение приватного ключа

Если вам нужно создать новую пару ключей:

# Generate new keypair
solana-keygen new --outfile ~/.config/solana/kora-keypair.json

Обязательно внесите достаточное количество SOL для тестирования/работы вашего узла.

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

После сохранения переменных вам будет предложено повторно развернуть сервер — сделайте это.

Шаг 5: Тестирование развёртывания

Создание публичной конечной точки

Чтобы отправлять запросы к вашей конечной точке, вам нужно создать публичный домен. Из вашего развёртывания перейдите в "Settings" > "Generate domain".

Настройка домена Railway

Используйте порт по умолчанию, "8080", и нажмите "Generate Domain".

Вам следует получить домен вроде https://my-kora-node.railway.app/

Тестирование конечной точки конфигурации

curl -X POST https://my-kora-node.railway.app \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"getConfig","params":[]}' | jq

Ожидаемый ответ:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "fee_payer": "YourPublicKeyHere...",
    "validation_config": {
      "max_allowed_lamports": 1000000,
      "allowed_programs": [...],
      "allowed_spl_paid_tokens": [...]
      // ...
    }
  }
}

Отличная работа! Ваш узел Kora теперь запущен.

Нужна помощь?

• Руководство для операторов узлов Kora — распространённые проблемы и решения
• Документация Railway — помощь по платформе
• GitHub Issues — сообщайте об ошибках или получайте поддержку
• Solana Stack Exchange — задавайте вопросы и делитесь опытом (не забудьте использовать тег kora)