単に追加dockerとして補助グループのためのjenkinsユーザー
sudo usermod -a -G docker jenkins
DockerイメージをJenkinsエージェントとして使用する場合は、必ずしも十分ではありません。つまり、次のいずれかでJenkinsfile始まるpipeline{agent{dockerfile場合pipeline{agent{image：
pipeline {
agent {
dockerfile {
filename 'Dockerfile.jenkinsAgent'
}
}
stages {
これは、Jenkinsがdocker runコマンドを実行するため、3つの問題が発生するためです。
- エージェントには（おそらく）Dockerプログラムがインストールされていません。
- エージェントはDockerデーモンソケットにアクセスできないため、Docker-in-Dockerを実行しようとしますが、これはお勧めできません。
- Jenkinsは、エージェントが使用する必要がある数値のユーザーIDと数値のグループIDを提供します。
docker runはコンテナにログインしないため、エージェントには補足グループがありません（それはに似ていますsudo）。
エージェント用のDockerのインストール
Dockerイメージ内でDockerプログラムを利用できるようにするには、DockerfileでDockerインストール手順を実行するだけです。
# Dockerfile.jenkinsAgent
FROM debian:stretch-backports
# Install Docker in the image, which adds a docker group
RUN apt-get -y update && \
apt-get -y install \
apt-transport-https \
ca-certificates \
curl \
gnupg \
lsb-release \
software-properties-common
RUN curl -fsSL https://download.docker.com/linux/debian/gpg | apt-key add -
RUN add-apt-repository \
"deb [arch=amd64] https://download.docker.com/linux/debian \
$(lsb_release -cs) \
stable"
RUN apt-get -y update && \
apt-get -y install \
docker-ce \
docker-ce-cli \
containerd.io
...
Dockerデーモンソケットの共有
以前言われていることがあるドッカーデーモンとドッカーデーモンソケットを共有するようにジェンキンスドッカー容器を実行する第二の問題の固定手段、外容器。したがって、その共有でDockerコンテナーを実行するようにJenkinsに指示する必要があります。
pipeline {
agent {
dockerfile {
filename 'Dockerfile.jenkinsAgent'
args '-v /var/run/docker.sock:/var/run/docker.sock'
}
}
UIDとGIDの設定
3番目の問題に対する理想的な修正は、エージェントの補足グループを設定することです。それは不可能のようです。私が知っている唯一の修正は、Jenkins UIDとDocker GIDを使用してエージェントを実行することです（ソケットにはグループ書き込み権限があり、が所有していますroot.docker）。しかし、一般的に、あなたはそれらのIDは、（ときに割り当てられていたが何であるかを知らないuseradd ... jenkinsとgroupadd ... docker、RANジェンキンスとドッカーがホストにインストールされたとき）。そして、Jenkinsにユーザーuser jenkinsとgroup を単に伝えることはできませんdocker
args '-v /var/run/docker.sock:/var/run/docker.sock -u jenkins:docker'
ので、それが命名されているユーザーとグループを使用するドッカーに指示jenkinsし、docker 画像内の、そしてあなたのドッカーイメージはおそらく持っていないjenkinsユーザーやグループを、そしてそれがなかった場合でも、それは同じUIDやGIDなどを持っているでしょう保証はないだろうホスト、そして同様にdockerGIDが同じである保証はありません
幸い、Jenkinsはdocker buildDockerfile のコマンドをスクリプトで実行するため、シェルスクリプトの魔法を使ってその情報をDockerビルド引数として渡すことができます。
pipeline {
agent {
dockerfile {
filename 'Dockerfile.jenkinsAgent'
additionalBuildArgs '--build-arg JENKINSUID=`id -u jenkins` --build-arg JENKINSGID=`id -g jenkins` --build-arg DOCKERGID=`stat -c %g /var/run/docker.sock`'
args '-v /var/run/docker.sock:/var/run/docker.sock -u jenkins:docker'
}
}
これは、idコマンドを使用してユーザーのUIDとGIDを取得し、コマンドを使用してDockerソケットに関する情報を取得します。jenkinsstat
Dockerfileはその情報を使用して、およびを使用して、エージェントのjenkinsユーザーとdockerグループを設定できます。groupaddgroupmoduseradd
# Dockerfile.jenkinsAgent
FROM debian:stretch-backports
ARG JENKINSUID
ARG JENKINSGID
ARG DOCKERGID
...
# Install Docker in the image, which adds a docker group
RUN apt-get -y update && \
apt-get -y install \
apt-transport-https \
ca-certificates \
curl \
gnupg \
lsb-release \
software-properties-common
RUN curl -fsSL https://download.docker.com/linux/debian/gpg | apt-key add -
RUN add-apt-repository \
"deb [arch=amd64] https://download.docker.com/linux/debian \
$(lsb_release -cs) \
stable"
RUN apt-get -y update && \
apt-get -y install \
docker-ce \
docker-ce-cli \
containerd.io
...
# Setup users and groups
RUN groupadd -g ${JENKINSGID} jenkins
RUN groupmod -g ${DOCKERGID} docker
RUN useradd -c "Jenkins user" -g ${JENKINSGID} -G ${DOCKERGID} -M -N -u ${JENKINSUID} jenkins
