AWS를 이용한 서버 배포 자동화 파이프라인 구축하기, EC2 기본 세팅부터, AWS로 서버 배포

 

✔️EC2 기본 세팅

 

1. 우선 EC2 인스턴스를 생성한다. 

연결 누르기

$ bash
$ cd ~

2. 인스턴스에 개발 환경 구축하기

$ sudo apt update

패키지 매니저가 관리하는 패키지의 정보를 최신 상태로 업데이트하기 위한 명령어

 

 

3. nvm, npm을 설치하여 개발 환경을 구축하기

 

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

touch ~/.zshrc

export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm

 

👇 설치안되면 아래 사이트참고하기 👇

 

https://github.com/nvm-sh/nvm

GitHub - nvm-sh/nvm: Node Version Manager - POSIX-compliant bash script to manage multiple active node.js versions

 

4. 설치 다 되었는지 확인 하려면 nvm 버전 물어보기

nvm --version

 

5. node.js 설치하기

$ nvm install node

 

$ sudo apt install npm

npm 명령어가 정상적으로 입력되지 않는 상황을 방지하기 위한 명령어.

 

 

🎉 위 과정까지 마쳤다면 AWS에서 개발할 수 있는 환경 세팅은 어느정도 마쳤다. 🎉 

---

✔️ 파이프라인 구축 전에 EC2 인스턴스 세팅하기

1. 생성되어 있는 EC2 인스턴스에 태그 부여하기.

태그를 추가하는 이유는 파이프라인 구축 단계에서 인스턴스를 잘 식별하기 위함이다. 

 

EC2 - 인스턴스 - 인스턴스 선택 후 [작업] - [인스턴스 설정] - [태그 관리] - [태그 추가 버튼] => 키와 값 자유롭게 이름 설정 가능

 

2. 생성되어 있는 EC2 인스턴스에 역할 부여하기. (IAM 서비스 이용)

역할(role)은 AWS의 개체 (서비스, 사용자 등)가 다른 서비스에 접근하게 할 수 있도록 해주는 방법이다. 

EC2 - 인스턴스 - 인스턴스 선택 후 [작업] - [보안] - [IAM 역할 수정] - [새 IAM 역할 생성] - [역할 만들기] - [AWS 서비스, EC2 선택하기] - [다음: 권한 버튼] - [ AmazonS3FullAccess, AmazonSSMFullAccess, AWSCodeDeployRole 선택하기 ] - [다음: 태그 버튼] - [다음 : 검토] - [ 역할에 임의의 이름 입력] -[ 역할 만들기 버튼 ]

 

3. 추가적으로 설정하기

[생성한 역할 (role) 클릭] - [신뢰관계 클릭] => (신뢰관계는 해당 역할을 취할 수 있는 서비스나 사용자를 명시하는 부분)

[신뢰관계 편집의 service 값 수정하기] 👇

"Service":["ec2.amazonaws.com", "codedeploy.ap-northeast-2.amazonaws.com"]

 

4. EC2 인스턴스에 생성한 역할 적용해주기

인스턴스 선택 후 [작업] - [보안] - [IAM 역할 수정] - [만들어놓은 역할 클릭] - [저장]

 

=> 이제 EC2는 S3, CodeDeploy, SSM 서비스에 접근 가능!

 

5. EC2 인스턴스가 적절한 보안 그룹 가지고 있는지 확인하기

[해당 인스턴스 클릭] - [보안 탭] - [보안 그룹 클릭] - [인바운드 규칙에 80, 443 포트 있는지 확인]

=> 80번 포트는 서버 배포를 위해 필요하고, 443포트는 CodeDeploy-Agent의 정상적인 작동을 위해 필요하다. 

 

🤔인바운드 규칙에 80, 443 포트없는 경우

[인바운드 규칙 편집 버튼 클릭] - HTTP, HTTPS 유형을 '위치 무관' 또는 '사용자지정' 으로 설정하고 [규칙 저장 클릭]

 

 

---

✔️ 서버 코드의 배포 과정을 자동으로 진행하는 파이프라인 구축하는 방법

1. 배포할 폴더를 vscode로 킨다. (로컬환경에서!)

레포지토리 최상위에 appspec.yml 파일을 추가힌다. 

( ➥ appspec.yml 은 배포 자동화를 도와주는 CodeDeploy-Agent가 인식하는 파일이다. )

appspec.yml 

version: 0.0
os: linux
files:
  - source: /
# 아래 destination은 해당 레포지토리를 클론한 위치로 설정한다. (코드에서 pwd 명령어 활용하기)
    destination: ~/파일명까지

hooks:
  ApplicationStop:
    - location: scripts/stop.sh
      runas: root
  AfterInstall:
    - location: scripts/initialize.sh
      runas: root
  ApplicationStart:
    - location: scripts/start.sh
      runas: root

 

 

2. 최상위에 scripts 디렉토리(폴더)를 생성한 후, 그 안에 initialize.sh, start.sh, stop.sh 파일 3개를 생성한다. 

( ➥ 각 파일은 appspec.yml 파일이 구성하고 있는 배포 수명 주기에 따라 실행된다. )

 

scripts/initialize.sh

#!/bin/bash
# 아래 위치는 해당 리포지토리를 클론한 위치로 설정한다. (pwd 활용)
cd ~/폴더명/server 파일까지
npm install
npm install pm2@latest -g
sudo apt-get update
sudo apt-get install authbind
sudo touch /etc/authbind/byport/80
sudo chown ubuntu /etc/authbind/byport/80
sudo chmod 755 /etc/authbind/byport/80

scripts/start.sh

 

#!/bin/bash
# 아래 위치는 리포지토리를 클론한 위치로 설정.
cd ~/폴더명/server 파일까지
authbind --deep pm2 start app.js

scripts/stop.sh

#!/bin/bash
# 아래 위치는 리포지토리를 클론한 위치로 설정.
cd ~/폴더명/server 파일까지
pm2 stop app.js 2> /dev/null || true
pm2 delete app.js 2> /dev/null || true

 

3. 모든 변경 사항 저장하고 git add / commit / push 하기

 

4. AWS CodeDeploy 세팅하기1

[AWS CodeDeploy 대시보드] - [애플리케이션] - [애플리케이션 생성] - [애플리케이션 이름은 임의로 설정, 컴퓨팅 플랫폼은 'EC2/온프레미스' 로 생성] - [애플리케이션 생성 버튼]

 

5. AWS CodeDeploy 세팅하기2

[생성한 애플리케이션 배포 그룹 탭] - [배포 그룹 생성 버튼 클릭] - [배포 그룹 이름은 임의로 설정, 서비스 역할 영역은 앞서 만들어 놓은  역할 role 선택] - [환경구성에서 'Amazon EC2 인스턴스'를 선택, 태그 그룹에는 EC2 인스턴스에 설정해둔 태그 키와 값 선택] - [로드 밸런싱 활성화 체크 해제하기] - [배포 그룹 생성 버튼 클릭]

 

6. 서버 배포 자동화 파이프라인 구축하기

🍪[CodePipeline] - [파이프라인 생성 버튼클릭] - [파이프라인 이름 임의로 입력] - [다음 버튼 클릭]

🍪- [소스 스테이지에서 배포할 레파지토리가 github에 저장되어 있는지 확인 후, 소스 공급자를 Github(버전2) 선택] - [다음 버튼 클릭] - [Github에 연결 버튼] - [연결 이름 선택] -  [Github에 연결 버튼 클릭] - [새 앱 설치 버튼 클릭] - [본인 깃헙 계정 선택] - [깃헛에 로그인 후 'Only select repositories'를 선택, 소스 코드로 이용할 리포지토리를 선택하고 [ Save ] 버튼 클릭] - [연결 버튼 클릭] - [레포지토리 이름은 방금 연결한 레포지토리 명과 같게 지정, 브랜치는 master나 main, 출력 아티팩트 형식은 'CodePipeline 기본값'] - [다음 버튼 클릭]

🍪- [빌드 스테이지] => 코드 컴파일 빌드 과정 및 테스트 코드가 있다면 이부분은 설정해야한다. 없으면  건너뛰기  - [다음 버튼 클릭]

🍪- [배포 스테이지] -[ 배포 공급자는 'AWS CodeDeploy' 선택, 리전은 서울, 애플리케이션 이름은 생성해 둔 애플리케이션 이름 선택, 배포 그룹은 생성해둔 배포 그룹 선택]

🍪- 배포 기다리기

 

 

---

처음에는 1분도 안되서 아래 사진처럼 성공 메세지가 떠서 좋아했다. 

그런데 install 에서 배포 실패가 되었다. 

 

✔️ 배포 실패하는 경우 해결방법

로그를 찾아보자!

CodeDeploy-Agent는 파이프라인 실행 때마다 로그를 해당 EC2 instance에 저장한다.

 

👇 아래 명령어로 로그 파일이 저장된 경로로 이동하기 👇

 'cd /opt/codedeploy-agent/deployment-root/deployment-logs'

ls 로 어떤 파일 존재하는지 확인하기

ls

해당 파일 nano로 파일 열기

nano 파일명

 

---

✔️ 배포 해결

appspec.yml, initialize.sh, start.sh, stop.sh 파일 안의 위치를 잘 설정하자.

pwd 명령어로 위치를 확인할 수 있다.

또는 /opt - 추가적인 (optional) 프로그램들의 설치 경로

 

---

✔️ AWS EC2 터미널 세션이 종료된다면??

 

$ bash
$ cd ~

$ sudo apt update

 

---

 

 

추가 공부해보기

linux의 standard stream

linux의 tail, head, grep과 같은 터미널 명령어

 

)

https://help.ubuntu.com/kubuntu/desktopguide/ko/directories-file-systems.html

디렉토리와 파일 시스템

https://velog.io/@wngud4950/AWS-EC2-CodeDeploy-Appspec.yml%EC%97%90-%EB%8C%80%ED%95%98%EC%97%AC

[AWS] EC2-CodeDeploy Appspec.yml에 대하여

 

 

😃 잘못된 개념 전달이 있다면 댓글 부탁드립니다. 저의 성장에 큰 도움이 됩니다🤓