# 관련링크 - [재생목록](https://www.youtube.com/playlist?list=PLMzNIYZSiq7b4cONNHK7Gs7ubtU27bPBu) - [리포지터리 - s3](https://github.com/sik2/terraform-s3) - [AWS - 테라폼 기초](https://www.slog.gg/p/13930) # 강의 # 1강 - [25 02 05, p 14003, 1강, S3, 버킷 개요](https://youtu.be/12MvMasDfSI) # 2강 - [25 02 05, p 14003, 2강, aws cli 로 s3 실습](https://youtu.be/uAQr40kFDWI) ## AWS CLI 명령어 - aws configure list - aws configure ## S3 실습 - aws s3 ls - 결과 없음 - aws s3 mb s3://bucket-name - 버킷이름은 유니크 해야함 - 버킷 생성됨, 기본적으로 ap-northeast-2 에 생성됨 - aws s3 ls - 결과 있음 - aws s3 rb s3://bucket-name --force - 버킷 삭제됨 - aws s3 ls - 결과 없음 # 3강 - [25 02 05, p 14003, 3강, aws cloud shell에서 aws cli 명령어 수행](https://youtu.be/gMIpKCsYaro) # 4강 - [25 02 06, p 14003, 4강, 테라폼 프로젝트 생성, ec2 인스턴스 1개 생성](https://youtu.be/Hx-rBFM4SBM) - [리포지터리](https://github.com/sik2/terraform-s3) - [GIT](https://github.com/sik2/terraform-s3/commit/8a9c4bcc) ## variables.tf ```hcl variable "prefix" { description = "Prefix for all resources" default = "dev" } variable "region" { description = "region" default = "ap-northeast-2" } variable "nickname" { description = "nickname" default = "sik2" } ``` ## main.tf ```hcl terraform { // aws 라이브러리 불러옴 required_providers { aws = { source = "hashicorp/aws" version = "~> 4.0" } } } # AWS 설정 시작 provider "aws" { region = var.region } # AWS 설정 끝 # VPC 설정 시작 resource "aws_vpc" "vpc_1" { cidr_block = "10.0.0.0/16" # 무조건 켜세요. enable_dns_support = true # 무조건 켜세요. enable_dns_hostnames = true tags = { Name = "${var.prefix}-vpc-1" } } resource "aws_subnet" "subnet_1" { vpc_id = aws_vpc.vpc_1.id cidr_block = "10.0.1.0/24" availability_zone = "${var.region}a" map_public_ip_on_launch = true tags = { Name = "${var.prefix}-subnet-1" } } resource "aws_subnet" "subnet_2" { vpc_id = aws_vpc.vpc_1.id cidr_block = "10.0.2.0/24" availability_zone = "${var.region}b" map_public_ip_on_launch = true tags = { Name = "${var.prefix}-subnet-2" } } resource "aws_subnet" "subnet_3" { vpc_id = aws_vpc.vpc_1.id cidr_block = "10.0.3.0/24" availability_zone = "${var.region}c" map_public_ip_on_launch = true tags = { Name = "${var.prefix}-subnet-3" } } resource "aws_internet_gateway" "igw_1" { vpc_id = aws_vpc.vpc_1.id tags = { Name = "${var.prefix}-igw-1" } } resource "aws_route_table" "rt_1" { vpc_id = aws_vpc.vpc_1.id route { cidr_block = "0.0.0.0/0" gateway_id = aws_internet_gateway.igw_1.id } tags = { Name = "${var.prefix}-rt-1" } } resource "aws_route_table_association" "association_1" { subnet_id = aws_subnet.subnet_1.id route_table_id = aws_route_table.rt_1.id } resource "aws_route_table_association" "association_2" { subnet_id = aws_subnet.subnet_2.id route_table_id = aws_route_table.rt_1.id } resource "aws_route_table_association" "association_3" { subnet_id = aws_subnet.subnet_3.id route_table_id = aws_route_table.rt_1.id } resource "aws_security_group" "sg_1" { name = "${var.prefix}-sg-1" ingress { from_port = 0 to_port = 0 protocol = "all" cidr_blocks = ["0.0.0.0/0"] } egress { from_port = 0 to_port = 0 protocol = "all" cidr_blocks = ["0.0.0.0/0"] } vpc_id = aws_vpc.vpc_1.id tags = { Name = "${var.prefix}-sg-1" } } # EC2 설정 시작 # EC2 역할 생성 resource "aws_iam_role" "ec2_role_1" { name = "${var.prefix}-ec2-role-1" # 이 역할에 대한 신뢰 정책 설정. EC2 서비스가 이 역할을 가정할 수 있도록 설정 assume_role_policy = <> /etc/fstab' END_OF_FILE } # EC2 인스턴스 생성 resource "aws_instance" "ec2_1" { # 사용할 AMI ID ami = "ami-07eff2bc4837a9e01" # EC2 인스턴스 유형 instance_type = "t2.micro" # 사용할 서브넷 ID subnet_id = aws_subnet.subnet_1.id # 적용할 보안 그룹 ID vpc_security_group_ids = [aws_security_group.sg_1.id] # 퍼블릭 IP 연결 설정 associate_public_ip_address = true # 인스턴스에 IAM 역할 연결 iam_instance_profile = aws_iam_instance_profile.instance_profile_1.name # 인스턴스에 태그 설정 tags = { Name = "${var.prefix}-ec2-1" } # 루트 볼륨 설정 root_block_device { volume_type = "gp3" volume_size = 32 # 볼륨 크기를 32GB로 설정 } # User data script for ec2_1 user_data = <<-EOF ${local.ec2_user_data_base} EOF } ``` - .gitignore ``` # Terraform 상태 파일 *.tfstate *.tfstate.* # Terraform 변수 파일 *.tfvars *.tfvars.json # 로컬 Terraform 디렉토리 **/.terraform/* # 충돌 로그 파일 crash.log crash.*.log # Terraform 재정의 파일 override.tf override.tf.json *_override.tf *_override.tf.json # Terraform CLI 설정 파일 .terraformrc terraform.rc .terraform.lock.hcl ``` # 5강 - [25 02 06, p 14003, 5강, 공개 버킷과 비공개 버킷을 생성, 테스트 파일 업로드](https://youtu.be/LGJScrodxWc) - [GIT](https://github.com/sik2/terraform-s3/commit/fc087f0) ```hcl # S3 설정 시작 resource "aws_s3_bucket" "bucket_1" { bucket = "${var.prefix}-bucket-${var.nickname}-1" tags = { Name = "${var.prefix}-bucket-${var.nickname}-1" } } data "aws_iam_policy_document" "bucket_1_policy_1_statement" { statement { sid = "PublicReadGetObject" effect = "Allow" principals { type = "AWS" identifiers = ["*"] } actions = ["s3:GetObject"] resources = ["${aws_s3_bucket.bucket_1.arn}/*"] } } resource "aws_s3_bucket_policy" "bucket_1_policy_1" { bucket = aws_s3_bucket.bucket_1.id policy = data.aws_iam_policy_document.bucket_1_policy_1_statement.json depends_on = [aws_s3_bucket_public_access_block.bucket_1_public_access_block_1] } resource "aws_s3_bucket_public_access_block" "bucket_1_public_access_block_1" { bucket = aws_s3_bucket.bucket_1.id block_public_acls = false block_public_policy = false ignore_public_acls = false restrict_public_buckets = false } resource "aws_s3_bucket" "bucket_2" { bucket = "${var.prefix}-bucket-${var.nickname}-2" tags = { Name = "${var.prefix}-bucket-${var.nickname}-2" } } resource "aws_s3_object" "object_1" { bucket = aws_s3_bucket.bucket_1.id key = "/index.html" content = "Hello" # 직접 문자열 사용 content_type = "text/html" etag = md5("Hello") depends_on = [aws_s3_bucket.bucket_2] } resource "aws_s3_object" "object_2" { bucket = aws_s3_bucket.bucket_2.id key = "/index.html" content = "Hello" # 직접 문자열 사용 content_type = "text/html" etag = md5("Hello") depends_on = [aws_s3_bucket.bucket_2] } # S3 설정 끝 ``` # 6강 - [25 02 06, p 14003, 6강, 샘플 앱 프로젝트 생성](https://youtu.be/3T4JiPrzE2Y) - [샘플 앱 - 리포지터리](https://github.com/sik2/sb-s3-sample) - [샘플 앱 - GIT](https://github.com/sik2/sb-s3-sample/commit/5f8a03e) # 7강 - [25 02 06, p 14003, 7강, aws sdk 도입, aws 엑세스 키 정보를 넣지않는 버전으로 진행](https://youtu.be/wTRRPRxLJSA) - [샘플 앱 - GIT](https://github.com/sik2/sb-s3-sample/commit/1e75d45) - 의존성 추가 ```kotlin implementation(platform("software.amazon.awssdk:bom:2.24.0")) implementation("software.amazon.awssdk:s3") ``` - global/aws/s3/S3Config.java ```java @Configuration public class S3Config { @Bean public S3Client s3Client() { return S3Client.builder() .region(Region.AP_NORTHEAST_2) .build(); } } ``` - domain/home/home/HomeController.java ```java @RestController @RequiredArgsConstructor public class HomeController { private final S3Client s3Client; @GetMapping("/") public List home() { List bucketList = s3Client.listBuckets().buckets(); return bucketList.stream().map(Bucket::name).collect(Collectors.toList()); } ``` ## 크롬으로 접속 테스트 - [http://localhost:8080](http://localhost:8080) - 성공 # 8강 - [25 02 07, p 14003, 8강, S3 파일업로드](https://youtu.be/ICiJ3nkCDJ0) - [샘플 앱 - GIT](https://github.com/sik2/sb-s3-sample/commit/8347b79) - domain/home/home/HomeController.java ```java @RestController @RequiredArgsConstructor public class HomeController { private final S3Client s3Client; private static final String BUCKET_NAME = "dev-bucket-sik2-1"; private static final String REGION = "ap-northeast-2"; private static final String IMG_DIR_NAME = "img1"; public static String getS3FileUrl(String fileName) { return "https://" + BUCKET_NAME + ".s3." + REGION + ".amazonaws.com/" + fileName; } @GetMapping("/") public List home() { List bucketList = s3Client.listBuckets().buckets(); return bucketList.stream().map(Bucket::name).collect(Collectors.toList()); } @GetMapping("/upload") public String upload() { return """ """; } @PostMapping("/upload") @ResponseBody public String handleFileUpload(MultipartFile file) throws IOException { PutObjectRequest putObjectRequest = PutObjectRequest.builder() .bucket(BUCKET_NAME) .key(IMG_DIR_NAME + "/" + file.getOriginalFilename()) .contentType(file.getContentType()) .build(); s3Client.putObject(putObjectRequest, RequestBody.fromInputStream(file.getInputStream(), file.getSize())); return "Uploaded Success"; } } ``` # 9강 - [25 02 07, p 14003, 9강, 업로드 된 이미지 파일의 URL로 이미지 표시](https://youtu.be/goYeuDAMdlo) - [샘플 앱 - GIT](https://github.com/sik2/sb-s3-sample/commit/e32d8d5) ```java //(중략) @PostMapping("/upload") @ResponseBody public String handleFileUpload(MultipartFile file) throws IOException { //(중략) return """

업로드 완료

""".formatted(getS3FileUrl(IMG_DIR_NAME + "/" + file.getOriginalFilename())); ``` # 10강 - [25 02 07, p 14003, 10강, 업로드 된 파일 삭제](https://youtu.be/wSfeC5ppGNk) - [샘플 앱 - GIT](https://github.com/sik2/sb-s3-sample/commit/df426b0) ```java @GetMapping("/deleteFile") public String showDeleteFile() { return """ """; } @PostMapping("/deleteFile") @ResponseBody public String deleteFile(String fileName) { DeleteObjectRequest deleteObjectRequest = DeleteObjectRequest.builder() .bucket(BUCKET_NAME) .key(IMG_DIR_NAME + "/" + fileName) .build(); s3Client.deleteObject(deleteObjectRequest); return "파일이 삭제되었습니다."; } ``` # 추가학습 자료 - [글 - Spring Boot에서 S3에 파일을 업로드하는 세 가지 방법](https://techblog.woowahan.com/11392) - [글 - Presigned URL을 이용하여 S3로 파일 업로드](https://velog.io/@mimi0905/Presigned-URL%EC%9D%84-%EC%9D%B4%EC%9A%A9%ED%95%98%EC%97%AC-S3%EB%A1%9C-%ED%8C%8C%EC%9D%BC-%EC%97%85%EB%A1%9C%EB%93%9C) $$hide # 8강 - [25 02 07, p 14003, 8강, 스프링부트 이미지로 컨테이너 만들기, 도커라이즈 환경에서 aws 엑세스 키 정보에 접근 불가]() - [샘플 앱 - GIT]() - Dockerfile ``` # 첫 번째 스테이지: 빌드 스테이지 FROM gradle:jdk-21-and-23-graal-jammy AS builder # 작업 디렉토리 설정 WORKDIR /app # 소스 코드와 Gradle 래퍼 복사 COPY build.gradle.kts . COPY settings.gradle.kts . # Gradle 래퍼에 실행 권한 부여 RUN gradle wrapper # 종속성 설치 RUN ./gradlew dependencies --no-daemon # 소스 코드 복사 COPY src src # 애플리케이션 빌드 RUN ./gradlew build --no-daemon # 두 번째 스테이지: 실행 스테이지 FROM ghcr.io/graalvm/jdk-community:23 # 작업 디렉토리 설정 WORKDIR /app # 첫 번째 스테이지에서 빌드된 JAR 파일 복사 COPY --from=builder /app/build/libs/*.jar app.jar # 실행할 JAR 파일 지정 ENTRYPOINT ["java", "-jar", "-Dspring.profiles.active=prod", "app.jar"] ``` ## 도커 이미지 생성 및 실행 ``` # 이미지 생성 docker build -t sik2dev/sb-s3-1:v0.0.1 . # 도커 허브에 이미지 푸시 docker push sik2dev/sb-s3-1:v0.0.1 # 이미지 실행 docker run --rm -p 8090:8080 sik2dev/sb-s3-1:v0.0.1 # 데몬 모드로 실행 docker run -d --rm -p 8090:8080 sik2dev/sb-s3-1:v0.0.1 ``` ## 크롬으로 접속 테스트 - [http://localhost:8090](http://localhost:8090) - 도커 컨테이너 안에서 실행되는 스프링부트앱은 도커 호스트(윈도우)에 있는 aws 엑세스 키 정보에 접근할 수 없어서, API 조회 실패(권한오류) # 9강 - [25 02 07, p 14003, 9강, 도커 허브에 이미지 업로드, 태그 2개(v0.0.1, latest) 추가]() ## 도커허브 로그인 ```bash docker login ``` ## 도커허브에 이미지 푸시 ```bash # 이전 진행했으면 스킵 docker push sik2dev/sb-s3-1:v0.0.1 # 여기서 시작 docker tag sik2dev/sb-s3-1:v0.0.1 sik2dev/sb-s3-1:latest docker push sik2dev/sb-s3-1:latest ``` # 10강 - [25 02 07, p 14003, 10강, EC2 안 도커 컨테이너 내부에 도커호스트의 IAM 권한을 상속받는다.]() ## EC2 에서 도커 이미지 생성 및 실행 ```bash docker run --rm -p 8090:8080 sik2dev/sb-s3-1 ``` ## 크롬으로 접속 테스트 - [http://43.203.246.74:8090](http://43.203.246.74:8090) - 성공 - 참고로 43.203.246.74는 인스턴스에 자동으로(랜덤으로) 부여된 공인 IP 이다. # 15강 - [25 02 07, p 14003, 15강, CDN과 클라우드 프론트 개념]() # 16강 - [25 02 07, p 14003, 16강, dev-sik2-bucket-2 버킷의 public 폴더를 클라우드 프론트로 CDN 화]() - [GIT]() # 5강 - [25 02 06, p 14003, 5강, ec2 인스턴스에서 ec2_role_1 설정으로 s3 와 관련된 aws cli 명령어를 사용 가능]() ### s3 명령어 사용 테스트 - aws s3 ls ### 현재 살아있는 EC2 인스턴스 리스팅 - `aws ec2 describe-instances --filters "Name=instance-state-name,Values=running"` ### 현재 살아있는 EC2 인스턴스 리스팅, Name 만 출력 - `aws ec2 describe-instances --filters "Name=instance-state-name,Values=running" --query "Reservations[].Instances[].Tags[?Key=='Name'].Value[]" --output text` ### 현재 AWS 환경에서 활성화된 인증 정보 - aws sts get-caller-identity

AWS - S3