Despliegue en Railway

Railway ofrece una experiencia de despliegue sencilla para nodos de Kora con SSL automático, gestión de dominios y monitoreo integrado. Esta guía te guiará a través de la configuración de un nodo de Kora en Railway con una imagen Docker simple y la CLI de Railway.

Requisitos previos

• Cuenta de Railway
• CLI de Railway instalado
• CLI de Solana para la creación de clave privada
• Endpoint RPC de Solana

Paso 1: Preparar los archivos de despliegue

Crea un nuevo directorio para tu nodo de Kora:

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

Agrega los archivos de ejemplo a tu directorio:

• kora.toml
• signers.toml
• Dockerfile

Tu directorio debería verse así:

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

Paso 2: Desplegar en Railway

Desde el directorio de tu proyecto, inicia sesión en Railway

# Login to Railway
railway login

Sigue las instrucciones en pantalla para iniciar sesión con tu cuenta.

Inicializa el proyecto de Railway en tu directorio.

railway init

Railway te pedirá que:

1. Crees un nuevo proyecto o selecciones uno existente
2. Elijas un nombre de proyecto (por ejemplo, "mi-nodo-kora")

Despliega tu aplicación

# Deploy the application
railway up

Esto hará lo siguiente:

• Subir tus archivos a Railway
• Construir la imagen Docker
• Desplegar tu aplicación

Resultado esperado:

Build time: 121.81 seconds
Deploy complete
Starting Container

¡Excelente! ¡Ya está todo configurado! Probablemente notarás un error en tus registros ("error: a value is required for --rpc-url <RPC_URL> but none was supplied"). Esto se debe a que aún no hemos configurado nuestras variables de entorno, así que hagámoslo a continuación.

Paso 3: Configurar las Variables de Entorno

Abre tu panel de Railway en railway.app y navega a tu proyecto. En tu proyecto, haz clic en "Settings" > "Variables"

Variables de Entorno de Railway para Kora

Agrega estas variables de entorno:

Advertencia de Seguridad: Tu clave privada tiene acceso a SOL para pagar tarifas. Utiliza un keypair dedicado para tu nodo Kora y solo deposítale el SOL que estés dispuesto a gastar en tarifas de transacción. Para obtener más información sobre firmantes, consulta la Guía de Firmantes.

Obtener Tu Clave Privada

Si necesitas crear un nuevo keypair:

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

Asegúrate de depositar suficiente SOL para probar/operar tu nodo.

Paso 4: Redesplegar

Después de guardar tus variables, se te solicitará redesplegar tu servidor: hazlo.

Paso 5: Probar Tu Despliegue

Generar un Endpoint Público

Para enviar solicitudes a tu endpoint, necesitarás generar un dominio público. Desde tu despliegue, ve a "Settings" > "Generate domain".

Configuración de Dominio en Railway

Usa el puerto predeterminado, "8080" y haz clic en "Generate Domain".

Deberías obtener un dominio como https://my-kora-node.railway.app/

Probar el Endpoint de Configuración

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

Respuesta esperada:

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

¡Buen trabajo! Tu nodo Kora ya está en funcionamiento.

¿Necesitas Ayuda?

• Guía para Operadores de Nodos Kora - Problemas comunes y soluciones
• Documentación de Railway - Ayuda específica de la plataforma
• Problemas en GitHub - Reporta errores u obtén soporte
• Solana Stack Exchange - Haz preguntas y comparte aprendizajes (asegúrate de usar la etiqueta kora)