mirror of
https://github.com/LamGC/jenkins-agent-with-docker.git
synced 2025-04-29 14:17:31 +00:00
43 lines
1.5 KiB
Markdown
43 lines
1.5 KiB
Markdown
# jenkins-agent-with-docker
|
||
|
||
带有 Docker CLI 的 Jenkins agent 镜像。
|
||
|
||
> **Note**：仅适用于 Docker，不适用于 Podman。
|
||
|
||
## 安全警告
|
||
|
||
将宿主机的 Docker 访问接口提供给 Jenkins 容器（包括 Agent）是一件很危险的事情，一旦 Jenkins 执行了恶意流水线，
|
||
那么流水线将能完全控制 Docker Engine，甚至能够访问宿主机的所有文件。因此，使用此镜像时必须非常小心。
|
||
|
||
## Usage
|
||
|
||
使用此镜像必须将宿主机的 `/var/run/docker.sock` 映射到容器内同等目录，否则 Docker CLI 无法正常工作。
|
||
|
||
### 创建用户和用户组
|
||
|
||
如果 Docker 不是用软件包管理器安装的，那就要先创建一个 `docker` 用户组，然后将 `jenkins` 用户加入到该用户组内：
|
||
|
||
```bash
|
||
sudo groupadd docker
|
||
```
|
||
|
||
然后创建一个 `jenkins` 用户，并将其加入到 Docker 用户组内：
|
||
|
||
```bash
|
||
sudo useradd -m -g docker jenkins
|
||
```
|
||
|
||
### 部署 Jenkins Agent 容器
|
||
|
||
在原先的部署命令上，添加 `/var/run/docker.sock` 的映射和宿主机 `jenkins` 用户、`docker` 用户组的 ID 到容器中：
|
||
|
||
```bash
|
||
docker run -d --name agent \
|
||
-v /var/run/docker.sock:/var/run/docker.sock \
|
||
-e GID=$(grep docker /etc/group | cut -d: -f3) \
|
||
-e UID=$(id -u jenkins) \
|
||
lamgc/jenkins-agent-docker -url {JENKINS_URL} -workDir=/home/jenkins/agent {Secret} {Agent_Name}
|
||
```
|
||
|
||
具体配置请参考原版镜像说明：[jenkins/inbound-agent - Readme](https://github.com/jenkinsci/docker-inbound-agent/#readme)
|