https://github.com/lamgc/jenkins-agent-with-docker

带有 Docker CLI 的 Jenkins agent 镜像。
https://github.com/lamgc/jenkins-agent-with-docker

jenkins jenkins-agent jenkins-docker jenkins-docker-slave

Last synced: 3 days ago
JSON representation

带有 Docker CLI 的 Jenkins agent 镜像。

• Host: GitHub
• URL: https://github.com/lamgc/jenkins-agent-with-docker
• Owner: LamGC
• License: apache-2.0
• Created: 2023-03-18T02:23:17.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2025-01-13T00:20:13.000Z (24 days ago)
• Last Synced: 2025-01-13T01:26:17.293Z (24 days ago)
• Topics: jenkins, jenkins-agent, jenkins-docker, jenkins-docker-slave
• Language: Dockerfile
• Homepage: https://hub.docker.com/r/lamgc/jenkins-agent-docker
• Size: 58.6 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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)