Instala Portainer y Traefik

Introducción

En esta lección aprenderás a instalar las dos herramientas fundamentales de nuestra infraestructura de IA: Portainer (gestor de contenedores) y Traefik (proxy reverso para gestionar dominios).

Paso 1: Ejecutar el Setup de Orion Design

Obtener el comando de instalación

1. Ve a la página oficial de Orion Design: oriondesign.art.br
2. Copia el comando de setup haciendo clic en «Copiar código de setup»
3. Pega el comando en tu terminal del servidor
4. Presiona Enter

Nota importante: También te proporcionaremos este comando para que simplemente lo copies y pegues.

bash <(curl -sSL setup.oriondesign.art.br)

Proceso de instalación inicial

• El sistema actualizará primero todos los paquetes de Ubuntu
• Después desplegará el menú de aplicaciones disponibles
• Este proceso toma entre 1-2 minutos dependiendo de tu conexión

⚠️ Advertencia sobre Ubuntu: Aunque aparezca un aviso recomendando Ubuntu 20.04, es mejor usar Ubuntu 22.04 ya que la versión 20 pronto perderá soporte.

Aceptar términos

• Aparecerá una pantalla pidiendo aceptar los términos de licencia MIT
• Escribe Y y presiona Enter

Paso 2: Navegar por el menú de aplicaciones

Explorar las opciones disponibles

• Página 1: Muestra las primeras 45 aplicaciones
• Página 2: Para ver el resto, escribe P2 y presiona Enter
• Regresar: Escribe P1 para volver a la página 1

Actualmente hay más de 70 aplicaciones disponibles, todas open source.

Entender los requisitos de recursos

Cada aplicación muestra números verdes (ej: 1/1, 2/2) que indican:

• Primer número: CPUs mínimas requeridas
• Segundo número: GB de RAM mínimos requeridos

Ejemplos:

• Chatwoot: 2 CPUs + 2 GB RAM
• N8n: 2 CPUs + 2 GB RAM
• Supabase: 2 CPUs + 4 GB RAM

💡 Recomendación: Tu servidor debe tener mínimo 8 GB de RAM para instalaciones exitosas.

Paso 3: Configurar DNS en tu dominio

Si no tienes generada la Zona DNS del dominio que vas a usar

1. Accede a tu panel de contabo y ve al apartado «DNS Zone Management»
2. Ve a «Create new DNS zone» escribe el nombre del dominio y elige el servidor al que va a apuntar
3. Importante: Tienes que cambiar las DNS del dominio a las de contabo

Administrar un dominio en contabo

1. Accede a tu panel de contabo y ve al apartado «DNS Zone Management»
2. Busca el dominio que quieres administrar y pulsa en el icono de editar

Crear registro tipo A (solo una vez)

1. Ve a la sección Registros
2. Agrega un registro tipo A con:
   • Nombre: workstation (o el nombre que prefieras)
   • Apunta a: La IP de tu servidor
3. Presiona Agregar registro

Crear registro CNAME para Portainer

1. Agrega un registro tipo CNAME con:
   • Nombre: devportainer (evita usar solo «portainer» para prevenir bloqueos de Google)
   • Apunta a: workstation.tudominio.com
2. Presiona Agregar registro

¿Por qué esta estructura DNS?

• Ventaja: Si cambias de servidor, solo modificas 1 registro (tipo A) con la IP del nuevo servidor
• Sin esta estructura: Tendrías que cambiar múltiples registros tipo A para cada aplicación
• Resultado: Administración más eficiente

Paso 4: Instalar Portainer y Traefik

Seleccionar la instalación

1. En el menú de Orion, escribe 01 (Traefik + Portainer)
2. Presiona Enter

Configurar los datos solicitados

Dominio de Portainer:

• Ingresa: dev-portainer.tudominio.com
• Presiona Enter

Usuario de Portainer:

• Recomendado: admin
• Presiona Enter

Contraseña:

• Debe incluir mayúsculas, minúsculas y caracteres especiales
• Presiona Enter

Nombre del servidor:

• Ingresa el nombre que desees (ej: nombre del cliente o agencia)
• Presiona Enter

Nombre de la red:

• Ingresa un nombre para la red interna (ej: jerocuevasNet)
• Presiona Enter

Email de contacto:

• Ingresa tu email principal
• Presiona Enter

Verificar y confirmar

1. Revisa que todos los datos sean correctos
2. Si hay errores, presiona N para corregir
3. Si todo está bien, presiona Y para continuar

Paso 5: Completar la instalación

Proceso automático

• Orion instalará automáticamente Traefik y Portainer
• El proceso toma entre 3-5 minutos máximo
• No cierres la terminal durante este proceso

Acceso a Portainer

1. Una vez terminado, aparecerán los datos de acceso
2. ¡IMPORTANTE! Tienes máximo 5 minutos para acceder
3. Copia la URL, usuario y contraseña proporcionados
4. Accede inmediatamente a tu dominio configurado

Verificar instalación exitosa

1. Ingresa tus credenciales en Portainer
2. Si accedes correctamente, verás el dashboard
3. Ve a la sección Stacks
4. Deberías ver Portainer y Traefik instalados

Próximos pasos

Con Portainer y Traefik instalados correctamente, ya tienes la base de tu infraestructura lista. Desde Portainer podrás:

• Gestionar todas las aplicaciones futuras
• Monitorear recursos del servidor
• Administrar contenedores Docker

En la siguiente lección instalaremos las primeras aplicaciones de IA sobre esta base sólida.

Consejos importantes

✅ Haz esto:

• Guarda todos tus datos de acceso en un lugar seguro
• Usa nombres descriptivos para tus registros DNS
• Mantén tu servidor con mínimo 8 GB RAM

❌ Evita esto:

Tardar más de 5 minutos en acceder a Portainer por primera vez

Usar nombres exactos de aplicaciones en DNS

Cerrar la terminal durante instalaciones