Розгортання на Railway

Railway пропонує зручний досвід розгортання для вузлів Kora з автоматичним SSL, керуванням доменами та вбудованим моніторингом. Цей посібник допоможе налаштувати вузол Kora на Railway за допомогою простого Docker-образу та Railway CLI.

Передумови

• Обліковий запис Railway
• Встановлений Railway CLI
• Solana CLI для створення приватного ключа
• Точка доступу Solana RPC

Крок 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 Environment Variables for Kora

Додайте ці змінні оточення:

Попередження про безпеку: Ваш приватний ключ має доступ до SOL для сплати комісій. Використовуйте виділений keypair для вашого вузла Kora і поповнюйте його лише тим SOL, який ви готові витратити на комісії за транзакції. Для отримання додаткової інформації про підписувачів дивіться Посібник з підписувачів.

Отримання вашого приватного ключа

Якщо вам потрібно створити новий keypair:

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

Переконайтеся, що поповнили достатньою кількістю SOL для тестування/роботи вашого вузла.

Крок 4: Повторне розгортання

Після збереження ваших змінних вам буде запропоновано повторно розгорнути ваш сервер — зробіть це.

Крок 5: Тестування вашого розгортання

Генерація публічної кінцевої точки

Щоб надсилати запити до вашої кінцевої точки, вам потрібно згенерувати публічний домен. З вашого розгортання перейдіть до "Settings" > "Generate domain".

Railway Domain Setup

Використовуйте типовий порт "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)