Image

컨테이너를 생성하기 위한 템플릿

Summary

Docker Image는 컨테이너를 생성하기 위한 템플릿으로, 애플리케이션 실행에 필요한 모든 설정과 종속성을 포함하는 패키지입니다. 이미지는 불변성을 가지며 계층화된 구조로 되어 있어 효율적인 저장과 배포가 가능합니다.

이미지는 Docker Hub에서 Pull 하거나 Dockerfile을 통해 직접 생성할 수 있으며, 컨테이너는 이미지를 실행한 인스턴스입니다. JDK 17과 MySQL 8 이미지를 활용한 개발환경 구성 실습과 Spring Boot 애플리케이션을 Docker 이미지로 빌드하고 배포하는 과정을 다룹니다.

Index

Image

Image 생성 방법

Image 실습

Image

컨테이너를 실행하기 위한 “설정과 프로그램이 담긴 패키지”

쉽게 비유하면

◦ Image = 요리 레시피

◦ Container = 레시피대로 만든 실제 요리

포인트

◦ 여러 컨테이너에서 반복 사용 가능

◦ 변경하지 않고 그대로 실행 가능

Docker Image란?

Docker Image는 컨테이너를 생성하는 데 필요한 모든 설정과 종속성을 포함하는 실행 가능한 패키지입니다. 이 이미지는 애플리케이션 코드, 라이브러리, 실행 환경 설정, 시스템 도구 등을 포함합니다.

Docker Image는 불변(Immutable)이며 계층화된(Layered) 구조를 가집니다.

Docker Image의 특징

•

읽기 전용: 이미지는 한 번 생성되면 변경할 수 없는 읽기 전용 템플릿입니다.

•

계층 구조: 여러 계층으로 구성되어 있어 효율적인 저장과 배포가 가능합니다.

•

이식성: Docker가 설치된 모든 환경에서 동일하게 실행됩니다.

•

재사용성: 하나의 이미지로 여러 컨테이너를 생성할 수 있습니다.

Image 생성 방법

Docker Pull

Dockerfile

Docker Pull

Docker Hub나 다른 레지스트리에서 미리 만들어진 이미지를 가져오는 방식입니다.

다음 명령어로 이미지를 가져옵니다

docker pull [이미지명]:[태그]
Bash
복사

•

예시

docker pull nginx:latest
Bash
복사

docker pull ubuntu:20.04
Bash
복사

이 방법은 가장 간단하게 이미지를 사용할 수 있는 방법으로, 공식 이미지나 검증된 이미지를 활용하여 빠르게 환경을 구성할 수 있습니다.

Docker Hub에는 다음과 같은 다양한 공식 이미지들이 있습니다:

•

ubuntu, centos, debian 등의 OS 이미지

•

nginx, apache 등의 웹 서버 이미지

•

mysql, postgresql, mongodb 등의 데이터베이스 이미지

•

node, python, java 등의 프로그래밍 언어 런타임 이미지

Docker Pull의 장점

•

신뢰할 수 있는 공식 이미지 사용 가능

•

직접 구성할 필요 없이 바로 사용 가능

•

버전 관리가 용이함 (태그를 통한 버전 지정)

•

커뮤니티에서 검증된 이미지 활용 가능

Dockerfile

직접 이미지를 정의하고 빌드하는 방식입니다.

특정 요구사항에 맞는 커스텀 이미지를 생성할 수 있습니다.

Dockerfile은 Docker 이미지를 생성하기 위한 스크립트 파일로, 이미지 구성 방법을 정의하는 지시문들이 포함되어 있습니다. 이를 통해 애플리케이션 환경을 코드로 관리할 수 있습니다.

기본적인 Dockerfile 구조

Dockerfile 주요 명령어

명령어	설명
FROM	베이스 이미지 지정
RUN	명령어 실행
COPY	로컬 파일 복사
ADD	파일 복사 (압축 해제 기능)
WORKDIR	작업 디렉토리 설정
EXPOSE	포트 노출
ENV	환경변수 설정
CMD	컨테이너 실행 명령어
ENTRYPOINT	컨테이너 시작점

Image 실습

Docker 이미지 실습 계획

1. 목표

JDK 17 이미지와 MySQL 8 이미지를 사용해서 개발환경 구성

Spring Boot 웹 앱을 포함한 이미지를 만들고 Docker Hub에 Push

2. 실습 준비

•

Docker 설치 완료

•

Docker Hub 계정 준비

•

간단한 Spring Boot 웹 앱 준비 (app.jar 또는 Spring Boot 프로젝트)

3. 단계별 실습

Step 1: 기본 이미지 가져오기

# JDK 17
docker pull openjdk:17

# MySQL 8
docker pull mysql:8
Bash
복사

•

확인

docker images
Bash
복사

Step 2: MySQL 컨테이너 실행

docker run -d \
  --name my-mysql \
  -e MYSQL_ROOT_PASSWORD=1234 \
  -e MYSQL_DATABASE=testdb \
  -p 3306:3306 \
  mysql:8
Bash
복사

•

설명

◦

d: 백그라운드 실행

◦

-name: 컨테이너 이름

◦

e: 환경변수 설정

◦

p: 포트 매핑 (호스트:컨테이너)

Step 3: JDK 개발환경 컨테이너 생성

Dockerfile 작성

# Base image
FROM openjdk:17

# 작업 디렉토리
WORKDIR /app

# Spring Boot 앱 복사
COPY target/myapp.jar /app/myapp.jar

# 포트 오픈
EXPOSE 8080

# 앱 실행
CMD ["java", "-jar", "myapp.jar"]
Docker
복사

•

이미지 빌드

docker build -t my-spring-app:1.0 .
Bash
복사

•

컨테이너 실행

docker run -d -p 8080:8080 --name spring-app my-spring-app:1.0
Bash
복사

포트 매핑(Port Mapping) 설명:

Docker의 -p 8080:8080 옵션은 포트 매핑을 정의합니다.

[호스트 포트]:[컨테이너 포트]

•

왼쪽(8080): 호스트 머신(내 컴퓨터)의 포트

•

오른쪽(8080): 컨테이너 내부의 포트

이 설정의 의미: 내 컴퓨터의 8080 포트로 들어오는 모든 트래픽이 Docker 컨테이너 내부의 8080 포트로 전달됩니다.

예를 들어, -p 9090:8080으로 설정하면 호스트의 9090 포트로 접속했을 때 컨테이너 내부의 8080 포트로 연결됩니다.

•

브라우저에서 http://localhost:8080 접속 확인

Step 4: Docker Hub에 Push

•

로그인

docker login
Bash
복사

•

태그 지정

docker tag my-spring-app:1.0 <DockerHubID>/my-spring-app:1.0
Bash
복사

•

Push

docker push <DockerHubID>/my-spring-app:1.0
Bash
복사

Step 5: Docker Compose 실습 (옵션)

•

docker-compose.yml

version: '3'
services:
  db:
    image: mysql:8
    environment:
      MYSQL_ROOT_PASSWORD: 1234
      MYSQL_DATABASE: testdb
    ports:
      - "3306:3306"

  app:
    build: .
    ports:
      - "8080:8080"
    depends_on:
      - db
YAML
복사

•

실행

docker-compose up -d
Bash
복사

•

MySQL과 Spring Boot 앱을 동시에 실행

Tip & 포인트

•

MySQL 컨테이너는 개발환경용이므로 비밀번호 단순화 가능

•

Spring Boot 앱에서 DB 연결 URL 예시:

spring.datasource.url=jdbc:mysql://db:3306/testdb
spring.datasource.username=root
spring.datasource.password=1234
Plain Text
복사

•

이렇게 하면 Docker Compose 환경에서 컨테이너 이름(db)로 접근 가능

No 태그