---
url: /sre/jenkins/hello-jenkins.md
---
# 你好Jenkins，以\[docker in docker]的方式见面

> 基于docker-compose快速构建Jenkins容器，且Jenkins容器与宿主机docker环境连通，实现「docker in docker」。

## 项目特点

* 使用docker部署Jenkins，与宿主机操作系统隔离，保证系统的隔离性和整洁性
* 轻松支持多版本，不同操作系统环境迁移性强（可移植性强）
* Jenkins容器内置docker，称为「docker in docker」，不必在Jenkins内部再安装npm maven go mysql等环境依赖

## 前置要求

1. 默认基础环境：amd64 Linux，推荐使用Ubuntu22.04
2. 安装docker和docker-compose

## 快速开始

克隆项目

```bash
git clone https://github.com/xiaolinstar/docker-jenkins.git 
```

进入项目

```bash
cd docker-jenkins
```

检查挂载卷 ，本项目中`docker-compose.yaml`中的挂载卷值默认为：

```yaml
volumes:
  - '/usr/bin/docker:/usr/bin/docker'
  - '/var/run/docker.sock:/var/run/docker.sock'
  - './jenkins_home:/var/jenkins_home'
```

👀在Windows或macOS中下载Docker Desktop可能存在参数不一致，请自行检查并酌情修改

```yaml
# Macbook Pro M1pro 
# Docker Desktop
volumes:
  - '/usr/local/bin/docker:/usr/bin/docker'
  - '~/.docker/run/docker.sock:/var/run/docker.sock'
  - './jenkins_home:/var/jenkins_home'
```

启动容器

```bash
# 创建jenkins_home并在后台启动docker容器
mkdir jenkins_home && docker compose up -d 
```

检查容器状态

启动的Jenkins容器名默认为`xiaolin-jenkins`

```bash
docker ps
```

进入`xiaolin-jenkins`容器内部，查看`docker`命令

```bash
# 宿主机执行
docker exec -it xiaolin-jenkins /bin/sh
# 检查Jenkins容器内docker环境
docker info
```

查看到相应的输出则正常启动成功。

❗️xiaolin-jenkins容器内的docker环境与宿主机是相通的，共享同一个docker环境。因此在xiaolin-jenkins容器内创建的容器，在宿主机上也能查看到。

## Jenkins快速体验

Web体验，通过浏览器进入宿主机8080端口

* 云服务： ${IP}:8080
* 本地： http://localhost:8080

获取登录密钥，查看日志信息，获取一串密钥，用于Web端登录

```bash
docker logs xiaolin-jenkins
```

Jenkins以插件的方式支持功能扩展，目前已经有1000+插件，除了安装社区推荐的插件外，建议安装以下插件：

* Blue Ocean: BlueOcean Aggregator
* Docker Commons: Provides the common shared functionality for various Docker-related plugins
* Docker Compose Build Step: Docker Compose plugin for Jenkins

## References

1. Jenkins用户手册，https://www.jenkins.io/zh/doc/

2. Blue Ocean UI，https://www.jenkins.io/zh/doc/book/blueocean/

3. Docker，https://www.docker.com/

## 联系作者

如果您有需要技术咨询，或者有想法使本文档变得更好。

联系作者：xing.xiaolin@foxmail.com