[Project/4th] 4. 테스트 서버 인프라 구축 - SSH 접속, Docker로 수동배포

[프로젝트 일지] 4번째 프로젝트 - 1. 서버 설계하기

[프로젝트 일지] 4번째 프로젝트 - 2. 스프링 프로젝트 생성, 개발환경 구성

[프로젝트 일지] 4번째 프로젝트 - 3. JPA Entity 관계 설정하기

 

 

 

 

저번주에 진행했던 일이지만, 뒤늦게 작성을 한다. 그동안 진행한 게 많은데 밀렸다🥲

 

 

 

 

 현재 백엔드 서버에서 API 개발이 조금씩 진행되고 있다. 프론트엔드와의 API 연결 테스트를 위해 테스트 서버를 따로 배포할 필요가 있었다. 실제 서비스는 EC2에서 배포하기로 했지만, 아직 출시 전이라 서버를 구매하지 않았다. 그리고 테스트 서버는 5월까지 개발하는 동안 잠깐 쓸 거라서 다른 팀원의 GCP 1년 무료 서비스로 구동하기로 했다.

 

 팀에 인프라를 전담하는 사람이 없다면, 백엔드에서 인프라도 같이 하게 되는 것 같다. 이전에 싸피 프로젝트에서 인프라를 담당했던 경험이 도움이 되는 것 같다. (고생하면서 배우는 인프라..)

 

 

 

 

 

 

아키텍처

---

테스트 서버 아키텍처

 

 

 

 

 

프로젝트 환경

---

로컬 개발 환경

• OS : MAC OS(M2)
• IDE : IntelliJ IDEA 2023.3.5 (Ultimate Edition) 
• Server : Amazon corretto 17.0.10, Spring Boot 3.2.4
• DB : MySQL 8.0.36
• Deploy : Docker 25.0.3, Dockerhub
• Git : Github

 

클라우드 개발 환경

• Server : Google Cloud Platporm
• OS : Ubuntu 20.04.6 LTS
• Deploy : Docker 26.0.0, Dockerhub
• DB : MySQL Latest

 

 

 

 

 

GCP 인스턴스 접속하기, ssh 개발 환경 세팅

---

팀원이 생성한 GCP 프로젝트에 공유 권한을 받았고, 내 로컬 컴퓨터에서 GCP 인스턴스에 접속을 해야 했다.

ssh 접속을 하기 위해 키를 등록하고, ssh 접속을 위한 Termius 세팅을 했다.

 

 

 

키 생성해서 GCP에 공개키 등록하기

 GCP ssh 접속을 하기 위해서는 키(개인키, 공개키)를 생성하고, 공개키를 GCP VM 인스턴스에 등록을 해야 한다.

 

 

개인키와 공개키는 내 컴퓨터에서 `ssh-keygen -C [이름]` 으로 생성할 수 있었다. 

키 생성

 

 

그리고 생성된 공개키(`id_rsa.pub`)를 복사하여 GCP에 등록을 해줬다.

공개키 파일 확인

 

 

ssh 키 등록

 

 

 

 

 

 

Termius로 SSH 원격 접속

 기본 터미널로 ssh 접속을 할 수 있지만, 매번 명령어 입력하고 비번 입력해서 접속하는 것이 귀찮다.

Termius는 ssh 원격 접속 플랫폼인데, 서버 host랑 키 등록만 해주면 클릭 한 번만으로 쉽게 접속을 할 수 있다. 그리고 SFTP도 제공하여 내 로컬 컴퓨터에 있는 파일도 쉽게 이동시킬 수 있다. + UI까지 좋음

 

 

개인 키 등록하기

 

Termius에서 접속을 하기 위해서는 개인키를 등록해야 한다. 키 생성한 폴더에서 `cat ~/.ssh/id_rsa`로 알아낼 수 있었다.

 

 

Termius로 접속

 

 

 

 

 

도커 설치 및 DB 설치

---

 

 

 

 

 

도커로 서버 배포하기

---

 

 CI/CD를 구성하는 것이 리소스가 드는 일이기 때문에 시간이 나면 나중에 구축하기로 하고, 일단 수동 배포를 하기로 했다.

이전에 Docker로 수동배포를 해본적이 있어서 금방 할 줄 알았으나.. 달라진 개발 환경(MAC OS😇) 때문에 애를 먹었다.

 

 결과적으로 CI/CD를 빨리 도입해야 겠다고 생각했다. 변경 사항이 생길 때마다 매번 수동으로 배포하려니 귀찮다.

 

 이전에 GitLab에 Jenkins를 이용해서 CI/CD를 구축해본적이 있다. 하지만 Github은 Github Action을 많이 쓴다고 해서 이걸 배워서 적용해야 하나 생각중이다.

 

 

 

수동 배포 과정

• 로컬에서 프로젝트 빌드하기

./gradlew build

 

 

 

• 로컬에서 도커 이미지 빌드

docker build. -t [docker계정명]/[프로젝트명] .

 

 

나중에 `docker run` 할 때, 에러가 났다.

 

The requested image's platform (linux/arm64/v8) does not match the detected host platform (linux/amd64/v3) and no specific platform was requested ...

 

 

문제 해결 참고 : [Docker] 이미지 빌드 플랫폼 호환성 관련 에러 (linux/amd64)

 

 도커 이미지를 빌드하는 데 호환성 문제가 발생한다고 한다. 맥북 M 계열 칩이 Arm64 아키텍처라서 호환성을 위해 도커 이미지도 같은 아키텍처로 빌드를 해줘야 한다.

 

(맥북 덕분에(?) 다양한 호환성 에러를 만나며 CPU에 대해 공부하게 되는 것 같다)

 

 

docker build --platform linux/amd64 -t [docker계정명]/[프로젝트명] .

 

`--platform linux/amd64` 옵션을 추가로 줬다.

 

 

 

• 로컬에서 Docker Hub에 이미지 업로드

docker push [docker계정명]/[프로젝트명]

 

 

 

• 서버에서 도커 이미지 가져오기

docker pull [docker계정명]/[프로젝트명]

 

 

 

• 도커 이미지 실행

docker run --name [컨테이너이름] -d -p [포트번호]:[포트번호] [docker계정명]/[프로젝트 이름]