mirror of
https://github.com/LamGC/jenkins-agent-with-docker.git
synced 2025-07-01 21:07:23 +00:00
Compare commits
80 Commits
fix-group-
...
538b70656e
Author | SHA1 | Date | |
---|---|---|---|
538b70656e | |||
599c6372d8
|
|||
0f4dd3416d | |||
0479eddfa5 | |||
20b27550dc | |||
66c1844792 | |||
ce997c2585 | |||
0934f56b34 | |||
f376b2a232 | |||
649d6788cd | |||
715a702573 | |||
90949faeda | |||
8811249453 | |||
516ea2bcd3 | |||
cb23f9e67f | |||
b597dd6ce0 | |||
1b201271da | |||
2ffa8458e5 | |||
f658ce9aeb | |||
83540d7530 | |||
c815735f22 | |||
076748d96f | |||
b6f2152cfa | |||
ccc89529e2 | |||
1dc372dd90 | |||
8f256ef1fd | |||
400ea70470 | |||
aef8988132 | |||
5b2b1d18e5 | |||
ffe1ee2908 | |||
28c3e56539 | |||
8f661a73cf | |||
3b0aad54d2 | |||
3f0e187c06 | |||
34f354fff7 | |||
9d3ddeddf3 | |||
3b4420ad29 | |||
386cabbeb5 | |||
3a49b54756 | |||
da2dd5a462 | |||
8d35755787 | |||
60b026171d | |||
9c7c9e1c48 | |||
5afb8f83ed | |||
2ce6452821 | |||
397cbd95cf | |||
b4ef66c361 | |||
16bba0236a | |||
46514b380f | |||
749e997882 | |||
b28da9704e | |||
815e8d8e6c | |||
1af1b99fa0 | |||
48f56b755b | |||
4366bb05ac | |||
8be0e285e3 | |||
261c76962f | |||
b292bb72b1 | |||
59286ff0fa | |||
5024e9c8c1 | |||
502049bd15 | |||
301eb3e9a2 | |||
46d4dcbada | |||
81044174fd | |||
ef6b491570 | |||
a680cfd095 | |||
b368357925 | |||
4b785b158d | |||
fc0e90330f | |||
6d4514fb8d | |||
2bff52dd14 | |||
e84d42263d | |||
25a9414433 | |||
aa911e9838 | |||
fd8155c1e3 | |||
f30cbeb0a9 | |||
6106658623 | |||
a3b1d5e008 | |||
a1fa05699b
|
|||
bd0799561f |
3
.github/workflows/check-updates.yml
vendored
3
.github/workflows/check-updates.yml
vendored
@ -19,6 +19,8 @@ jobs:
|
||||
uses: actions/checkout@v3
|
||||
with:
|
||||
token: ${{ secrets.CHECK_UPDATES_TOKEN }}
|
||||
- name: Install dependencies
|
||||
run: sudo apt-get install -y jq
|
||||
- name: Check updates
|
||||
run: chmod +x ./update-version.sh && ./update-version.sh
|
||||
- name: Get latest version
|
||||
@ -29,4 +31,5 @@ jobs:
|
||||
with:
|
||||
commit_message: Update LATEST_VERSION to ${{ steps.latest-version.outputs.version }}
|
||||
commit_options: '--no-verify'
|
||||
push_options: '--force'
|
||||
file_pattern: LATEST_VERSION
|
@ -4,7 +4,9 @@ FROM jenkins/inbound-agent:${BASE_TAG}
|
||||
|
||||
USER root
|
||||
|
||||
RUN groupadd -g 987 docker && usermod -aG docker jenkins
|
||||
COPY start-agent.sh /usr/local/bin/start.sh
|
||||
RUN chmod 755 /usr/local/bin/start.sh
|
||||
ENTRYPOINT [ "/bin/bash", "/usr/local/bin/start.sh" ]
|
||||
|
||||
RUN apt-get update && apt-get install -y \
|
||||
ca-certificates \
|
||||
@ -16,5 +18,4 @@ RUN apt-get update && apt-get install -y \
|
||||
apt-get update && apt-get install -y docker-ce-cli docker-buildx-plugin docker-compose-plugin && \
|
||||
apt-get clean && rm -rf /var/lib/apt/lists/*
|
||||
|
||||
USER jenkins
|
||||
|
||||
ENV DOCKER_HOST=unix:///var/run/docker.sock
|
||||
|
1
LATEST_VERSION
Normal file
1
LATEST_VERSION
Normal file
@ -0,0 +1 @@
|
||||
3283.v92c105e0f819-6
|
40
README.md
40
README.md
@ -1,2 +1,42 @@
|
||||
# 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)
|
||||
|
26
start-agent.sh
Normal file
26
start-agent.sh
Normal file
@ -0,0 +1,26 @@
|
||||
#!/bin/bash
|
||||
|
||||
if [ $(id -u) != "0" ]; then
|
||||
echo "This script must be run as root"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if [ -z "$GID" ]; then
|
||||
echo "GID is not set"
|
||||
exit 1
|
||||
fi
|
||||
if [ -z "$UID" ]; then
|
||||
echo "UID is not set"
|
||||
exit 1
|
||||
fi
|
||||
if ! grep -q docker /etc/group; then
|
||||
groupadd -g $GID docker && usermod -aG docker jenkins
|
||||
echo "Added docker group"
|
||||
fi
|
||||
if [ $(id -u jenkins) -ne $UID ]; then
|
||||
usermod -u $UID jenkins
|
||||
echo "Changed jenkins UID"
|
||||
fi
|
||||
|
||||
echo "Starting agent..."
|
||||
runuser -u jenkins -m -g docker -- /bin/bash /usr/local/bin/jenkins-agent $@
|
@ -1,4 +1,12 @@
|
||||
LATEST_VERSION=$(curl -s https://api.github.com/repos/jenkinsci/docker-inbound-agent/releases/latest | grep tag_name | cut -d '"' -f 4)
|
||||
#!/bin/bash
|
||||
|
||||
LATEST_VERSION=$(curl -s https://api.github.com/repos/jenkinsci/docker-agent/releases/latest | jq -r '.tag_name')
|
||||
CURL_EXIT_CODE=$?
|
||||
if [ $CURL_EXIT_CODE -ne 0 ] || [ -z "$LATEST_VERSION" ]; then
|
||||
echo "Failed to retrieve the latest version"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if [ "$LATEST_VERSION" != "$(cat LATEST_VERSION)" ]; then
|
||||
echo "$LATEST_VERSION" > LATEST_VERSION
|
||||
fi
|
Reference in New Issue
Block a user