Cómo publicar un grupo de Mintter en tu propio sitio web alojado con ionos
Introducción
Esta guía sigue los pasos que he realizado para poder publicar un grupo en un dominio propio contratado, no pretendo ser riguroso en los términos empleados pues mis conocimientos son limitados en este campo. Así mismo esta explicación es para ionos ya que los pasos a seguir en otras empresas de hosting/servidores pueden ser distintos.
En el siguiente vídeo se explica como se hace el "Publish Group to Site" en Digital Ocean. Si consigues hacer este proceso en otras empresas de hosting puedes aportar a la comunidad desarrollando tu propia guía en Mintter.
Lo primero es tener una cuenta con ionos. Este paso es simple y lo omitimos.
Primer requisito: tener el dominio contratado.
Adquirir el dominio
Accedes desde el menú a Dominios & SSL:
Una vez contratado el dominio, en la siguiente pestaña haces clic en el nombre de tu dominio
Se te abre la siguiente ventana, en la que tienes que ir a DNS y añadir un registro. En mi caso he filtrado por un subdominio porque es donde quiero realizar la instalación.
Tienes que generar un registro que apunte el dominio/subdominio a la ip del servidor (más adelante se explica como configurar el servidor cloud):
Segundo requisito: contratar el servidor cloud.
Servidor cloud
Elegí un servidor Cloud porque me explicaron que si necesitabas ampliar la capacidad era más sencillo que con un servidor normal. Sobre la siguiente ventana, puedes crear un nuevo servidor Cloud...
O si creas uno por primera vez, te vas a la pagina principal de ionos - Servidores y Cloud - Servidores virtuales - Servidores cloud.
Yo he contratado la versión más básica, que en caso de necesitar ampliarse a futuro no debería haber problemas. En uno de los siguientes pasos de configuración tienes que seleccionar que tenga la instalación sobre ubuntu:
Una vez dentro del panel de tu servidor cloud, yo he llamado al mío Mintter cloud pero le podéis llamar como queráis. A partir de aquí hay algunas cosas más complejas.
Tienes que ir a Red, posteriormente Políticas de firewall, y debes abrir el puerto 56000. Si no, te dará error el último paso de "Public group to site" (me pasó en la instalación). Haz clic en la opción que pone Linux, que viene con los puertos 22, 80 y 443 abiertos de antemano, para poder añadir el 56000.
En la siguiente imagen puedes ver como se crean: todas las ip permitidas, protocolo TCP, puerto 56000 y de comentario le he puesto "para Mintter". Le das a añadir.
Tras esto ya tenemos todo configurado en este segundo requisito. Ahora volvemos a Infraestructura- Servidores y haces clic en el nombre de tu servidor. Te sale la siguiente imagen:
Tachado en naranja está la ip de nuestro servidor, hacia la cual tenemos que dirigir nuestro dominio/subdominio. Nuestro usuario es root y puedes tomar la contraseña para acceder a tu servidor por SSH en esta pestaña. Técnicamente los siguientes pasos los puedes hacer seleccionando en acciones sobre tu servidor -Iniciar consola KVM, o con el programa PuTTY desde tu ordenador.
Enlace para descargar PuTTY: https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
En mi caso he usado el terminal de Mac:
Instalación Mintter
Tercer requisito: instalación de curl en el servidor usando el terminal.
Necesitamos instalar curl en el servidor de ubuntu, para ello me he basado en la guía siguiente: https://comandosenlinux.com/ubuntu/como-instalar-curl-en-ubuntu
Abrimos el terminal y ejecutamos:
ssh root@LA.IP.DEL.SERVIDOR
Para alguien familiarizado con el terminal, esto no requiere ser explicado, pero como me dirijo a gente menos experimentada detallo las cosas que un inicio me costaron más por simples que sean. En la siguiente imagen tras introducir el anterior comando, te pide la contraseña del servidor que ya he mencionado previamente como se obtiene. Tienes que pegarla o escribirla, y posteriormente pulsar intro, pero la contraseña en ningún momento la verás en pantalla por lo que es fácil equivocarse.
Una vez dentro podemos instalar curl en nuestro servidor, los comandos son (puedes copiar y pegar en terminal uno a uno):
sudo apt-get update (intro y esperas a que se cargue todo, antes de introducir el siguiente comando).
sudo apt-get install curl (intro y esperas a que se cargue todo, antes de introducir el siguiente comando).
curl --version (intro y verás la versión de curl si todo se ha instalado correctamente)
Cuarto requisito: instalar el docker de Mintter en el servidor.
Los pasos están descritos en https://github.com/MintterHypermedia/mintter
Continuamos con el terminal y pegamos el siguiente comando, modificando https://example.com por el nombre de nuestro dominio/subdominio:
sh <(curl -sL https://go.hyper.media/website_deployment.sh) https://example.com --auto-updateEsta es la opción para que se realicen las actualizaciones automáticas en nuestro servidor, pero si quieres evitar esto copia el comando sin el "auto-update" del enlace de github. Te recomiendo leer la página de github para entender las opciones.
Si lo has hecho todo bien, terminará la instalación y te saldrá al final del terminal un enlace privado que debes copiar:
Último paso:
Publish group to site
Abrimos la aplicación de Mintter, abrimos el grupo que queremos que salga en nuestro dominio, damos a los tres puntos que aparecen en la esquina superior derecha y pulsamos Publish group to site. Aquí debemos introducir el enlace privado generado en el paso anterior y ya tendremos el grupo vinculado a nuestro dominio.
Con esto ya tendréis vuestro grupo de Mintter en vuestro dominio web propio. Espero que os funcione y haya sido de ayuda la guía.
Powered by Mintter + The Hypermedia Protocol