🎯 CI/CD와 자동화 파이프라인을 배우고 파이프라인 자동화 도구인 Docker에 대해 정리합니다.

📗 Today I Learned

CI/CD와 자동화 파이프라인

소프트웨어 개발은 단순히 코드를 작성하는 것에서 끝나지 않습니다. 코드를 얼마나 빠르고 안전하게 사용자에게 전달할 수 있는지가 경쟁력이 됩니다.
출처: 링크드인

---

전통적 배포 방식

전통적인 소프트웨어 개발 프로세스는 보통 개발 → QA → 운영의 흐름으로 진행됩니다.

• 개발 : 분석 , 계획, 구현, 유닛 테스트, 데모

  • 로컬에서 기능 구현 후, ZIP으로 묶거나 FTP로 수동으로 서버에 업로드합니다.

• QA : 통합 테스트, 사용자 수용 테스트, 비기능적 분석

  • 테스트 서버에서 수동으로 테스트를 진행합니다.

• 운영 : 공개, 모니터링

  • 운영 서버에 올려 직접 배포를 진행합니다.

🤔 FTP (File Transfer Protocol)란?

원격 서버에 파일을 업로드하거나, 원격 서버에서 파일을 다운로드할 수 있는 프로토콜입니다.

FTP가 지금 쓰이지 않는 이유는 아래와 같습니다.

• 전송 내용 노출 : 암호화 없이 정보를 주고받는 구조로 보안 위험성이 있습니다.
• 수작업 중심의 비효율 : 사람이 직접 파일을 선택해서 업로드 해야 합니다.
• 버전 관리와 협업에 부적합 : 단순한 파일 전송만 가능하고, 변경 이력 관리나 팀 간 협업 기능이 전혀 없습니다.

🚨 전통적 배포 방식의 한계

• 느린 배포 주기 : 개발 요구사항이 정의된 때로부터 제품 전달이 완료되기까지 긴 시간이 소요됩니다.

• 느린 피드백 루프 : 개발팀의 효율성을 떨어뜨립니다.

• 자동화 미비 : 릴리스 회수가 적으므로 자동화 필요 감소 → 릴리스 기간 예측 어려워집니다.

• 핫픽스 위험성 : 긴급한 코드 변경에 대하여 충분한 테스트가 이루어질 수 없는 위험이 있습니다.

• 비효율적 개발 문화 : 팀 스트레스, 의사소통 부족, 책임의 분산, 낮은 업무 만족도 등이 있습니다.

💡 해결책 : 지속적 통합과 배포(CI/CD)

• CI/CD를 통해 개발부터 배포까지의 과정을 자동화해서, 빠르고 안전하게 소프트웨어를 배포할 수 있게 해주는 방식을 통해 으로 다음과 같은 이점을 갖습니다.

  • 빠른 제품 배포 : 빠르게 제품을 사용자에게 배포할 수 있습니다.

  • 짧은 피드백 주기 : 사용자나 QA의 피드백을 빠르게 반영할 수 있습니다.

  • 위험도가 낮은 릴리스 : 반복적인 배포와 롤백이 가능해 안정적인 운영이 가능합니다.

  • 유연한 릴리스 정책 결정 가능 : 특정 기능만 배포하거나 점진적으로 적용하는 전략도 사용할 수 있습니다.

🤔 CI/CD란?

CI는 지속적 통합(Continuous Integration)으로 개발자들이 작업한 코드를 공용 저장소(Git 등)에 자주 통합하는 방식입니다.

CD는 지속적 배포 또는 지속적 전달(Continuous Deployment / Continuous Delivery)의 줄임말로 변경 사항이 승인되면 운영 서버에까지 자동으로 배포하는 방식입니다.

---

자동 배포 파이프라인

출처: servicenow

코드 변경 → 지속적 통합 → 자동화 테스트 → 빌드 → 구성 관리 → 배포

• 각 단계를 유지하면서 동시에 자동화하는 것이 필요하고, 또한 지속적인 모니터링도 필수입니다.

🔁 자동 배포 파이프라인이란?

코드를 작성한 뒤, 배포(서버에 올리는 것)까지 모든 과정을 자동으로 처리하는 흐름입니다.

---

지속적 통합 (CI; Continuous Integration)

지속적 통합은 개발자가 작성한 코드가 올바르게 동작하고 있는지 자동으로 확인하는 과정입니다.

• 코드 체크아웃 : 리포지토리에서 최신 코드를 받아옵니다.

• 빌드 및 테스트 : 컴파일, 링크를 수행한 후 단위 테스트를 실행합니다.

• 테스트 커버리지 리포트 생성 : 소스코드의 어느 부분까지 검사하고 있는지를 확인합니다.

• 정적 분석 수행 : 코딩 규칙 위반, 코드 스타일 등을 자동 점검합니다.

• 개발자에게 피드백 제공 : 문제가 발생하면 바로 알림을 받습니다.

---

자동 인수 테스트

인수 테스트(UAT; User Acceptance Test)는 고객이 원하는 기능이 맞는지 확인하는 단계입니다.

• 전통적으로 QA 팀이 맡던 역할을 자동화합니다.

• 통합 테스트, 비기능적 테스트(성능/보안 등)도 포함됩니다.

• CD 파이프라인에 통합되어, 개발자가 구현을 마치자마자 바로 검증이 가능해집니다.

• 릴리스 결정을 자동으로 수행할 수 있게 됩니다.

---

구성 관리

구성 관리 (Configuration Management)는 단순히 코드를 배포하는 것을 넘어, 운영 환경을 자동으로 준비하고 구성하는 과정까지 포함합니다.

• 필요한 패키지 설치, 환경 변수 설정 등 시스템을 구성합니다.

• 여러 서비스 인스턴스와 배포 버전을 관리합니다.

• 구성 파일을 Git 등으로 관리하고 변경 이력을 추적합니다.

이러한 전통 방식에서 운영팀이 맡던 방식을 자동화해서 개발 환경과 운영 환경의 차이로 인한 오류를 최소화합니다.

---

CD를 위한 기술적 전제 조건

지속적 배포(Continuous Deployment)를 하기 위해서는 몇 가지 기술적인 조건이 필요합니다.

• 자동화 : 빌드, 테스트, 패키징, 배포까지 전부 자동으로 진행돼야 합니다.

• 속도 : 커밋 발생할 때마다 파이프라인이 실행되어야 하므로 실행 속도가 빨라야 합니다.

• 장애 복구 : 문제가 생기면 즉시 롤백할 수 있어야 잦은 배포도 안전하게 수행됩니다.

• 무중단 배포 : 사용자 입장에서 배포 중에도 서비스가 중단되지 않아야 합니다.

• 트렁크 기반 개발 : 메인 브랜치 중심으로 개발하여 통합 주기를 짧게 유지해야 합니다.

🤔 트렁크(trunk)는 무슨 뜻일까?

나무의 중앙 줄기를 뜻한 말로 중앙(main) 브랜치, 즉 모든 코드가 모이는 ‘기본 줄기’를 뜻합니다.

그러므로 트렁크 기반 개발이란 개발자들이 짧은 시간 안에 자주 트렁크에 병합하는 방식을 말합니다.

---

파이프라인 자동화 도구들

• 컨테이너 가상화 및 클러스터 운용

  • Docker + Kubernetes

• CI 서버

  • Jenkins

• 구성 관리 자동화

  • Ansible

• 소프트웨어 버전 관리 (SCM; Software Code Management)

  • Github

• 그 외

  • 빌드 도구, 단위 테스트 프레임워크, 정적 코드 분석기, 인수 테스트 프레임워크

---

컨테이너 가상화

컨테이너

컨테이너는 응용 프로그램뿐만 아니라 그 프로그램이 제대로 실행되기 위해 필요한 모든 것을 하나의 단위로 묶어서 실행.할 수 있는 기술입니다.

• 개발부터 배포까지 일관성 유지 : 어디서 실행하든 동일한 결과를 기대할 수 있습니다.

• 가상 머신의 대체 혹은 보완 : 무거운 하이퍼바이저 기반 가상머신(VM) 방식 대신, 컨테이너는 더 가볍고 빠르게 실행할 수 있는 대안이 됩니다.

• 높은 이식성 : 운영체제나 하드웨어에 덜 의존적이게 되어 시스템의 이식이 용이해진 덕분에 클라우드, 로컬, 테스트 서버 어디서든 실행 가능합니다.

🤔 가상 머신과 컨테이너는 구조적으로 어떻게 다를까?

출처: netadmin

1번: 전통적인 가상 머신 구조 (VM 기반)

인프라 → Host OS → Hypervisor → Guest OS → 앱 실행

애플리케이션은 각각 자기만의 운영체제(Guest OS) 위에서 돌아가는 방식입니다. 각 앱마다 OS를 따로 올려야 하므로 무겁고, 느립니다.

하이퍼바이저(hypervisor)는 가상 머신(VM)을 만들어주는 프로그램으로 한 컴퓨터 안에서 가짜 컴퓨터(가상 머신)를 여러 개 돌릴 수 있게 해줍니다.

가상 머신(VM)은

---

2번: 컨테이너 기반 구조 (Docker 기반)

인프라 → OS → Docker Engine → 앱 실행

모든 앱이 하나의 OS를 공유하면서 실행되며 Docker Engine이 각각의 앱을 독립된 환경처럼 분리해줍니다.

---

3번: 컨테이너 + 가상 머신 혼합 구조 (클라우드 환경에서 많이 사용됨)

인프라 → Host OS → Hypervisor → Guest OS → Docker Engine → 앱 실행

VM 위에서 Docker 컨테이너를 실행하는 구조로 클라우드에서는 이 구조가 일반적입니다. (ex. AWS EC2 위에서 Docker 돌리는 방식)

💡 클라우드 제공자(AWS, GCP 등)의 물리 서버를 여러 고객이 동시에 공유하기 때문에 각 고객에게 분리된 환경(=가상 머신)을 제공해야 보안과 자원 관리가 가능합니다.

---

가상화 (Virtualization)

가상화(Virtualization)는 컴퓨팅 자원을 더 유연하고 효율적으로 활용하기 위해 하드웨어를 소프트웨어로 추상화하는 기술을 말합니다.

즉, 한 대의 물리적인 컴퓨터 안에서 여러 개의 ‘가짜 컴퓨터’를 만들어 각각 다른 작업을 할 수 있게 해주는 것입니다.

가상화 컴퓨팅의 이점

[시스템 측면]

• 자원 활용률 향상 : 서버 하나로 여러 시스템을 운영합니다.

• 복원과 백업이 쉬움 : 설정된 상태를 스냅샷처럼 저장하고 쉽게 복원합니ㅏㄷ.

[비지니스 측면]

• 비용 절감 : 물리 서버 수가 줄어드니 유지비도 절약합니다.

• 다운타임 최소화 : 시스템이 중단되는 시간을 줄여 문제가 발생해도 서비스 이용이 오래 멈추지 않도록 합니다.

• 데이터센터 관리 간소화 : 공간과 전력 소모도 줄일 수 있습니다.

• 재해 복구에 강함 : 백업 VM을 바로 띄워 대체 가능합니다.

[개발자 입장]

• 통일된 환경 제공 : 개발한 소프트웨어의 배포, 테스트, 구성 관리 등에 통일된 환경을 제공할 수 있습니다.

• 자동화 프로세스 최적화 : 소프트웨어 통합/인도 프로세스의 자동화에 적용하기가 좋습니다.

---

서버 가상화 기술의 진화

1. 가상 기계 (VM; Virtual Machine) 기반

하이퍼바이저(Hypervisor)라는 소프트웨어가 물리적인 컴퓨터 자원을 나눠서 여러 운영체제를 동시에 실행할 수 있게 해줍니다.

• Type 1(네이티브 또는 베어메탈형) : 물리 서버에 직접 설치됩니다.

  • 전가상화 : 가상 머신이 실제 하드웨어를 그대로 흉내내는 방식

  • 반가상화 : 운영체제를 약간 수정해서 하이퍼바이저와 직접 통신하는 방식

• Type 2(호스트형) : 기존 OS 위에 설치됩니다.

출처: 위키피디아

2. 컨테이너 기반

가상 머신과 비슷하지만, 운영체제를 따로 올리지 않고, 호스트 OS의 커널을 공유하면서도 앱 실행 환경은 격리시킵니다.

• 운영체제를 포함하지 않아 훨씬 가볍고 빠릅니다.

• 앱마다 컨테이너로 감싸서 실행 환경을 독립적으로 유지시킵니다.

🤔 호스트와 게스트의 차이는 무엇일까?

호스트 : 다른 시스템을 가상화하여 실행하는 컴퓨터

게스트: 호스트 시스템 위에 가상화되어 제공되는 가상 시스템

---

Docker 🐳

Docker는 널리 이용되고 있는 컨테이너 기반 가상화 플랫폼으로, 운영체제에 상관없이 리눅스 기반의 응용 프로그램들을 격리된 컨테이너 환경에서 실행하고 관리할 수 있도록 해주는 오픈 소스 도구입니다.

Docker에서는 보통 Dockerfile이라는 설정 파일을 작성하여 이미지(Image)를 만들고, 이 이미지를 기반으로 컨테이너(Container)를 실행합니다.

출처: dataminded

---

도커 구성요소

• Docker Desktop : 그래픽 사용자 인터페이스(GUI)를 제공하며, Docker Engine이 포함되어 있는 통합 도구입니다. 윈도우나 macOS와 같은 운영체제에서는 리눅스 환경이 필요하기 때문에, 가상 머신(VM) 위에서 실행됩니다.

• Docker Engine : 도커의 핵심 기술로, 컨테이너와 이미지 등 도커 객체를 생성하고 관리하는 역할을 합니다.

  • 클라이언트-서버 구조로 구성되어 있으며, 사용자는 Docker CLI(명령줄 도구)를 통해 요청을 보내고, Docker Daemon이 그 요청을 처리합니다.

  • 내부적으로는 리눅스의 커널 기능, 특히 프로세스 격리를 위한 Namespace(서로 보이지 않게 격리)와 리소스 제한을 위한 Control Group(CPU·메모리 제한)을 활용하여, 호스트 커널의 자원을 공유하면서도 서로 격리된 컨테이너 환경을 실행할 수 있도록 해줍니다.
    출처: dev community

도커 엔진 점검

• docker info
  도커 엔진의 상태, 버전, 사용 가능한 컨테이너/이미지 수, 실행 드라이버 정보 등을 보여줍니다.

• docker run hello-world
  도커가 공식 제공하는 hello-world 이미지를 다운로드해서 컨테이너로 실행합니다.
  → 실행에 성공하면 “도커가 정상적으로 설치되어 있고, 컨테이너를 실행할 수 있습니다”라는 메시지를 출력해줍니다.
  

---

이미지와 컨테이너

• 도커 이미지 (Docker Image)

  • 응용 프로그램을 실행하는 데 필요한 모든 파일들과 실행 방법을 하나로 묶은 실행 패키지입니다.

  • 이미지는 불변(immutable)하며, 상태를 저장하지 않는 구조입니다. → 네트워크로 전송하거나, 도커 레지스트리(Docker Hub 등)에 저장할 수 있으며, 이름과 버전(tag)을 지정하여 관리할 수 있습니다.

  • 이미지 구조는 계층화(layered)되어 있어, 하나의 이미지를 기반으로 다른 이미지를 만들 수 있는 유연성을 제공합니다.

🤔 이미지란 무엇일까?

도커에서 컨테이너를 실행하려면 먼저 이미지(Image) 가 필요합니다. 이미지는 쉽게 말해, 컨테이너를 만들기 위한 기초 템플릿을 말합니다. 이 이미지 안에는 프로그램이 실행되기 위한 모든 환경이 들어 있는데, 구체적으로는 다음과 같은 요소들이 포함됩니다.

도커 이미지는 하나의 커다란 파일 덩어리가 아니라, 여러 개의 레이어(layer)가 층층이 쌓여서 만들어진 구조입니다.
각 레이어는 이전 레이어 위에 추가된 변경사항만을 포함하고 있으며, 이러한 방식 덕분에 중복을 줄이고 효율적인 저장과 배포가 가능합니다.
출처: tistory

1. 운영체제

• 도커 자체가 원래 리눅스 커널의 기술을 이용해서 만들어졌기 때문에 대부분은 Ubuntu, Alpine처럼 리눅스 기반의 운영체제가 베이스로 들어갑니다. 이렇게 구성된 이미지는 어떤 운영체제 위에서도 동일하게 실행될 수 있는 일관된 기반을 제공해, 윈도우든 맥이든 어디서든 컨테이너가 안정적으로 작동할 수 있도록 해줍니다.

2. 필수 소프트웨어

• 예를 들어 웹 서버(nginx, Apache)나 데이터베이스(MySQL, PostgreSQL) 같은 필수 실행 프로그램들이 필요합니다.

3. 라이브러리와 패키지

• Python, Node.js 같은 런타임 환경이나, 프로그램이 실행되기 위해 필요한 종속성 라이브러리들도 함께 포함됩니다.

4. 애플리케이션 코드

• 직접 만든 웹 서비스나 API 서버 코드, HTML/CSS 파일 등이 들어가 실제 서비스를 구성합니다.

5. 설정 파일 및 명령어

• 실행 시 필요한 환경 변수, 설정 파일(.env, config.json 등), 그리고 시작 명령어 등이 함께 정의되어 있습니다.

• 도커 컨테이너 (Docker Container)

  • 도커 이미지로부터 만들어진 실행 가능한 인스턴스입니다.

  • 하나의 이미지로부터 여러 개의 컨테이너를 생성할 수 있으며, 이를 통해 동일한 애플리케이션을 여러 환경에서 동시에 실행할 수 있습니다.

  • 컨테이너는 이미지와 달리 실행 중에 상태를 가질 수 있습니다. → 파일을 생성하거나 설정을 변경하면 그 내용이 컨테이너 내부에 저장됩니다.

    • 다만, 컨테이너를 삭제하면 그 안에 저장된 상태도 함께 사라집니다.

---

도커 컨테이너, 이미지 관련 명령어

• docker run <이미지 이름> : 이름이 주어진 이미지를 로컬에서 또는 레지스트리에서 가져다가 컨테이너를 만들어서 실행합니다.

🤔 웹에 띄우고 싶다면?

docker run -p [호스트포트]:[컨테이너포트] 이미지이름

• -p: 포트포워딩 (호스트 : 컨테이너)

이미지	컨테이너 포트
nginx / httpd (Apache)	80
mysql	3306
redis	6379
postgres	5432
mongo	27017

---

localhost:8080로 실행한 결과

• docker ps : 현재 실행 중인 컨테이너들의 정보를 조회합니다.
  
  • docker ps -a : 중단되어 있는 것까지 포함하여 컨테이너 정보를 조회합니다.

• docker images : 로컬 컴퓨터에서 가지고 있는 이미지들의 정보를 조회합니다.
  

• docker stop <컨테이너 이름/ID> : 현재 실행 중인 컨테이너의 실행을 중단합니다. 컨테이너가 없어지지는 않습니다.
  

• docker rm <컨테이너 이름/ID> : 컨테이너를 삭제합니다.
  

• docker rmi <이미지 이름/ID> : 이미지를 삭제합니다.
  

• docker run --name <컨테이너 이름> <이미지> : 도커 컨테이너 이름을 지정합니다.

• docker container prune : 컨테이너 전체를 삭제합니다.

• docker image prune -e : 이미지 전체를 삭제합니다.

⚠️ 발생한 오류

이미지를 삭제하려 했는데 container is using its referenced image 오류가 발생하였습니다. 이는 이 이미지를 기반으로 만들어진 컨테이너가 존재하고 있어서 삭제가 되지 않는 오류입니다.

---

💡 해결 과정

컨테이너를 삭제하고 이미지를 삭제하였습니다.

---

Docker 실습

컨테이너 수동 수정으로 나만의 이미지 만들기

기존 httpd 이미지를 실행한 뒤, 컨테이너 내부에서 기본 웹 페이지(It works!)를 수정하고, 그 결과를 새로운 이미지로 저장하여, 이후에는 수정된 페이지가 기본 페이지로 표시되도록 합니다.

1단계 : httpd 컨테이너에서 웹 페이지 수정

docker run -it -p 8080:80 httpd /bin/bash

• httpd 이미지를 기반으로 컨테이너를 실행하고, bash 쉘에 진입합니다.
  

grep DocumentRoot /usr/local/apache2/conf/httpd.conf

• Apache 웹 서버의 기본 문서 디렉토리 경로를 확인합니다. (일반적으로 /usr/local/apache2/htdocs)
  

cd htdocs
ls -l
cat index.html

• 기존 기본 페이지 파일을 확인합니다.
  

cat > index.html
<html><body><h1>New page!</h1></body></html>

• 새 HTML 내용을 입력하여 기본 페이지를 수정합니다.

• 입력을 완료한 후 Ctrl + D를 눌러 저장합니다.
  

httpd-foreground

• Apache HTTP 서버(httpd)를 포그라운드(Foreground) 모드로 실행하는 명령어입니다.
  

exit

• 컨테이너에서 빠져나옵니다.
  

---

2단계 : 수정된 컨테이너에서 이미지 생성

docker ps -a

• 컨테이너 정보 조회를 통해 수정한 컨테이너 ID를 확인합니다.
  

docker start <컨테이너 ID/이름>
docker exec -it <컨테이너 ID/이름> /bin/bash

• 컨테이너를 시작한 후, 터미널로 진입하여 내부를 수정합니다. /bin/bash는 셸 환경으로 진입하기 위한 명령입니다.
  
  

cat ./htdocs/index.html

• 정상적으로 index.html 파일이 있는지 확인합니다.
  

httpd-foreground

• 웹서버(Apache)를 포그라운드 모드로 실행합니다. 이 상태에서 localhost:8080 접속을 하면 바꾼 페이지로 나옵니다.
  

exit

• 웹 서버가 잘 동작했다면 Ctrl + C로 빠져나온 후 exit으로 컨테이너에서 빠져나옵니다.

docker commit <컨테이너 ID 또는 이름> <저장할_이미지_이름>:<태그>

• 이제 변경된 컨테이너를 새로운 이미지로 저장합니다.

docker images

• 새로운 이미지가 정상적으로 생성되었는지 확인합니다.
  

docker run -d -p 8080:80 my_httpd:0.1 httpd-foreground

• 이제 새로운 이미지에서 컨테이너를 실행하면, 자동으로 웹서버가 포그라운드로 실행되어 localhost:8080에서 바로 접속이 가능해집니다.
  

---

생성 자동화 실습 – Apache(httpd) 커스터마이징

1️⃣ Dockerfile 작성 및 확인

FROM [--platform=<platform>]<image>[AS <name>]

RUN <command>

ENTRYPOINT ["executable", "param1", "param2"]

• Dockerfile : 도커 이미지 생성 절차를 기술하는 계층 구조 기반의 파일입니다.

  • FROM : 어떤 이미지를 기반으로 만들지 정함

  • RUN : 이미지 생성 중에 명령을 실행하고 그 결과를 포함

  • ENTRYPOINT : 컨테이너가 실행될 때 자동으로 실행할 명령 지정

• Dockerfile이 있는 경로에서 cat 명령어로 내용을 확인합니다.

2️⃣ 이미지 빌드

docker build -t my_httpd:0.2 .

• docker build : 현재 디렉토리에 있는 Dockerfile을 기반으로 이미지를 생성합니다.

• -t : 이미지 이름과 태그(tag)를 지정해주는 옵션 (t는 tag의 약자)입니다.

• my_httpd:0.2 : 이미지 이름이 my_httpd, 태그는 0.2라는 뜻입니다.

• . : 현재 디렉토리를 빌드 컨텍스트(build context)로 사용한다는 뜻입니다.
  → 즉, Dockerfile이 있는 위치
  

3️⃣ 이미지 확인

docker images

• 새로운 이미지가 정상적으로 생성되었는지 확인합니다.
  

4️⃣ 컨테이너 실행

docker run -d -p 8080:80 my_httpd:0.2

• -d : 백그라운드 실행

• -p 8080:80 : 호스트의 8080 포트를 컨테이너의 80 포트에 연결

• my_httpd:0.2 : 사용할 이미지 이름과 태그

---

도커 레포지토리에 이미지 올리기

🔗 도커 허브에 계정이 있어야 진행할 수 있습니다.

1️⃣ 도커 로그인

docker login

2️⃣ 이미지 태그 설정

docker tag <이미지 이름> <[내 도커 아이디]/[내가 원하는 이름]>

3️⃣ 이미지 푸시 (업로드)

docker push <방금 만든 이미지>

Docker Hub 레포지토리

도커 허브에 repository가 올라간 것을 확인할 수 있습니다.

---

환경변수 다루기

Ubuntu 22.04 환경에 Python3를 설치하고, hello.py를 실행하는 컨테이너를 만드는 실습입니다.

1️⃣ hello.py 작성

import os
print("Hello Wolrd from %s!" % os.environ["NAME"])

• os.environ["NAME"] : 시스템 환경변수 NAME을 불러와서 출력합니다.

2️⃣ Dockerfile 작성

FROM ubuntu:22.04

ENV NAME=Grepp

RUN apt-get update && apt-get install -y python3
COPY hello.py .

ENTRYPOINT ["python3", "hello.py"]

• ENV NAME=Grepp : Docker 이미지 안에서 NAME의 기본값을 설정합니다. hello.py에서 os.environ.get("NAME")으로 접근 가능합니다.

• RUN : 이미지를 빌드할 때 실행되는 명령어로 python3을 설치합니다. (apt 업데이트 포함)

• COPY hello.py . : 호스트의 hello.py 파일을 컨테이너 내부 작업 디렉토리로 복사합니다.

• ENTRYPOINT : 컨테이너가 실행될 때 자동으로 python3 hello.py를 실행하게 설정합니다.

3️⃣ 이미지 빌드

docker build -t hello:0.2 . 

4️⃣ 빌드 실행

4-1. 기본 실행 (Dockerfile의 ENV 값 사용)

docker run hello:0.2

• Hello World from Grepp! 가 출력됩니다.

4-2. 실행 시 환경변수 덮어쓰기

docker run -e NAME=Programmers hello:0.2

• Hello World from Programmers! 가 출력됩니다.

💡 --rm 옵션을 붙이면 실행 완료와 함께 컨테이너가 삭제됩니다.

docker run --rm -e NAME=ChatGPT hello:0.2

---

컨테이너 안의 파일들에 접근하는 방법

1️⃣ 컨테이너 실행

docker run --rm -d -p 8080:80 --name my_nginx nginx:latest

2️⃣ 컨테이너 내부 접속

docker exec -it my_nginx /bin/bash

• docker exec : 실행 중인 컨테이너 안에서 명령어를 직접 실행할 수 있게 해주는 명령어입니다.

• -it : 터미널에서 상호작용 모드로 실행됩니다.

  • -i : 표준 입력(stdin)을 열어둬서, 명령어를 직접 입력할 수 있게 해줍니다. (--interactive)

  • -t : 가짜 터미널(TTY)을 만들어서, 사람이 보는 터미널처럼 출력이 보이게 해줍니다. (--tty)

3️⃣ 컨테이너와 호스트 간 파일 복사

docker cp <호스트파일> <컨테이너이름>:<경로>
docker cp <컨테이너이름>:<경로> <호스트경로>

• cp : docker cp 호스트와 컨테이너 간에 파일을 복사할 때 사용합니다.

💡 파일이 있는 경로에서 명령어를 입력해야 합니다.

예시

docker cp index.html my_nginx:/usr/share/nginx/html
docker cp my_nginx:/usr/share/nginx/html/50x.html .

4️⃣ 이미지 빌드 시 파일 추가

FROM nginx:latest

ADD ./index.html /usr/share/nginx/html/new.html

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

Dockerfile에서 이미지 만들 때 파일을 미리 넣어두고 싶을 때 사용합니다.

• ADD 또는 COPY : Dockerfile에서 쓰는 명령어로 호스트의 파일을 컨테이너 안으로 포함시킵니다.

docker build -t your_nginx .

5️⃣ 바인드 마운트

docker run -it -v <호스트경로>:<컨테이너경로> <이미지> /bin/bash

호스트의 특정 디렉토리를 컨테이너 내부와 직접 연결하는 방식입니다.

• 컨테이너에서 파일을 수정하면 → 호스트에도 바로 반영됩니다.

• -v <호스트경로>:<컨테이너경로> : 호스트의 <호스트경로> 디렉토리를 컨테이너의<컨테이너경로>에 연결합니다.

예제

docker run -it -v ~/work/vol:/host_directory ubuntu:22.04 /bin/bash

cat > /host_directory/B.txt
This is a test file called B.txt
exit

• B.txt 파일이 호스트에도 반영된 것을 확인할 수 있습니다.

6️⃣ 도커 볼륨

docker volume create <볼륨이름>
docker run -v <볼륨이름>:<컨테이너경로> <이미지>

도커 볼륨은 Docker가 자체적으로 생성하고 관리하는 데이터 저장소 공간으로 호스트의 정확한 경로는 숨겨져 있고, Docker가 알아서 저장 위치를 관리합니다.

• 여러 컨테이너에서 같은 데이터 공유 가능합니다.

예제

docker run --rm -d -p 8888:80 -v my-volume:/usr/share/nginx/html --name my_nginx nginx:latest
sudo ls -l /var/lib/docker/volumes/my-volume/_data
docker exec -it my_nginx /bin/bash
cd /usr/share/nginx/html
cat > new.html
This file is created inside the container.
exit

sudo ls -l /var/lib/docker/volumes/my-volume/_data

도커 볼륨을 생성해서 Nginx 컨테이너에 연결하고, 컨테이너 안에서 파일을 만들고, 그 파일이 호스트(로컬)의 Docker 볼륨 위치에 실제로 저장합니다.

• 도커 볼륨은 호스트의 내부 디렉토리 /var/lib/docker/volumes/<볼륨이름>/_data 에 실제로 저장됩니다.

---

✏️ 회고

파이프라인과 docker에 대한 많은 개념들을 정리하면서 가상 머신과 도커에 대해 많이 알게 되었다.