Docker 部署 Jenkins

约 1120 字大约 4 分钟

2024-08-24

写在前面

介绍如何在 Docker 中部署 Jenkins，包括拉取镜像、运行容器、配置 Nginx 反向代理、初始化、安装插件、配置管理员信息以及安全设置。

安装 Jenkins 镜像

拉取镜像

docker pull jenkins/jenkins:lts

目前 docker 被墙，使用 docker pull 拉取 certbot 镜像会失败，可以使用自行查找第三方镜像仓库。

我这里使用的是阿里云的镜像加速服务：

当前仅支持阿里云用户使用具备公网访问能力的阿里云产品进行镜像加速，且仅限于特定范围内的容器镜像。详情请见公告。

运行 Jenkins 容器

docker run -it -d \
   --name jenkins \
   -p 18080:8080 \
   -p 50000:50000 \
   -v your_host_jenkins_home_dir:/var/jenkins_home \
   -e JENKINS_URL=your_domain \
   -e JAVA_OPTS=-Dhudson.security.csrf.GlobalCrumbIssuerConfiguration.DISABLE_CSRF_PROTECTION=true \
   jenkins/jenkins:lts

上述配置中，

--name，自定义容器名称；

-p，宿主机与容器直接端口映射，Jenkins 容器默认端口就是 8080，不需要修改。50000 端口用于 Jenkins 代理通信，不需要修改；

-v，将宿主机目录挂载到 Jenkins 容器的配置目录下，这样可以便于后续迁移，如果容器删除或者在其他服务器部署，保存宿主机的目录下的文件即可恢复；

-e，分别是 Jenkins URL 配置和跨域配置，URL 即域名访问，与后续 Nginx 配置一起使用，非必要。跨域配置是为了解决高版本 Jenkins 配置过程 403 等异常问题，禁止跨域保护可能存在安全风险，如果没问题，可以不加，非必要。

Nginx 配置

使用 nginx 时，必须要配置反向代理，配置方式如下：

    server {
        listen   80;
        server_name  your_domain;
        location = / {
            proxy_pass http://localhost:18080;
        }
        
        location ~ .* {
            proxy_pass http://localhost:18080;
            proxy_redirect     default;
            proxy_set_header   Host               $host:$server_port;
            proxy_set_header   X-Real-IP          $remote_addr;
            proxy_set_header 	 X-Forwarded-Host   $host:$server_port;
            proxy_set_header   X-Forwarded-Server $host;
            proxy_set_header   X-Forwarded-For    $proxy_add_x_forwarded_for;
            proxy_set_header   X-Forwarded-Proto  $scheme;
        }
    }