mirror of
https://github.com/LamGC/jenkins-agent-with-docker.git
synced 2025-04-29 14:17:31 +00:00
初步添加一个 Readme。
This commit is contained in:
parent
bd0799561f
commit
a1fa05699b
40
README.md
40
README.md
@ -1,2 +1,42 @@
|
|||||||
# jenkins-agent-with-docker
|
# jenkins-agent-with-docker
|
||||||
|
|
||||||
带有 Docker CLI 的 Jenkins agent 镜像。
|
带有 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)
|
||||||
|
Loading…
Reference in New Issue
Block a user