Railway Dağıtımı

Railway, otomatik SSL, alan adı yönetimi ve yerleşik izleme ile Kora düğümleri için kolay bir dağıtım deneyimi sunar. Bu kılavuz, basit bir Docker imajı ve Railway CLI kullanarak Railway'de bir Kora düğümü kurulumunu adım adım anlatacaktır.

Ön Koşullar

• Railway Hesabı
• Railway CLI kurulu
• Özel anahtar oluşturma için Solana CLI
• Solana RPC Uç Noktası

Adım 1: Dağıtım Dosyalarını Hazırlama

Kora düğümünüz için yeni bir dizin oluşturun:

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

Dizininize örnek dosyaları ekleyin:

• kora.toml
• signers.toml
• Dockerfile

Dizininiz şimdi şöyle görünmelidir:

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

Adım 2: Railway'e Dağıtım

Proje dizininizden Railway'e giriş yapın

# Login to Railway
railway login

Hesabınızla giriş yapmak için ekrandaki talimatları izleyin.

Dizininizde Railway projesini başlatın.

railway init

Railway sizden şunları isteyecektir:

1. Yeni bir proje oluşturun veya mevcut olanı seçin
2. Bir proje adı seçin (örn. "my-kora-node")

Uygulamanızı Dağıtın

# Deploy the application
railway up

Bu işlem:

• Dosyalarınızı Railway'e yükler
• Docker imajını oluşturur
• Uygulamanızı dağıtır

Beklenen çıktı:

Build time: 121.81 seconds
Deploy complete
Starting Container

Harika! Her şey hazır! Muhtemelen günlüklerinizde bir hata göreceksiniz ("error: a value is required for --rpc-url <RPC_URL> but none was supplied "). Bu, henüz ortam değişkenlerimizi yapılandırmadığımız için oluyor--o halde bir sonraki adımda bunu yapalım.

Adım 3: Ortam Değişkenlerini Yapılandırın

railway.app adresindeki Railway kontrol panelinizi açın ve projenize gidin. Projenizde "Settings" > "Variables" seçeneğine tıklayın

Kora için Railway Ortam Değişkenleri

Şu ortam değişkenlerini ekleyin:

Güvenlik Uyarısı: Özel anahtarınız, ücret ödemek için SOL'a erişebilir. Kora düğümünüz için özel bir keypair kullanın ve yalnızca işlem ücretleri için harcamaya razı olduğunuz SOL ile fonlayın. İmzalayanlar hakkında daha fazla bilgi için İmzalayanlar Kılavuzu'na bakın.

Özel Anahtarınızı Alma

Yeni bir keypair oluşturmanız gerekiyorsa:

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

Test etmek/düğümünüzü çalıştırmak için yeterli SOL yatırdığınızdan emin olun.

Adım 4: Yeniden Dağıtın

Değişkenlerinizi kaydettikten sonra, sunucunuzu yeniden dağıtmanız istenecektir--bunu yapın.

Adım 5: Dağıtımınızı Test Edin

Genel Uç Nokta Oluşturun

Uç noktanıza istek göndermek için genel bir Alan Adı oluşturmanız gerekecektir. Dağıtımınızdan "Settings" > "Generate domain" seçeneğine gidin.

Railway Alan Adı Kurulumu

Varsayılan port olan "8080"i kullanın ve "Generate Domain" seçeneğine tıklayın.

https://my-kora-node.railway.app/ gibi bir alan adı edinmelisiniz

Test Yapılandırma Uç Noktası

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

Beklenen yanıt:

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

Harika iş! Kora düğümünüz artık yayında.

Yardıma mı İhtiyacınız Var?

• Kora Düğüm Operatörleri Kılavuzu - Yaygın sorunlar ve çözümler
• Railway Belgeleri - Platforma özel yardım
• GitHub Sorunları - Hata bildirin veya destek alın
• Solana Stack Exchange - Soru sorun/öğrendiklerinizi paylaşın (kora etiketini kullandığınızdan emin olun)