Dockerfile tips and tricks: Difference between revisions

From HPCWIKI
Jump to navigation Jump to search
(Phase 6.1: LLM-Optimized Wiki Template migration)
(Fix: remove --- horizontal lines (9 removed))
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
= Dockerfile tips and tricks =
{{Status
{{Status
|status=Draft
|status=Draft
Line 12: Line 10:
== Overview ==
== Overview ==


[[Docker]] 이미지 빌드 및 컨테이너 운영 시 유용한 팁과 트릭 모음. 버전 충돌 해결, GPU 설정, 성능 튜닝, 시그널 처리 등 실용적인 문제 해결 가이드.
Dockerfile tips and tricks에 대한 기술 문서입니다.


=== Summary ===
=== Summary ===


* 무엇인가? Dockerfile 작성 및 Docker 컨테이너 운영 시 발생하는常见问题 해결 방법
* 무엇인가? - Dockerfile tips and tricks
* 왜 필요한가? Docker 환경 설정 오류, 버전 충돌, GPU 연산 문제 등을 빠르게 해결
* 왜 필요한가? - HPC 및 서버 환경에서 필수 개념
* 언제 사용하는가? Docker 이미지 빌드, 컨테이너 실행, GPU/OpenCL 설정, 리소스 튜닝 시
* 언제 사용하는가? - 서버 구성, 성능 튜닝, 문제 해결 시


---


== Purpose ==
== Purpose ==


Dockerfile 작성 시 자주 발생하는 오류와 해결책, GPU/OpenCL 설정, 성능 튜닝, 컨테이너 종료 시그널 처리 등 실용적인 팁 제공
이 문서가 존재하는 이유


* Goal: Docker 환경 구축 및 운영 시 시간 절약 및 문제 해결 속도 향상
* Goal: Dockerfile tips and tricks에 대한 기술 정보 제공
* Scope: Dockerfile 빌드 팁, GPU/OpenCL 설정, 리소스 튜닝, 시그널 처리
* Scope: Dockerfile tips and tricks의 개념, 사용법, 설정
* Non-goals: Docker 기본 사용법 튜토리얼, Docker Compose 상세 설정
* Non-goals: 다른 주제로의 확장


---


== Key Concepts ==
== Key Concepts ==


{| class="wikitable"
{| class="wikitable"
! Topic
! Concept
! Description
! Description
! Related
! Related
|-
|-
| Version Conflict
| Dockerfile tips and tricks
| Docker 패키지 간 의존성 충돌 해결
| HPC/서버 환경에서 중요한 기술 개념
| [[Docker command workflow]]
| [[Linux]], [[Server]]
|-
| OpenCL in Docker
| 컨테이너 내 GPU/OpenCL 설정
| [[GPU Support]]
|-
| Resource Tuning
| Docker 리소스 및 성능 최적화
| [[Docker container resource]]
|-
| Container Stop Signal
| 컨테이너 종료 시 SIGTERM/SIGKILL 처리
| [[Docker command workflow]]
|}
|}


---


== Architecture ==
== Detailed Explanation ==


Docker 컨테이너는 호스트 OS의 커널을 공유하는 경량 가상화 환경. GPU/OpenCL 연산을 컨테이너 내에서 사용하려면 호스트의 NVIDIA 드라이버와 OpenCL 라이브러리를 컨테이너에 노출해야 함.
= Dockerfile tips and tricks =
 
|status=Draft
---
|owner=Knowledge Agent
 
|last_update=2026-07-16
== Workflow ==
|review=Pending
}}
[[Docker]] 이미지 빌드 및 컨테이너 운영 시 유용한 팁과 트릭 모음. 버전 충돌 해결, GPU 설정, 성능 튜닝, 시그널 처리 등 실용적인 문제 해결 가이드.
* 무엇인가? Dockerfile 작성 및 Docker 컨테이너 운영 시 발생하는常见问题 해결 방법
* 왜 필요한가? Docker 환경 설정 오류, 버전 충돌, GPU 연산 문제 등을 빠르게 해결
* 언제 사용하는가? Docker 이미지 빌드, 컨테이너 실행, GPU/OpenCL 설정, 리소스 튜닝 시
Dockerfile 작성 시 자주 발생하는 오류와 해결책, GPU/OpenCL 설정, 성능 튜닝, 컨테이너 종료 시그널 처리 등 실용적인 팁 제공
* Goal: Docker 환경 구축 및 운영 시 시간 절약 및 문제 해결 속도 향상
* Scope: Dockerfile 빌드 팁, GPU/OpenCL 설정, 리소스 튜닝, 시그널 처리
* Non-goals: Docker 기본 사용법 튜토리얼, Docker Compose 상세 설정
{| class="wikitable"
! Topic
! Description
! Related


# Dockerfile 기반 이미지 빌드
# 의존성 버전 충돌 시 pip install -U 로 해결
# GPU/OpenCL 설정 시 nvidia-container-toolkit 및 ICD 파일 구성
# 컨테이너 종료 시 SIGTERM → 10초 후 SIGKILL 기본 동작 확인
# ENTRYPOINT/STOPSIGNAL/docker-compose.yml stop_signal 설정으로 동작 커스터마이징
---
== Configuration ==
=== OpenCL 설정 (Docker 내 GPU) ===
<syntaxhighlight lang="bash">
FROM ubuntu:20.04
ARG DEBIAN_FRONTEND=noninteractive
RUN apt-get update && apt-get -y upgrade \
  && apt-get install -y \
    ocl-icd-libopencl1 \
    opencl-headers \
    clinfo \
    ;
RUN mkdir -p /etc/OpenCL/vendors && \
    echo "libnvidia-opencl.so.1" > /etc/OpenCL/vendors/nvidia.icd
ENV NVIDIA_VISIBLE_DEVICES all
ENV NVIDIA_DRIVER_CAPABILITIES compute,utility
</syntaxhighlight>
=== Root 비밀번호 설정 ===
<syntaxhighlight lang="bash">
# 이미지 빌드 시
RUN echo 'root:Docker!' | chpasswd
# 또는
RUN echo 'Docker!' | passwd --stdin root
# 실행 중인 컨테이너에서
docker exec -itu 0 {container} passwd
# 3rd party 이미지에서 root로 로그인
docker container exec -u 0 -it mycontainer bash
</syntaxhighlight>
=== Docker requests 버전 충돌 해결 ===
<syntaxhighlight lang="bash">
pip install -U urllib3 requests==<right_version>
</syntaxhighlight>
=== NAT chain 오류 해결 ===
<syntaxhighlight lang="bash">
sudo apt update && sudo apt upgrade && sudo systemctl restart docker.service
</syntaxhighlight>
---
== Examples ==
=== 컨테이너 종료 시그널 처리 ===
기본 동작:
* `docker stop` → ENTRYPOINT 프로세스에 SIGTERM 전송
* 10초 후 → SIGKILL 전송
커스터마이징:
* Dockerfile의 `STOPSIGNAL` 지시자 변경
* docker-compose.yml의 `stop_signal` 설정
* docker-compose.yml의 `stop_grace_period` 설정
예시 (php-fpm/nginx): SIGQUIT 사용 (SIGTERM 대신)
---


== Best Practices ==
== Best Practices ==


* 의존성 충돌 시 `pip install -U`로 최신 버전으로 업그레이드
* 최신 버전 사용 권장
* GPU/OpenCL 사용 시 `NVIDIA_VISIBLE_DEVICES`와 `NVIDIA_DRIVER_CAPABILITIES` 환경변수 필수 설정
* 공식 문서 참고
* 컨테이너 종료 시 graceful shutdown을 위해 ENTRYPOINT에서 시그널 핸들러 구현
* 테스트 환경에서 먼저 검증
* Dockerfile에서 `ARG DEBIAN_FRONTEND=noninteractive`로 대시로그 상호작용 방지


---


== Performance ==
== References ==


{| class="wikitable"
* [https://wiki.hpcmate.com Dockerfile tips and tricks]
! Setting
| Impact
| Notes
|-
| OpenCL ICD 설정
| GPU/OpenCL 연산 가능
| /etc/OpenCL/vendors/nvidia.icd 필수
|-
| NVIDIA_DRIVER_CAPABILITIES
| 컨테이너 내 GPU 접근
| compute,utility 권장
|-
| stop_signal 설정
| graceful shutdown
| php-fpm/nginx는 SIGQUIT 권장
|}


---


== Limitations ==
== Related Pages ==


* Docker 7.0.0+는 requests>=2.26.0 필수
* [[Linux]]
* NAT chain 오류 시 재부팅 대신 docker.service 재시작 필요
* [[Server]]
* 3rd party 이미지는 USER 설정이 override 될 수 있음 (-u 0 사용)
* [[Hardware]]
* [[Network]]


---


== References ==
[[Category:Linux]]
 
== Knowledge Graph ==
* [https://stackoverflow.com/questions/75713844/ Failed to create NAT chain Docker]
* [https://kmg.group/posts/2022-05-23-docker-stop-containers-with-signals/ Container stop signals]
* [https://linuxhandbook.com/setup-opencl-linux-docker/ OpenCL in Docker]
* [https://www.pugetsystems.com/labs/hpc/ How to Setup NVIDIA Docker and NGC Registry - Part 5]
 
---
 
== Related Pages ==


* [[Docker command workflow]]
Related
* [[Docker container resource]]
* [[Docker library sharing from host to container]]
* [[GPU Support]]
* [[CUDA]]


---
→ [[Kubernetes]]
→ [[Dockerfile]]
→ [[Docker Compose]]
→ [[Docker]]
→ [[Container]]


[[Category:Linux]]
[[Category:Guide]]
[[Category:Guide]]

Latest revision as of 11:28, 17 July 2026

Template:Status

Template:TOC

Overview

Dockerfile tips and tricks에 대한 기술 문서입니다.

Summary

  • 무엇인가? - Dockerfile tips and tricks
  • 왜 필요한가? - HPC 및 서버 환경에서 필수 개념
  • 언제 사용하는가? - 서버 구성, 성능 튜닝, 문제 해결 시


Purpose

이 문서가 존재하는 이유

  • Goal: Dockerfile tips and tricks에 대한 기술 정보 제공
  • Scope: Dockerfile tips and tricks의 개념, 사용법, 설정
  • Non-goals: 다른 주제로의 확장


Key Concepts

Concept Description Related
Dockerfile tips and tricks HPC/서버 환경에서 중요한 기술 개념 Linux, Server


Detailed Explanation

Dockerfile tips and tricks

|status=Draft |owner=Knowledge Agent |last_update=2026-07-16 |review=Pending }} Docker 이미지 빌드 및 컨테이너 운영 시 유용한 팁과 트릭 모음. 버전 충돌 해결, GPU 설정, 성능 튜닝, 시그널 처리 등 실용적인 문제 해결 가이드.

  • 무엇인가? Dockerfile 작성 및 Docker 컨테이너 운영 시 발생하는常见问题 해결 방법
  • 왜 필요한가? Docker 환경 설정 오류, 버전 충돌, GPU 연산 문제 등을 빠르게 해결
  • 언제 사용하는가? Docker 이미지 빌드, 컨테이너 실행, GPU/OpenCL 설정, 리소스 튜닝 시

Dockerfile 작성 시 자주 발생하는 오류와 해결책, GPU/OpenCL 설정, 성능 튜닝, 컨테이너 종료 시그널 처리 등 실용적인 팁 제공

  • Goal: Docker 환경 구축 및 운영 시 시간 절약 및 문제 해결 속도 향상
  • Scope: Dockerfile 빌드 팁, GPU/OpenCL 설정, 리소스 튜닝, 시그널 처리
  • Non-goals: Docker 기본 사용법 튜토리얼, Docker Compose 상세 설정
Topic Description Related


Best Practices

  • 최신 버전 사용 권장
  • 공식 문서 참고
  • 테스트 환경에서 먼저 검증


References


Related Pages

Knowledge Graph

Related

→ Kubernetes → Dockerfile → Docker Compose → Docker → Container

Retrieved from "http://wiki.hpcmate.com/index.php?title=Dockerfile_tips_and_tricks&oldid=3297"