Docker Compose on Joonlog

Jenkins Agent를 Docker로 동작시키기 위한 방법

Mon, 27 Oct 2025 09:00:00 +0900

Jenkins Agent가 도커로 사용되도록 설정 Jenkins Server-Agent 분리

Built-In-Node excutor 설정
- Jenkins Agent를 도커에서 동적으로 실행할거라 built-in-node의 Number of executors값을 0으로 설정
Agent Node 추가
- Manage Jenkins - Nodes - System Configuration - New Node
- Node 설정
  - Number of excutors: Jenkins Agent가 최대로 실행 가능한 파이프라인 수
  - Remote root directory: Jenkins Agent 컨테이너 내부의 루트 디렉토리
Agent 설치 스크립트 확인
- 이후에 컨테이너 기동에 필요한 secret 값이 포함되어 있으니 확인 필수

Dockerfile

파이프라인용 에이전트이므로 최소로 컨테이너 기동

1
2
3
4
5
6


FROM jenkins/inbound-agent:latest-jdk21
USER root
RUN apt-get update \
 && apt-get install -y docker.io ca-certificates openssh-client \
 && rm -rf /var/lib/apt/lists/*
USER jenkins

docker-compose.yaml

변수들은 .env 파일을 통해 별도로 설정
- JENKINS_URL: 도커 네트워크 인터페이스 docker0의 ip인 172.17.0.1를 기입
- JENKINS_SECRET: 위 콘솔에 나온 secret 값을 기입
- JENKINS_AGENT_NAME: 위에서 설정한 이름
- JENKINS_AGENT_WORKDIR: 위에서 설정한 Jenkins Agent가 컨테이너 내부에서 사용할 경로
- AGENT_WORKDIR: Jenkins Agent 컨테이너가 호스트에서 사용하는 실제 경로

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22


version: "3.8"

services:
 agent:
 build:
 context: .
 dockerfile: Dockerfile
 container_name: jenkins-agent-docker
 restart: unless-stopped
 init: true
 environment:
 JENKINS_URL: "${JENKINS_URL}"
 JENKINS_SECRET: "${JENKINS_SECRET}"
 JENKINS_AGENT_NAME: "${JENKINS_AGENT_NAME}"
 JENKINS_AGENT_WORKDIR: "${JENKINS_AGENT_WORKDIR:-/home/jenkins/agent}"
 DOCKER_BUILDKIT: "1"
 JENKINS_WEB_SOCKET: "true"
 volumes:
 - /var/run/docker.sock:/var/run/docker.sock
 - ${AGENT_WORKDIR:-/var/lib/jenkins_agent}:${JENKINS_AGENT_WORKDIR:-/home/jenkins/agent}
 group_add:
 - "${DOCKER_GID}"

컨테이너 권한 설정
- 호스트의 도커 소켓을 사용하는 DooD 방식이기 때문에 컨테이너에서도 호스트의 도커 GID 동기화 필요
  - /var/lib/jenkins_agent: 호스트에 컨테이너 데이터가 저장될 경로.
    - 컨테이너 내부에서도 기록해야하니 기본 사용자인 1000으로 설정
1 2

echo "DOCKER_GID=$(stat -c %g /var/run/docker.sock)" >> .env mkdir -p /var/lib/jenkins_agent && chown 1000:1000 /var/lib/jenkins_agent
Jenkins Agent 빌드
1

docker compose up -d --build
Node 연결 확인
파이프라인 테스트
- hello world 테스트 성공!

참고

Jenkins Agent 노드 추가: https://github.com/jenkinsci/docker-agent/blob/master/README_inbound-agent.md

Teleport 18 이미지 빌드 및 배포

Thu, 09 Oct 2025 09:00:00 +0900

Teleport 18 이미지 빌드

도커 이미지 빌드

Dockerfile
- 빌드한 바이너리 파일의 teleport/tctl/tsh/tbot을 복사해서 이미지 빌드

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


FROM ubuntu:20.04

RUN apt-get update && apt-get install -y \
 ca-certificates dumb-init libfido2-1 && \
 apt-get clean && rm -rf /var/lib/apt/lists/*

COPY build/teleport /usr/local/bin/teleport
COPY build/tctl /usr/local/bin/tctl
COPY build/tsh /usr/local/bin/tsh
COPY build/tbot /usr/local/bin/tbot

ENTRYPOINT ["/usr/bin/dumb-init", "teleport", "start", "-c", "/etc/teleport/teleport.yaml"]

이미지 빌드 및 도커허브 푸시

1
2
3
4


docker build -t teleport18-custom .
docker login -u <username>
docker tag teleport18-custom <username>/teleport18:v1.0.0
docker push <username>/teleport18:v1.0.0

Teleport 18 배포

Auth+Proxy 분리 구축

디렉토리 구조

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# tree
.
├── auth
│ ├── config
│ │ └── teleport.yaml
│ └── data
├── docker-compose.yaml
└── proxy
 ├── config
 │ └── teleport.yaml
 └── data

1. docker-compose.yaml

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50


version: '3.8'

services:
 auth:
 image: <username>/teleport18:v1.0.0
 container_name: teleport-auth
 hostname: teleport-auth
 restart: unless-stopped
 volumes:
 - ./auth/config:/etc/teleport
 - ./auth/data:/var/lib/teleport
 entrypoint: ["/usr/local/bin/teleport"]
 command: ["start", "--config=/etc/teleport/teleport.yaml"]
 expose:
 - "3025"
 networks:
 - teleport-net

 proxy:
 image: <username>/teleport18:v1.0.0
 container_name: teleport-proxy
 hostname: teleport-proxy
 restart: unless-stopped
 ports:
 - "3080:3080" # Web UI & public HTTPS
 - "3023:3023" # Proxy SSH
 - "3024:3024" # Reverse tunnel
 - "3026:3026" # Kube reverse tunnel
 volumes:
 - ./proxy/config:/etc/teleport
 - ./proxy/data:/var/lib/teleport
 - /etc/letsencrypt:/etc/letsencrypt:ro
 environment:
 - TELEPORT_CDN_BASE_URL=https://cdn.cloud.gravitational.io
 entrypoint: ["/usr/local/bin/teleport"]
 command: [
 "start",
 "--config=/etc/teleport/teleport.yaml",
 "--roles=proxy",
 "--token=teleportclustertoken",
 "--auth-server=teleport-auth:3025"
 ]
 networks:
 - teleport-net
 depends_on:
 - auth

networks:
 teleport-net:
 driver: bridge

2. auth/teleport.yaml

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


teleport:
 nodename: teleport-auth
 data_dir: /var/lib/teleport
 log:
 output: stderr
 severity: INFO

auth_service:
 enabled: yes
 cluster_name: cluster
 listen_addr: 0.0.0.0:3025
 tokens:
 - "proxy:teleportclustertoken"

proxy_service:
 enabled: no

ssh_service:
 enabled: no

3. proxy/teleport.yaml

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25


teleport:
 nodename: teleport-proxy
 data_dir: /var/lib/teleport
 log:
 output: stderr
 severity: INFO

 auth_servers:
 - teleport-auth:3025

auth_service:
 enabled: no

proxy_service:
 enabled: yes
 web_listen_addr: 0.0.0.0:3080
 tunnel_listen_addr: 0.0.0.0:3024
 kube_listen_addr: 0.0.0.0:3026
 public_addr: <도메인>:3080
 https_keypairs:
 - cert_file: /etc/letsencrypt/live/<도메인>/fullchain.pem
 key_file: /etc/letsencrypt/live/<도메인>/privkey.pem

ssh_service:
 enabled: no