Cómo instalar Discourse en Ubuntu 20.04

El autor seleccionó la Free and Open Source Fund para recibir una donación como parte del programa Write for DOnations.

Introducción

Discourse es una plataforma de debate de código abierto. Puede usarse como una lista de correo, un foro de debate o una sala de chat grande. En este tutorial, instalará Discourse en un entorno aislado utilizando Docker, una aplicación de creación de contenedores.

Requisitos previos

Antes de comenzar, necesitará lo siguiente:

  • Un servidor Ubuntu 20.04 con un mínimo de 2 GB de RAM, un usuario sudo non-root y un firewall Para obtener orientación, puede consultar nuestro tutorial de configuración inicial de servidores para Ubuntu 20.04.
  • Docker instalado en su servidor. Para instalarlo, puede seguir el paso 1 de nuestro tutorial de instalación de Docker para Ubuntu 20.04.
  • Un dominio (o subdominio) con un registro A disponible apuntado a la IP de su servidor. Si administra su DNS en DigitalOcean, puede seguir esta guía para asociar su IP con su dominio. En este tutorial, se utilizará discourse.your_domain.
  • Un servidor de correo SMTP. Si no desea ejecutar su propio servidor de correo, puede usar otro servicio, como una cuenta gratuita de Mailgun.

Paso 1: Descargar Discourse

Antes de descargar e instalar Discourse, cree el directorio /var/discourse. Aquí es donde se alojarán todos sus archivos relacionados con Discourse:

sudo mkdir /var/discourse 

Por último, clone la imagen de Docker oficial de Discourse en /var/discourse:

sudo git clone https://github.com/discourse/discourse_docker.git /var/discourse 

Ahora que tiene la imagen de Docker de Discourse establecida, puede instalar y configurar su plataforma.

Paso 2: Instalar y configurar Discourse

Posiciónese en el directorio /var/discourse:

cd /var/discourse 

Ahora inicie la secuencia de comandos de configuración incluida:

sudo ./discourse-setup 

La secuencia de comandos de instalación de Discourse le preguntará lo siguiente:

  • Hostname for your Discourse? (¿Nombre de host de su Discourse?)

Ingrese discourse.your_domain o cualquier nombre de host que haya elegido para su plataforma.

  • Email address for admin account? (¿Dirección de correo electrónico de la cuenta de administrador?)

Seleccione la dirección de correo electrónico que desea usar para la cuenta de administrador de Discourse. No es necesario que esté relacionada con su dominio de Discourse y puede ser cualquier dirección de correo electrónico que considere conveniente.

Tenga en cuenta que esta dirección de correo electrónico se convertirá en la predeterminada de administrador de Discourse. Deberá volver a utilizar esta dirección de correo electrónico más adelante cuando configure Discourse desde su panel de control.

  • SMTP server address? (¿Dirección del servidor SMTP?)

  • SMTP user name? (¿Nombre de usuario de SMTP?)

  • SMTP port? (¿Puerto SMTP?)

  • SMTP password? (¿Contraseña de SMTP?)

Introduzca los datos de su servidor SMTP para estas preguntas. Si usa Mailgun, la dirección del servidor SMTP será smtp.mailgun.org, el nombre de usuario y la contraseña son las credenciales de SMTP de su dominio, que se encuentran en la pestaña domains (dominios) de Mailgun.

Por último, la secuencia de comandos de instalación de Discourse le solicitará que confirme todos estos ajustes. Confirme sus ajustes. Al hacerlo, la secuencia de comandos generará un archivo de configuración denominado app.yml. El proceso de instalación se iniciará automáticamente.

Nota: Si necesita cambiar o corregir estos ajustes después de la instalación, edite el archivo /containers/app.yml y ejecute ./launcher rebuild app. De lo contrario, sus cambios no se surtirán efecto

La instalación de Discourse tomará aproximadamente 2 a 8 minutos, y una vez terminada, se ejecutará su instancia. Ahora, puede abrir un navegador web y crear una cuenta de administrador.

Paso 3: Registrar una cuenta de administrador

Visite discourse.your_domain en el navegador web que prefiera y verá la pantalla inicial “Congrats” (Felicitaciones) de Discourse.

Pantalla de felicitación de Discourse

Si recibe un error 502 de Puerta de enlace incorrecta, espere unos minutos y actualice el navegador; es posible que la instalación de Discourse no se haya completado.

Cuando la página carga, haga clic en el botón azul Register (Registrarse). Verá un formulario titulado Register Admin Account (Registrar cuenta de administrador) con los siguientes campos:

  • Email: Elija la dirección de correo electrónico que suministró anteriormente desde el menú desplegable.
  • Username: Elija un nombre de usuario.
  • Password: Elija una contraseña segura.

Luego, haga clic en el botón azul Register (Registrarse) del formulario para enviarlo. Verá un cuadro de diálogo que indica Confirm your Email (Confirmar su correo electrónico). Busque el correo electrónico de confirmación en su bandeja de entrada. Si no lo recibió, haga clic en el botón Resend Activation Email (Reenviar correo electrónico de activación). Si sigue sin poder registrar una cuenta de administrador nueva, consulte la Lista de comprobación para la resolución de problemas de correo electrónico de Discourse.

Después de registrar su cuenta de administrador, se iniciará el asistente de configuración que lo guiará a través de la configuración básica de Discourse. Puede completarlo ahora o hacer clic en Maybe Later (Tal vez más adelante) para omitirlo.

Asistente de configuración de Discourse

Después de completar u omitir el asistente de configuración, verá algunos temas y la Guía de inicio rápido de administración de Discourse. La guía de inicio rápido se titula READ ME FIRST (Leer antes de continuar), y contiene consejos para personalizar aún más la instalación de Discourse.

Página de inicio de Discourse y enlace a la Guía de inicio rápido de administración

Su plataforma de Discourse está lista para usarse. Si necesita actualizar Discourse en el futuro, puede hacerlo desde la línea de comandos extrayendo la última versión del código del repositorio de Git y recompilando la aplicación de la siguiente manera:

cd /var/discourse sudo git pull sudo ./launcher rebuild app 

También puede actualizar Discourse en su navegador. Visite http://discourse.your_domain/admin/upgrade, haga clic en Upgrade to the Latest Version (Actualizar a la versión más reciente) y siga las instrucciones.

Página del administrador de actualizaciones de Discourse

Conclusión

Ahora, puede comenzar a administrar su foro de Discourse y permitir que los usuarios se registren. Puede obtener más información sobre las características de Discourse en la página About (Acerca de nosotros) oficial de Discourse.