为你的 PostgreSQL 数据库托管 pgAdmin 4

​

简介

• 本文将引导你在 Square Cloud 上创建并托管一个 pgAdmin 应用。
• 在开始之前，请确保你已拥有 Square Cloud 账户，你可以在注册页面使用邮箱创建账户。
• 最后，你的账户需要有一个有效计划。请比较可用计划，并根据需要选择一个。

​

创建项目

• pgAdmin 运行在 Python 上，因此项目需要一个 requirements.txt 或 pyproject.toml。 请参阅如何创建 requirements.txt。
• 你的 requirements.txt 必须包含 pgadmin4 以及一个用于提供服务的 web 服务器。在本教程中，我们将使用 gunicorn。

pgadmin4
gunicorn

• 接下来，你需要一个配置文件 config_local.py 来设置一些路径。这些路径将定义在何处保存关于 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'

​

ZIP 中的文件

• requirements.txt 或 pyproject.toml
• config_local.py
• squarecloud.app（下面的配置文件）

​

配置文件

• 通过控制面板上传时，请手动将运行时设置为 Python，并使用下面的 START 命令作为启动命令。在 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

• Gunicorn 在所有网络接口（0.0.0.0）的 80 端口上监听，Square Cloud 会将你子域名的流量转发到这里。请保持单个 worker（--workers=1），改为增加线程：使用多个 worker 时，pgAdmin 会出现 CSRF 错误。
• 接下来，设置 2 个环境变量：PGADMIN_SETUP_EMAIL 和 PGADMIN_SETUP_PASSWORD。pgAdmin 首次启动时会用它们创建第一个用户。

PGADMIN_SETUP_EMAIL=accessemail@example.com
PGADMIN_SETUP_PASSWORD=yourSecurePassword

• 你可以在上传表单的 Advanced configuration 中、在应用的 Environment Variables 页面中（之后重启应用），或使用 squarecloud app env set 设置它们。pgAdmin 不会读取项目根目录的 .env 文件，因此像上面这样的文件只有作为 .squarecloud/.env 才有效，这是 Square Cloud 在应用启动时加载的文件（我们现成的 release 就使用它）。请参阅环境变量。

​

将项目上传到 Square Cloud

​

通过控制面板

1

访问上传页面

访问上传页面并上传你的项目 zip 文件。

2

配置你的环境

上传 zip 后，你需要为项目配置名称、主文件或运行时环境以及其他设置。
如果你上传的是 Web 项目，请务必选择 “Web Publication” 并为项目设置子域名。

3

部署你的项目

最后，点击 “Deploy” 按钮，即可将项目托管到 Square Cloud。
部署完成后，你可以在控制面板中监控项目的状态和日志。

4

确认你的应用已上线

首次部署通常在一分钟内完成。在控制面板中，等待你的应用状态显示为运行中，并检查日志中是否有启动错误。
如果你部署的是网站或 API，请在浏览器中打开 https://<your-subdomain>.squareweb.app，你应该能看到应用正常响应。如果你部署的是机器人，发送一条命令确认它已上线。

应用无法启动？请参见故障排除指南，了解最常见的原因和解决方法。

​

通过 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

​

结语

​

后续步骤

​

联系我们