# 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`)