Docker 기술 문서

컨테이너 시작 및 중지 (Container Lifecycle) 서비스의 생명주기를 관리하는 가장 기본적인 명령어들입니다. 아래 빌드 명령어를 별도로 작성했지만, docker-compose up -d --build 명령어 입력 시 이미지를 새로 빌드(build)한 후에 컨테이너를 시작(up)이 가능합니다. 명령어 설명 주요 사용 사례 docker-compose up -d docker-compose.yml 파일에 정의된 모든 서비스를 백그라운드(-d)에서 생성하고 시작 최초로 프로젝트를 실행할 때 코드 변경 없이 단순히 중지했던 컨테이너를 다시 시작할 때 docker-compose down up으로 생성된 컨테이너와 네트워크 등 모든 리소스를 중지하고 제거 서비스를 완전히 종료하고 정리할 때 새로운 설정을 적용하기 위해 기존 환경을 깨끗이 지우고 싶을 때 docker-compose down -v down의 기본 기능에 더해, 데이터베이스 데이터 등이 저장되는 볼륨(volume)까지 영구적으로 삭제 개발 환경에서 데이터를 포함한 모든 것을 초기화하고 싶을 때 주의: 운영 환경에서는 데이터 유실 위험, 절대 사용하면 안 됩니다. docker-compose restart <서비스이름> 특정 서비스(컨테이너)만 재시작 Nginx 설정 파일 등 코드 빌드가 필요 없는 설정을 수정한 후 해당 서비스만 가볍게 재시작하고 싶을 때 로그 및 상태 확인 (Monitoring & Status) 실행 중인 컨테이너의 상태를 확인하고 문제를 진단하기 위한 필수 명령어들입니다. 명령어 설명 주요 사용 사례 docker ps 현재 실행 중인 모든 Docker 컨테이너의 목록, ID, 상태, 포트 정보 등을 보여줍니다. 컨테이너가 정상적으로 실행되고 있는지 확인할 때 외부로 노출된 포트 번호를 확인할 때 docker-compose logs <서비스이름> 특정 서비스 컨테이너가 생성된 이후부터 현재까지의 모든 로그를 출력합니다. 에러 발생 후 원인을 파악하기 위해 전체적인 로그 기록을 검토할 때 docker-compose logs -f <서비스이름> 특정 서비스의 로그를 실시간(-f, follow)으로 계속해서 보여줍니다. API 요청 등 특정 액션을 취했을 때 서버의 반응을 실시간으로 확인하며 디버깅할 때 이미지 및 빌드 관리 (Image & Build) 소스 코드 변경사항을 컨테이너에 적용할 때 사용하는 핵심 명령어입니다. 명령어 설명 주요 사용 사례 docker-compose up -d --build 컨테이너를 시작하기 전, Docker 이미지를 강제로 새로 빌드(build)하여 최신 코드를 반영 Java 코드, application.yml, package.json 등 소스 코드를 수정한 후 변경사항을 컨테이너에 적용하고 싶을 때 가장 중요한 명령어로, 코드 수정 후에는 반드시 사용해야 합니다. docker-compose build <서비스이름> 특정 서비스의 이미지만 새로 빌드합니다. 컨테이너를 시작하지는 않습니다. up 하기 전에 코드 빌드가 성공적으로 완료되는지 미리 확인할 때 컨테이너 내부 명령어 실행 (Execution & Debugging) 실행 중인 컨테이너 내부에 직접 들어가거나 명령을 내려 환경을 진단합니다. 명령어 설명 주요 사용 사례 docker-compose exec <서비스이름> <명령어> 실행 중인 컨테이너 내부에서 원하는 명령어를 실행합니다. Nginx 설정 문법 검사: docker-compose exec nginx nginx -t 컨테이너 내 환경변수 확인: docker-compose exec app printenv docker-compose exec <서비스이름> /bin/sh 해당 컨테이너의 셸(shell) 환경으로 접속합니다. (배포용 이미지에 따라 /bin/bash일 수도 있습니다.) 컨테이너 내부 파일 구조를 직접 확인하거나 여러 명령어를 연속적으로 실행하며 심층 디버깅을 할 때 서버 운영 시 up -d --build(코드 변경 시), down(정리), logs -f(실시간 확인) 명령어는 가장 빈번하게 사용됩니다. 3개는 기억하고 있는게 좋습니다.

문제 상황 (Problem Description) Spring Boot 애플리케이션 개발 중, 로컬 환경(java -jar 또는 IDE 실행)에서는 모든 기능이 정상 동작했지만, docker-compose up으로 컨테이너 환경에서 실행했을 때만 S3 파일 업로드 및 다른 API 호출이 실패하는 문제가 발생했습니다. 주요 증상 (핵심 단서): AWS S3 파일 업로드 시, 버킷이 분명히 ap-northeast-2(서울) 리전에 있음에도 불구하고 The bucket is in this region: us-east-1 라는 301 PermanentRedirect 에러가 발생했습니다. 연관 증상: @PostMapping으로 정의된 다른 API들은 404 Not Found 에러를 반환했습니다. 공통점: 모든 기능은 로컬 환경에서는 완벽하게 동작했습니다. 핵심 원인 (Root Cause) 문제의 핵심 원인은 로컬 실행 환경과 Docker 컨테이너 실행 환경 간의 설정 불일치였습니다. 이번 사례의 주요 원인은 docker-compose.yml에 .env 파일을 환경 변수로 주입하는 env_file 설정이 누락되어, Docker 컨테이너가 .env 파일의 내용을 전혀 읽지 못한 것이었습니다. 이로 인해 다음과 같은 연쇄적인 문제가 발생했습니다. S3 리전 및 버킷 이름 누락: 컨테이너 내부의 AWS SDK는 환경 변수(AWS_REGION, AWS_S3_BUCKET_NAME 등)를 읽을 수 없었습니다. AWS SDK는 리전 정보가 없을 경우 기본값(default)으로 us-east-1 리전을 사용하게 되므로, ap-northeast-2에 있는 버킷에 접근 시도 시 PermanentRedirect 에러가 발생했습니다. context-path 누락: 동일한 이유로 .env 파일에 정의된 SERVER_SERVLET_CONTEXT_PATH 환경 변수 또한 누락되었습니다. 그 결과, Spring Boot 애플리케이션이 context-path 없이 실행되어 모든 API 엔드포인트의 주소가 달라졌고, 이는 404 Not Found 에러로 이어졌습니다. 최종 해결책 (Final Solution) docker-compose.yml 파일에 env_file 속성을 추가하여, 컨테이너 실행 시 .env 파일의 변수들을 환경 변수로 주입하도록 수정했습니다. 수정 전 services: uritrip-java-server: build: . ports: - "8080:8080" # env_file 설정이 누락되어 있었음 수정 후 services: uritrip-java-server: build: . ports: - "8090:8090" env_file: - .env # <-- 이 한 줄을 추가하여 문제 해결 수정 후 docker-compose up -d --build 명령어로 컨테이너를 재시작하자 모든 S3 및 API 기능이 정상적으로 동작했습니다.

Docker Compose를 사용하면 여러 개의 컨테이너를 손쉽게 관리하고 실행할 수 있습니다. Docker Compose를 활용한 Java 애플리케이션과 데이터베이스(PostgreSQL) 환경 구성 방법을 살펴보겠습니다. Docker Compose란? Docker Compose는 여러 개의 Docker 컨테이너를 정의하고 관리할 수 있는 도구입니다. docker-compose.yml 파일을 작성하면 한 번의 명령어로 애플리케이션과 관련 서비스를 동시에 실행할 수 있습니다. 💡 Docker Compose를 사용할 경우 얻을 수 있는 장점✅ 여러 개의 컨테이너를 쉽게 관리✅ YAML 파일을 활용하여 환경 설정을 코드로 저장✅ docker-compose up 한 줄로 환경 구성 및 실행 프로젝트 구조 Docker Compose를 적용할 기본적인 디렉토리 구조입니다. /java-docker-app ├── src/main/java/com/example/demo/DemoApplication.java ├── Dockerfile ├── docker-compose.yml ├── build.gradle 또는 pom.xml ├── .env (환경 변수 파일) └── app.jar (빌드된 JAR 파일) docker-compose.yml 작성 Java 애플리케이션과 PostgreSQL 데이터베이스를 함께 실행하는 환경을 구성. 📌 docker-compose.yml version: '3.8' services: app: image: java-docker-app # Java 애플리케이션 컨테이너 build: . ports: - "8080:8080" depends_on: - db environment: SPRING_DATASOURCE_URL: jdbc:postgresql://db:5432/mydatabase SPRING_DATASOURCE_USERNAME: ${DB_USER} SPRING_DATASOURCE_PASSWORD: ${DB_PASSWORD} db: image: postgres:15 # PostgreSQL 최신 버전 사용 container_name: postgres-db restart: always ports: - "5432:5432" environment: POSTGRES_DB: mydatabase POSTGRES_USER: ${DB_USER} POSTGRES_PASSWORD: ${DB_PASSWORD} volumes: - pgdata:/var/lib/postgresql/data volumes: pgdata: depends_on: db 서비스가 실행된 후 app 서비스가 실행되도록 설정 환경 변수 설정 (SPRING_DATASOURCE_URL): 애플리케이션이 PostgreSQL과 연결되도록 설정 volumes: 데이터가 컨테이너가 종료되어도 유지되도록 설정 (단순 테스트 작성 불필요, 하지만 작성을 권장) 4. 환경 변수 파일 (.env) 작성 데이터베이스 접속 정보를 .env 파일에 저장하면 보안성과 유연성이 향상됩니다. 📌 .env 파일 DB_USER=myuser DB_PASSWORD=mypassword 이제 docker-compose.yml에서 ${DB_USER}, ${DB_PASSWORD}를 사용하여 환경 변수를 불러올 수 있습니다. Docker Compose 실행 📌 컨테이너 실행 docker-compose up -d -d 옵션을 사용하면 백그라운드에서 실행됩니다. 📌 컨테이너 상태 확인 docker-compose ps 예시) Name Command State Ports --------------------------------------------------------------------------------- java-docker-app "java -jar app.jar" Up (running) 0.0.0.0:8080->8080/tcp postgres-db "docker-entrypoint.sh" Up (running) 0.0.0.0:5432->5432/tcp 📌 실행 중인 컨테이너 내부 접속해보기 docker exec -it postgres-db psql -U myuser -d mydatabase PostgreSQL 데이터베이스 내부에서 SQL 명령어 실행 가능 SELECT * FROM pg_tables;

Java 애플리케이션을 컨테이너화하여 배포하면 운영 환경에 영향을 받지 않고 쉽게 실행할 수 있습니다. Docker를 활용하여 Java 애플리케이션을 컨테이너화하는 방법을 설명드리겠습니다. 아래 URL은 간단한 Java 서버 구현 내용입니다. https://kakao.gg/tech/backend/67b6c0ca2d3471597980a6c9 Dockerfile을 활용하여 Java 애플리케이션 컨테이너화 📌 프로젝트 구조 먼저, 간단한 Java 애플리케이션을 준비합니다. /java-docker-app ├── src/main/java/com/example/demo/DemoApplication.java ├── Dockerfile ├── build.gradle 또는 pom.xml └── app.jar (빌드된 JAR 파일) 📌 Java 애플리케이션 빌드 Gradle 또는 Maven을 사용하여 .jar 파일을 빌드합니다. Gradle ./gradlew bootJar 생성된 JAR 파일 위치 build/libs/app.jar Maven mvn clean package 생성된 JAR 파일 위치 target/app.jar Dockerfile 작성 이제 Dockerfile을 작성하여 Java 애플리케이션을 컨테이너화합니다. 📌 OpenJDK 기반 Docker 이미지 사용 Dockerfile을 프로젝트 루트 디렉토리에 생성하고 다음 내용을 추가합니다. # 공식 OpenJDK 이미지 사용 FROM openjdk:17-jdk-slim # 작업 디렉토리 설정 WORKDIR /app # 애플리케이션 JAR 파일 복사 COPY build/libs/app.jar app.jar # 컨테이너에서 실행할 명령어 지정 CMD ["java", "-jar", "app.jar"] Docker 이미지 빌드 및 실행 📌 Docker 이미지 빌드 이제 Dockerfile을 기반으로 Docker 이미지를 빌드합니다. docker build -t java-docker-app . 빌드가 완료되면 docker images 명령어로 확인할 수 있습니다. docker images 출력 예시 REPOSITORY TAG IMAGE ID CREATED SIZE java-docker-app latest abc123456789 10 seconds ago 400MB GUI가 사용 가능한 환경이라면 Docker Desktop을 통해 접속 후 Images 클릭 (위 이미지에는 Java Image가 존재하지 않습니다. 확인 방법에 대한 설명입니다.) 📌 Docker 컨테이너 실행 docker run -d -p 8080:8080 --name my-java-app java-docker-app -d : 백그라운드 실행 -p 8080:8080 : 호스트의 8080 포트를 컨테이너의 8080 포트에 매핑 --name my-java-app : 컨테이너 이름 설정 📌 실행 확인 docker ps 📌 컨테이너 접속 docker exec -it my-java-app /bin/sh

왜 클라우드 배포가 필요할까? 애플리케이션을 개발하고 로컬에서 실행하는 것은 쉽지만, 실제 사용자들이 접근할 수 있도록 배포하려면 클라우드 서버가 필요합니다.Docker를 활용하면 개발 환경과 동일한 상태로 애플리케이션을 배포할 수 있어 운영이 훨씬 쉬워집니다. ✅ Docker 배포의 장점✔️ 어디서든 동일한 환경에서 실행 가능 (개발 환경 &asymp; 운영 환경)✔️ 빠른 배포 및 롤백 가능✔️ 다양한 클라우드 플랫폼(AWS, GCP, Azure)에서 손쉽게 실행 Docker 애플리케이션 배포 개요 Docker 애플리케이션을 클라우드에 배포하는 방법은 여러 가지가 있지만 아래가 많이 사용됩니다. Docker Hub에 이미지 업로드 &rarr; 서버에서 실행 AWS EC2에서 직접 컨테이너 실행 AWS ECS, GCP Cloud Run 등 컨테이너 서비스 활용 Docker 앱을 AWS EC2에 배포해보기 🔹 Docker Hub에 애플리케이션 이미지 업로드 클라우드에서 실행하려면 먼저 Docker Hub에 이미지를 업로드해야 합니다. 📌 Docker Hub 로그인 docker login 📌 2. 애플리케이션 빌드 (Dockerfile 필요) docker build -t my-docker-app . 📌 3. Docker Hub에 태그 추가 docker tag my-docker-app <DockerHubID>/my-docker-app 📌 4. Docker Hub에 이미지 업로드 docker push <DockerHubID>/my-docker-app ✅ 이제 클라우드에서 이미지를 가져와 실행할 수 있습니다! 🔹 AWS EC2에서 Docker 컨테이너 실행 이미지를 Hub에 올려놨으니, AWS EC2 인스턴스를 생성하고, Docker 컨테이너를 실행합시다~ 📌 1. AWS EC2 인스턴스 생성 AWS에 로그인 후 EC2 인스턴스 생성 Amazon Linux 2 또는 Ubuntu 선택 보안 그룹에서 포트 8080(애플리케이션용)과 22(SSH 접속용) 허용 📌 2. SSH로 EC2 접속 ssh -i my-key.pem ec2-user@<EC2-퍼블릭-아이피> 📌 3. Docker 설치 sudo yum update -y sudo yum install docker -y sudo systemctl start docker sudo usermod -aG docker ec2-user 📌 4. Docker Hub에서 이미지 가져오기 & 실행 docker pull <DockerHubID>/my-docker-app docker run -d -p 8080:8080 <DockerHubID>/my-docker-app 📌 5. 애플리케이션 접속 확인이제 웹 브라우저에서 http://<EC2-퍼블릭-IP>:8080 에 접속하면 애플리케이션이 실행됩니다! 🚀 사실 DockerFile만 실행시키면 의미가 없습니다. Docker-compose를 사용하는 것이 좋습니다. Docker Compose를 활용한 배포 예를들어 MySQL 등 다른 서비스와 함께 배포해야 한다면, Docker Compose를 활용하면 더욱 편리합니다. 📌 EC2에서 docker-compose.yml 파일 작성 version: '3.8' services: database: image: mysql:8.0 container_name: mysql-container restart: always environment: MYSQL_ROOT_PASSWORD: root MYSQL_DATABASE: testdb MYSQL_USER: user MYSQL_PASSWORD: password ports: - "3306:3306" app: image: <DockerHubID>/my-docker-app container_name: spring-app depends_on: - database environment: SPRING_DATASOURCE_URL: jdbc:mysql://database:3306/testdb SPRING_DATASOURCE_USERNAME: user SPRING_DATASOURCE_PASSWORD: password ports: - "8080:8080" 📌 Docker Compose 실행 docker-compose up -d ✅ 이제 MySQL과 애플리케이션이 함께 실행됩니다! 🎉 실무에서 활용 가능한 클라우드 배포 옵션 AWS EC2에서 직접 Docker를 실행하는 방법 외에도, 다양한 클라우드 배포 방식이 있습니다. 배포 방식 특징 AWS ECS (Elastic Container Service) Docker 컨테이너 자동 관리 가능 AWS EKS (Kubernetes) 대규모 Kubernetes 클러스터 운영 가능 GCP Cloud Run 서버리스 컨테이너 실행 Azure Container Apps Azure에서 쉽게 컨테이너 실행 ✅ 규모가 커지면 ECS 또는 Kubernetes를 활용하는 것이 효율적입니다!

Docker Compose란? Docker를 사용하면 하나의 컨테이너를 실행하는 것은 쉽지만, 애플리케이션은 보통 여러 개의 서비스(컨테이너)가 함께 동작해야 합니다. 예를 들어, Spring Boot 애플리케이션 + MySQL 데이터베이스를 실행한다고 가정해 봅시다.각각을 개별적으로 실행하면 설정이 번거롭고 관리하기 어렵습니다.✅ 이를 해결하는 것이 바로 Docker Compose입니다! Docker Compose를 사용하면 여러 개의 컨테이너를 하나의 설정 파일(docker-compose.yml)로 관리할 수 있습니다.한 번의 명령어(docker-compose up)로 여러 컨테이너를 실행하고, 네트워크를 자동으로 설정해줍니다. Docker Compose를 사용하면 좋은 점 ✔️ 여러 개의 컨테이너를 한 번에 실행 가능✔️ 설정을 코드(docker-compose.yml)로 관리하여 재사용 가능✔️ 각 컨테이너의 환경 변수와 네트워크를 쉽게 설정 가능 Spring Boot + MySQL을 Docker Compose로 실행해보기 🔹 docker-compose.yml 파일 작성 이제 프로젝트 폴더 안에 docker-compose.yml 파일을 만들고, 아래 내용을 작성하세요. 📌 설정 파일 설명 app 서비스는 Spring Boot 애플리케이션 database 서비스는 MySQL 데이터베이스 version: '3.8' services: database: image: mysql:8.0 container_name: mysql-container restart: always environment: MYSQL_ROOT_PASSWORD: root MYSQL_DATABASE: testdb MYSQL_USER: user MYSQL_PASSWORD: password ports: - "3306:3306" app: build: . container_name: spring-app depends_on: - database environment: SPRING_DATASOURCE_URL: jdbc:mysql://database:3306/testdb SPRING_DATASOURCE_USERNAME: user SPRING_DATASOURCE_PASSWORD: password ports: - "8080:8080" ✅ 설명: database: MySQL 컨테이너 실행 app: Spring Boot 애플리케이션 실행 (MySQL과 연결) depends_on: database가 먼저 실행된 후 app이 실행되도록 설정 환경 변수(environment)를 사용해 데이터베이스 설정을 관리 🔹 Spring Boot 애플리케이션 Dockerfile 작성 이제 Dockerfile을 만들어 Spring Boot 애플리케이션을 컨테이너에서 실행할 수 있도록 설정합니다. 📌 프로젝트 루트 디렉터리에 Dockerfile 파일을 만들고 다음 내용을 작성하세요. # 1. OpenJDK 기반 이미지 사용 FROM openjdk:17-jdk-slim # 2. 작업 디렉토리 설정 WORKDIR /app # 3. JAR 파일을 컨테이너로 복사 COPY target/demo-0.0.1-SNAPSHOT.jar app.jar # 4. 애플리케이션 실행 CMD ["java", "-jar", "app.jar"] ✅ 이제 Spring Boot 애플리케이션을 빌드하면 됩니다! 🔹 애플리케이션 빌드 및 실행 Spring Boot 빌드합니다. ./mvnw clean package Docker Compose를 사용하여 모든 컨테이너 실행 docker-compose up -d ✅ 이제 MySQL과 Spring Boot 서버가 함께 실행됩니다!✅ http://localhost:8080에 접속하면 애플리케이션이 동작하는 것을 확인할 수 있습니다. 환경 변수 활용 .env 파일로 설정 관리하기 Docker Compose에서 환경 변수를 파일로 관리하면 설정 변경이 쉬워집니다.📌 .env 파일을 생성하고 다음 내용을 추가합니다. MYSQL_ROOT_PASSWORD=root MYSQL_DATABASE=testdb MYSQL_USER=user MYSQL_PASSWORD=password 📌 docker-compose.yml에서 환경 변수를 참조하도록 수정합니다. ${} 사용하면 환경 변수를 사용할 수 있습니다. environment: MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD} MYSQL_DATABASE: ${MYSQL_DATABASE} MYSQL_USER: ${MYSQL_USER} MYSQL_PASSWORD: ${MYSQL_PASSWORD}

Tomcat 이미지 다운로드 Tomcat 이미지를 Docker Hub에서 다운로드합니다. 최신 버전 또는 원하는 버전을 지정할 수 있습니다. docker pull tomcat:latest tomcat:latest: Tomcat의 최신 버전을 다운로드합니다. 특정 버전을 원할 경우 tomcat:<버전> 형식으로 지정 가능합니다 (예: tomcat:9.0). 이미지 다운로드 후 로컬 이미지 목록에서 확인 docker images Tomcat 컨테이너 실행 해당 게시글은 컨테이너 실행까지만 진행하고 넘어가셔도 충분합니다. compose에서 추가로 내용 작성할 예정입니다. Docker Tomcat은 이렇게 실행시키고, 설정하면 된다~ 정도로 가볍게 읽고 넘어가시는 걸 추천드립니다. 기본 실행 명령어 Tomcat 컨테이너를 생성하고 실행합니다. docker run -d --name my-tomcat \ -p 8080:8080 \ tomcat:latest 옵션 설명 -d: 컨테이너를 백그라운드에서 실행합니다. --name my-tomcat: 컨테이너 이름을 my-tomcat으로 지정합니다. -p 8080:8080: 로컬 호스트의 8080 포트를 컨테이너의 8080 포트에 연결합니다. tomcat:latest: 사용할 Tomcat 이미지 이름과 태그를 지정합니다. Tomcat 기본 페이지 확인 컨테이너 실행 후 브라우저에서 다음 URL로 접속 http://localhost:8080 Tomcat 기본 관리 페이지가 표시되면 설정이 완료된 것입니다. Tomcat 환경 설정 Tomcat 컨테이너의 설정 파일을 수정하거나 웹 애플리케이션을 배포하려면 설정이 필요합니다. (추가 옵션 설정이 필요 없는 경우 선택 사항에 가깝습니다.) 웹 애플리케이션 배포 로컬 디렉터리를 컨테이너의 Tomcat webapps 디렉터리에 마운트하여 애플리케이션을 배포합니다 docker run -d --name my-tomcat \ -p 8080:8080 \ -v $(pwd)/webapps:/usr/local/tomcat/webapps \ tomcat:latest 옵션 설명 -v $(pwd)/webapps:/usr/local/tomcat/webapps 로컬 디렉터리 webapps를 컨테이너의 Tomcat webapps 디렉터리에 연결합니다. 여기에서 .war 파일을 배포하면 Tomcat이 자동으로 로드합니다. 3.2 Tomcat 설정 파일 접근 Tomcat 설정 파일(server.xml 등)을 수정하려면 다음 디렉터리를 마운트합니다 -v $(pwd)/config:/usr/local/tomcat/conf 로컬에서 설정 파일을 준비한 후 컨테이너에 연결하면 쉽게 수정 가능합니다. Tomcat 사용자 설정 (선택 사항) Tomcat 관리자 계정을 설정하려면 tomcat-users.xml 파일을 수정해야 합니다. 이 파일을 로컬에서 생성 후 컨테이너에 마운트하여 설정할 수 있습니다. tomcat-users.xml 예시 <tomcat-users> <role rolename="manager-gui"/> <role rolename="admin-gui"/> <user username="admin" password="admin_password" roles="manager-gui,admin-gui"/> </tomcat-users> 실행 시 마운트 docker run -d --name my-tomcat \ -p 8080:8080 \ -v $(pwd)/tomcat-users.xml:/usr/local/tomcat/conf/tomcat-users.xml \ tomcat:latest 데이터 볼륨 설정 (선택 사항) Tomcat 로그나 기타 데이터를 호스트에 저장하려면 볼륨을 설정합니다. 로그 파일 마운트 -v $(pwd)/logs:/usr/local/tomcat/logs 컨테이너의 로그 파일을 로컬 디렉터리에 저장

MySQL 이미지 다운로드 MySQL 이미지를 Docker Hub에서 다운로드합니다. 최신 버전 또는 원하는 버전을 지정할 수 있습니다. docker pull mysql:latest mysql:latest: MySQL의 최신 버전을 다운로드합니다. 특정 버전을 원하면 mysql:<버전> 형식으로 지정하세요 (예: mysql:8.0). 이미지 다운로드 후 로컬 이미지 목록에서 확인할 수 있습니다. docker images MySQL 컨테이너 실행 기본 실행 명령어 MySQL 컨테이너를 생성하고 실행합니다. docker run -d --name my-mysql \ -e MYSQL_ROOT_PASSWORD=root_password \ -p 3306:3306 \ mysql:latest 옵션 설명 -d: 컨테이너를 백그라운드에서 실행합니다. --name my-mysql: 컨테이너 이름을 my-mysql로 지정합니다. -e MYSQL_ROOT_PASSWORD=root_password: MySQL 루트 사용자 비밀번호를 설정합니다. -p 3306:3306: 로컬 호스트의 3306 포트를 컨테이너의 3306 포트와 연결합니다. mysql:latest: 사용할 MySQL 이미지 이름과 태그를 지정합니다. 추가 설정 옵션 필요에 따라 데이터베이스 이름, 사용자 계정 등을 설정할 수 있습니다. docker run -d --name my-mysql \ -e MYSQL_ROOT_PASSWORD=root_password \ -e MYSQL_DATABASE=my_database \ -e MYSQL_USER=my_user \ -e MYSQL_PASSWORD=my_password \ -p 3306:3306 \ mysql:latest MYSQL_DATABASE: 생성할 기본 데이터베이스 이름. MYSQL_USER: 새 사용자 이름. MYSQL_PASSWORD: 새 사용자의 비밀번호. 실행 상태 확인 실행 중인 컨테이너를 확인하려면 다음 명령어를 사용합니다. docker ps 컨테이너가 정상적으로 실행 중이면 STATUS가 Up 상태로 표시됩니다. MySQL 접속 컨테이너 내부 MySQL CLI 접속 MySQL 클라이언트로 컨테이너 내부에 접속하려면 다음 명령어를 사용합니다. root_password를 입력하면 MySQL 쉘에 접속할 수 있습니다. 외부 MySQL 클라이언트로 접속 호스트: localhost 포트: 3306 사용자 이름: 설정된 MySQL 사용자 이름 (기본값은 root) 비밀번호: 설정된 비밀번호 예: MySQL Workbench, DBeaver와 같은 GUI 클라이언트를 사용하여 접속. 데이터 볼륨 설정 (선택 사항) 말이 선택 사항이지 필수입니다. 이유는 아래와 같습니다. 컨테이너가 중지되거나 삭제되더라도 데이터를 유지하려면 데이터 볼륨을 설정해야 합니다. 옵션 설명 -v mysql_data:/var/lib/mysql: 호스트의 mysql_data 디렉터리를 컨테이너 내부의 /var/lib/mysql에 마운트합니다. 볼륨을 설정하면 데이터는 컨테이너 삭제 후에도 유지됩니다. 컨테이너 중지 및 삭제 컨테이너 중지 docker stop my-mysql 컨테이너 삭제 docker rm my-mysql 중지된 컨테이너를 포함한 모든 컨테이너 목록 확인 docker ps -a 기본적인 내용이기 때문에 간단하게 실행만 해봤습니다. 서버부터 compose, volume까지 천천히 업로드해보겠습니다.

Spring Boot 애플리케이션을 Docker에서 실행하기 🔹 1단계: Spring Boot 프로젝트 생성 우선, 간단한 Spring Boot 애플리케이션을 만듭니다.Spring Initializr (https://start.spring.io/) 를 이용해서 다음 설정으로 프로젝트를 생성하세요. 📌 Spring Boot 프로젝트 기본 설정 Language: Java Spring Boot: (버전) Dependencies: Spring Web 🔹 2단계: 간단한 REST API 작성 src/main/java/com/example/demo/DemoApplication.java 를 다음과 같이 수정합니다. package com.example.demo; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; @RestController @RequestMapping("/api") public class DemoApplication { @GetMapping("/hello") public String hello() { return "Hello from Dockerized Spring Boot!"; } } ✅ 이제 http://localhost:8080/api/hello 에 접속하면 메시지를 확인할 수 있습니다. 🔹 3단계: Dockerfile 작성 이제 Spring Boot 애플리케이션을 Docker에서 실행하기 위해 Dockerfile을 만듭니다. 지금부터가 제일 중요합니다. 위에는 본인 Java Spring Boot Project로 진행해도 문제 없습니다.프로젝트 루트 디렉터리에 Dockerfile 파일을 추가하고 아래 내용을 작성하세요. # 1. OpenJDK 기반 이미지 사용 FROM openjdk:17-jdk-slim # 2. 작업 디렉토리 설정 WORKDIR /app # 3. JAR 파일을 컨테이너로 복사 COPY target/demo-0.0.1-SNAPSHOT.jar app.jar # 4. 애플리케이션 실행 CMD ["java", "-jar", "app.jar"] (해당은 docker-compose가 아니기 때문에, 가장 기본적인 docker file로 진행됩니다.) ✅ 이 Dockerfile은 OpenJDK 17 환경에서 Spring Boot 애플리케이션을 실행하는 역할을 합니다. 🔹 4단계: 애플리케이션 빌드 및 Docker 이미지 생성 먼저 Spring Boot 애플리케이션을 빌드하여 .jar 파일을 생성합니다. ./mvnw clean package 빌드가 완료되면 target/ 폴더에 demo-0.0.1-SNAPSHOT.jar 파일이 생성됩니다.이제 Docker 이미지를 빌드합니다. docker build -t my-spring-app . ✅ docker images 명령어로 빌드된 이미지를 확인할 수 있습니다. 🔹 5단계: 컨테이너 실행 및 확인 이제 빌드한 이미지를 기반으로 컨테이너를 실행해봅시다. docker run -p 8080:8080 my-spring-app ✅ 브라우저에서 http://localhost:8080/api/hello 에 접속하면 "Hello from Dockerized Spring Boot!" 메시지가 나타납니다. 🎉

Docker 컨테이너 실행 및 관리 Docker 컨테이너는 이미지를 기반으로 실행됩니다.Docker Hub에는 다양한 이미지가 제공되며, 가져와 실행할 수 있습니다. 🔹 첫 번째 컨테이너 실행하기 docker run hello-world ✅ 실행 결과Docker가 hello-world 이미지를 찾고 없다면 자동으로 다운로드한 후 실행합니다.이제 컨테이너가 정상적으로 동작하는지 확인! 🔹 실행 중인 컨테이너 확인 docker ps 이 명령어를 사용하면 현재 실행 중인 컨테이너 목록을 확인할 수 있습니다. 🔹 컨테이너 중지 및 삭제 # 컨테이너 중지 docker stop 컨테이너_ID # 컨테이너 삭제 docker rm 컨테이너_ID Dockerfile 작성 및 실행 Dockerfile은 컨테이너를 빌드하는 기초 파일 입니다.간단한 웹 서버를 실행하는 컨테이너를 통해 확인해보죠~ 🔹 간단한 Node.js 웹 서버 만들기 먼저, 프로젝트 폴더를 만들고 이동합니다. mkdir my-docker-app && cd my-docker-app 🔹 Dockerfile 작성 Dockerfile을 만들고 아래 내용을 작성합니다. # 1. Node.js 공식 이미지를 기반으로 사용 FROM node:18 # 2. 컨테이너 내 작업 디렉토리 설정 WORKDIR /app # 3. 애플리케이션 파일 복사 COPY . . # 4. 패키지 설치 RUN npm install # 5. 컨테이너 시작 시 실행할 명령어 CMD ["node", "server.js"] 🔹 간단한 server.js 파일 생성 Dockerfile과 같은 폴더에 server.js 파일을 만들고 다음 코드를 추가합니다. const http = require('http'); const server = http.createServer((req, res) => { res.writeHead(200, { 'Content-Type': 'text/plain' }); res.end('Hello from Docker!'); }); server.listen(3000, () => { console.log('Server running at http://localhost:3000'); }); 🔹 Docker 이미지 빌드 이제 위의 Dockerfile을 사용해 이미지를 빌드합니다. docker build -t my-docker-app . 이 명령어를 실행하면 my-docker-app이라는 이름으로 Docker 이미지가 생성됩니다. 🔹 컨테이너 실행 만든 이미지를 기반으로 컨테이너를 실행합니다. -p 3000:3000에서 앞쪽(호스트 포트)과 뒤쪽(컨테이너 포트) 두 개의 포트를 적는 이유는 호스트(로컬 머신)와 컨테이너 간의 포트 매핑을 설정하기 위해서입니다. docker run -p 3000:3000 my-docker-app ✅ 실행 후 http://localhost:3000에 접속하면 "Hello from Docker!" 메시지를 확인할 수 있습니다! 🚀