配置 Redis、PostgreSQL 及账户凭证#

本文档介绍如何配置 GitLab 实例所需的凭证。

#前提条件

• 本文档适用于平台提供的 GitLab 17 及以上版本，基于 Operator 等技术与平台解耦。

#Redis 凭证

#要求

GitLab 对 Redis 部署模式和版本有以下要求：

• 部署模式支持 Standalone 和 Sentinel 模式，但不支持 Redis Cluster 模式
• 需要 Redis 版本 6.2 及以上

#凭证格式

在计划部署 GitLab 实例的命名空间中创建一个 Secret，选择 Opaque 类型，并在配置中添加并填写以下字段：

Standalone 示例

apiVersion: v1
data:
  host: <base64 encode host>
  password: <base64 encode password>
  port: <base64 encode port>
kind: Secret
metadata:
  name: gitlab-redis
  namespace: <ns-of-gitlab-instance>
type: Opaque

Sentinel 示例

apiVersion: v1
data:
  password: <base64 encode password>
  address: <base64 encode address>
  masterName: <base64 encode masterName>
  sentinelPassword: <base64 encode sentinelPassword>
kind: Secret
metadata:
  name: gitlab-redis
  namespace: <ns-of-gitlab-instance>
type: Opaque

#更新凭证

如果在部署 GitLab 实例后需要修改 Redis 连接信息，应直接更新 GitLab 实例资源，而非修改凭证内容。具体操作请参考配置 Redis 访问凭证。

#使用 Alauda Cache Service for Redis OSS

Redis 服务可通过 Alauda Cache Service for Redis OSS 提供，请注意以下重要要求：

• 选择 Redis 版本 7.2 及以上
• 架构类型选择 sentinel 模式
• 参数模板选择 RDB 持久化模板，如 system-rdb-redis-7.2-sentinel
• 开启数据持久化，存储配额不少于 2G
• 多网卡场景下，Redis sentinel 会选择节点默认 IP 初始化各 Redis 节点的访问地址，因此不支持使用非默认 IP + 暴露端口访问节点。此时建议使用 LoadBalancer 访问方式创建 Redis 实例。详情请参考 Alauda Cache Service for Redis OSS 功能说明文档。

创建 Redis 实例时，会自动生成包含连接信息的 Secret，可直接用于部署 GitLab。该 Secret 资源可通过标签 middleware.instance/type: Redis 进行筛选。

kubectl get secret -n <ns-of-redis-instance> -l middleware.instance/type=Redis

使用 Alauda Cache Service for Redis OSS

Redis 服务可由 Alauda Cache Service for Redis OSS 提供。在某些特殊场景下，需要注意以下限制：

• 多网卡场景下，Redis sentinel 会选择节点默认 IP 初始化各 Redis 节点的访问地址，因此不支持使用节点非默认 IP + 暴露端口访问。此时建议使用 LoadBalancer 访问方式创建 Redis 实例。详情请参考 Alauda Cache Service for Redis OSS 功能说明文档。

#PostgreSQL 凭证

#要求

GitLab 对 PostgreSQL 版本有以下要求：

• GitLab 17.z 需要 PostgreSQL 14.z 版本
• GitLab 18.z 需要 PostgreSQL 16.z 版本

#凭证格式

在计划部署 GitLab 实例的命名空间中创建一个 Secret，选择 Opaque 类型，并在配置中添加并填写以下字段：

YAML 示例：

apiVersion: v1
data:
  database: <base64 encode database name>
  host: <base64 encode host>
  password: <base64 encode password>
  port: <base64 encode port>
  username: <base64 encode username>
  sslmode: <base64 encode sslmode>
kind: Secret
metadata:
  name: gitlab-pg
  namespace: <ns-of-gitlab-instance>
type: Opaque

如何在 PG 实例上创建数据库

使用 psql cli 连接 PG 实例，执行以下命令创建数据库：

create database <database name>;

为 gitaly 集群创建独立数据库

高可用模式下，gitaly 组件需配置为集群模式，且需要独立数据库存储 gitaly 元数据。需创建另一个 Secret 存储数据库连接信息，字段与上述一致。

#sslmode

sslmode 是控制 GitLab 服务与 PostgreSQL 数据库连接安全性的参数。可选项：

• enable：启用 SSL 连接
• disable：禁用 SSL 连接

使用 Alauda support for PostgreSQL 时，sslmode 应设置为 enable。
使用外部 PostgreSQL 时，sslmode 取决于您的 PostgreSQL 配置。

#更新凭证

如果在部署 GitLab 实例后需要修改 PostgreSQL 连接信息，应直接更新 GitLab 实例资源，而非修改凭证内容。具体操作请参考配置 PostgreSQL 凭证。

#使用数据服务提供的 PostgreSQL

Data Services 支持部署可用于 GitLab 部署的 PostgreSQL 实例。创建 PostgreSQL 实例时，请注意以下重要要求：

1. 选择与 GitLab 版本匹配的 PostgreSQL 版本，例如部署 GitLab 17.z 时需选择 PostgreSQL 14.z
2. 存储配额不少于 5Gi

创建 PostgreSQL 实例时，会自动生成包含连接信息的 Secret。该 Secret 资源可通过标签 middleware.instance/type: PostgreSQL 进行筛选。

kubectl get secret -n <ns-of-postgresql-instance> -l middleware.instance/type=PostgreSQL | grep -E '^postgres'

#GitLab 账户凭证

在计划部署 GitLab 实例的命名空间中创建一个 Secret，选择 Opaque 类型，并在配置中添加并填写以下字段：

apiVersion: v1
data:
  password: <base64 encode password>
kind: Secret
metadata:
  name: gitlab-root-password
  namespace: <ns-of-gitlab-instance>
type: Opaque