사용자를 위한 보조 그룹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명령을 수행하기 때문에 세 가지 문제가 발생하기 때문입니다.

• 에이전트는 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 데몬 소켓 공유

앞에서 말했듯 이 두 번째 문제를 해결하는 것은 Jenkins Docker 컨테이너를 실행하여 컨테이너 외부 의 Docker 데몬과 Docker 데몬 소켓을 공유하는 것을 의미합니다 . 따라서 Jenkins에게 그 공유로 Docker 컨테이너를 실행하도록 지시해야합니다.

pipeline {
    agent {
        dockerfile {
            filename 'Dockerfile.jenkinsAgent'
            args '-v /var/run/docker.sock:/var/run/docker.sock'
        }
    }

UID 및 GID 설정

세 번째 문제에 대한 이상적인 해결책은 에이전트에 대한 보충 그룹을 설정하는 것입니다. 가능하지 않은 것 같습니다. 내가 아는 유일한 해결책은 Jenkins UID 및 Docker GID로 에이전트를 실행하는 것입니다 (소켓에는 그룹 쓰기 권한이 있으며이 소유합니다 root.docker). 그러나 일반적으로 해당 ID가 무엇인지 알지 못합니다 ( Jenkins와 Docker가 호스트에 설치되었을 때 ID가 할당 useradd ... jenkins되고 groupadd ... docker실행되었을 때). Jenkins에게 사용자 jenkins및 그룹 에게 간단하게 말할 수는 없습니다.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를 의 jenkins사용자와 stat도커 소켓에 대한 정보를 얻기 위해 명령.

귀하의 Dockerfile는 설정 A는 해당 정보를 사용할 수있는 jenkins사용자와 docker사용하여 에이전트 그룹을 groupadd, groupmod그리고 useradd:

# 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