Hospede o pgAdmin 4 para seu banco de dados PostgreSQL

Introdução

Para desenvolver e hospedar uma instância do pgAdmin na Square Cloud, siga a sequência de configurações e pré-requisitos abaixo. Este guia cobre todo o processo, da configuração inicial ao deploy em produção.

Pré-requisitos

Conta Square Cloud: Cadastre-se através da página de cadastro usando seu e-mail.
Plano ativo: Garante recursos dedicados e desempenho otimizado para seu aplicativo. Confira nossos planos disponíveis e escolha o mais adequado às suas necessidades.

Este guia usa o runtime Python.

Obtenha o projeto

O pgAdmin roda em Python, então o projeto precisa de um requirements.txt ou de um pyproject.toml (veja como criar um requirements.txt). Ele lista o pgadmin4 e um servidor web para servi-lo. Este guia usa o gunicorn:

requirements.txt

pgadmin4==9.18
gunicorn==26.2.0

As versões estão fixadas, como na nossa release pronta, para que uma reinstalação nunca pule para uma versão nova com mudanças incompatíveis. Para atualizar depois, troque-as aqui e envie o projeto de novo. Em seguida, crie um arquivo config_local.py. O pgAdmin o lê ao iniciar: essas configurações o rodam como servidor web e guardam os dados, o log e o banco SQLite dele em uma pasta .pgadmin dentro da sua aplicação.

config_local.py

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'

Já temos tudo pronto para deploy nas nossas releases do pgadmin4-web. Você só precisa baixar o project.zip, preencher as duas variáveis abaixo e fazer o upload.

Configure a Square Cloud

Crie um arquivo squarecloud.app na raiz do projeto:

squarecloud.app

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

O Gunicorn escuta na porta 80 em todas as interfaces (0.0.0.0), onde a Square Cloud entrega o tráfego do seu subdomínio. Mantenha um único worker (--workers=1) e adicione threads: com mais workers, o pgAdmin falha com erros de CSRF. Ao enviar pelo dashboard, defina o runtime manualmente como Python e use o mesmo comando START como comando de inicialização.

Variáveis de ambiente

Defina 2 variáveis de ambiente, PGADMIN_SETUP_EMAIL e PGADMIN_SETUP_PASSWORD. O pgAdmin as usa para criar o primeiro usuário quando inicia pela primeira vez.

.env

PGADMIN_SETUP_EMAIL=accessemail@example.com
PGADMIN_SETUP_PASSWORD=yourSecurePassword

Defina-as em Configuração avançada, no formulário de upload, na página Variáveis de ambiente da aplicação (e depois reinicie-a), ou com squarecloud app env set. O pgAdmin não lê um arquivo .env na raiz do projeto, então esses valores só funcionam como variáveis de ambiente. Veja Variáveis de ambiente.

O que vai no ZIP

requirements.txt ou pyproject.toml
config_local.py
squarecloud.app

Faça o deploy e verifique

Via dashboard

Acesse a página de upload

Acesse a página de upload e envie seu arquivo zip.

Configure seu ambiente

Após fazer o upload do seu arquivo zip, você precisará configurar o nome, o arquivo principal ou o ambiente de execução e outras configurações do seu projeto.
Se você estiver enviando um projeto web, certifique-se de selecionar “Publicação na Web” e definir um subdomínio para o seu projeto.

Faça o deploy do projeto

Por fim, clique no botão “Deploy” para hospedar seu projeto na Square Cloud. Após o deploy, você poderá monitorar o status e os registros do seu projeto no dashboard.

Confirme que seu app está no ar

Seu primeiro deploy geralmente leva menos de um minuto. No dashboard, aguarde o status da sua aplicação mudar para em execução e verifique os registros em busca de erros de inicialização.
Se você fez deploy de um site ou API, abra https://<seu-subdominio>.squareweb.app no navegador: você deve ver sua aplicação respondendo. Se você fez deploy de um bot, envie um comando para confirmar que ele está online.

Seu app não está iniciando? Veja o guia de solução de problemas para as causas e correções mais comuns.

Via CLI

Para usar esse método, seu projeto precisa de um arquivo de configuração chamado squarecloud.app na raiz. Ele informa à Square Cloud como executar a sua aplicação.

Guia do arquivo de configuração

Saiba como criar o arquivo de configuração squarecloud.app que define o ambiente da sua aplicação.

Instale a CLI

Instale a CLI da Square Cloud. Se você já a tem, execute o mesmo comando para atualizá-la:

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

npm install -g @squarecloud/cli@latest

Faça login

Execute o comando abaixo. Ele abre o seu navegador: aprove o login lá e a CLI está pronta. Não há nenhuma chave de API para copiar. Para scripts e CI, veja autenticação da CLI.

squarecloud auth login

Envie o seu projeto

Na pasta do seu projeto, execute o comando abaixo. A CLI compacta a pasta atual, deixando de fora o que o squarecloud.ignore lista, e faz o upload:

squarecloud upload

Para enviar um zip que você mesmo criou, passe-o com --file:

squarecloud upload --file <caminho/para/zip>

Confirme que seu app está no ar

Seu primeiro deploy geralmente leva menos de um minuto. Verifique o status e os registros da sua aplicação diretamente pelo terminal:

squarecloud app status
squarecloud app logs

Se você fez deploy de um site ou API, abra https://<seu-subdominio>.squareweb.app no navegador: você deve ver sua aplicação respondendo. Se você fez deploy de um bot, envie um comando para confirmar que ele está online.

Seu app não está iniciando? Veja o guia de solução de problemas para as causas e correções mais comuns.

Primeiro acesso

Abra https://my-pgadmin-subdomain.squareweb.app e entre com o e-mail e a senha que você definiu. Depois, adicione o seu servidor PostgreSQL para gerenciá-lo de qualquer lugar.

Erros comuns

Domínio personalizado

Para usar um domínio personalizado (ex.: meusite.com) no lugar da URL padrão meusite.squareweb.app, você precisa do plano Standard ou superior. A URL padrão vem do campo SUBDOMAIN no arquivo de configuração. Para conectar o seu domínio, veja como configurar seu próprio domínio.

Requisitos mínimos de RAM

Mínimo: 512MB de RAM para sites e APIs, o suficiente para um build estático no runtime estático. Para aplicações que renderizam páginas no servidor (Next.js, Nuxt, Angular SSR e similares), recomendamos pelo menos 1GB de RAM. Para aplicações maiores, aloque mais RAM para evitar que a aplicação fique sem memória e trave.

Não foi possível encontrar esse site.

Verifique se o subdomínio/domínio corresponde ao configurado no campo SUBDOMAIN ou nas configurações de domínio personalizado. Se você acabou de enviar o site, aguarde até 60 segundos para a Square liberar o primeiro acesso.

Site demorou demais para responder…

O seu servidor precisa escutar na porta 80 e no host 0.0.0.0. A Square Cloud define as variáveis de ambiente PORT (80) e HOST (0.0.0.0) na sua aplicação: leia essas variáveis no código em vez de fixar outros valores. Um servidor que escuta apenas em localhost ou 127.0.0.1 nunca recebe requisições.

Erros de CSRF depois de entrar

O pgAdmin está rodando com mais de um worker do Gunicorn. Defina --workers=1 no comando START, adicione threads com --threads se precisar de mais capacidade e reinicie a aplicação.

Próximos passos

Banco de dados gerenciado

Crie um banco de dados PostgreSQL para gerenciar com o pgAdmin.

Erros de conexão com o banco

Corrija erros de SSL/TLS e de conexão.

Gunicorn

Ajuste o servidor web que roda o pgAdmin.

Para saber mais sobre o pgAdmin, consulte a documentação oficial do pgAdmin.

Contate-nos

Se você continuar enfrentando dificuldades técnicas, nossa equipe de suporte especializada está disponível para auxiliá-lo. Entre em contato conosco e teremos prazer em ajudá-lo a resolver qualquer questão: a qualidade do suporte é uma grande parte do motivo pelo qual desenvolvedores avaliam a Square Cloud com 4,9/5 em 402 avaliações no Google e Trustpilot.

Bots

Sites

APIs e backends

Bancos de dados

Aplicações self-hosted

Guias

Guias de migração

Hospede o pgAdmin 4 para seu banco de dados PostgreSQL

Introdução

Pré-requisitos

Obtenha o projeto

Configure a Square Cloud

Variáveis de ambiente

O que vai no ZIP

Faça o deploy e verifique

Via dashboard

Via CLI

Guia do arquivo de configuração

Primeiro acesso

Erros comuns

Domínio personalizado

Requisitos mínimos de RAM

Não foi possível encontrar esse site.

Site demorou demais para responder…

Erros de CSRF depois de entrar

Próximos passos

Banco de dados gerenciado

Erros de conexão com o banco

Gunicorn

Contate-nos

​Introdução

​Pré-requisitos

​Obtenha o projeto

​Configure a Square Cloud

​Variáveis de ambiente

​O que vai no ZIP

​Faça o deploy e verifique

​Via dashboard

​Via CLI

Guia do arquivo de configuração

​Primeiro acesso

​Erros comuns

​Domínio personalizado

​Requisitos mínimos de RAM

​Não foi possível encontrar esse site.

​Site demorou demais para responder…

​Erros de CSRF depois de entrar

​Próximos passos

Banco de dados gerenciado

Erros de conexão com o banco

Gunicorn

​Contate-nos

Introdução

Pré-requisitos

Obtenha o projeto

Configure a Square Cloud

Variáveis de ambiente

O que vai no ZIP

Faça o deploy e verifique

Via dashboard

Via CLI

Primeiro acesso

Erros comuns

Domínio personalizado

Requisitos mínimos de RAM

Não foi possível encontrar esse site.

Site demorou demais para responder…

Erros de CSRF depois de entrar

Próximos passos

Contate-nos