Ανάπτυξη στο Railway

Το Railway προσφέρει μια εύκολη εμπειρία ανάπτυξης για κόμβους Kora με αυτόματο SSL, διαχείριση domain και ενσωματωμένη παρακολούθηση. Αυτός ο οδηγός θα σας καθοδηγήσει στη ρύθμιση ενός κόμβου 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 για το Kora

Προσθέστε αυτές τις μεταβλητές περιβάλλοντος:

Προειδοποίηση Ασφαλείας: Το ιδιωτικό κλειδί σας έχει πρόσβαση σε SOL για την πληρωμή χρεώσεων. Χρησιμοποιήστε ένα αποκλειστικό keypair για τον κόμβο Kora σας και χρηματοδοτήστε το μόνο με το SOL που είστε διατεθειμένοι να δαπανήσετε σε χρεώσεις συναλλαγών. Για περισσότερες πληροφορίες σχετικά με τους υπογράφοντες, δείτε τον Οδηγό Υπογραφόντων.

Λήψη του Ιδιωτικού Κλειδιού σας

Εάν χρειάζεται να δημιουργήσετε ένα νέο keypair:

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

Βεβαιωθείτε ότι καταθέτετε επαρκές SOL για δοκιμή/λειτουργία του κόμβου σας.

Βήμα 4: Επανάπτυξη

Αφού αποθηκεύσετε τις μεταβλητές σας, θα σας ζητηθεί να επαναπτύξετε τον διακομιστή σας--κάντε το αυτό.

Βήμα 5: Δοκιμή της Ανάπτυξής σας

Δημιουργία Δημόσιου Τελικού Σημείου

Για να στέλνετε αιτήματα στο τελικό σημείο σας, θα πρέπει να δημιουργήσετε ένα δημόσιο Domain. Από την ανάπτυξή σας, μεταβείτε στο "Settings" > "Generate domain".

Ρύθμιση Domain στο Railway

Χρησιμοποιήστε την προεπιλεγμένη θύρα, "8080" και κάντε κλικ στο "Generate Domain".

Θα πρέπει να αποκτήσετε ένα domain όπως https://my-kora-node.railway.app/

Δοκιμή 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

Αναμενόμενη απάντηση:

{
  "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 - Αναφορά σφαλμάτων ή υποστήριξη
• Solana Stack Exchange - Υποβολή ερωτήσεων/ανταλλαγή γνώσεων (φροντίστε να χρησιμοποιήσετε την ετικέτα kora)