Railway Implementatie

Railway biedt een eenvoudige implementatie-ervaring voor Kora nodes met automatische SSL, domeinbeheer en ingebouwde monitoring. Deze handleiding zal je door het opzetten van een Kora node op Railway leiden met een eenvoudige Docker image en de Railway CLI.

Vereisten

• Railway Account
• Railway CLI geïnstalleerd
• Solana CLI voor het aanmaken van privésleutels
• Solana RPC Endpoint

Stap 1: Bereid Implementatiebestanden Voor

Maak een nieuwe directory aan voor je Kora node:

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

Voeg de voorbeeldbestanden toe aan je directory:

• kora.toml
• signers.toml
• Dockerfile

Je directory zou er nu als volgt uit moeten zien:

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

Stap 2: Implementeer naar Railway

Log vanaf je projectdirectory in op Railway

# Login to Railway
railway login

Volg de instructies op het scherm om in te loggen met je account.

Initialiseer het Railway project in je directory.

railway init

Railway zal je vragen om:

1. Een nieuw project aan te maken of een bestaand project te selecteren
2. Een projectnaam te kiezen (bijv. "my-kora-node")

Implementeer Je Applicatie

# Deploy the application
railway up

Dit zal:

• Je bestanden uploaden naar Railway
• De Docker image bouwen
• Je applicatie implementeren

Verwachte output:

Build time: 121.81 seconds
Deploy complete
Starting Container

Geweldig! We zijn helemaal klaar! Je zult waarschijnlijk een foutmelding in je logs opmerken ("error: a value is required for --rpc-url <RPC_URL> but none was supplied"). Dit komt doordat we onze omgevingsvariabelen nog niet hebben geconfigureerd--dus laten we dat nu doen.

Stap 3: Configureer Omgevingsvariabelen

Open je Railway dashboard op railway.app en navigeer naar je project. Klik in je project op "Settings" > "Variables"

Railway Omgevingsvariabelen voor Kora

Voeg deze omgevingsvariabelen toe:

Beveiligingswaarschuwing: Je privésleutel heeft toegang tot SOL voor het betalen van transactiekosten. Gebruik een toegewezen keypair voor je Kora-node en voorzie deze alleen van de SOL die je bereid bent te besteden aan transactiekosten. Voor meer informatie over ondertekenaars, zie de Gids voor Ondertekenaars.

Je Privésleutel Verkrijgen

Als je een nieuw keypair moet aanmaken:

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

Zorg ervoor dat je voldoende SOL stort om je node te testen/bedienen.

Stap 4: Opnieuw Implementeren

Na het opslaan van je variabelen word je gevraagd je server opnieuw te implementeren--doe dat.

Stap 5: Test Je Implementatie

Genereer Publiek Endpoint

Om verzoeken naar je endpoint te sturen, moet je een publiek domein genereren. Ga vanaf je implementatie naar "Settings" > "Generate domain".

Railway Domeinconfiguratie

Gebruik de standaardpoort, "8080" en klik op "Generate Domain".

Je zou een domein moeten krijgen zoals https://my-kora-node.railway.app/

Test Configuratie Endpoint

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

Verwachte reactie:

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

Goed gedaan! Je Kora node is nu live.

Hulp nodig?

• Kora Node Operators Gids - Veelvoorkomende problemen en oplossingen
• Railway Documentatie - Platformspecifieke hulp
• GitHub Issues - Meld bugs of krijg ondersteuning
• Solana Stack Exchange - Stel vragen/deel kennis (zorg ervoor dat je de kora tag gebruikt)