Aloja pgAdmin 4 para tu base de datos PostgreSQL

​

Introducción

• Este artículo te guía a través de la creación y el alojamiento de una aplicación de pgAdmin en Square Cloud.
• Antes de comenzar, asegúrate de tener una cuenta en Square Cloud, que puedes crear en la página de registro con tu correo electrónico.
• Por último, necesitas tener un plan activo en tu cuenta. Compara los planes disponibles y elige uno según tus necesidades.

​

Creando el proyecto

• pgAdmin se ejecuta en Python, así que el proyecto necesita un requirements.txt o un pyproject.toml. Consulta cómo crear un requirements.txt.
• Tu requirements.txt debe tener pgadmin4 y un servidor web para servirlo. En este tutorial, usaremos gunicorn.

pgadmin4
gunicorn

• A continuación, necesitarás un archivo de configuración config_local.py para definir algunas rutas. Estas rutas definirán dónde guardar cierta información sobre tu pgAdmin.

SERVER_MODE = True
MAX_LOGIN_ATTEMPTS = 3
"""
    CRITICAL 50
    ERROR    40
    WARNING  30
    SQL      25
    INFO     20
    DEBUG    10
    NOTSET    0
"""
CONSOLE_LOG_LEVEL = 10
DATA_DIR = "/application/.pgadmin/"
LOG_FILE = "/application/.pgadmin/logfile"
SQLITE_PATH = '/application/.pgadmin/pgadmin4.db'

​

Archivos en tu ZIP

• requirements.txt o pyproject.toml
• config_local.py
• squarecloud.app (el archivo de configuración de abajo)

​

Archivo de configuración

• Al subir desde el dashboard, define manualmente el runtime como Python y usa el comando START de abajo como comando de inicio. En un archivo de configuración squarecloud.app, se ve así:

DISPLAY_NAME=App name
RUNTIME=python
MEMORY=1024
START=python -m gunicorn --bind 0.0.0.0:80 --workers=1 --threads=4 pgadmin4.pgAdmin4:app
VERSION=recommended
SUBDOMAIN=my-pgadmin-subdomain

• Gunicorn escucha en el puerto 80 en todas las interfaces (0.0.0.0), donde Square Cloud entrega el tráfico de tu subdominio. Mantén un solo worker (--workers=1) y añade threads: con más workers, pgAdmin falla con errores de CSRF.
• A continuación, define 2 variables de entorno, PGADMIN_SETUP_EMAIL y PGADMIN_SETUP_PASSWORD. pgAdmin las usa para crear el primer usuario cuando se inicia por primera vez.

PGADMIN_SETUP_EMAIL=accessemail@example.com
PGADMIN_SETUP_PASSWORD=yourSecurePassword

• Defínelas en la Configuración avanzada del formulario de subida, en la página Variables de entorno de la aplicación (y luego reiníciala) o con squarecloud app env set. pgAdmin no lee un archivo .env en la raíz de tu proyecto, así que un archivo como el de arriba solo funciona como .squarecloud/.env, el archivo que Square Cloud carga cuando se inicia la aplicación (nuestra release lista para usar lo usa). Consulta Variables de entorno.

​

Subiendo el proyecto a Square Cloud

​

A través del panel

1

Accede a la página de subida

Accede a la página de subida y sube el archivo zip de tu proyecto.

2

Configura tu entorno

Después de subir tu zip, deberás configurar el nombre, el archivo principal o el entorno de ejecución y otros ajustes de tu proyecto.
Si estás subiendo un proyecto web, asegúrate de seleccionar “Publicación Web” y de definir un subdominio para tu proyecto.

3

Despliega tu proyecto

Por último, haz clic en el botón “Deploy” para alojar tu proyecto en Square Cloud.
Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.

4

Confirma que tu aplicación esté en vivo

Tu primer despliegue suele tardar menos de un minuto. En el dashboard, espera a que el estado de tu aplicación muestre “running” y revisa los logs por si hay errores de inicio.
Si desplegaste un sitio web o una API, abre https://<tu-subdominio>.squareweb.app en tu navegador: deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online.

¿La aplicación no inicia? Consulta la guía de solución de problemas para ver las causas y soluciones más comunes.

​

A través de la CLI

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

Consideraciones finales

​

Próximos pasos

​

Contáctanos