📌 컨테이너를 학습하고 3 tier로 운영환경을 구성해봅니다.
개발 환경을 구성해보고 지속적 통합을 경험해봅니다.

1. Reverse Proxy 구성하기

A. 도커 설치

$ sudo apt-get update && \
sudo apt-get install -y apt-transport-https ca-certificates curl software-properties-common && \
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - && \
sudo apt-key fingerprint 0EBFCD88 && \
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" && \
sudo apt-get update && \
sudo apt-get install -y docker-ce && \
sudo usermod -aG docker ubuntu && \
sudo curl -L "https://github.com/docker/compose/releases/download/1.23.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && \
sudo chmod +x /usr/local/bin/docker-compose && \
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
  • 도커 컨테이너가 처음인 분들은 강의 영상 확인 후, 포스팅을 참고바랍니다.

B. 컨테이너 실행

  • Dockerfile

    FROM nginx
    
    COPY nginx.conf /etc/nginx/nginx.conf
  • nginx.conf

    events {}
    
    http {
      upstream app {
        server 172.17.0.1:8080;
      }
    
      server {
        listen 80;
    
        location / {
          proxy_pass http://app;
        }
      }
    }
  • 실행

    $ docker build -t brainbackdoor/reverse-proxy .
    $ docker run -d -p 80:80 brainbackdoor/reverse-proxy
    $ curl http://localhost

2. TLS 설정

  • 서버의 보안과 별개로 서버와 클라이언트간 통신상의 암호화가 필요합니다. 평문으로 통신할 경우, 패킷을 스니핑할 수 있기 때문입니다.

  • letsencrypt를 활용하여 무료로 TLS 인증서를 사용할 수 있어요.

    $ docker run -it --rm --name certbot \
      -v '/etc/letsencrypt:/etc/letsencrypt' \
      -v '/var/lib/letsencrypt:/var/lib/letsencrypt' \
      certbot/certbot certonly -d 'yourdomain.com' --manual --preferred-challenges dns --server https://acme-v02.api.letsencrypt.org/directory
  • 인증서 생성 후 유효한 URL인지 확인을 위해 DNS TXT 레코드로 추가합니다.

  • DNS를 설정하는 사이트에서 DNS TXT 레코드를 추가한 후, 제대로 반영되었는지 dig 명령어로 확인한 후에 인증서 설정 진행을 계속합니다.

    $ dig -t txt _acme-challenge.example.com +short
  • 생성한 인증서를 활용하여 Reverse Proxy에 TLS 설정을 해봅시다. 우선 인증서를 Dockerfile이 있는 현재 경로로 옮깁니다.

    $ cp /etc/letsencrypt/live/[도메인주소]/fullchain.pem ./
    $ cp /etc/letsencrypt/live/[도메인주소]/privkey.pem ./
    DNS-01 챌린지와 인증서 적용
    DNS-01 챌린지와 인증서 적용서버 · certbot · manual · dns-01 · _acme-challenge TXT · 값: <토큰> · DNS 사이트 · 도메인 레코드 · TXT _acme-challenge · dig로 반영 확인 · Let's Encrypt · acme-v02 · TXT 조회 · 검증 성공 · /etc/letsencrypt/live/[도메인주소]/ · fullchain.pem · privkey.pem · 개인키: 서버에서 생성·보관 · cp → 작업 폴더 · Dockerfile COPY · nginx ssl_certificate · :0.0.2 재실행 -p 443 · :443이 이 인증서로 응답. 적용한 뒤에야 :443이 이 인증서로 응답합니다.서버 · certbotmanual · dns-01_acme-challenge TXT값: <토큰>DNS 사이트도메인 레코드TXT _acme-challengedig로 반영 확인Let's Encryptacme-v02TXT 조회 · 검증 성공/etc/letsencrypt/live/[도메인주소]/fullchain.pemprivkey.pem개인키: 서버에서 생성·보관cp → 작업 폴더Dockerfile COPYnginx ssl_certificate:0.0.2 재실행 -p 443:443이 이 인증서로 응답
    DNS-01 챌린지와 인증서 적용서버 · certbot · manual · dns-01 · _acme-challenge TXT · 값: <토큰> · DNS 사이트 · 도메인 레코드 · TXT _acme-challenge · dig로 반영 확인 · Let's Encrypt · acme-v02 · TXT 조회 · 검증 성공 · /etc/letsencrypt/live/[도메인주소]/ · fullchain.pem · privkey.pem · 개인키: 서버에서 생성·보관 · cp → 작업 폴더 · Dockerfile COPY · nginx ssl_certificate · :0.0.2 재실행 -p 443 · :443이 이 인증서로 응답. 적용한 뒤에야 :443이 이 인증서로 응답합니다.서버 · certbotmanual · dns-01_acme-challenge TXT값: <토큰>DNS 사이트도메인 레코드TXT _acme-challengedig로 반영 확인Let's Encryptacme-v02TXT 조회 · 검증 성공/etc/letsencrypt/live/[도메인주소]/fullchain.pemprivkey.pem개인키: 서버에서 생성·보관cp → 작업 폴더Dockerfile COPYnginx ssl_certificate:0.0.2 재실행 -p 443:443이 이 인증서로 응답
    과정 보기

    1. certbot이 주문하면 CA가 _acme-challenge TXT 값을 요구합니다. 아직 발급 전입니다.

    DNS-01 챌린지와 인증서 적용 · 1서버 · certbot · manual · dns-01 · _acme-challenge TXT · 값: <토큰> · DNS 사이트 · 도메인 레코드 · Let's Encrypt · acme-v02 · /etc/letsencrypt/live/[도메인주소]/ · fullchain.pem · privkey.pem · 개인키: 서버에서 생성·보관 · cp → 작업 폴더 · Dockerfile COPY · nginx ssl_certificate · :0.0.2 재실행 -p 443 · :443 아직 아님. CA가 _acme-challenge TXT 값을 요구합니다. 아직 발급 전입니다.서버 · certbotmanual · dns-01_acme-challenge TXT값: <토큰>DNS 사이트도메인 레코드Let's Encryptacme-v02/etc/letsencrypt/live/[도메인주소]/fullchain.pemprivkey.pem개인키: 서버에서 생성·보관cp → 작업 폴더Dockerfile COPYnginx ssl_certificate:0.0.2 재실행 -p 443:443 아직 아님
    DNS-01 챌린지와 인증서 적용 · 1서버 · certbot · manual · dns-01 · _acme-challenge TXT · 값: <토큰> · DNS 사이트 · 도메인 레코드 · Let's Encrypt · acme-v02 · /etc/letsencrypt/live/[도메인주소]/ · fullchain.pem · privkey.pem · 개인키: 서버에서 생성·보관 · cp → 작업 폴더 · Dockerfile COPY · nginx ssl_certificate · :0.0.2 재실행 -p 443 · :443 아직 아님. CA가 _acme-challenge TXT 값을 요구합니다. 아직 발급 전입니다.서버 · certbotmanual · dns-01_acme-challenge TXT값: <토큰>DNS 사이트도메인 레코드Let's Encryptacme-v02/etc/letsencrypt/live/[도메인주소]/fullchain.pemprivkey.pem개인키: 서버에서 생성·보관cp → 작업 폴더Dockerfile COPYnginx ssl_certificate:0.0.2 재실행 -p 443:443 아직 아님

    2. TXT를 DNS에 넣고 dig로 확인한 뒤, CA가 조회해 검증하고 발급합니다.

    DNS-01 챌린지와 인증서 적용 · 2서버 · certbot · manual · dns-01 · _acme-challenge TXT · 값: <토큰> · DNS 사이트 · 도메인 레코드 · TXT _acme-challenge · dig로 반영 확인 · Let's Encrypt · acme-v02 · TXT 조회 · 검증 성공 · /etc/letsencrypt/live/[도메인주소]/ · fullchain.pem · privkey.pem · 개인키: 서버에서 생성·보관 · cp → 작업 폴더 · Dockerfile COPY · nginx ssl_certificate · :0.0.2 재실행 -p 443 · :443 아직 아님. 발급된 fullchain·privkey가 서버에 저장됐습니다. 아직 적용 전입니다.서버 · certbotmanual · dns-01_acme-challenge TXT값: <토큰>DNS 사이트도메인 레코드TXT _acme-challengedig로 반영 확인Let's Encryptacme-v02TXT 조회 · 검증 성공/etc/letsencrypt/live/[도메인주소]/fullchain.pemprivkey.pem개인키: 서버에서 생성·보관cp → 작업 폴더Dockerfile COPYnginx ssl_certificate:0.0.2 재실행 -p 443:443 아직 아님
    DNS-01 챌린지와 인증서 적용 · 2서버 · certbot · manual · dns-01 · _acme-challenge TXT · 값: <토큰> · DNS 사이트 · 도메인 레코드 · TXT _acme-challenge · dig로 반영 확인 · Let's Encrypt · acme-v02 · TXT 조회 · 검증 성공 · /etc/letsencrypt/live/[도메인주소]/ · fullchain.pem · privkey.pem · 개인키: 서버에서 생성·보관 · cp → 작업 폴더 · Dockerfile COPY · nginx ssl_certificate · :0.0.2 재실행 -p 443 · :443 아직 아님. 발급된 fullchain·privkey가 서버에 저장됐습니다. 아직 적용 전입니다.서버 · certbotmanual · dns-01_acme-challenge TXT값: <토큰>DNS 사이트도메인 레코드TXT _acme-challengedig로 반영 확인Let's Encryptacme-v02TXT 조회 · 검증 성공/etc/letsencrypt/live/[도메인주소]/fullchain.pemprivkey.pem개인키: 서버에서 생성·보관cp → 작업 폴더Dockerfile COPYnginx ssl_certificate:0.0.2 재실행 -p 443:443 아직 아님

    3. 발급된 인증서를 수동으로 적용하고 이미지를 재실행해야 443이 응답합니다.

    DNS-01 챌린지와 인증서 적용 · 3서버 · certbot · manual · dns-01 · _acme-challenge TXT · 값: <토큰> · DNS 사이트 · 도메인 레코드 · TXT _acme-challenge · dig로 반영 확인 · Let's Encrypt · acme-v02 · TXT 조회 · 검증 성공 · /etc/letsencrypt/live/[도메인주소]/ · fullchain.pem · privkey.pem · 개인키: 서버에서 생성·보관 · cp → 작업 폴더 · Dockerfile COPY · nginx ssl_certificate · :0.0.2 재실행 -p 443 · :443이 이 인증서로 응답. 적용한 뒤에야 :443이 이 인증서로 응답합니다.서버 · certbotmanual · dns-01_acme-challenge TXT값: <토큰>DNS 사이트도메인 레코드TXT _acme-challengedig로 반영 확인Let's Encryptacme-v02TXT 조회 · 검증 성공/etc/letsencrypt/live/[도메인주소]/fullchain.pemprivkey.pem개인키: 서버에서 생성·보관cp → 작업 폴더Dockerfile COPYnginx ssl_certificate:0.0.2 재실행 -p 443:443이 이 인증서로 응답
    DNS-01 챌린지와 인증서 적용 · 3서버 · certbot · manual · dns-01 · _acme-challenge TXT · 값: <토큰> · DNS 사이트 · 도메인 레코드 · TXT _acme-challenge · dig로 반영 확인 · Let's Encrypt · acme-v02 · TXT 조회 · 검증 성공 · /etc/letsencrypt/live/[도메인주소]/ · fullchain.pem · privkey.pem · 개인키: 서버에서 생성·보관 · cp → 작업 폴더 · Dockerfile COPY · nginx ssl_certificate · :0.0.2 재실행 -p 443 · :443이 이 인증서로 응답. 적용한 뒤에야 :443이 이 인증서로 응답합니다.서버 · certbotmanual · dns-01_acme-challenge TXT값: <토큰>DNS 사이트도메인 레코드TXT _acme-challengedig로 반영 확인Let's Encryptacme-v02TXT 조회 · 검증 성공/etc/letsencrypt/live/[도메인주소]/fullchain.pemprivkey.pem개인키: 서버에서 생성·보관cp → 작업 폴더Dockerfile COPYnginx ssl_certificate:0.0.2 재실행 -p 443:443이 이 인증서로 응답
  • Dockerfile 을 아래와 같이 수정합니다.

    FROM nginx
    
    COPY nginx.conf /etc/nginx/nginx.conf 
    COPY fullchain.pem /etc/letsencrypt/live/[도메인주소]/fullchain.pem
    COPY privkey.pem /etc/letsencrypt/live/[도메인주소]/privkey.pem
  • nginx.conf 파일을 아래와 같이 수정합니다.

    events {}
    
    http {       
      upstream app {
        server 172.17.0.1:8080;
      }
      
      # Redirect all traffic to HTTPS
      server {
        listen 80;
        return 301 https://$host$request_uri;
      }
    
      server {
        listen 443 ssl;  
        ssl_certificate /etc/letsencrypt/live/[도메인주소]/fullchain.pem;
        ssl_certificate_key /etc/letsencrypt/live/[도메인주소]/privkey.pem;
    
        # Disable SSL
        ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    
        # 통신과정에서 사용할 암호화 알고리즘
        ssl_prefer_server_ciphers on;
        ssl_ciphers ECDH+AESGCM:ECDH+AES256:ECDH+AES128:DH+3DES:!ADH:!AECDH:!MD5;
    
        # Enable HSTS
        # client의 browser에게 http로 어떠한 것도 load 하지 말라고 규제합니다.
        # 이를 통해 http에서 https로 redirect 되는 request를 minimize 할 수 있습니다.
        add_header Strict-Transport-Security "max-age=31536000" always;
    
        # SSL sessions
        ssl_session_cache shared:SSL:10m;
        ssl_session_timeout 10m;      
    
        location / {
          proxy_pass http://app;    
        }
      }
    }
  • 방금전에 띄웠던 도커 컨테이너를 중지 & 삭제하고 새로운 설정을 반영하여 다시 띄워봅시다.

    $ docker stop proxy && docker rm proxy
    $ docker build -t brainbackdoor/reverse-proxy:0.0.2 .
    $ docker run -d -p 80:80 -p 443:443 --name proxy brainbackdoor/reverse-proxy:0.0.2
    Reverse Proxy와 TLS 종료
    Reverse Proxy와 TLS 종료클라이언트 · 브라우저 · nginx · proxy :80 · :443 · fullchain · privkey · TLS 종료 지점 · WAS · 172.17.0.1:8080 · (호스트) · DB · :3306 · TLS · HTTP 평문 · DB 암호화 미확인 · TLSv1·TLSv1.1·TLSv1.2 · HTTP/2 비활성. 암호화 구간은 클라이언트 ↔ nginx 하나입니다. TLS는 nginx에서 끝납니다.클라이언트브라우저nginxproxy :80 · :443fullchain · privkeyTLS 종료 지점WAS172.17.0.1:8080(호스트)DB:3306TLSHTTP 평문DB 암호화 미확인TLSv1·TLSv1.1·TLSv1.2 · HTTP/2 비활성
    Reverse Proxy와 TLS 종료클라이언트 · 브라우저 · nginx · proxy :80 · :443 · fullchain · privkey · TLS 종료 지점 · WAS · 172.17.0.1:8080 · (호스트) · DB · :3306 · TLS · HTTP 평문 · DB 암호화 미확인 · TLSv1·TLSv1.1·TLSv1.2 · HTTP/2 비활성. 암호화 구간은 클라이언트 ↔ nginx 하나입니다. TLS는 nginx에서 끝납니다.클라이언트브라우저nginxproxy :80 · :443fullchain · privkeyTLS 종료 지점WAS172.17.0.1:8080(호스트)DB:3306TLSHTTP 평문DB 암호화 미확인TLSv1·TLSv1.1·TLSv1.2 · HTTP/2 비활성
    과정 보기

    1. :80 요청은 https로 301 리다이렉트됩니다.

    Reverse Proxy와 TLS 종료 · 1클라이언트 · 브라우저 · nginx · proxy :80 · :443 · fullchain · privkey · WAS · 172.17.0.1:8080 · (호스트) · DB · :3306 · :80 → 301 · TLSv1·TLSv1.1·TLSv1.2 · HTTP/2 비활성. :80 요청은 https로 301 리다이렉트됩니다.클라이언트브라우저nginxproxy :80 · :443fullchain · privkey WAS172.17.0.1:8080(호스트)DB:3306:80 → 301TLSv1·TLSv1.1·TLSv1.2 · HTTP/2 비활성
    Reverse Proxy와 TLS 종료 · 1클라이언트 · 브라우저 · nginx · proxy :80 · :443 · fullchain · privkey · WAS · 172.17.0.1:8080 · (호스트) · DB · :3306 · :80 → 301 · TLSv1·TLSv1.1·TLSv1.2 · HTTP/2 비활성. :80 요청은 https로 301 리다이렉트됩니다.클라이언트브라우저nginxproxy :80 · :443fullchain · privkey WAS172.17.0.1:8080(호스트)DB:3306:80 → 301TLSv1·TLSv1.1·TLSv1.2 · HTTP/2 비활성

    2. TLS는 nginx에서 끝나고, WAS로는 평문 HTTP(:8080)가 갑니다.

    Reverse Proxy와 TLS 종료 · 2클라이언트 · 브라우저 · nginx · proxy :80 · :443 · fullchain · privkey · TLS 종료 지점 · WAS · 172.17.0.1:8080 · (호스트) · DB · :3306 · TLS · HTTP 평문 · TLSv1·TLSv1.1·TLSv1.2 · HTTP/2 비활성. nginx가 복호화한 뒤 proxy_pass로 WAS에 평문 HTTP를 보냅니다.클라이언트브라우저nginxproxy :80 · :443fullchain · privkeyTLS 종료 지점WAS172.17.0.1:8080(호스트)DB:3306TLSHTTP 평문TLSv1·TLSv1.1·TLSv1.2 · HTTP/2 비활성
    Reverse Proxy와 TLS 종료 · 2클라이언트 · 브라우저 · nginx · proxy :80 · :443 · fullchain · privkey · TLS 종료 지점 · WAS · 172.17.0.1:8080 · (호스트) · DB · :3306 · TLS · HTTP 평문 · TLSv1·TLSv1.1·TLSv1.2 · HTTP/2 비활성. nginx가 복호화한 뒤 proxy_pass로 WAS에 평문 HTTP를 보냅니다.클라이언트브라우저nginxproxy :80 · :443fullchain · privkeyTLS 종료 지점WAS172.17.0.1:8080(호스트)DB:3306TLSHTTP 평문TLSv1·TLSv1.1·TLSv1.2 · HTTP/2 비활성

    3. 응답은 nginx에서 다시 암호화됩니다. 자물쇠는 클라이언트 ↔ nginx 구간에만 있습니다.

    Reverse Proxy와 TLS 종료 · 3클라이언트 · 브라우저 · nginx · proxy :80 · :443 · fullchain · privkey · TLS 종료 지점 · WAS · 172.17.0.1:8080 · (호스트) · DB · :3306 · TLS · HTTP 평문 · DB 암호화 미확인 · TLSv1·TLSv1.1·TLSv1.2 · HTTP/2 비활성. 암호화 구간은 클라이언트 ↔ nginx 하나입니다. TLS는 nginx에서 끝납니다.클라이언트브라우저nginxproxy :80 · :443fullchain · privkeyTLS 종료 지점WAS172.17.0.1:8080(호스트)DB:3306TLSHTTP 평문DB 암호화 미확인TLSv1·TLSv1.1·TLSv1.2 · HTTP/2 비활성
    Reverse Proxy와 TLS 종료 · 3클라이언트 · 브라우저 · nginx · proxy :80 · :443 · fullchain · privkey · TLS 종료 지점 · WAS · 172.17.0.1:8080 · (호스트) · DB · :3306 · TLS · HTTP 평문 · DB 암호화 미확인 · TLSv1·TLSv1.1·TLSv1.2 · HTTP/2 비활성. 암호화 구간은 클라이언트 ↔ nginx 하나입니다. TLS는 nginx에서 끝납니다.클라이언트브라우저nginxproxy :80 · :443fullchain · privkeyTLS 종료 지점WAS172.17.0.1:8080(호스트)DB:3306TLSHTTP 평문DB 암호화 미확인TLSv1·TLSv1.1·TLSv1.2 · HTTP/2 비활성

3. 운영 데이터베이스 구성하기

일반적으로, 실제 운영환경에서 컨테이너로 데이터베이스의 영속성 데이터를 다루지 않습니다. 컨테이너의 철학과 데이터베이스의 영속성은 다소 배치되는 부분이 있다고 생각합니다. 여기서는 원활한 실습을 위해 제가 미리 push해둔 컨테이너를 활용합니다.

# id: root, pw: masterpw
$ docker run -d -p 3306:3306 brainbackdoor/data-subway:0.0.1

4. 설정 파일 나누기

  • 실제로 배포를 하려다보면, JUnit을 활용한 test 단계와 local 환경에서 직접 애플리케이션을 확인할 때, 그리고 실제로 배포할 때 등 각 상황에 맞춰 설정을 다르게 적용할 필요성이 생깁니다.

  • 예제 코드의 커밋을 통해 test와 local, prod에서 다른 설정을 사용하는 방법을 익혀봅시다.

  • -Dspring.profiles.active=prod 옵션을 추가하여 실행하면 application-prod.properties의 설정을 사용합니다.

    $ java -jar -Dspring.profiles.active=prod [jar파일명]
    프로필별 설정 파일과 DB
    프로필별 설정 파일과 DB기본 설정 ← 활성 프로필로 덮어쓰기 · 실행: 테스트 · JUnit 실행 · test · 프로필 · application-test.properties · account.name = testuser · H2 · 요구 DB · 실행: 로컬 · IntelliJ Multirun local · local · 프로필 · application-local.properties · account.name = localuser · docker MySQL · 요구 DB · 실행: 배포 · java -jar -Dspring.profiles.active=prod · prod · 프로필 · application-prod.properties · account.name = produser · 운영 DB · DB URL 미지정 · 스크립트 인자: prod | dev · 프로필 예시: test | local | prod. 세 프로필이 각자 다른 파일과 DB를 씁니다.기본 설정 ← 활성 프로필로 덮어쓰기실행: 테스트JUnit 실행test프로필application-test.propertiesaccount.name = testuserH2요구 DB실행: 로컬IntelliJ Multirun locallocal프로필application-local.propertiesaccount.name = localuserdocker MySQL요구 DB실행: 배포java -jar -Dspring.profiles.active=prodprod프로필application-prod.propertiesaccount.name = produser운영 DBDB URL 미지정스크립트 인자: prod | dev · 프로필 예시: test | local | prod
    프로필별 설정 파일과 DB기본 설정 ← 활성 프로필로 덮어쓰기 · 실행: 테스트 · JUnit 실행 · test · 프로필 · application-test.properties · account.name = testuser · H2 · 요구 DB · 실행: 로컬 · IntelliJ Multirun local · local · 프로필 · application-local.properties · account.name = localuser · docker MySQL · 요구 DB · 실행: 배포 · java -jar -Dspring.profiles.active=prod · prod · 프로필 · application-prod.properties · account.name = produser · 운영 DB · DB URL 미지정 · 스크립트 인자: prod | dev · 프로필 예시: test | local | prod. 세 프로필이 각자 다른 파일과 DB를 씁니다.기본 설정 ← 활성 프로필로 덮어쓰기실행: 테스트JUnit 실행test프로필application-test.propertiesaccount.name = testuserH2요구 DB실행: 로컬IntelliJ Multirun locallocal프로필application-local.propertiesaccount.name = localuserdocker MySQL요구 DB실행: 배포java -jar-Dspring.profiles.active=prodprod프로필application-prod.propertiesaccount.name = produser운영 DBDB URL 미지정스크립트 인자: prod | dev · 프로필 예시: test |local | prod
    과정 보기

    1. JUnit 실행 → test 프로필 → application-test.properties → H2.

    프로필별 설정 파일과 DB · 1기본 설정 ← 활성 프로필로 덮어쓰기 · 실행: 테스트 · JUnit 실행 · test · 프로필 · application-test.properties · account.name = testuser · H2 · 요구 DB · 실행: 로컬 · IntelliJ Multirun local · local · 프로필 · application-local.properties · account.name = localuser · docker MySQL · 요구 DB · 실행: 배포 · java -jar -Dspring.profiles.active=prod · prod · 프로필 · application-prod.properties · account.name = produser · 운영 DB · DB URL 미지정 · 스크립트 인자: prod | dev · 프로필 예시: test | local | prod. JUnit은 test 프로필 → application-test.properties → H2.기본 설정 ← 활성 프로필로 덮어쓰기실행: 테스트JUnit 실행test프로필application-test.propertiesaccount.name = testuserH2요구 DB실행: 로컬IntelliJ Multirun locallocal프로필application-local.propertiesaccount.name = localuserdocker MySQL요구 DB실행: 배포java -jar -Dspring.profiles.active=prodprod프로필application-prod.propertiesaccount.name = produser운영 DBDB URL 미지정스크립트 인자: prod | dev · 프로필 예시: test | local | prod
    프로필별 설정 파일과 DB · 1기본 설정 ← 활성 프로필로 덮어쓰기 · 실행: 테스트 · JUnit 실행 · test · 프로필 · application-test.properties · account.name = testuser · H2 · 요구 DB · 실행: 로컬 · IntelliJ Multirun local · local · 프로필 · application-local.properties · account.name = localuser · docker MySQL · 요구 DB · 실행: 배포 · java -jar -Dspring.profiles.active=prod · prod · 프로필 · application-prod.properties · account.name = produser · 운영 DB · DB URL 미지정 · 스크립트 인자: prod | dev · 프로필 예시: test | local | prod. JUnit은 test 프로필 → application-test.properties → H2.기본 설정 ← 활성 프로필로 덮어쓰기실행: 테스트JUnit 실행test프로필application-test.propertiesaccount.name = testuserH2요구 DB실행: 로컬IntelliJ Multirun locallocal프로필application-local.propertiesaccount.name = localuserdocker MySQL요구 DB실행: 배포java -jar-Dspring.profiles.active=prodprod프로필application-prod.propertiesaccount.name = produser운영 DBDB URL 미지정스크립트 인자: prod | dev · 프로필 예시: test |local | prod

    2. IntelliJ Multirun local(db·dev·SubwayApplication) → application-local.properties → docker MySQL.

    프로필별 설정 파일과 DB · 2기본 설정 ← 활성 프로필로 덮어쓰기 · 실행: 테스트 · JUnit 실행 · test · 프로필 · application-test.properties · account.name = testuser · H2 · 요구 DB · 실행: 로컬 · IntelliJ Multirun local · local · 프로필 · application-local.properties · account.name = localuser · docker MySQL · 요구 DB · 실행: 배포 · java -jar -Dspring.profiles.active=prod · prod · 프로필 · application-prod.properties · account.name = produser · 운영 DB · DB URL 미지정 · 스크립트 인자: prod | dev · 프로필 예시: test | local | prod. Multirun local(db·dev·SubwayApplication) → application-local.properties → docker MySQL.기본 설정 ← 활성 프로필로 덮어쓰기실행: 테스트JUnit 실행test프로필application-test.propertiesaccount.name = testuserH2요구 DB실행: 로컬IntelliJ Multirun locallocal프로필application-local.propertiesaccount.name = localuserdocker MySQL요구 DB실행: 배포java -jar -Dspring.profiles.active=prodprod프로필application-prod.propertiesaccount.name = produser운영 DBDB URL 미지정스크립트 인자: prod | dev · 프로필 예시: test | local | prod
    프로필별 설정 파일과 DB · 2기본 설정 ← 활성 프로필로 덮어쓰기 · 실행: 테스트 · JUnit 실행 · test · 프로필 · application-test.properties · account.name = testuser · H2 · 요구 DB · 실행: 로컬 · IntelliJ Multirun local · local · 프로필 · application-local.properties · account.name = localuser · docker MySQL · 요구 DB · 실행: 배포 · java -jar -Dspring.profiles.active=prod · prod · 프로필 · application-prod.properties · account.name = produser · 운영 DB · DB URL 미지정 · 스크립트 인자: prod | dev · 프로필 예시: test | local | prod. Multirun local(db·dev·SubwayApplication) → application-local.properties → docker MySQL.기본 설정 ← 활성 프로필로 덮어쓰기실행: 테스트JUnit 실행test프로필application-test.propertiesaccount.name = testuserH2요구 DB실행: 로컬IntelliJ Multirun locallocal프로필application-local.propertiesaccount.name = localuserdocker MySQL요구 DB실행: 배포java -jar-Dspring.profiles.active=prodprod프로필application-prod.propertiesaccount.name = produser운영 DBDB URL 미지정스크립트 인자: prod | dev · 프로필 예시: test |local | prod

    3. java -jar -Dspring.profiles.active=prod → application-prod.properties → 운영 DB.

    프로필별 설정 파일과 DB · 3기본 설정 ← 활성 프로필로 덮어쓰기 · 실행: 테스트 · JUnit 실행 · test · 프로필 · application-test.properties · account.name = testuser · H2 · 요구 DB · 실행: 로컬 · IntelliJ Multirun local · local · 프로필 · application-local.properties · account.name = localuser · docker MySQL · 요구 DB · 실행: 배포 · java -jar -Dspring.profiles.active=prod · prod · 프로필 · application-prod.properties · account.name = produser · 운영 DB · DB URL 미지정 · 스크립트 인자: prod | dev · 프로필 예시: test | local | prod. 세 프로필이 각자 다른 파일과 DB를 씁니다.기본 설정 ← 활성 프로필로 덮어쓰기실행: 테스트JUnit 실행test프로필application-test.propertiesaccount.name = testuserH2요구 DB실행: 로컬IntelliJ Multirun locallocal프로필application-local.propertiesaccount.name = localuserdocker MySQL요구 DB실행: 배포java -jar -Dspring.profiles.active=prodprod프로필application-prod.propertiesaccount.name = produser운영 DBDB URL 미지정스크립트 인자: prod | dev · 프로필 예시: test | local | prod
    프로필별 설정 파일과 DB · 3기본 설정 ← 활성 프로필로 덮어쓰기 · 실행: 테스트 · JUnit 실행 · test · 프로필 · application-test.properties · account.name = testuser · H2 · 요구 DB · 실행: 로컬 · IntelliJ Multirun local · local · 프로필 · application-local.properties · account.name = localuser · docker MySQL · 요구 DB · 실행: 배포 · java -jar -Dspring.profiles.active=prod · prod · 프로필 · application-prod.properties · account.name = produser · 운영 DB · DB URL 미지정 · 스크립트 인자: prod | dev · 프로필 예시: test | local | prod. 세 프로필이 각자 다른 파일과 DB를 씁니다.기본 설정 ← 활성 프로필로 덮어쓰기실행: 테스트JUnit 실행test프로필application-test.propertiesaccount.name = testuserH2요구 DB실행: 로컬IntelliJ Multirun locallocal프로필application-local.propertiesaccount.name = localuserdocker MySQL요구 DB실행: 배포java -jar-Dspring.profiles.active=prodprod프로필application-prod.propertiesaccount.name = produser운영 DBDB URL 미지정스크립트 인자: prod | dev · 프로필 예시: test |local | prod

5. 배포 스크립트 작성해보기

  • 반복적으로 사용하는 명령어를 Script로 작성해봅니다.

    #!/bin/bash
    
    ## 변수 설정
    
    txtrst='\033[1;37m' # White
    txtred='\033[1;31m' # Red
    txtylw='\033[1;33m' # Yellow
    txtpur='\033[1;35m' # Purple
    txtgrn='\033[1;32m' # Green
    txtgra='\033[1;30m' # Gray
    
    
    echo -e "${txtylw}=======================================${txtrst}"
    echo -e "${txtgrn}  << 스크립트 🧐 >>${txtrst}"
    echo -e "${txtylw}=======================================${txtrst}"
    
    ## 저장소 pull
    ## gradle build
    ## 프로세스 pid를 찾는 명령어
    ## 프로세스를 종료하는 명령어
    ## ...
    
  • 기능 단위로 함수로 만들어봅니다.

    function pull() {
      echo -e ""
      echo -e ">> Pull Request 🏃♂️ "
      git pull origin master
    }
    
    pull;
  • 스크립트 실행시 파라미터를 전달해봅니다.

    • 실행시 파라미터를 전달하도록 하여 범용성 있는 스크립트를 작성해봅니다.

    • read 명령어를 활용하여 사용자의 Y/N 답변을 받도록 할 수도 있어요.

    #!/bin/bash
    
    ## ...
    
    EXECUTION_PATH=$(pwd)
    SHELL_SCRIPT_PATH=$(dirname $0)
    BRANCH=$1
    PROFILE=$2
    
    ## 조건 설정
    if [[ $# -ne 2 ]]
    then
        echo -e "${txtylw}=======================================${txtrst}"
        echo -e "${txtgrn}  << 스크립트 🧐 >>${txtrst}"
        echo -e ""
        echo -e "${txtgrn} $0 브랜치이름 ${txtred}{ prod | dev }"
        echo -e "${txtylw}=======================================${txtrst}"
        exit
    fi
    
    ## ...
    
  • 반복적으로 동작하는 스크립트를 작성해봅니다.

    • github branch 변경이 있는 경우에 스크립트가 동작하도록 작성해봅니다.

    function check_df() {
      git fetch
      master=$(git rev-parse $BRANCH)
      remote=$(git rev-parse origin/$BRANCH)
    
      if [[ $master == $remote ]]; then
        echo -e "[$(date)] Nothing to do!!! 😫"
        exit 1
      fi
    }
  • crontab을 활용해봅니다.

    • 매 10분마다 동작하도록한 후 log를 확인해보세요.

    • crontab과 /etc/crontab의 차이에 대해 학습해봅니다.

    배포 스크립트의 흐름과 중단 구간
    배포 스크립트의 흐름과 중단 구간배포 스크립트(실행 2: 변경 있음) · cron · 매 10분 실행 · check_df · git fetch · rev-parse $BRANCH ≠ origin/$BRANCH · pull · git pull origin master · build · 주석 · ./gradlew clean build · 종료 · 주석 · pgrep -f java · kill -2 · 기동 · 주석 · nohup java -jar … & · 확인 · 실습 · curl http://localhost:8080 · 실선: 실행 코드 · 점선: 주석·실습 명령 · 실행 기록 · 상태 예시 · [실행 1] Nothing to do!!! · [실행 2] 변경 감지 · [실행 2] Pull Request · [실행 2] 프로세스 종료 · [실행 2] 새 프로세스 · 프로세스(실행 2 구간) · 기존 PID · 빈 구간 · 새 PID · 종료 → 빈 구간 → 기동 · 서비스 중단 발생. 종료 후 기동이라 중단 구간이 있습니다. 무중단 배포가 아닙니다.배포 스크립트(실행 2: 변경 있음)cron매 10분 실행check_dfgit fetch · rev-parse $BRANCH ≠origin/$BRANCHpullgit pull origin masterbuild · 주석./gradlew clean build종료 · 주석pgrep -f java · kill -2기동 · 주석nohup java -jar … &확인 · 실습curl http://localhost:8080실선: 실행 코드 · 점선: 주석·실습 명령실행 기록 · 상태 예시[실행 1] Nothing to do!!![실행 2] 변경 감지[실행 2] Pull Request[실행 2] 프로세스 종료[실행 2] 새 프로세스프로세스(실행 2 구간)기존 PID빈 구간새 PID종료 → 빈 구간 → 기동 · 서비스 중단 발생
    배포 스크립트의 흐름과 중단 구간배포 스크립트(실행 2: 변경 있음) · cron · 매 10분 실행 · check_df · git fetch · rev-parse $BRANCH ≠ origin/$BRANCH · pull · git pull origin master · build · 주석 · ./gradlew clean build · 종료 · 주석 · pgrep -f java · kill -2 · 기동 · 주석 · nohup java -jar … & · 확인 · 실습 · curl http://localhost:8080 · 실선: 실행 코드 · 점선: 주석·실습 명령 · 실행 기록 · 상태 예시 · [실행 1] Nothing to do!!! · [실행 2] 변경 감지 · [실행 2] Pull Request · [실행 2] 프로세스 종료 · [실행 2] 새 프로세스 · 프로세스(실행 2 구간) · 기존 PID · 빈 구간 · 새 PID · 종료 → 빈 구간 → 기동 · 서비스 중단 발생. 종료 후 기동이라 중단 구간이 있습니다. 무중단 배포가 아닙니다.배포 스크립트(실행 2: 변경 있음)cron매 10분 실행check_dfgit fetch · rev-parse$BRANCH ≠ origin/$BRANCHpullgit pull origin masterbuild · 주석./gradlew clean build종료 · 주석pgrep -f java · kill -2기동 · 주석nohup java -jar … &확인 · 실습curl http://localhost:8080실선: 실행 코드 · 점선: 주석·실습 명령실행 기록 · 상태 예시[실행 1] Nothing to do!!![실행 2] 변경 감지[실행 2] Pull Request[실행 2] 프로세스 종료[실행 2] 새 프로세스프로세스(실행 2 구간)기존 PID빈 구간새 PID종료 → 빈 구간 → 기동 · 서비스 중단 발생
    과정 보기

    1. cron이 실행할 때 변경이 없으면 "Nothing to do"로 끝냅니다.

    배포 스크립트의 흐름과 중단 구간 · 1배포 스크립트(실행 2: 변경 있음) · cron · 매 10분 실행 · check_df · git fetch · rev-parse $BRANCH ≠ origin/$BRANCH · pull · git pull origin master · build · 주석 · ./gradlew clean build · 종료 · 주석 · pgrep -f java · kill -2 · 기동 · 주석 · nohup java -jar … & · 확인 · 실습 · curl http://localhost:8080 · 실선: 실행 코드 · 점선: 주석·실습 명령 · 실행 기록 · 상태 예시 · [실행 1] Nothing to do!!! · 프로세스(실행 2 구간) · 기존 PID · 종료 → 빈 구간 → 기동 · 서비스 중단 발생. 같으면 "Nothing to do"로 끝냅니다.배포 스크립트(실행 2: 변경 있음)cron매 10분 실행check_dfgit fetch · rev-parse $BRANCH ≠origin/$BRANCHpullgit pull origin masterbuild · 주석./gradlew clean build종료 · 주석pgrep -f java · kill -2기동 · 주석nohup java -jar … &확인 · 실습curl http://localhost:8080실선: 실행 코드 · 점선: 주석·실습 명령실행 기록 · 상태 예시[실행 1] Nothing to do!!!프로세스(실행 2 구간)기존 PID종료 → 빈 구간 → 기동 · 서비스 중단 발생
    배포 스크립트의 흐름과 중단 구간 · 1배포 스크립트(실행 2: 변경 있음) · cron · 매 10분 실행 · check_df · git fetch · rev-parse $BRANCH ≠ origin/$BRANCH · pull · git pull origin master · build · 주석 · ./gradlew clean build · 종료 · 주석 · pgrep -f java · kill -2 · 기동 · 주석 · nohup java -jar … & · 확인 · 실습 · curl http://localhost:8080 · 실선: 실행 코드 · 점선: 주석·실습 명령 · 실행 기록 · 상태 예시 · [실행 1] Nothing to do!!! · 프로세스(실행 2 구간) · 기존 PID · 종료 → 빈 구간 → 기동 · 서비스 중단 발생. 같으면 "Nothing to do"로 끝냅니다.배포 스크립트(실행 2: 변경 있음)cron매 10분 실행check_dfgit fetch · rev-parse$BRANCH ≠ origin/$BRANCHpullgit pull origin masterbuild · 주석./gradlew clean build종료 · 주석pgrep -f java · kill -2기동 · 주석nohup java -jar … &확인 · 실습curl http://localhost:8080실선: 실행 코드 · 점선: 주석·실습 명령실행 기록 · 상태 예시[실행 1] Nothing to do!!!프로세스(실행 2 구간)기존 PID종료 → 빈 구간 → 기동 · 서비스 중단 발생

    2. 변경이 있으면 pull·빌드 뒤 기존 프로세스를 종료합니다. 새 프로세스가 뜰 때까지 응답할 프로세스가 없습니다.

    배포 스크립트의 흐름과 중단 구간 · 2배포 스크립트(실행 2: 변경 있음) · cron · 매 10분 실행 · check_df · git fetch · rev-parse $BRANCH ≠ origin/$BRANCH · pull · git pull origin master · build · 주석 · ./gradlew clean build · 종료 · 주석 · pgrep -f java · kill -2 · 기동 · 주석 · nohup java -jar … & · 확인 · 실습 · curl http://localhost:8080 · 실선: 실행 코드 · 점선: 주석·실습 명령 · 실행 기록 · 상태 예시 · [실행 1] Nothing to do!!! · [실행 2] 변경 감지 · [실행 2] Pull Request · [실행 2] 프로세스 종료 · 프로세스(실행 2 구간) · 기존 PID · 빈 구간 · 종료 → 빈 구간 → 기동 · 서비스 중단 발생. 기존 프로세스를 종료하면 새 프로세스가 뜰 때까지 응답할 프로세스가 없습니다.배포 스크립트(실행 2: 변경 있음)cron매 10분 실행check_dfgit fetch · rev-parse $BRANCH ≠origin/$BRANCHpullgit pull origin masterbuild · 주석./gradlew clean build종료 · 주석pgrep -f java · kill -2기동 · 주석nohup java -jar … &확인 · 실습curl http://localhost:8080실선: 실행 코드 · 점선: 주석·실습 명령실행 기록 · 상태 예시[실행 1] Nothing to do!!![실행 2] 변경 감지[실행 2] Pull Request[실행 2] 프로세스 종료프로세스(실행 2 구간)기존 PID빈 구간종료 → 빈 구간 → 기동 · 서비스 중단 발생
    배포 스크립트의 흐름과 중단 구간 · 2배포 스크립트(실행 2: 변경 있음) · cron · 매 10분 실행 · check_df · git fetch · rev-parse $BRANCH ≠ origin/$BRANCH · pull · git pull origin master · build · 주석 · ./gradlew clean build · 종료 · 주석 · pgrep -f java · kill -2 · 기동 · 주석 · nohup java -jar … & · 확인 · 실습 · curl http://localhost:8080 · 실선: 실행 코드 · 점선: 주석·실습 명령 · 실행 기록 · 상태 예시 · [실행 1] Nothing to do!!! · [실행 2] 변경 감지 · [실행 2] Pull Request · [실행 2] 프로세스 종료 · 프로세스(실행 2 구간) · 기존 PID · 빈 구간 · 종료 → 빈 구간 → 기동 · 서비스 중단 발생. 기존 프로세스를 종료하면 새 프로세스가 뜰 때까지 응답할 프로세스가 없습니다.배포 스크립트(실행 2: 변경 있음)cron매 10분 실행check_dfgit fetch · rev-parse$BRANCH ≠ origin/$BRANCHpullgit pull origin masterbuild · 주석./gradlew clean build종료 · 주석pgrep -f java · kill -2기동 · 주석nohup java -jar … &확인 · 실습curl http://localhost:8080실선: 실행 코드 · 점선: 주석·실습 명령실행 기록 · 상태 예시[실행 1] Nothing to do!!![실행 2] 변경 감지[실행 2] Pull Request[실행 2] 프로세스 종료프로세스(실행 2 구간)기존 PID빈 구간종료 → 빈 구간 → 기동 · 서비스 중단 발생

    3. 새 프로세스를 띄우고 curl localhost:8080으로 확인합니다. 무중단 배포가 아닙니다.

    배포 스크립트의 흐름과 중단 구간 · 3배포 스크립트(실행 2: 변경 있음) · cron · 매 10분 실행 · check_df · git fetch · rev-parse $BRANCH ≠ origin/$BRANCH · pull · git pull origin master · build · 주석 · ./gradlew clean build · 종료 · 주석 · pgrep -f java · kill -2 · 기동 · 주석 · nohup java -jar … & · 확인 · 실습 · curl http://localhost:8080 · 실선: 실행 코드 · 점선: 주석·실습 명령 · 실행 기록 · 상태 예시 · [실행 1] Nothing to do!!! · [실행 2] 변경 감지 · [실행 2] Pull Request · [실행 2] 프로세스 종료 · [실행 2] 새 프로세스 · 프로세스(실행 2 구간) · 기존 PID · 빈 구간 · 새 PID · 종료 → 빈 구간 → 기동 · 서비스 중단 발생. 종료 후 기동이라 중단 구간이 있습니다. 무중단 배포가 아닙니다.배포 스크립트(실행 2: 변경 있음)cron매 10분 실행check_dfgit fetch · rev-parse $BRANCH ≠origin/$BRANCHpullgit pull origin masterbuild · 주석./gradlew clean build종료 · 주석pgrep -f java · kill -2기동 · 주석nohup java -jar … &확인 · 실습curl http://localhost:8080실선: 실행 코드 · 점선: 주석·실습 명령실행 기록 · 상태 예시[실행 1] Nothing to do!!![실행 2] 변경 감지[실행 2] Pull Request[실행 2] 프로세스 종료[실행 2] 새 프로세스프로세스(실행 2 구간)기존 PID빈 구간새 PID종료 → 빈 구간 → 기동 · 서비스 중단 발생
    배포 스크립트의 흐름과 중단 구간 · 3배포 스크립트(실행 2: 변경 있음) · cron · 매 10분 실행 · check_df · git fetch · rev-parse $BRANCH ≠ origin/$BRANCH · pull · git pull origin master · build · 주석 · ./gradlew clean build · 종료 · 주석 · pgrep -f java · kill -2 · 기동 · 주석 · nohup java -jar … & · 확인 · 실습 · curl http://localhost:8080 · 실선: 실행 코드 · 점선: 주석·실습 명령 · 실행 기록 · 상태 예시 · [실행 1] Nothing to do!!! · [실행 2] 변경 감지 · [실행 2] Pull Request · [실행 2] 프로세스 종료 · [실행 2] 새 프로세스 · 프로세스(실행 2 구간) · 기존 PID · 빈 구간 · 새 PID · 종료 → 빈 구간 → 기동 · 서비스 중단 발생. 종료 후 기동이라 중단 구간이 있습니다. 무중단 배포가 아닙니다.배포 스크립트(실행 2: 변경 있음)cron매 10분 실행check_dfgit fetch · rev-parse$BRANCH ≠ origin/$BRANCHpullgit pull origin masterbuild · 주석./gradlew clean build종료 · 주석pgrep -f java · kill -2기동 · 주석nohup java -jar … &확인 · 실습curl http://localhost:8080실선: 실행 코드 · 점선: 주석·실습 명령실행 기록 · 상태 예시[실행 1] Nothing to do!!![실행 2] 변경 감지[실행 2] Pull Request[실행 2] 프로세스 종료[실행 2] 새 프로세스프로세스(실행 2 구간)기존 PID빈 구간새 PID종료 → 빈 구간 → 기동 · 서비스 중단 발생

6. 추가로 진행해볼만한 작업들

A. 설정 별도로 관리하기

  • 우선, github private 저장소를 생성한 후 application.properties 등의 설정 파일을 올립니다.

  • git의 서브모듈 기능을 활용하여 특정 경로에 private repository를 참조하도록 설정합니다

    • 이후에 소스코드를 받을 때는 서브모듈까지 clone해야 합니다.

    $ git submodule add [자신의 private 저장소] ./src/main/resources/config
    $ git clone --recurse-submodules [자신의 프로젝트 저장소]
  • 설정 파일의 내용이 변경된 경우

    $ git submodule foreach git pull origin main
    $ git submodule foreach git add .
    $ git submodule foreach git commit -m "commit message"
    $ git submodule foreach git push origin main

B. 로컬 테스트시 MultiRun 활용

  • 로컬에서 서버를 띄울 때, IntelliJ의 Multirun 플러그인을 활용하면 보다 손 쉽게 서버를 띄울 수 있습니다.

    • Multi Run 플러그인 설치

    • Multi Run 설정

      • IntelliJ -> Run -> Edit Configurations...

      • Docker 설정

      • NPM 설정

      • Multi Run 설정