Déploiement sur Railway

Railway offre une expérience de déploiement simple pour les nœuds Kora avec SSL automatique, gestion de domaine et surveillance intégrée. Ce guide vous accompagnera dans la configuration d'un nœud Kora sur Railway avec une image Docker simple et l'interface CLI de Railway.

Prérequis

• Compte Railway
• Railway CLI installé
• Solana CLI pour la création de clé privée
• Point de terminaison RPC Solana

Étape 1 : Préparer les fichiers de déploiement

Créez un nouveau répertoire pour votre nœud Kora :

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

Ajoutez les fichiers d'exemple à votre répertoire :

• kora.toml
• signers.toml
• Dockerfile

Votre répertoire devrait maintenant ressembler à ceci :

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

Étape 2 : Déployer sur Railway

Depuis votre répertoire de projet, connectez-vous à Railway

# Login to Railway
railway login

Suivez les instructions à l'écran pour vous connecter avec votre compte.

Initialisez le projet Railway dans votre répertoire.

railway init

Railway vous invitera à :

1. Créer un nouveau projet ou sélectionner un projet existant
2. Choisir un nom de projet (par exemple, « my-kora-node »)

Déployer votre application

# Deploy the application
railway up

Cela permettra de :

• Télécharger vos fichiers vers Railway
• Construire l'image Docker
• Déployer votre application

Résultat attendu :

Build time: 121.81 seconds
Deploy complete
Starting Container

Parfait ! Nous sommes prêts ! Vous remarquerez probablement une erreur dans vos journaux ("error: a value is required for --rpc-url <RPC_URL> but none was supplied "). Cela est dû au fait que nous n'avons pas encore configuré nos variables d'environnement -- alors faisons-le maintenant.

Étape 3 : Configurer les variables d'environnement

Ouvrez votre tableau de bord Railway sur railway.app et accédez à votre projet. Dans votre projet, cliquez sur « Paramètres » > « Variables »

Variables d'environnement Railway pour Kora

Ajoutez ces variables d'environnement :

Avertissement de sécurité : Votre clé privée a accès aux SOL pour payer les frais. Utilisez un keypair dédié pour votre nœud Kora et ne le financez qu'avec le SOL que vous êtes prêt à dépenser en frais de transaction. Pour plus d'informations sur les signataires, consultez le Guide des signataires.

Obtenir votre clé privée

Si vous devez créer un nouveau keypair :

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

Assurez-vous de déposer suffisamment de SOL pour tester/exploiter votre nœud.

Étape 4 : Redéployer

Après avoir enregistré vos variables, vous serez invité à redéployer votre serveur -- faites-le.

Étape 5 : Tester votre déploiement

Générer un point de terminaison public

Pour envoyer des requêtes à votre point de terminaison, vous devrez générer un domaine public. Depuis votre déploiement, allez dans « Paramètres » > « Générer un domaine ».

Configuration du domaine Railway

Utilisez le port par défaut, « 8080 » et cliquez sur « Générer un domaine ».

Vous devriez obtenir un domaine comme https://my-kora-node.railway.app/

Tester le point de terminaison de configuration

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

Réponse attendue :

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

Excellent travail ! Votre nœud Kora est maintenant en ligne.

Besoin d'aide ?

• Guide des opérateurs de nœuds Kora - Problèmes courants et solutions
• Documentation Railway - Aide spécifique à la plateforme
• Issues GitHub - Signaler des bugs ou obtenir de l'assistance
• Solana Stack Exchange - Poser des questions/partager vos connaissances (assurez-vous d'utiliser le tag kora)