Zero to Zulip Instalación de Zulip en Ubuntu 20.04 para principiantes
Written by Socialism.tools Admin
Published noviembre 28, 2021

Introducción

Zulip es un programa de colaboración de código abierto y una gran alternativa a Slack. Esta guía te guiará a través de la instalación y configuración básica de Zulip para que puedas tener conversaciones rápidas y productivas con tus amigos y compañeros de trabajo. Estas instrucciones deberían ser similares a las de los documentos oficiales, pero aquí proporcionaré información adicional y contexto para ayudarte en el camino. Si estas instrucciones le parecen desalentadoras, considere la posibilidad de utilizar la aplicación del mercado de DigitalOcean, que se encargará del paso 1 y de las partes obligatorias del 2 por usted.

Paso 0: Prepare su servidor

El primer paso es el aprovisionamiento de su servidor. Zulip es bastante ligero por defecto – utilicé el nodo de alta frecuencia de 12$/mes más cercano a mí en Chicago en Vultr, con Ubuntu 20.04, la última versión estable. Puedes usar cualquier producto VPS para esto, pero no recomendaría alojar desde una VM en casa.

Si aún no tienes Vultr, puedes utilizar este enlace para registrarte y conseguir la friolera de 100 dólares de crédito inicial. Cuando te hayas conectado, elige el tamaño de servidor adecuado para continuar. Si estás en Vultr o en un proveedor similar, es fácil escalar, así que no hay problema en empezar con algo pequeño.

Es probable que no necesites IPv6, pero recomiendo hacer copias de seguridad automáticas si planeas usar tu instalación de Zulip en un entorno de producción. Si sabes cómo hacerlo, lo mejor es utilizar claves SSH. Una vez que hayas creado tu servidor, inicia la sesión y comencemos.

Paso 1: Instalación

Comenzamos descargando y desempaquetando la última versión con estos tres comandos. Si es la primera vez que utiliza la línea de comandos, intente pegarlas de una en una en lugar de todas a la vez.

cd $(mktemp -d)
wget https://download.zulip.com/server/zulip-server-latest.tar.gz
tar -xf zulip-server-latest.tar.gz

Mi salida tenía este aspecto. Puede ver el cambio de directorio (observe la parte anterior al $ en la línea 2) y el progreso de la descarga del archivo zip. Descomprimir (tar -xf) el archivo (esto es muy similar a descomprimir un .zip, linux usa tar) no devuelve ningún resultado cuando termina, pero puedes usar ls para buscar.

zulip@zulip:~$ cd $(mktemp -d)
zulip@zulip:/tmp/tmp.euQYrA7K6i$ wget https://download.zulip.com/server/zulip-server-latest.tar.gz
--2021-10-28 20:09:27--  https://download.zulip.com/server/zulip-server-latest.tar.gz
Resolving download.zulip.com (download.zulip.com)... 54.230.15.74, 54.230.15.34, 54.230.15.70, ...
Connecting to download.zulip.com (download.zulip.com)|54.230.15.74|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 84435141 (81M) [application/gzip]
Saving to: ‘zulip-server-latest.tar.gz’

zulip-server-latest.tar.gz    100%[=================================================>]  80.52M  13.1MB/s    in 6.2s

2021-10-28 20:09:34 (13.0 MB/s) - ‘zulip-server-latest.tar.gz’ saved [84435141/84435141]

zulip@zulip:/tmp/tmp.euQYrA7K6i$ tar -xf zulip-server-latest.tar.gz
zulip@zulip:/tmp/tmp.euQYrA7K6i$

Ahora tendrás que ejecutar sudo -s para elevar tus permisos al usuario root. Esto es similar a hacer clic en %22Permitir%22 en las ventanas emergentes en Windows o macOS cuando se instala un software. Ahora tendrás que ejecutar otro comando, pero tiene dos opciones, llamadas flags, que querrás editar. Copie y pegue esta plantilla en el bloc de notas o algo similar para poder editarla antes de introducirla en su servidor:

./zulip-server-*/scripts/setup/install --certbot --email=YOUR_EMAIL --hostname=YOUR_HOSTNAME

Tu correo electrónico se convertirá en un administrador de Zulip cuando la instalación haya terminado. Si estás instalando en nombre de un grupo u organización, utiliza la cuenta de tu organización en lugar de tu correo electrónico personal, y considera la posibilidad de utilizar una cuenta compartida – este correo electrónico recibirá los mensajes de soporte y de error del servicio Zulip.

El nombre de host es la URL de tu servidor, como zulip.website.com. Este nombre de host deberá ser accesible desde Internet para que el certificado HTTPS funcione correctamente. Si usas Vultr, hay dos pasos. Primero, obtén tu dirección IP desde la consola de Vultr. A continuación, acceda a su registrador de DNS (como Gandi, Cloudflare o Namecheap) y cree un registro A para esa dirección IP en su nombre de host. Los ordenadores no entienden los nombres por defecto, sólo saben dónde ir en función de la dirección IP. El registro A indica al navegador de alguien la dirección IP en la que debe encontrar su servidor cuando un humano escribe la dirección.

Ahora que tienes tu registro A listo, vamos a configurar Zulip. Pega el comando con tu correo electrónico y nombre de host en tu servidor de Zulip, y luego espera unos minutos.

una nota rápida sobre HTTPS

A continuación, se le pedirá que acepte los términos y condiciones de Let’s Encrypt, el proveedor de credenciales HTTPS. HTTPS es la forma en que la comunicación de tu aplicación Zulip y el servidor se mantiene segura.

Si recibe un error aquí, compruebe que sus DNS apuntan a su servidor; es posible que tenga que esperar unos minutos o incluso horas para que se realice. Puedes comprobar que tu nombre de host apunta a tu ip con nslookup en windows o dig en macOS. Abre tu terminal y escribe nslookup YOUR_HOSTNAME y asegúrate de que la IP coincide con tu máquina Zulip.

  • Si alojas en casa, asegúrate de que tu router o tu proveedor de Internet no bloquean los puertos 80 o 443.
  • Si utilizas un proxy inverso, asegúrate de seguir las instrucciones de Zulip aquí

La instalación se ejecutará durante unos minutos más. Cuando termine, obtendrás un enlace de creación de dominio: cópialo y pégalo en tu navegador para crear tu primera cuenta de administrador.

Paso 2: Configuración inicial

Después de crear tu cuenta, verás la pantalla principal de Zulip. También deberías ver una gran barra roja en la parte superior que te avisa de que el correo electrónico no está funcionando: vamos a arreglarlo.

Abre tu archivo de configuración de Zulip con nano /etc/zulip/settings.py. Si aún no tienes una, crea una cuenta en Mailgun e introduce la información. Asegúrese de eliminar el símbolo # que precede a la línea de configuración.

He aquí un ejemplo:

## EMAIL_HOST and EMAIL_HOST_USER are generally required.
EMAIL_HOST = 'smtp.mailgun.org'
EMAIL_HOST_USER = 'rosa@mail.website.com'

## Passwords and secrets are not stored in this file.  The password
## for user EMAIL_HOST_USER goes in `/etc/zulip/zulip-secrets.conf`.
## In that file, set `email_password`.  For example:
# email_password = abcd1234

## EMAIL_USE_TLS and EMAIL_PORT are required for most SMTP providers.
EMAIL_USE_TLS = True
EMAIL_PORT = 587

Guarde su archivo, luego agregue su contraseña en zulip-secrets.conf como se especifica. Eso es, vamos a probarlo. Ejecute su zulip -c ‘/home/zulip/deployments/current/manage.py send_test_email youremail@domain.com’ para enviar un correo electrónico de prueba. Si funciona, puedes continuar. Si no es así, compruebe los pasos de solución de problemas aquí.

Notificaciones push para móviles

Vamos a editar mucho /etc/zulip/settings. py, así que ponte cómodo.

Vuelva a abrir ese archivo y descomente la línea PUSH_NOTIFICATION_BOUNCER_URL, luego guarde y cierre el archivo. Ya deberías estar conectado como usuario de Zulip, y si lo estás, ejecuta /home/zulip/deployments/current/manage.py register_server. Si no, ejecuta su zulip -c ‘/home/zulip/deployments/current/manage.py register_server’ como root (esto ejecutará el comando de registro usando el usuario Zulip ). Entonces, simplemente reinicie su servidor con /home/zulip/deployments/current/scripts/restart-server de nuevo.

Si los usuarios ya han iniciado sesión en la aplicación móvil, deben cerrar la sesión y volver a iniciarla para que se apliquen los ajustes push.
Este servicio se basa en Kandra Labs para proxy sus mensajes push. Aunque algunas personas no se sientan cómodas con que un tercero vea sus contenidos push, es una limitación técnica razonable. Si estás realmente comprometido, puedes compilar tus propias versiones de las aplicaciones de Zulip, lo cual es una tarea enorme, e incluso después de hacerlo Apple y Google pueden ver todo tu contenido push. No recomiendo hacer esto; no vale la pena el esfuerzo. Hagamos algo divertido: ¡permitir la búsqueda de GIFs!

Opcional: Integración de GIPHY

Esta es fácil y divertida. Sólo tienes que descomentar la línea `GIPHY_API_KEY` e introducir tu clave de API desde la consola de desarrollo de GIPHY. Debe elegir SDK como tipo de producto. Toma tu dev key y pégala en tu archivo settings.py en la línea GIPHY, luego reinicia tu servidor una vez más. Cuando vuelvas a entrar, haz clic en el engranaje de configuración, haz clic en la configuración de la organización, luego desplázate hacia abajo y habilita GIPHY con la clasificación de edad que hayas elegido.

Para obtener una clave de producción, tendrás que grabar un breve vídeo en el que pruebes tu nueva integración (de marca) con GIPHY. Cuando lo tengas, vuelve a tu panel de desarrollador y pulsa el botón para solicitar una clave de producción.

Paso 3: Configuración de la organización

Ahora que su servidor está bloqueado y cargado, ¿qué queda? Bueno, tienes una instalación sencilla de Zulip – probablemente quieras establecer moderadores y políticas de publicación. Cuando hayas iniciado sesión en Zulip, haz clic en el engranaje de configuración en la parte superior derecha y luego haz clic en Administrar organización. Debes establecer un nombre de organización, una descripción, una foto de perfil y un logotipo para que la gente sepa quién eres y de qué vas.

  • En la configuración de la organización, puedes ajustar el tiempo que un usuario puede editar o eliminar un mensaje. También puedes elegir enviar resúmenes semanales por correo electrónico a los usuarios inactivos y algunas otras cosas generales.
  • Permisos de organización es donde puedes decidir quién puede añadir a otros a tu servidor de Zulip, qué dominios permitirás, si los nuevos usuarios tienen un periodo de espera antes de ser admitidos completamente, y más. Estos ajustes pueden ayudarte a evitar el abuso de los bots o de los enjambres de trolls.
  • Dependiendo de lo estricto que quieras controlar tu espacio de trabajo, puedes establecer quién puede crear nuevos flujos. Recomiendo asegurar que sólo los administradores o moderadores puedan @all un stream.
  • También puedes restringir la adición de bots y emoji personalizados sólo a los administradores para ayudar a prevenir el abuso.
  • En la sección de flujos por defecto, puedes decidir a qué flujos se añaden automáticamente los nuevos usuarios. Esto puede ser una gran manera de canalizar a los nuevos usuarios en una corriente con voluntarios que les darán orientación personalizada sobre lo que deben hacer a continuación. Zulip puede ser abrumador al principio, como cualquier aplicación de chat, y una ayuda humana siempre es estupenda.
  • Puede añadir campos personalizados a los perfiles de los usuarios – esto puede ser útil para las propiedades específicas de su organización.
  • Si su organización almacena muchas fotos o medios de comunicación, considere la posibilidad de utilizar un backend de carga de archivos (esto conlleva costes adicionales, pero es mucho más barato que comprar un disco duro más grande para su VM)

Este es el resumen rápido de los ajustes importantes. Zulip tiene mucho más que ofrecer que puedes configurar y modificar a tu gusto, pero esto debería ser suficiente para empezar.

Buena suerte con tu nueva instalación de Zulip. No te olvides de mantenerlo actualizado parcheando de vez en cuando.

Pin It on Pinterest