Jenkins + Docker完整部署指南(附详细步骤)

# 查看当前Java版本
java -version
​
# 查看所有已安装的Java版本
update-alternatives --display java

# 更新软件包列表
sudo apt update
​
# 安装OpenJDK 21
sudo apt install -y openjdk-21-jdk openjdk-21-jre
​
# 验证安装
java -version

# 配置默认Java版本
sudo update-alternatives --config java
​
# 会显示类似以下内容：
# Selection    Path                                         Priority   Status
# ------------------------------------------------------------
#   0            /usr/lib/jvm/java-21-openjdk-amd64/bin/java   2111      auto mode
#   1            /usr/lib/jvm/java-11-openjdk-amd64/bin/java   1111      manual mode
# * 2            /usr/lib/jvm/java-21-openjdk-amd64/bin/java   2111      manual mode
​
# 输入序号选择Java 21（通常是最新版本的序号）
# 例如输入：0 或 2
# 同样配置javac
sudo update-alternatives --config javac

# 查找Java 21安装路径
sudo update-alternatives --config java
# 记下Java 21的路径，例如：/usr/lib/jvm/java-21-openjdk-amd64
​
# 编辑环境配置文件
sudo nano /etc/environment

JAVA_HOME="/usr/lib/jvm/java-21-openjdk-amd64"

# 使配置生效
source /etc/environment
​
# 验证JAVA_HOME
echo $JAVA_HOME
java -version

# 列出所有Java相关包
dpkg -l | grep -i jdk
​
# 卸载JDK 11
sudo apt remove -y openjdk-11-jdk openjdk-11-jre
​
# 清理残留配置
sudo apt autoremove -y
sudo apt autoclean

# 检查Java版本
java -version
​
# 检查javac版本
javac -version
​
# 检查JAVA_HOME
echo $JAVA_HOME
​
# 检查PATH
which java

sudo apt remove docker docker-engine docker.io containerd runc

# 更新软件包索引
sudo apt update
​
# 安装必要的依赖包
sudo apt install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg \
    lsb-release \
    software-properties-common

# 创建密钥目录
sudo mkdir -p /etc/apt/keyrings
​
# 下载并添加Docker GPG密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
​
# 设置密钥权限
sudo chmod a+r /etc/apt/keyrings/docker.gpg

echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu jammy stable" | sudo tee /etc/apt/sources.list.d/docker.list

# 更新软件包索引
sudo apt update
​
# 安装Docker及相关组件
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# 启动Docker服务
sudo systemctl start docker
​
# 设置开机自启动
sudo systemctl enable docker
​
# 检查Docker状态
sudo systemctl status docker

# 创建docker用户组（通常已存在）
sudo groupadd docker 2>/dev/null || true
​
# 将当前用户添加到docker组
sudo usermod -aG docker $USER
​
# 刷新用户组权限（二选一）
# exit 后重新连接服务器

# 检查Docker版本
docker --version
​
# 运行测试容器
docker run hello-world

# 直接运行命令：
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://地址.mirror.aliyuncs.com",//替换成你的镜像加速的地址
    "https://docker.1panel.live",
    "https://docker.rainbond.cc"
  ]
}
EOF
​
# 重启Docker
sudo systemctl daemon-reload
sudo systemctl restart docker
​
# 验证
docker info | grep -A 10 "Registry Mirrors"
# 测试拉取镜像
docker run hello-world
# 如果成功，应该看到：
# Hello from Docker!
# This message shows that your installation appears to be working correctly.

# 检查Docker Compose版本
docker compose version

# 下载Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
​
# 添加执行权限
sudo chmod +x /usr/local/bin/docker-compose
​
# 创建软链接
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
​
# 验证安装
docker-compose --version

# 创建Jenkins项目目录（可以在你自己想放的目录下，我的在/root/mynane/main下面创建的）
mkdir -p jenkins-docker
cd jenkins-docker
​
# 创建数据持久化目录（一定要在jenkins-docker目录下运行哦）
mkdir -p jenkins_home
​
# 查看当前目录结构
pwd  # 应该显示：/root/你的用户名/jenkins-docker

# Jenkins容器内使用UID 1000运行
# 需要给jenkins_home目录正确的权限
sudo chown -R 1000:1000 jenkins_home
​
# 验证权限
ls -la jenkins_home

# 使用nano编辑器创建配置文件
vim docker-compose.yml

version: '3.8'
​
services:
  jenkins:
    image: jenkins/jenkins:lts-jdk21
    container_name: jenkins
    restart: unless-stopped
    privileged: true
    user: root
    ports:
      - "8080:8080"      # Jenkins Web界面
      - "50000:50000"    # Jenkins代理通信端口
    volumes:
      # 持久化Jenkins数据
      - ./jenkins_home:/var/jenkins_home
      # 允许Jenkins使用主机的Docker
      - /var/run/docker.sock:/var/run/docker.sock
      # 挂载Docker二进制文件（可选，用于在Jenkins中执行docker命令）
      - /usr/bin/docker:/usr/bin/docker
    environment:
      - JAVA_OPTS=-Duser.timezone=Asia/Shanghai -Dhudson.model.DirectoryBrowserSupport.CSP=
      - JENKINS_OPTS=--prefix=/jenkins
    networks:
      - jenkins-network
​
networks:
  jenkins-network:
    driver: bridge
重要说明：

# 启动容器（后台运行）
docker compose up -d
​
# 查看容器状态
docker compose ps
​
# 查看容器日志
docker compose logs -f jenkins

#解决方法：是网络原因，修改一下镜像就行
sudo tee /etc/docker/daemon.json <<'EOF'
{
  "registry-mirrors": [
    "https://x1doswo1.mirror.aliyuncs.com",
    "https://docker.1panel.live",
    "https://docker.rainbond.cc",
    "https://docker.m.daocloud.io",
    "https://docker.mirrors.ustc.edu.cn",
    "https://docker.nju.edu.cn",
    "https://mirror.baidubce.com"
  ]
}
EOF

解决方法：sed -i '/^version:/d' docker-compose.yml

# 实时查看启动日志
docker compose logs -f jenkins
​
# 看到以下信息说明启动成功：
# Jenkins is fully up and running

# 方式1：从日志中查看
docker compose logs jenkins | grep -A 5 "initialAdminPassword"
​
# 方式2：从容器内查看
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
​
# 方式3：从持久化目录查看
cat jenkins_home/secrets/initialAdminPassword

# 检查防火墙状态
sudo ufw status
​
# 如果防火墙未启用，先启用
sudo ufw enable
​
# 允许SSH（防止被锁在外面！）
sudo ufw allow 22/tcp
​
# 允许Jenkins Web端口
sudo ufw allow 8080/tcp
​
# 允许Jenkins代理端口（如果需要）
sudo ufw allow 50000/tcp
​
# 重新加载防火墙
sudo ufw reload
​
# 查看规则
sudo ufw status numbered