Deployment Railway

Railway menawarkan pengalaman deployment yang mudah untuk node Kora dengan SSL otomatis, manajemen domain, dan monitoring bawaan. Panduan ini akan membahas cara setup node Kora di Railway menggunakan Docker image sederhana dan Railway CLI.

Prasyarat

• Akun Railway
• Railway CLI terinstal
• Solana CLI untuk pembuatan private key
• Solana RPC Endpoint

Langkah 1: Persiapkan File Deployment

Buat direktori baru untuk node Kora Anda:

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

Tambahkan file contoh ke direktori Anda:

• kora.toml
• signers.toml
• Dockerfile

Direktori Anda sekarang akan terlihat seperti:

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

Langkah 2: Deploy ke Railway

Dari direktori project Anda, login ke Railway

# Login to Railway
railway login

Ikuti instruksi di layar untuk login dengan akun Anda.

Inisialisasi project Railway di direktori Anda.

railway init

Railway akan meminta Anda untuk:

1. Membuat project baru atau memilih yang sudah ada
2. Memilih nama project (misalnya, "my-kora-node")

Deploy Aplikasi Anda

# Deploy the application
railway up

Ini akan:

• Mengunggah file Anda ke Railway
• Membangun Docker image
• Men-deploy aplikasi Anda

Output yang diharapkan:

Build time: 121.81 seconds
Deploy complete
Starting Container

Bagus! Kita sudah siap! Anda mungkin akan melihat error di log Anda ("error: a value is required for --rpc-url <RPC_URL> but none was supplied"). Hal ini terjadi karena kita belum mengonfigurasi variabel environment--jadi mari kita lakukan selanjutnya.

Langkah 3: Konfigurasi Variabel Environment

Buka dashboard Railway Anda di railway.app dan navigasi ke proyek Anda. Di proyek Anda, klik "Settings" > "Variables"

Variabel Environment Railway untuk Kora

Tambahkan variabel environment berikut:

Peringatan Keamanan: Private key Anda memiliki akses ke SOL untuk membayar biaya transaksi. Gunakan keypair khusus untuk node Kora Anda dan hanya isi dengan SOL yang bersedia Anda belanjakan untuk biaya transaksi. Untuk informasi lebih lanjut tentang signer, lihat Panduan Signer.

Mendapatkan Private Key Anda

Jika Anda perlu membuat keypair baru:

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

Pastikan untuk menyetor SOL yang cukup untuk testing/mengoperasikan node Anda.

Langkah 4: Deploy Ulang

Setelah menyimpan variabel Anda, Anda akan diminta untuk deploy ulang server Anda--lakukan itu.

Langkah 5: Uji Deployment Anda

Generate Endpoint Publik

Untuk mengirim request ke endpoint Anda, Anda perlu generate Domain publik. Dari deployment Anda, buka "Settings" > "Generate domain".

Pengaturan Domain Railway

Gunakan port default, "8080" dan klik "Generate Domain".

Anda harus mendapatkan domain seperti https://my-kora-node.railway.app/

Uji Endpoint Konfigurasi

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

Respons yang diharapkan:

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

Kerja bagus! Node Kora Anda sekarang sudah aktif.

Butuh Bantuan?

• Panduan Operator Node Kora - Masalah umum dan solusinya
• Dokumentasi Railway - Bantuan khusus platform
• GitHub Issues - Laporkan bug atau dapatkan dukungan
• Solana Stack Exchange - Ajukan pertanyaan/bagikan pembelajaran (pastikan menggunakan tag kora)