SHA256
207 lines
6.2 KiB
Markdown
207 lines
6.2 KiB
Markdown
# Ansible 部署
|
|
|
|
使用 Ansible 在 Rocky Linux 8.10 服务器上自动部署 Gitea + PostgreSQL 18。
|
|
|
|
## 前置要求
|
|
|
|
- 控制机安装 Ansible >= 2.12
|
|
- 目标服务器运行 Rocky Linux 8.10(或兼容的 RHEL 8 系发行版)
|
|
- 控制机可通过 SSH 连接目标服务器(建议配置密钥认证)
|
|
- 安装 Ansible 依赖(collection):
|
|
```bash
|
|
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`:
|
|
|
|
```yaml
|
|
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` | 管理员邮箱 | `admin@tongji.edu.cn` |
|
|
| `postgresql_version` | PostgreSQL 版本号 | `18` |
|
|
| `gitea_secret_key` | 安全密钥, 留空自动生成 | `""` |
|
|
| `gitea_internal_token` | 内部令牌, 留空自动生成 | `""` |
|
|
|
|
**安全建议**: 生产部署时, `gitea_admin_password` 和 `gitea_db_password` 应使用 `ansible-vault` 加密, 而非明文写在 `all.yml` 中。
|
|
|
|
## 使用方法
|
|
|
|
### 完整部署
|
|
|
|
```bash
|
|
ansible-playbook playbook.yml
|
|
```
|
|
|
|
### 按 Role 单独运行
|
|
|
|
```bash
|
|
# 仅运行基础配置
|
|
ansible-playbook playbook.yml --tags common
|
|
|
|
# 仅运行 PostgreSQL
|
|
ansible-playbook playbook.yml --tags postgresql
|
|
|
|
# 仅运行 Gitea(安装 + 配置)
|
|
ansible-playbook playbook.yml --tags gitea
|
|
```
|
|
|
|
### 更新系统软件包(默认不执行)
|
|
|
|
```bash
|
|
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
|
|
==========================================
|
|
```
|
|
|
|
## 测试与验证
|
|
|
|
### 静态检查
|
|
|
|
无需连接服务器即可执行:
|
|
|
|
```bash
|
|
# 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 到目标服务器):
|
|
|
|
```bash
|
|
ansible-playbook playbook.yml --check
|
|
```
|
|
|
|
### 集成测试(可选)
|
|
|
|
如果需要在本地完整测试部署流程, 推荐使用 [Molecule](https://ansible.readthedocs.io/projects/molecule/) + Vagrant:
|
|
|
|
```bash
|
|
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`)
|