[이채원] sprint8

[Chaewon3Lee]

요구사항

기본

애플리케이션 컨테이너화

Dockerfile 작성

• Amazon Corretto 17 이미지를 베이스 이미지로 사용하세요.
• 작업 디렉토리를 설정하세요. (/app)
• 프로젝트 파일을 컨테이너로 복사하세요. 단, 불필요한 파일은 .dockerignore를 활용해 제외하세요.
• Gradle Wrapper를 사용하여 애플리케이션을 빌드하세요.
• 80 포트를 노출하도록 설정하세요.
• 프로젝트 정보를 환경 변수로 설정하세요.
  • PROJECT_NAME: discodeit
  • PROJECT_VERSION: 1.2-M8
• JVM 옵션을 환경 변수로 설정하세요.
  • JVM_OPTS: 기본값은 빈 문자열로 정의
• 애플리케이션 실행 명령어를 설정하세요. 이때 환경변수로 정의한 프로젝트 정보를 활용하세요.

이미지 빌드 및 실행 테스트

• Docker 이미지를 빌드하고 태그(local)를 지정하세요.
• 빌드된 이미지를 활용해서 컨테이너를 실행하고 애플리케이션을 테스트하세요.
• prod 프로필로 실행하세요.
• 데이터베이스는 로컬 환경에서 구동 중인 PostgreSQL 서버를 활용하세요.
• http://localhost:8081로 접속 가능하도록 포트를 매핑하세요.

Docker Compose 구성

• 애플리케이션과 PostgreSQL 서비스를 포함하세요.
• 각 서비스에 필요한 모든 환경 변수를 설정하세요.
  • .env 파일을 활용하되, .env는 형상관리에서 제외하여 보안을 유지하세요.
• 애플리케이션 서비스를 로컬 Dockerfile에서 빌드하도록 구성하세요.
• 애플리케이션 볼륨을 구성하여 컨테이너가 재시작되어도 BinaryContentStorage 데이터가 유지되도록 하세요.
• PostgreSQL 볼륨을 구성하여 컨테이너가 재시작되어도 데이터가 유지되도록 하세요.
• PostgreSQL 서비스 실행 후 schema.sql이 자동으로 실행되도록 구성하세요.
• 서비스 간 의존성을 설정하세요(depends_on).
• 필요한 포트 매핑을 구성하세요.
• Docker Compose를 사용하여 서비스를 시작하고 테스트하세요.
  • --build 플래그를 사용하여 서비스 시작 전에 이미지를 빌드하도록 합니다.

BinaryContentStorage 고도화 (AWS S3) 체크리스트

AWS S3 버킷 구성

• AWS S3 버킷을 생성하세요.
• 버킷 이름을 discodeit-binary-content-storage-(사용자 이니셜) 형식으로 지정하세요.
• 퍼블릭 액세스 차단 설정을 활성화하세요(모든 퍼블릭 액세스 차단).
• 버전 관리는 비활성화 상태로 두세요.

AWS S3 접근을 위한 IAM 구성

• S3 버킷에 접근하기 위한 IAM 사용자(discodeit)를 생성하세요.
• AmazonS3FullAccess 권한을 할당하고, 사용자 생성을 완료하세요.
• 생성된 사용자에 엑세스 키를 생성하세요.
• 발급받은 키를 포함해서 AWS 관련 정보는 .env 파일에 추가합니다.

```env
AWS_S3_ACCESS_KEY=엑세스_키
AWS_S3_SECRET_KEY=시크릿_키
AWS_S3_REGION=ap-northeast-2
AWS_S3_BUCKET=버킷_이름
```

• 작성한 .env 파일은 리뷰를 위해 PR에 별도로 첨부해주세요. 단, 엑세스 키와 시크릿 키는 제외하세요.

AWS S3 테스트

• AWS S3 SDK 의존성을 추가하세요.

```groovy
implementation 'software.amazon.awssdk:s3:2.31.7'
```

• S3 API를 간단하게 테스트하세요.
  • 패키지명: `com.sprint.mission.discodeit.stoarge.s3`
  • 클래스명: `AWSS3Test`
• Properties 클래스를 활용해서 .env에 정의한 AWS 정보를 로드하세요.
• 작업 별 테스트 메소드를 작성하세요.
  • 업로드
  • 다운로드
  • PresignedUrl 생성

AWS S3를 활용한 BinaryContentStorage 고도화

• 앞서 작성한 테스트 메소드를 참고해 `S3BinaryContentStorage`를 구현하세요.
• `discodeit.storage.type` 값이 `s3`인 경우에만 Bean으로 등록되어야 합니다.
• `S3BinaryContentStorageTest`를 함께 작성하면서 구현하세요.
• BinaryContentStorage 설정을 유연하게 제어할 수 있도록 `application.yaml`을 수정하세요.

```yaml
discodeit:
storage:
type: ${STORAGE_TYPE:local} # local | s3 (기본값: local)
local:
root-path: ${STORAGE_LOCAL_ROOT_PATH:.discodeit/storage}
s3:
access-key: ${AWS_S3_ACCESS_KEY}
secret-key: ${AWS_S3_SECRET_KEY}
region: ${AWS_S3_REGION}
bucket: ${AWS_S3_BUCKET}
presigned-url-expiration: ${AWS_S3_PRESIGNED_URL_EXPIRATION:600} # 기본값 10분
```

• AWS 관련 정보는 형상관리하면 안되므로 `.env` 파일에 작성된 값을 임포트하는 방식으로 설정하세요.
• Docker Compose에서도 위 설정을 주입할 수 있도록 수정하세요.
• `download` 메소드는 PresignedUrl을 활용해 리다이렉트하는 방식으로 구현하세요.

AWS를 활용한 배포 (AWS RDS, ECR, ECS) 체크리스트

AWS RDS 구성

• AWS RDS PostgreSQL 인스턴스를 생성하세요.

항목	값	비고
데이터베이스 생성 방식	표준 생성
엔진 옵션 > 엔진 유형	PostgreSQL
엔진 옵션 > 엔진 버전	17.2-R2	기본값
템플릿	프리 티어	과금 주의
설정 > DB 인스턴스 식별자	discodeit-db
설정 > 자격증명설정 > 마스터 사용자 이름	postgres	기본값
설정 > 자격증명설정 > 자격 증명 관리	자체 관리	기본값
설정 > 자격증명설정 > 마스터 암호	임의의 값	따로 메모해두세요.
인스턴스 구성 > DB 인스턴스 클래스	db.t4g.micro	기본값
연결 > 퍼블릭 액세스	아니오	과금 주의
연결 > 추가구성 > 데이터베이스 포트	5432	기본값
모니터링 > 보존기간	7일	프리티어, 과금 주의
모니터링 > 추가 모니터링 설정	모두 체크 해제	기본값, 과금 주의
추가 구성 > 백업	체크 해제	과금 주의

• 과금이 발생할 수 있으니 다음 항목은 한번 더 확인해주세요.

  • 템플릿: 프리티어
  • 퍼블릭 액세스: 아니오
  • 모니터링 > 보존기간: 7일
  • 모니터링 > 추가 모니터링 설정: 모두 체크 해제
  • 추가 구성 > 백업: 비활성화

• SSH 터널링을 통해 개발 환경에서 접근할 수 있도록 EC2를 구성하세요.

• EC2 인스턴스를 생성하세요.

항목	값	비고
이름 및 태그	rds-ssh
인스턴스 유형	t2.micro	기본값, 과금 주의
키 페어	새 키 페어 생성	.pem 파일 저장 위치 기억
네트워크 설정 > 방화벽(보안그룹)	기존 보안 그룹 선택
이외 설정	기본값 유지

• 보안 그룹에서 인바운드 규칙을 편집하세요.

  • 유형: SSH, 소스: 내 IP

• DataGrip을 통해 연결 후 데이터베이스와 사용자, 테이블을 초기화하세요.

• 데이터 소스 추가 시 SSH/SSL > Use SSH tunnel 설정을 활성화하세요. 이때 이전에 다운로드한 .pem 파일을 활용하세요.

• 연결이 성공하면 데이터베이스와 사용자, 테이블을 초기화하세요.

-- 1. 새 유저 생성
CREATE USER discodeit_user WITH PASSWORD 'discodeit1234';

-- 2. 권한 부여
GRANT discodeit_user TO postgres;

-- 3. 데이터베이스 생성
CREATE DATABASE discodeit OWNER discodeit_user;

-- 4. schema.sql 실행하여 테이블 생성

• 구성이 완료되면 rds-ssh 인스턴스는 완전히 삭제하여 과금에 유의하세요.

AWS ECR 구성

• 퍼블릭 레포지토리(discodeit)를 생성하세요.
• AWS CLI를 설치하세요.
• aws configure 실행 후 앞서 생성한 discodeit IAM 사용자 정보를 입력하세요.

엑세스 키
시크릿 키
region: ap-northeast-2
output format: json

• discodeit IAM 사용자가 ECR에 접근할 수 있도록 권한 부여: AmazonElasticContainerRegistryPublicFullAccess
• Docker 클라이언트를 레지스트리에 인증

aws ecr-public get-login-password --region us-east-1 | docker login --username AWS --password-stdin public.ecr.aws/...

• 멀티플랫폼 이미지를 빌드하고 push 하세요.

  • 태그: latest, 1.2-M8
  • 플랫폼: linux/amd64, linux/arm64

• AWS 콘솔에서 푸시된 이미지 확인

AWS ECS 구성

• 배포 환경에서 컨테이너 실행에 사용할 환경 변수 파일 작성하고 S3에 업로드하세요.
• discodeit.env 파일을 만들어 다음의 내용을 작성하세요.

# Spring Configuration
SPRING_PROFILES_ACTIVE=prod

# Application Configuration
STORAGE_TYPE=s3
AWS_S3_ACCESS_KEY=엑세스_키
AWS_S3_SECRET_KEY=시크릿_키
AWS_S3_REGION=ap-northeast-2
AWS_S3_BUCKET=버킷_이름
AWS_S3_PRESIGNED_URL_EXPIRATION=600

# DataSource Configuration
RDS_ENDPOINT=RDS_엔드포인트(포트 포함)
SPRING_DATASOURCE_URL=jdbc:postgresql://${RDS_ENDPOINT}/discodeit
SPRING_DATASOURCE_USERNAME=RDS_유저네임
SPRING_DATASOURCE_PASSWORD=RDS_비밀번호

# JVM Configuration
JVM_OPTS="-Xmx384m -Xms256m -XX:MaxMetaspaceSize=64m -XX:+UseSerialGC"

• 이 파일을 S3에 업로드하세요.
• 이 파일은 형상관리되지 않도록 주의하세요.
• AWS ECS 클러스터를 생성하세요.

항목	값	비고
클러스터 이름	discodeit-cluster
인프라	EC2 인스턴스	Fargate 체크해제
인스턴스 유형	t2.micro	과금 주의
원하는 용량	최소 0, 최대 1	과금 주의
SSH 키 페어	새 키 페어 생성

• 태스크를 정의하세요.

항목	값	비고
태스크 정의 패밀리	discodeit-task
시작 유형	EC2	Fargate 해제
네트워크 모드	bridge
태스크 크기	CPU: 0.25 vCPU, 메모리: 0.5 GB
컨테이너 이름	discodeit-app
이미지 URI	배포한 이미지
포트 매핑	호스트 80 / 컨테이너 80
리소스 제한	CPU 0.25, 메모리 0.5GB 하드, 0.25GB 소프트
환경 변수	S3의 discodeit.env

• 태스크 생성 후 태스크 실행 역할에 S3 관련 권한을 추가하세요.
• discodeit 클러스터 상세 화면에서 서비스를 생성하세요.

항목	값	비고
태스크 정의	discodeit-task
서비스 이름	discodeit-service
원하는 태스크	1
상태 검사 유예 기간	30초

• 태스크의 EC2 보안 그룹의 인바운드 규칙을 설정하여 어디서든 접근할 수 있도록 하세요.

• EC2 보안 그룹에서 인바운드 규칙을 편집하세요.

• 규칙 유형으로 HTTP를 선택하세요.

• Anywhere-IPv4를 선택하여 모든 IP를 허용하세요.

• 태스크 실행이 완료되면 해당 EC2의 퍼블릭 IP에 접속해보세요.

심화

이미지 최적화 및 GitHub Actions CI/CD 파이프라인 구축 체크리스트

이미지 최적화하기

• 멀티 스테이지(빌드, 런타임) 빌드를 활용해 이미지의 크기를 줄여보세요.
  • 태그명: local-slim
  • 이전에 빌드한 이미지(1.2-M8 또는 local)와 크기를 비교해보세요.
• 이미지 레이어 캐시를 고려해 Dockerfile을 수정해보세요.

GitHub Actions를 활용한 CI/CD 파이프라인 구축

CI (지속적 통합)

• CI 워크플로우를 설정하세요.
• .github/workflows/test.yml 파일을 생성하세요.
• main 브랜치에 PR이 생성되면 실행되도록 설정하세요.
• 테스트를 실행하는 Job을 정의하세요.
• CodeCov를 통해 테스트 커버리지 뱃지를 README에 추가해보세요.

CD (지속적 배포)

• CD 워크플로우를 설정하세요.

• .github/workflows/deploy.yml 파일을 생성하세요.

• release 브랜치에 코드가 푸시되면 실행되도록 설정하세요.

• AWS 정보 설정

• GitHub 레포지토리 설정을 통해 시크릿을 추가하세요.

  • AWS_ACCESS_KEY: IAM 사용자의 액세스 키
  • AWS_SECRET_KEY: IAM 사용자의 시크릿 키

• GitHub 레포지토리 설정을 통해 변수를 추가하세요.

  • AWS_REGION: AWS 리전(ap-northeast-2)
  • ECR_REPOSITORY_URI: ECR 레포지토리 URI
  • ECS_CLUSTER: ECS 클러스터 이름(discodeit-cluster)
  • ECS_SERVICE: ECS 서비스 이름(discodeit-service)
  • ECS_TASK_DEFINITION: ECS 태스크 정의 이름(discodeit-task)

Docker 이미지 빌드 및 푸시

• Docker 이미지를 빌드하고 푸시하는 Job을 정의하세요.
• AWS CLI를 설정하는 Step을 추가하세요. (Public ECR 배포용 리전: us-east-1)
• ECR 로그인 Step을 추가하세요. (Public ECR 로그인)
• Docker 이미지 빌드 및 푸시 과정을 Step으로 추가하세요.
  • 멀티 플랫폼 옵션은 제외
  • GitHub Actions 런타임 OS와 ECS는 x86_64
• 이미지 태그는 latest와 GitHub 커밋 해시를 사용하도록 설정하세요.

ECS 서비스 업데이트

• ECS 서비스를 업데이트하는 Job을 정의하세요.
• AWS CLI를 설정하는 Step을 추가하세요. (리전: AWS_REGION)
• 태스크 정의를 업데이트하는 Step을 추가하세요.
  • 기존 태스크 정의를 기반으로 새 이미지를 사용하도록 업데이트
• 프리티어 리소스를 고려해 기존 서비스 중단 Step 추가 (aws ecs update-service --desired-count)
• 새로 등록한 태스크 정의를 사용하도록 ECS 서비스를 업데이트하는 Step을 추가하세요.
• AWS 콘솔을 통해 새로 등록된 태스크 정의로 배포되었는지 확인하세요.

주요 변경사항

. 원활한 실습 진행을 위해 Spring Boot Admin 관련 코드는 삭제되었습니다.
세부 사항
admin 모듈

IntelliJ Gradle 툴 윈도우에서도 삭제해주세요.

yfdejqkdz-image.png

spring boot admin 의존성 삭제

build.gradle

...
implementation 'de.codecentric:spring-boot-admin-starter-client:3.4.5'
...
2. 프로젝트 버전이 변경되었습니다. v1.2-M8
세부 사항

build.gradle

...
version = '0.0.1-SNAPSHOT'
version = '1.2-M8'
...
1.2: api-doc 버전을 따릅니다.
M8: 미션 8을 의미합니다.

스크린샷

리뷰를 위해 PR에 포함해야 할 정보 체크리스트

원활한 리뷰를 위해 PR에 다음과 같은 정보를 포함해주세요.

• .env 파일 (AWS 키는 제외)
  제출용.txt

RDS

rds콘솔캡쳐.pdf

ECR

• 푸시된 이미지가 보이는 AWS 콘솔 페이지 스크린샷 이미지
  

ECS

• 실행 중인 태스크 구성정보가 표시된 AWS 콘솔 페이지 스크린샷 이미지
• 배포된 EC2 엔드포인트
  
  http://3.38.153.169/

VPC

• 보안 그룹의 인바운드 규칙을 확인할 수 있는 AWS 콘솔 페이지 스크린샷 이미지

IAM

• 사용자의 권한 정책이 표시된 AWS 콘솔 페이지 스크린샷 이미지
  

멘토에게

• 셀프 코드 리뷰를 통해 질문 이어가겠습니다.