Wdrożenie na Railway

Railway oferuje łatwe wdrożenie węzłów Kora z automatycznym SSL, zarządzaniem domenami i wbudowanym monitoringiem. Ten przewodnik przeprowadzi Cię przez konfigurację węzła Kora na Railway przy użyciu prostego obrazu Dockera i interfejsu CLI Railway.

Wymagania wstępne

• Konto Railway
• Zainstalowane Railway CLI
• Solana CLI do tworzenia kluczy prywatnych
• Punkt końcowy Solana RPC

Krok 1: Przygotowanie plików wdrożeniowych

Utwórz nowy katalog dla swojego węzła Kora:

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

Dodaj przykładowe pliki do swojego katalogu:

• kora.toml
• signers.toml
• Dockerfile

Twój katalog powinien teraz wyglądać następująco:

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

Krok 2: Wdrożenie na Railway

Z katalogu projektu zaloguj się do Railway

# Login to Railway
railway login

Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby zalogować się na swoje konto.

Zainicjuj projekt Railway w swoim katalogu.

railway init

Railway wyświetli monit o:

1. Utworzenie nowego projektu lub wybór istniejącego
2. Wybranie nazwy projektu (np. "moj-wezel-kora")

Wdróż swoją aplikację

# Deploy the application
railway up

To spowoduje:

• Przesłanie plików na Railway
• Zbudowanie obrazu Dockera
• Wdrożenie aplikacji

Oczekiwany wynik:

Build time: 121.81 seconds
Deploy complete
Starting Container

Świetnie! Wszystko jest gotowe! Prawdopodobnie zauważysz błąd w logach ("error: a value is required for --rpc-url <RPC_URL> but none was supplied"). Dzieje się tak, ponieważ nie skonfigurowaliśmy jeszcze zmiennych środowiskowych — zajmijmy się tym teraz.

Krok 3: Konfiguracja zmiennych środowiskowych

Otwórz swój panel Railway pod adresem railway.app i przejdź do swojego projektu. W projekcie kliknij "Settings" > "Variables"

Zmienne środowiskowe Railway dla Kora

Dodaj następujące zmienne środowiskowe:

Ostrzeżenie bezpieczeństwa: Twój klucz prywatny ma dostęp do SOL na opłacanie prowizji. Użyj dedykowanej pary kluczy dla swojego węzła Kora i doładuj ją tylko taką ilością SOL, którą jesteś gotów wydać na opłaty transakcyjne. Więcej informacji o podpisujących znajdziesz w Przewodniku po podpisujących.

Pobieranie klucza prywatnego

Jeśli musisz utworzyć nową parę kluczy:

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

Upewnij się, że wpłacisz wystarczającą ilość SOL do testowania/obsługi swojego węzła.

Krok 4: Ponowne wdrożenie

Po zapisaniu zmiennych zostaniesz poproszony o ponowne wdrożenie serwera — zrób to.

Krok 5: Przetestuj wdrożenie

Wygeneruj publiczny punkt końcowy

Aby wysyłać żądania do swojego punktu końcowego, musisz wygenerować publiczną domenę. W swoim wdrożeniu przejdź do "Settings" > "Generate domain".

Konfiguracja domeny Railway

Użyj domyślnego portu "8080" i kliknij "Generate Domain".

Powinieneś uzyskać domenę taką jak https://my-kora-node.railway.app/

Testowanie endpointu konfiguracji

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

Oczekiwana odpowiedź:

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

Świetna robota! Twój węzeł Kora jest teraz aktywny.

Potrzebujesz pomocy?

• Przewodnik operatorów węzłów Kora - Typowe problemy i rozwiązania
• Dokumentacja Railway - Pomoc specyficzna dla platformy
• GitHub Issues - Zgłaszanie błędów lub uzyskiwanie wsparcia
• Solana Stack Exchange - Zadawaj pytania/dziel się wiedzą (pamiętaj o użyciu tagu kora)