1. 环境准备
确保你的系统具有互联网访问权限,并且是基于 CentOS 7/8 或 Ubuntu 18.04/20.04 等常用发行版。你需要具有 sudo
权限的账户来完成以下步骤。
一、Git 安装与配置
1.1 安装 Git
在 CentOS 系统上:
sudo yum install git -y
在 Ubuntu 系统上:
sudo apt update sudo apt install git -y
1.2 配置 Git 用户信息
git config --global user.name "Your Name" git config --global user.email "your.email@example.com"
验证配置:
git config --list
二、Jenkins 安装与配置
2.1 安装 Java(Jenkins 依赖)
在 CentOS 系统上:
sudo yum install java-11-openjdk-devel -y
在 Ubuntu 系统上:
sudo apt install openjdk-11-jdk -y
验证 Java 版本:
source /etc/profile
java -version
2.2 安装 Jenkins
在 CentOS 上:
sudo yum install epel-release -y sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key sudo yum install jenkins -y
在 Ubuntu 上:
wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo apt-key add - sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list' sudo apt update sudo apt install jenkins -y
2.3 启动 Jenkins 服务
sudo systemctl start jenkins
sudo systemctl enable jenkins
sudo systemctl status jenkins
2.4 打开 Jenkins
Jenkins 默认运行在端口 8080
,使用浏览器访问 http://your_server_ip:8080
,第一次登录时需要输入初始管理员密码。
获取初始密码:
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
2.5 安装推荐插件与创建管理员用户
根据向导完成安装推荐的插件,并创建管理员账户。
三、Ansible 安装与配置
3.1 安装 Ansible
在 CentOS 上:
sudo yum install epel-release -y sudo yum install ansible -y
在 Ubuntu 上:
sudo apt update sudo apt install software-properties-common -y sudo apt-add-repository --yes --update ppa:ansible/ansible sudo apt install ansible -y
3.2 配置 Ansible 主机文件
修改 /etc/ansible/hosts
文件,添加你需要管理的服务器:
sudo nano /etc/ansible/hosts
示例:
[web] webserver.example.com [db] dbserver.example.com
保存后可以测试连接:
ansible all -m ping
四、集成 Jenkins 与 Ansible
4.1 在 Jenkins 中安装 Ansible 插件
- 在 Jenkins 的仪表盘中,点击 "Manage Jenkins" -> "Manage Plugins"。
- 搜索
Ansible
并安装 "Ansible Plugin"。 - 重启 Jenkins。
4.2 在 Jenkins 中配置 Ansible
- 在 Jenkins 中,点击 "Manage Jenkins" -> "Global Tool Configuration"。
- 滚动到 "Ansible" 部分,点击 "Add Ansible"。
- 填写 Ansible 安装路径(例如
/usr/bin/ansible
)。
4.3 创建 Jenkins Pipeline 与 Ansible 集成
创建一个 Pipeline 作业,在 Pipeline 脚本中使用 Ansible:
pipeline {agent anystages {stage('Ansible Playbook') {steps {ansiblePlaybook credentialsId: 'your-credentials-id', inventory: 'inventory-file-path', playbook: 'playbook-file.yml'}}}
}
五、故障排除
5.1 Jenkins 启动失败
- 确认 Java 正确安装,运行
java -version
检查版本是否为11
以上。 - 确认端口
8080
没有被其他服务占用。
5.2 Git 无法连接仓库
- 检查 SSH 密钥是否正确配置。通过
ssh -T git@github.com
来测试连接。 - 检查防火墙是否允许 Git 的连接端口。
5.3 Ansible 无法连接服务器
- 检查目标主机是否配置了 SSH 免密登录,
ansible all -m ping
命令是否正常执行。 - 确认
/etc/ansible/hosts
中的主机名和 IP 地址是否正确。