Desplegar con Slot

Slot es un servicio gestionado que ofrece instancias alojadas de Katana y indexadores Torii para juegos Dojo. Esta guía explica paso a paso el flujo completo de despliegue, desde la autenticación hasta la puesta en producción. En Q2BSTUDIO impulsamos proyectos con software a medida y aplicaciones a medida, combinando inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA y power bi para acelerar la innovación. Si necesitas acompañamiento experto en despliegues y arquitectura, podemos ayudarte con servicios cloud aws y azure y con el desarrollo de aplicaciones a medida.

Prerrequisitos

Asegúrate de tener instalada la última versión de Dojo.

Comando sugerido: dojoup

Configuración de autenticación

Inicio de sesión inicial

Ejecuta: slot auth login

Se abrirá el navegador para completar la autenticación. Sigue las indicaciones hasta finalizar el proceso.

Solución de problemas de autenticación

Si aparecen problemas por credenciales antiguas, elimínalas y vuelve a iniciar sesión.

Comandos: rm ~/Library/Application Support/slot/credentials.json

Luego: slot auth login

Despliegue del backend Katana

Inicializa tu proyecto

Crea o entra a tu proyecto Dojo: sozo init dojo-starter && cd dojo-starter

Crea el despliegue de Katana

Comando: slot deployments create my-dojo-game katana

Este comando crea una instancia Katana, devuelve una URL de endpoint RPC y proporciona credenciales de cuenta únicas.

Configura tu proyecto

Tras el despliegue recibirás una URL RPC. Actualiza tu archivo Scarb.toml con los campos: rpc_url igual a la URL de Katana, account_address con el valor mostrado en los logs, private_key con la clave del despliegue y world_address se agregará tras la migración.

Nota: cada slot de Katana genera semillas de cuenta únicas, por lo que deberás actualizar estos valores en cada despliegue.

Supervisa los logs de Katana

Comando: slot deployments logs my-dojo-game katana -f

Verás logs en tiempo real y la información de cuentas necesaria para la configuración.

Compila y migra

Compila: sozo build

Migra: sozo migrate

Si la migración se completa correctamente, verás un mensaje confirmando el despliegue del World con una dirección tipo 0x seguido de la cadena hexadecimal. Guarda esa dirección como WORLD_ADDRESS para el despliegue de Torii.

Despliegue del indexador Torii

Despliega una instancia Torii usando la dirección del World y el RPC de Katana.

Comando: slot deployments create my-dojo-game torii --world 0x123456... --rpc https://api.cartridge.gg/x/your-deployment-id/katana --start-block 1

Parámetros clave

--world dirección del contrato World

--rpc endpoint de Katana

--start-block bloque desde el que iniciar la indexación usa 1 para el histórico completo

Al finalizar, recibirás el endpoint GraphQL para consultas y el endpoint gRPC para suscripciones en tiempo real.

Supervisa los logs de Torii

Comando: slot deployments logs my-dojo-game torii -f

Así verificas que el indexador sincroniza correctamente con el estado de tu World.

Verificación y pruebas

1 Verifica que Katana está en ejecución probando tu endpoint RPC.

2 Confirma que el World fue migrado correctamente y que las entidades están disponibles.

3 Prueba la indexación de Torii lanzando consultas GraphQL y validando los datos esperados.

Acceso a tus servicios

Ejemplos de endpoints:

Katana RPC: https://api.cartridge.gg/x/your-deployment-id/katana

Torii GraphQL: https://api.cartridge.gg/x/your-deployment-id/torii/graphql

Torii gRPC: https://api.cartridge.gg/x/your-deployment-id/torii

Gestión de despliegues

Listar despliegues activos

Comando: slot deployments list

Eliminar despliegues cuando ya no sean necesarios

Comandos: slot deployments delete my-dojo-game katana

y: slot deployments delete my-dojo-game torii

Mejores prácticas

- Usa un nombre de despliegue consistente para Katana y Torii.

- Mantén abiertos los streams de logs durante los primeros minutos para detectar incidencias.

- Actualiza tu configuración local cada vez que cambien endpoints o credenciales.

- No subas claves privadas ni datos sensibles a tu control de versiones.

Resolución de problemas

- Fallos de autenticación: borra credenciales y vuelve a iniciar sesión.

- Errores de migración: valida la URL RPC y la configuración de cuenta.

- Problemas de sincronización de Torii: revisa la dirección del World y el endpoint RPC.

Cómo obtener ayuda

1 Revisa los logs de despliegue en busca de mensajes de error.

2 Verifica que todos los valores de configuración son correctos y actuales.

3 Asegúrate de estar usando la última versión de Dojo con dojoup.

Enhorabuena, ya tienes un juego Dojo completamente desplegado con el secuenciador Katana y el indexador Torii operando en la infraestructura gestionada de Slot. Tu entorno queda listo para desarrollo y pruebas persistentes y escalables. En Q2BSTUDIO también te ayudamos a extender tu solución con seguridad avanzada, ciberseguridad, automatización y analítica, integrando servicios inteligencia de negocio con power bi y potenciando la ia para empresas con agentes IA para acelerar decisiones y operaciones.