☘ ANONI Chat - infra setup
초기 인프라 셋팅
Spring Boot init
- 스프링 이니셜라이저를 사용하여 java기반의 SpringBoot서버 초기 셋팅
Vultr
보안과 확장성을 고려하여 Cloud 서버를 구축하고자 Vultr를 선택하였다.
그 중 Vultr를 선택한 이유는,
- 성능 대비 가격 효율성
- AWS, Azure 등 대형 클라우드 서비스보다 저렴하면서, 높은 성능의 인스턴스를 제공한다.
- 다양한 인스턴스 옵션
- 공유 CPU / Cloud GPU 등 다양한 유형의 인스턴스를 지원한다.
- 유연한 요금제와 과금
- Vultr는 시간 단위로, 사용한 만큼 실시간으로 과금된다.
- 또한, 포인트를 먼저 결제하고, 그 포인트에서 차감되는 방식으로 초과 과금을 방지하고, 예상하기도 쉽다.
Vultr Cloude 셋팅
- 서비스 완성 이전까지 월 5달러 스펙의 인스턴스를 띄워놓을 계획이다.
- 추후, 언제나 server스펙을 업그레이드 할 수 있기 때문이다.
- Main ServerOS로는 linux Ubuntu를 선택하였다.
Vultr 인스턴스 생성후, console에서 최소사양으로 ubuntu desktop을 설지하겠다.
ubuntu 초기 셋팅
sudo apt-get update ( apt-get 도구 업데이트 )
sudo apt-get upgrade ( apt-get 도구 업그레이드 )
gui를 설치하기 전에 apt-get 도구를 update와 upgrade를 진행한다.
ubuntu-desktop 패키지 설치
sudo apt-get install --no-install-recommends ubuntu-desktop ( 최소 설치 )
sudo apt-get install ubuntu-desktop ( 전체 설치 )
- 여타 desktop버전의 프로그램들 ex) 인터넷 브라우저 등 을 설치할 계획이라면, 전체 설치를 하면되고,
DB, jenkins 등 서버용 셋팅만을 원하면 최소 설치를 하기를 권장한다.
gui 설치 후 추가 패키지 설치
sudo apt-get install indicator-appmenu-tools ( hud service not connected 오류 해결 )
sudo apt-get install indicator-session ( 계정, 세션 아이콘 추가 )
sudo apt-get install indicator-datetime ( 상단 메뉴 시간 추가 )
sudo apt-get install indicator-applet-complete ( 볼륨 조절 아이콘 추가 )
- gui 패키지 설치 후 발생할 수 있는
hud service not connected오류와 관련하여 indicator-appmenu-tools 패키지를 통해 해결할 수 있다. - 나머지 패키지는 사용자의 입장에서 직관적인 편의성을 위한 패지키로써 선택사항입니다.
gui 환경 실행
startx ( xwindow 환경 실행 )
sudo systemctl isolate graphical.target ( runlevel 5 일회성 실행 / init 실행 )
sudo systemctl enable graphical.target ( runlevel 5 영구히 실행 / 활성 )
sudo systemctl set-default graphical.target ( runlevel 5 영구히 실행 / inittab 수정 )
- CLI에 startx 명령어를 입력하면 xwindow 환경이 실행이 되면서 gui 환경으로 전환이 된다.
startx명령어 없이 영구히 적용하기 위해 위 명령어를 입력하면 된다.
우분투의 runlevel
0 : poweroff.target
1 : rescue.target
2, 3, 4 : multi-user.target ( CLI 환경 )
5 : graphical.target ( GUI 환경 )
6 : reboot.target
Docker 설정
# 1. 베이스 이미지 (명시적으로 22.04)
FROM ubuntu:22.04
# 2. 작성자 정보
LABEL maintainer="xotjd794613@naver.com"
# 3. 환경변수 설정 (비인터랙티브 설치)
ENV DEBIAN_FRONTEND=noninteractive
# 4. 패키지 업데이트 및 JDK 17 설치
RUN apt-get update && \
apt-get install -y openjdk-17-jdk curl && \
apt-get clean && rm -rf /var/lib/apt/lists/*
# 5. 작업 디렉토리 설정
WORKDIR /app
# 6. 실행할 jar 파일 복사 (빌드된 .jar)
COPY ./build/libs/AnoniChat-0.0.1-SNAPSHOT.jar /app/AnoniChatApp.jar
# 7. 포트 노출 (SpringBoot default: 8080)
EXPOSE 8080
# 8. 기본 실행 명령
ENTRYPOINT ["java", "-jar", "/app/AnoniChatApp.jar"]
- Spring 프로젝트의 Gradle 빌드 후
.jar파일의 위치를 기준으로 docker파일을 작성해주었다.
이슈
다음과 같은 디렉토리 상황에서
경로를 찾을 수 없는 오류가 발생하였다.
C:\Users\User\Desktop\AnoniChat\
├── App\
│ ├── Dockerfile
│ └── build\
│ └── libs\
│ └── AnoniChat-0.0.1-SNAPSHOT.jar
원인이 무엇일까?
.dockerignore 파일
.gradle
build
target
*.iml
*.log
.DS_Store
.git
- 이그노어 파일에 build를 추가시켜놓고도 모르고있었다..
문제 해결 후
- gradle빌드 후 도커 이미지파일 생성
gradlew bootJar
docker build -t anonichat .
docker image 생성 완료.
- build : .(현재 디렉토리)를 기준으로 빌드하여 이미지 생성
- tag : 현재 anonichat이미지에 태그를 붙여 복사
docker build -t xotjd794613/anonichat:v0.02 .
docker tag anonichat xotjd794613/anonichat:v0.02
docker push "계정명"/anonichat-app:latest
- 이미지 생성후 UBUNTU서버에서
- docker 다운로드
- docker 로그인
- image pull 받기
curl -fsSL https://get.docker.com | sh
docker login
sudo docker pull [image이름]:[태그]
실행
sudo docker run -p 8000:8080 "계정명"/anonichat:latest
+ Docker(컨테이너)를 적용하여 얻는 이득이 뭘까?
1. 배포 환경 통일성
이전 방식:
- 개발자는 로컬에서
.jar로 실행 - 서버는 Ubuntu, 다른 Java 버전, 설정 다를 수 있음 → "로컬에선 되는데 서버에선 안 돼"
Docker 도입 후:
Dockerfile에 명시된 Java 버전, 종속성, 실행 방식이 모두 이미지에 포함- 개발/운영 환경 차이가 없음
→ "로컬에선 되는데 서버에선 안 돼" 문제가 사라짐
2. CI/CD 파이프라인 단순화
과거 방식:
.jar파일을 빌드하고 → 서버에 복사하고 → 수동으로 백업 & 재실행
Docker 도입 후:
- Jenkins에서
docker build→docker push→ 서버에서docker pull && restart - 단일 명령으로 배포 자동화됨
3. 버전 관리 / 롤백 가능
docker run xotjd794613/anonichat:v0.02 docker run xotjd794613/anonichat:v0.01
→ 이전 버전으로 즉시 롤백 가능
과거 방식은 .jar 백업/복원 과정이 필요했음
Docker는 이미지 자체가 버전 단위 배포본
4. 의존성 없는 실행 가능
- 서버에 JDK 없어도 됨
- Gradle, Maven, OpenJDK, Node 등 포함해서 독립 실행 가능
- Java + Redis + Nginx 등 멀티 컨테이너 서비스화도 가능
→ 서버는 단지 "Docker 런타임"만 제공하면 됨
5. 운영 서버 리스크 감소
- 시스템에 직접 설치하는 것이 아님 → 호스트 오염 없음
- 서버를 초기화하거나 다른 서버로 옮겨도 → Docker만 깔고 이미지 pull
→ 서버 관리와 인프라 유지 부담 최소화
Table Of Contents