SHA256
forked from course-team/tjhlp-gitea
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)