Inicio de VPSie

Volver a la base de conocimientos

Configurar una página de estado confiable es crucial para mantener informados a los usuarios sobre la salud y disponibilidad de sus servicios. Cachet es un sistema de página de estado de código abierto que facilita el monitoreo y la comunicación de estados del sistema. En esta guía, le guiaremos paso a paso en el proceso de instalación del sistema de página de estado Cachet en Debian 12, asegurando una forma profesional y efectiva de gestionar la disponibilidad y los incidentes de sus servicios.

Para comenzar, asegúrese de haber creado una cuenta de VPSie si aún no lo ha hecho. A continuación, proceda a desplegar un servidor Debian 12 configurado según sus necesidades específicas.

Cree su cuenta ahora

Una vez desplegado el servidor, inicie sesión en la interfaz de línea de comandos mediante SSH. Antes de instalar paquetes, es esencial actualizar la lista de paquetes del sistema para garantizar el acceso a las versiones más recientes. Abra una terminal y ejecute el siguiente comando:

sudo apt-get update -y

Instalación de Docker Engine

Primero, actualice el índice de paquetes e instale los paquetes necesarios, curl y ca-certificates, ejecutando el siguiente comando:

sudo apt-get install -y ca-certificates curl gnupg

Agregue la clave GPG oficial de Docker creando un directorio para la clave GPG de Docker y agregándola:

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

A continuación, configure el repositorio de Docker ejecutando el siguiente comando:

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Después de configurar el repositorio, actualice el índice de paquetes e instale Docker Engine junto con otros componentes necesarios:

sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Ejecute el siguiente comando para iniciar sesión como usuario root (si no lo está ya):

su -
 Finalmente, verifique que Docker esté instalado correctamente ejecutando el siguiente comando:
sudo docker run hello-world

Esto ejecutará un contenedor de prueba y confirmará la instalación exitosa de Docker en su sistema Debian 12.

Cachet

Ejecutar Cachet

Ahora descargue el proyecto Cachet y navegue al directorio cachet-docker,

Cree el directorio cachet-docker:

mkdir cachet-docker

Cambie al directorio cachet-docker:

cd cachet-docker

Puede clonar el repositorio de Cachet en GitHub usando git. Asegúrese de tener git instalado.

git clone https://github.com/CachetHQ/Docker.git .

Esto clonará el proyecto Cachet en el directorio cachet-docker.

Ahora, abra el archivo docker-compose.yml usando el editor nano con el siguiente comando:

nano docker-compose.yml

Cambie el puerto de host predeterminado a 8000 actualizando la sección ports de la siguiente manera:

ports:
- 8000:8000

También puede personalizar los detalles de la base de datos según sus requisitos. Por ahora, mantenga la versión de Cachet en 3.

Después de realizar sus cambios, guarde el archivo y salga del editor.

Finalmente, construya su imagen de Cachet e inicie los contenedores para Cachet y PostgreSQL usando estos comandos de Docker:

docker compose build
docker compose up
Cachet

En los registros detallados del contenedor de Cachet, es posible que vea un error relacionado con la configuración APP_KEY. Copie la APP_KEY generada y luego presione Ctrl+C para detener los contenedores.

A continuación, vuelva a abrir el archivo docker-compose.yml con el editor nano:

nano docker-compose.yml

Actualice el parámetro APP_KEY para incluir la cadena base64, de la siguiente manera:

APP_KEY=base64:uJg5pnABoi0slHeeCZ8ehQ0BxF35oBQfNiPSopqrQQw=

Guarde el archivo y salga del editor.

Luego, use los siguientes comandos de Docker para detener los contenedores de Cachet y PostgreSQL e iniciarlos nuevamente:

docker compose down
docker compose up -d

Una vez que los contenedores estén en ejecución, compruebe su estado con:

docker compose ps

Debería ver listados los contenedores Cachet y PostgreSQL, con Cachet ejecutándose en el puerto 8000.

Cachet

Configurar Nginx como proxy inverso

Para configurar Nginx como proxy inverso para Cachet, que se ejecuta en un contenedor en el puerto 8000, siga estos pasos:

Si aún no ha instalado Nginx, puede hacerlo con los siguientes comandos:

sudo apt install nginx

Cree un nuevo archivo de configuración de Nginx para Cachet:

sudo nano /etc/nginx/sites-available/cachet

Agregue la siguiente configuración al archivo:

				
					server {
    listen 80;
    server_name your_domain_or_IP;

    location / {
        proxy_pass http://localhost:8000; # Forward requests to the Cachet container
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # Optional: Handle SSL/TLS termination (if you plan to use HTTPS)
    # Uncomment the lines below if you have SSL certificates

    # listen 443 ssl;
    # ssl_certificate /etc/ssl/certs/your_certificate.crt;
    # ssl_certificate_key /etc/ssl/private/your_private_key.key;

    # location / {
    #     proxy_pass http://localhost:8000;
    #     proxy_set_header Host $host;
    #     proxy_set_header X-Real-IP $remote_addr;
    #     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    #     proxy_set_header X-Forwarded-Proto $scheme;
    # }
}
				
			

Reemplace your_domain_or_IP con su nombre de dominio o dirección IP. Si está usando HTTPS, deberá configurar los certificados SSL como se indica en la sección opcional.

Ahora, habilite la configuración de Nginx vinculando el archivo de configuración a sites-enabled:

sudo ln -s /etc/nginx/sites-available/cachet /etc/nginx/sites-enabled/

Antes de reiniciar Nginx, asegúrese de que no haya errores de sintaxis en su configuración:

sudo nginx -t

Aplique la nueva configuración reiniciando Nginx:

sudo systemctl restart nginx

Instalar Cachet

Abra su navegador web y vaya a http://{domain/IP} para acceder a su instalación de Cachet. Si todo está configurado correctamente, debería ver la página de configuración.

Elija la opción Database como predeterminada para Cache Driver, Queue Driver y Session Driver. Después, proporcione los detalles necesarios para la configuración de su servidor de correo y haga clic en Next para continuar.

Ahora configure el nombre de la página de estado, la zona horaria predeterminada y el idioma predeterminado. Luego, vuelva a hacer clic en Siguiente.

Cachet

Para crear un nuevo usuario administrador para Cachet, introduzca su nombre de usuario, correo electrónico y contraseña. A continuación, haga clic en Completar configuración para finalizar el proceso.

Cachet

Inicie sesión en Cachet con su nombre de usuario y contraseña, y luego haga clic en el botón Iniciar sesión.



Para concluir, la instalación del sistema de página de estado Cachet en Debian 12 es un proceso sencillo. Siguiendo los pasos descritos, puede configurar fácilmente una página de estado para supervisar y comunicar el estado de sus servicios. Con Cachet, dispondrá de una forma profesional de mantener informados a sus usuarios sobre cualquier problema o actualización de los servicios.

Volver a la base de conocimientos