Docker 를 사용하여 front 팀과 협업하기

태그

Docker

분류

DevOps

목차

Docker buildx 를 사용한 Multi-Architecture image build

front team 은 어떻게 사용해야 하나요? 🤔

1. Backend 팀에게 파일 받기

2. Docker Desktop 설치, 실행

Why Docker?

front 팀이 저희가 만든 WAS 를 사용할 수 있도록 해야 했습니다. 이를 위해 저에게는 여러 선택지가 있었습니다.

1. 안쓰는 노트북을 사용하여 개인 서버를 구축한다.

Qoddi 를 사용하여 프로젝트를 배포한다.

AWS 를 사용하여 프로젝트를 배포한다.

Docker 를 사용하여 front 팀이 이미지를 pull 받게 한다.

이 외에도 여러가지 방법이 있겠지만, 저는 제일 마지막 방법을 선택하기로 했습니다.

그 이유는 아래와 같습니다.

- 1 번의 경우 이전 프로젝트에서 해본적이 있는데, 구축은 어렵지 않으나 속도가 너무 느려서 front 팀이 답답해 했습니다.

- free tier 의 경우 프로젝트와 mysql 을 사용하면 끝이며, redis 를 사용하지 못합니다. Docker 로 프로젝트를 배포하는 것 또한 가능하지만, 비용이 들 가능성이 있습니다.

- 2 번과 같은 맥락으로 개발 초기단계에 서버 비용을 들이고 싶지 않았습니다.

이러한 이유를 종합하여 결국 만든 프로젝트를 image 로 말아 Docker hub 에 올리고, 이를 front 팀이 pull 받아 사용 하는 것으로 하였습니다. 전체 기능이 완성되고, version 을 매길 수 있게 되면 그 때 클라우드 서비스를 이용 해보려 합니다.

Dockerfile

Dockerfile 은 프로젝트를 Docker container 로 packaging 하기 위한 내용을 담고 있습니다.

저의 경우는 아래와 같이 작성 하였습니다.

FROM openjdk:17
COPY ./build/libs/backend-0.0.1-SNAPSHOT.jar /app.jar
ENTRYPOINT ["java","-jar","/app.jar"]
Plain Text
복사

•

FROM openjdk:17

◦

이 Docker image 는 openjdk 버전 17을 기반으로 한다는 뜻입니다. 따라서 이 image 는 Java 17이 설치된 환경에서 시작됩니다.

◦

FROM 지시문은 Docker 이미지를 만들기 위한 기반 image 를 지정합니다.

•

COPY ./build/libs/backend-0.0.1-SNAPSHOT.jar /app.jar

◦

로컬 파일 시스템의 ./build/libs/backend-0.0.1-SNAPSHOT.jar 파일을 Docker image 내의 /app.jar 위치로 복사 한다는 뜻입니다.

◦

애플리케이션의 실행 가능한 jar 파일을 container 안으로 가져옵니다.

•

ENTRYPOINT ["java","-jar","/app.jar"]

◦

ENTRYPOINT 지시문은 container 가 시작될 때 실행될 명령을 정의합니다.

◦

여기서는 java -jar /app.jar 명령을 사용하여 /app.jar 파일을 실행합니다.

compose.yaml

Docker Compose 를 사용하여 다중 컨테이너 Docker 애플리케이션을 정의하고 관리하기 위한 설정 파일입니다.

저의 경우 mysql, spring app, redis 세개의 컨테이너가 존재합니다.

version: '3.8'
services:
  mysql:
    # 도커 허브에서 mysql 의 최신 image 를 사용합니다.
    image: mysql:latest
    # 재시작 정책입니다.
    # mysql 이 실행되기 전, app 이 실행되면 실행오류가 발생합니다.
    restart: always
    env_file:
      # 환경변수가 담겨있는 파일을 지정해줍니다.
      docker.env
    volumes:
      - mysql-data:/var/lib/mysql
    ports:
      - "3306:3306"
    healthcheck:
      # 서비스가 제대로 실행했는지 체크합니다.
      test: ["CMD", "mysqladmin" ,"ping", "-h", "mysql"]
      interval: 10s
      timeout: 5s
      retries: 5

  redis:
    image: redis:latest
    restart: always
    ports:
      - "6379:6379"
    volumes:
      - redis-data:/data

  app:
    # 사용자 정의 image 를 사용 합니다.
    image: sieun96/starbucks-clone-coding:0.0.1
    ports:
      - "8080:8080"
    env_file:
      docker.env
    depends_on:
      # spring app 이 의존하는 서비스를 적어주어야 합니다.
      mysql:
        condition: service_healthy
      redis:
        condition: service_started

volumes:
  # 데이터를 저장합니다. 재실행해도 초기화 되지 않습니다.
  mysql-data:
  redis-data:
YAML
복사

환경변수 파일 작성

필요한 환경 변수를 key=value 로 작성 해주세요.

MYSQL_ROOT_PASSWORD=""
MYSQL_DATABASE=""
# application.yml 또한 똑같이 바꿔 줘야 합니다.
SPRING_DATASOURCE_URL: "jdbc:mysql://mysql:3306/{스키마명}?useSSL=false&allowPublicKeyRetrieval=true"
SPRING_DATASOURCE_USERNAME: ""
SPRING_DATASOURCE_PASSWORD: ""
SPRING_DATA_REDIS_HOST: "redis"
SPRING_DATA_REDIS_PORT: "6379"
...
Plain Text
복사

Docker buildx 를 사용한 Multi-Architecture image build

이 과정은 필요에 의해 밟으면 됩니다. 만약 github actions 를 이용하여 이미지 배포 자동화가 되어있다면 할 필요 없습니다!

제 맥북(m1) 에서 만든 Docker image 를 실행할 때, 실행 하려는 컴퓨터의 하드웨어 아키텍쳐에 따라 실패할 수도, 성공할 수도 있습니다. 왜 그럴까요?

일반적인 방식으로 docker image 를 만들어 허브에 올리면 아래와 같이 나올거에요.

docker build -t {이미지 이름}:{태그} .
Shell
복사

이를 윈도우 환경에서 pull 받아 실행하면 어떻게 될까요? 당연히 안되겠죠. 때문에 다양한 아키텍쳐를 고려해야 합니다. 프론트 팀원이 어떤 실행 환경을 가지고 있을지 모르니까요.