Héberger pgAdmin 4 pour votre base PostgreSQL

​

Introduction

• Cet article vous guide dans la création et l’hébergement d’une application pgAdmin sur Square Cloud.
• Avant de commencer, assurez-vous d’avoir un compte sur Square Cloud, que vous pouvez créer avec votre e-mail sur la page d’inscription.
• Enfin, vous devez avoir un plan actif sur votre compte. Comparez les plans disponibles et choisissez-en un selon vos besoins.

​

Création du projet

• pgAdmin s’exécute sur Python : le projet a donc besoin d’un requirements.txt ou d’un pyproject.toml. Consultez comment créer un requirements.txt.
• Votre requirements.txt doit contenir pgadmin4 ainsi qu’un serveur web pour le servir. Dans ce tutoriel, nous utiliserons gunicorn.

pgadmin4
gunicorn

• Ensuite, vous aurez besoin d’un fichier de configuration config_local.py pour définir certains chemins. Ces chemins détermineront où enregistrer certaines informations sur votre 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'

​

Fichiers de votre ZIP

• requirements.txt ou pyproject.toml
• config_local.py
• squarecloud.app (le fichier de configuration ci-dessous)

​

Fichier de configuration

• Lors d’un envoi depuis le tableau de bord, définissez manuellement le runtime sur Python et utilisez la commande START ci-dessous comme commande de démarrage. Dans un fichier de configuration squarecloud.app, cela ressemble à ceci :

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 écoute sur le port 80 sur toutes les interfaces (0.0.0.0), là où Square Cloud achemine le trafic de votre sous-domaine. Gardez un seul worker (--workers=1) et ajoutez plutôt des threads : avec plus de workers, pgAdmin échoue avec des erreurs CSRF.
• Définissez ensuite 2 variables d’environnement, PGADMIN_SETUP_EMAIL et PGADMIN_SETUP_PASSWORD. pgAdmin les utilise pour créer le premier utilisateur lors de son premier démarrage.

PGADMIN_SETUP_EMAIL=accessemail@example.com
PGADMIN_SETUP_PASSWORD=yourSecurePassword

• Définissez-les dans la Configuration avancée du formulaire d’envoi, sur la page Variables d’environnement de l’application (puis redémarrez-la), ou avec squarecloud app env set. pgAdmin ne lit pas de fichier .env à la racine de votre projet : un fichier comme celui ci-dessus ne fonctionne donc que sous la forme .squarecloud/.env, le fichier que Square Cloud charge au démarrage de l’application (notre release prête à l’emploi l’utilise). Consultez Variables d’environnement.

​

Upload du projet sur Square Cloud

​

Via le tableau de bord

1

Accéder à la page d'upload

Accédez à la page d’upload et téléversez le fichier zip de votre projet.

2

Configurer votre environnement

Après avoir téléversé votre zip, vous devrez configurer le nom, le fichier principal ou l’environnement d’exécution ainsi que d’autres paramètres de votre projet.
Si vous téléversez un projet web, veillez à sélectionner « Publication Web » et à définir un sous-domaine pour votre projet.

3

Déployer votre projet

Enfin, cliquez sur le bouton « Deploy » pour héberger votre projet sur Square Cloud.
Une fois le déploiement effectué, vous pouvez suivre l’état et les logs de votre projet depuis le tableau de bord.

4

Confirmez que votre application est en ligne

Votre premier déploiement prend généralement moins d’une minute. Dans le tableau de bord, attendez que le statut de votre application affiche « en cours d’exécution » et vérifiez les logs pour détecter d’éventuelles erreurs de démarrage.
Si vous avez déployé un site web ou une API, ouvrez https://<votre-sous-domaine>.squareweb.app dans votre navigateur, vous devriez voir votre application répondre. Si vous avez déployé un bot, envoyez-lui une commande pour confirmer qu’il est en ligne.

Votre application ne démarre pas ? Consultez le guide de dépannage pour les causes les plus courantes et leurs solutions.

​

Via 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

​

Considérations finales

​

Prochaines étapes

​

Contactez-nous