使用 PostgreSQL - GitLab - GitLab 文档中心

Tier: 基础版，专业版，旗舰版

Offering: JihuLab.com，私有化部署

许多应用依赖 PostgreSQL 作为其数据库，因此您必须使用它来运行测试。

配合 Docker Executor 使用 PostgreSQL#

要将极狐GitLab UI 中设置的变量传递给 service 容器，您必须定义变量。您必须将变量定义为群组或项目级别，然后在作业中调用这些变量，如下方变通方法所示。

Postgres 15.4 及更高版本在扩展脚本中包含引号（"）、反斜杠（\）或美元符号（ $）时，不会将模式或所有者名称代入。如果 CI 变量未配置，其值将使用环境变量名称的字符串形式。例如，`POSTGRES_USER:$ USER会导致POSTGRES_USER` 变量被设置为 '$USER'，从而使 Postgres 显示以下错误：

shell
Fatal: invalid character in extension

变通方法是在极狐GitLab CI/CD 变量中设置变量，或以字符串形式设置变量：

在极狐GitLab 中设置 Postgres 变量。在极狐GitLab UI 中设置的变量不会传递到 service 容器。
在 .gitlab-ci.yml 文件中，指定一个 Postgres 镜像：
```
yaml
default:
   services:
     - postgres
```

在 .gitlab-ci.yml 文件中，添加您定义的变量：

yaml
variables:
  POSTGRES_DB: $POSTGRES_DB
  POSTGRES_USER: $POSTGRES_USER
  POSTGRES_PASSWORD: $POSTGRES_PASSWORD
  POSTGRES_HOST_AUTH_METHOD: trust

关于将 postgres 用作 Host 的更多信息，请参阅服务如何链接到作业。

配置您的应用以使用数据库，例如：

yaml
Host: postgres
User: $POSTGRES_USER
Password: $POSTGRES_PASSWORD
Database: $POSTGRES_DB

或者，您可以在 .gitlab-ci.yml 文件中以字符串形式设置变量：

yaml
variables:
  POSTGRES_DB: DB_name
  POSTGRES_USER: username
  POSTGRES_PASSWORD: password
  POSTGRES_HOST_AUTH_METHOD: trust

您可以使用 Docker Hub 上提供的任何其他 Docker 镜像。例如，要使用 PostgreSQL 16.10，service 将变为 postgres:16.10。

postgres 镜像可以接受某些环境变量。更多详情，请参阅 Docker Hub 上的文档。

配合 Shell Executor 使用 PostgreSQL#

您还可以在使用 Shell executor 的极狐GitLab Runner 的手动配置服务器上使用 PostgreSQL。

首先安装 PostgreSQL 服务器：

shell
sudo apt-get install -y postgresql postgresql-client libpq-dev

下一步是创建用户，因此登录到 PostgreSQL：

shell
sudo -u postgres psql -d template1

然后创建一个用户（本例中为 runner），供您的应用使用。在以下命令中将 $password 更改为一个强密码。

确保在以下命令中不要输入 template1=#，因为那是 PostgreSQL 提示符的一部分。

shell
template1=# CREATE USER runner WITH PASSWORD '$password' CREATEDB;

创建的用户具有创建数据库的权限（CREATEDB）。以下步骤描述如何为该用户显式创建一个数据库。权限允许您的测试框架根据需要创建和删除数据库。

为 runner 用户创建数据库并授予其所有权限：

shell
template1=# CREATE DATABASE nice_marmot OWNER runner;

如果一切顺利，现在可以退出数据库会话：

shell
template1=# \q

现在，尝试使用 runner 用户连接到新创建的数据库，以检查一切是否就绪。

shell
psql -U runner -h localhost -d nice_marmot -W

此命令显式指示 psql 连接到 localhost 以使用 md5 认证。如果省略此步骤，您将被拒绝访问。

最后，配置您的应用以使用数据库，例如：

yaml
Host: localhost
User: runner
Password: $password
Database: nice_marmot

示例项目#

我们为您准备了一个示例 PostgreSQL 项目，它运行在 JihuLab.com 上，并使用我们公开可用的实例 runner。

想要修改它？Fork 它，提交，然后推送您的更改。几分钟后，更改会被公共 runner 检出，作业随即开始。