Files
jkljkluiouio 25c1fa9bd7 chore(ansible): 停止Git追踪服务器相关配置文件,改为添加示例配置文件
添加hosts.yml和all.yml的示例配置文件
更新README.md中的部署说明
将敏感配置文件添加到.gitignore
2026-04-21 15:16:46 +08:00
..
2026-04-12 23:24:13 +08:00
2026-04-12 23:24:13 +08:00
2026-04-12 23:24:13 +08:00
2026-04-12 23:24:13 +08:00
2026-04-12 23:24:13 +08:00
2026-04-12 23:24:13 +08:00

Ansible 部署

使用 Ansible 在 Rocky Linux 8.10 服务器上自动部署 Gitea + PostgreSQL 18。

前置要求

  • 控制机安装 Ansible >= 2.12
  • 目标服务器运行 Rocky Linux 8.10(或兼容的 RHEL 8 系发行版)
  • 控制机可通过 SSH 连接目标服务器(建议配置密钥认证)
  • 安装 Ansible 依赖(collection):
    ansible-galaxy collection install -r requirements.yml
    

目录结构

ansible/
├── ansible.cfg                     Ansible 配置
├── playbook.yml                    主 Playbook
├── requirements.yml                Ansible collection 依赖
├── .yamllint.yml                   YAML lint 配置
├── inventory/
│   ├── hosts.yml                   主机清单
│   └── group_vars/
│       └── all.yml                 全局变量
└── roles/
    ├── common/                     基础系统配置
    │   └── tasks/main.yml
    ├── postgresql/                 PostgreSQL 18 安装与配置
    │   ├── tasks/main.yml
    │   ├── handlers/main.yml
    │   └── templates/
    │       └── pg_hba.conf.j2
    └── gitea/                      Gitea 安装与配置
        ├── tasks/
        │   ├── main.yml
        │   ├── install.yml         下载二进制(在线获取最新版本)
        │   └── configure.yml       生成配置、创建管理员
        ├── handlers/main.yml
        └── templates/
            ├── app.ini.j2          Gitea 配置文件模板
            └── gitea.service.j2    systemd 服务文件

配置

1. 主机清单

编辑 inventory/hosts.yml:

all:
  hosts:
    gitea-server:
      ansible_host: 192.168.1.100    # 替换为实际 IP
      ansible_user: root

2. 变量配置

编辑 inventory/group_vars/all.yml, 必须修改的项:

变量 说明 默认值
gitea_domain Gitea 访问域名或 IP gitea.example.com
gitea_admin_password 管理员初始密码 ChangeMe!2025
gitea_db_password 数据库密码 change_this_db_password

可选变量:

变量 说明 默认值
gitea_version 指定 Gitea 版本, 留空自动获取最新 ""
gitea_http_port HTTP 端口 3000
gitea_admin_user 管理员用户名 admin
gitea_admin_email 管理员邮箱 [email protected]
postgresql_version PostgreSQL 版本号 18
gitea_secret_key 安全密钥, 留空自动生成 ""
gitea_internal_token 内部令牌, 留空自动生成 ""

安全建议: 生产部署时, gitea_admin_password 和 gitea_db_password 应使用 ansible-vault 加密, 而非明文写在 all.yml 中。

使用方法

完整部署

ansible-playbook playbook.yml

按 Role 单独运行

# 仅运行基础配置
ansible-playbook playbook.yml --tags common

# 仅运行 PostgreSQL
ansible-playbook playbook.yml --tags postgresql

# 仅运行 Gitea(安装 + 配置)
ansible-playbook playbook.yml --tags gitea

更新系统软件包(默认不执行)

ansible-playbook playbook.yml --tags update-system

Role 说明

common

  • 安装基础软件包(git, wget, curl 等)
  • 创建 git 系统用户
  • 配置 firewalld 开放 Gitea 端口
  • 创建 Gitea 所需的目录结构并设置权限

postgresql

  • 添加 PostgreSQL 官方 Yum 仓库
  • 禁用系统自带的 postgresql 模块
  • 安装 PostgreSQL(版本由 postgresql_version 变量控制, 默认 18)并初始化数据库集群
  • 配置 pg_hba.conf 认证方式为 md5
  • 创建 Gitea 所需的数据库和用户

gitea

  • 安装: 在线获取最新版本号(通过 dl.gitea.com/gitea/version.json), 下载对应的 linux-amd64 二进制到 /usr/local/bin/gitea。支持通过 gitea_version 变量锁定版本
  • 配置: 通过 gitea generate secret 自动生成安全密钥, 渲染 app.ini 配置模板(禁用注册、禁用邮件、启用 Webhook), 部署 systemd 服务
  • 初始化: 等待 Gitea 启动后, 通过 gitea admin user create 创建管理员账号

app.ini 关键配置

配置项 值 说明
INSTALL_LOCK true 跳过 Web 安装向导
DISABLE_REGISTRATION true 禁止自助注册
ENABLE_NOTIFY_MAIL false 不使用邮件通知
ALLOWED_HOST_LIST * 允许 Webhook 访问任意主机
DEFAULT_REPO_UNITS repo.code,repo.issues 新仓库默认只开启代码和 Issue

部署完成后

Playbook 执行完毕后会输出:

==========================================
Gitea 答疑平台部署完成!
==========================================
访问地址: http://gitea.example.com:3000
管理员: admin
==========================================
后续步骤:
1. 登录管理员账号并修改初始密码
2. 创建 API Token (设置 -> 应用 -> 生成令牌)
3. 配置 Python CLI 工具并执行 tjhlp setup init
==========================================

测试与验证

静态检查

无需连接服务器即可执行:

# Playbook 语法检查
ansible-playbook --syntax-check playbook.yml

# YAML 格式检查(需要 pip install yamllint)
yamllint -c .yamllint.yml .

# Ansible 最佳实践检查(需要 pip install ansible-lint)
ansible-lint playbook.yml

Dry Run

模拟执行, 不做实际变更(需要能 SSH 到目标服务器):

ansible-playbook playbook.yml --check

集成测试(可选)

如果需要在本地完整测试部署流程, 推荐使用 Molecule + Vagrant:

pip install molecule molecule-vagrant pytest-testinfra
cd roles/gitea && molecule test

由于 Rocky 8 + systemd 在 Docker 中支持不完整, Vagrant(VirtualBox)是更可靠的测试环境。

部署后验证清单

部署完成后应检查:

  • Gitea Web 界面可访问(http://{domain}:{port})
  • 管理员账号可登录
  • PostgreSQL 服务运行中(systemctl status postgresql-{version})
  • Gitea 服务运行中(systemctl status gitea)
  • 防火墙已开放对应端口(firewall-cmd --list-ports)