Dockerfile 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

Pokerogue 게임을 Container 이미지로 빌드하기 위한 방법

Sun, 19 Oct 2025 09:00:00 +0900

Pokerogue 이미지 빌드

Pokerogue 게임을 컨테이너 이미지로 빌드하기 위한 방법

개요

Pokerogue 게임을 K8S 환경에서 동작하게 하기 위해서 약간의 소스코드 수정과 Dockerfile 작성이 필요
- 공식 GitHub에는 로컬 기준으로 코드가 작성된 부분이 많음
Pokerogue는 Vite 기반 React 프론트엔드와 Go 기반 백엔드 그리고 Mariadb로 구성

Frontend

공식 GitHub: https://github.com/pagefaultgames/pokerogue
TypeScript로 작성
Vite 번들러를 사용하는 React SPA
Pokerogue의 UI, 정적파일, 로직 및 랜더링 제공
/api/*로 백엔드 API 호출
OAuth 외부 로그인 UI 제공

Frontend 이미지 빌드

Dockerfile

 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


ARG NODE_VERSION=22.14
ARG OS=alpine

# Build stage
FROM node:${NODE_VERSION}-${OS} AS build

RUN apk add --no-cache git rsync
WORKDIR /app

RUN corepack enable && corepack prepare pnpm@10.14.0 --activate

COPY . .

# Initialize git submodules
RUN git submodule update --init --recursive

# Install dependencies with cache
RUN --mount=type=cache,target=/root/.pnpm-store \
 pnpm install --frozen-lockfile

# Production build
RUN pnpm run build

# Production stage
FROM nginx:alpine

COPY nginx.conf /etc/nginx/conf.d/default.conf

# Copy built files from build stage
COPY --from=build /app/dist /usr/share/nginx/html

EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

공식 GitHub에는 beta 브랜치에만 Dockerfile이 존재
- development mode로 실행되게 작성되어 있어서 Dockerfile은 새로 전부 작성

Build Stage와 Production Stage 분리
- Build Stage
  - Node.js 정적 파일 빌드
  - Git submodule 초기화
  - pnpm dependencies 설치
  - pnpm 빌드로 /app/dist 생성
- Production Stage
  - Nginx Alpine 이미지
  - 빌드된 정적 파일만 복사
  - Node.js 런타임 포함하지 않음
Git Submodule 처리
- Pokerogue는 assets와 locales를 Git submodule로 관리
- 최종 이미지에는 빌드된 dist 포함되므로 빌드에 사용된 .git은 제외됨

Nginx 사용

SPA 라우팅
- https://pokerogue.com/ 이외에 /game, /home 등 제공하지 않는 경로로 접근 시 index.html을 제공하도록 설정
gzip 압축
- JavaScript, CSS 파일들을 gzip으로 압축하여 전송
보안 헤더 적용
정적 파일 캐싱
- 이미지, 폰트, JS, CSS 등을 1년간 브라우저 캐시

 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


server {
 listen 80;
 server_name localhost;
 root /usr/share/nginx/html;
 index index.html;

 # SPA routing - all routes go to index.html
 location / {
 try_files $uri $uri/ /index.html;
 }

 gzip on;
 gzip_vary on;
 gzip_min_length 1024;
 gzip_types text/plain text/css text/xml text/javascript application/x-javascript application/xml+rss application/json application/javascript;

 add_header X-Frame-Options "SAMEORIGIN" always;
 add_header X-Content-Type-Options "nosniff" always;
 add_header X-XSS-Protection "1; mode=block" always;

 location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
 expires 1y;
 add_header Cache-Control "public, immutable";
 }
}

.env 파일 관리

환경변수들을 빌드 시점에 포함시켜야함

.dockeringnore 파일에 명시되어 있던 .env 주석처리

1
2
3
4
5
6
7


# .dockerignore
node_modules
*.log
*.md
.gitignore
Dockerfile
#.env 

Vite의 .env 우선순위
- Vite는 다음 순서로 .env 파일 로드
  - 나중에 로드된 파일이 이전 파일의 변수값을 덮어씀
  1. .env - 모든 환경에서 로드
  2. .env.[mode] - 특정 모드 (예: .env.production)
- 따라서 pnpm run build 실행 시 production 모드로 실행되므로 최종적으로 .env.production에 있는 환경변수를 참조하게 됨

.env | .env.production

VITE_SERVER_URL: 실제 게임을 서비스할 도메인으로 변경
VITE_DISCORD_CLIENT_ID: Discord OAuth 로그인을 위한 본인 값 입력
VITE_GOOGLE_CLIENT_ID: Google OAuth 로그인을 위한 본인 값 입력

1
2
3
4
5
6


VITE_BYPASS_LOGIN=0
VITE_BYPASS_TUTORIAL=0
VITE_SERVER_URL=https://pokerogue.<도메인>:<포트>/api
VITE_DISCORD_CLIENT_ID=<discord client id>
VITE_GOOGLE_CLIENT_ID=<google client id>
VITE_I18N_DEBUG=0

이미지 빌드

1
2


docker build -t ksi05298/pokerogue-web:latest .
docker push ksi05298/pokerogue-web:latest

Backend

공식 GitHub: https://github.com/pagefaultgames/rogueserver
Go로 작성
사용자 인증, 게임 데이터 저장, 조회, 세션 관리 등을 수행하는 RESTFUL API 서버
- /account/*, /gamedata/*, /auth/* 엔드포인트 제공
MariaDB와 연동

Backend 이미지 빌드

Dockerfile

Dockerfile은 공식 GitHub에 있는 파일 그대로 사용
- scratch 이미지를 사용해서 정적 바이너리만 포함

 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


# SPDX-FileCopyrightText: 2024-2025 Pagefault Games
#
# SPDX-License-Identifier: AGPL-3.0-or-later
ARG GO_VERSION=1.22

FROM docker.io/library/golang:${GO_VERSION} AS builder

WORKDIR /src

COPY ./go.mod /src/
COPY ./go.sum /src/

RUN go mod download && go mod verify

COPY . /src/

RUN CGO_ENABLED=0 \
 go build -tags=devsetup -o rogueserver

RUN chmod +x /src/rogueserver

# ---------------------------------------------

FROM scratch

WORKDIR /app

COPY --from=builder /src/rogueserver .
COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/

EXPOSE 8001

ENTRYPOINT ["./rogueserver"]

OAuth 쿠키 설정 수정

공식 rogueserver 코드에서 구글/디스코드 로그인에 필요한 OAuth 쿠키 설정에 문제 있어 수정 필요

api/endpoints.go 파일의 658줄 handleProviderCallback 함수 내부

수정 전

1
2
3
4
5
6
7
8
9


 http.SetCookie(w, &http.Cookie{
 Name: "pokerogue_sessionId",
 Value: sessionToken,
 Path: "/",
 Secure: true,
 SameSite: http.SameSiteStrictMode,
 Domain: "pokerogue.net",
 Expires: time.Now().Add(time.Hour * 24 * 30 * 3), // 3 months
 })

수정 후

1
2
3
4
5
6
7
8
9


 http.SetCookie(w, &http.Cookie{
 Name: "pokerogue_sessionId",
 Value: sessionToken,
 Path: "/",
 Secure: true,
 SameSite: http.SameSiteLaxMode,
 Domain: "",
 Expires: time.Now().Add(time.Hour * 24 * 30 * 3), // 3 months
 })

변경 사항
- SameSite: SameSiteStrictMode → SameSiteLaxMode
  - OAuth callback은 cross-site 요청이 될 수 밖에 없음 (google.com → 내 도메인)
  - Strict로 설정하면 cross-site 쿠키 전송이 차단돼서 CSRF오류가 발생됨
  - Lax로 변경하여 안전한 도메인에서의 GET 요청(oauth callback)에서 쿠키 전송 허용
- Domain: “pokerogue.net” → “”
  - pokerogue 공식 도메인에서 빈 문자열로 변경해서 현재 도메인이 자동 적용되도록 설정

이미지 빌드 및 푸시

1
2


docker build -t ksi05298/rogueserver:latest .
docker push ksi05298/rogueserver:latest

참고

Vite 환경변수 가이드:

https://vitejs.dev/guide/env-and-mode.html

OAuth SameSite Cookie 설정:

https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie/SameSite

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