Initial commit: AWS CloudFront with OpenTofu infrastructure
- Complete CloudFront distribution setup with origin.servidor.it.com - WAF v2 integration for security protection - S3 backend for Terraform state management - CloudFront logging to S3 - HTTP-only origin protocol configuration (resolves 504 Gateway Timeout) - Comprehensive documentation with deployment guide 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
kappa
151
README.md
Normal file
151
README.md
Normal file
@@ -0,0 +1,151 @@
|
||||
# AWS CloudFront with OpenTofu
|
||||
|
||||
이 프로젝트는 OpenTofu를 사용하여 AWS CloudFront 배포와 CloudFormation 스택을 관리합니다.
|
||||
|
||||
## 구조
|
||||
|
||||
- `versions.tf` - Provider 및 Terraform 버전 설정
|
||||
- `variables.tf` - 입력 변수 정의
|
||||
- `main.tf` - CloudFront 배포 및 CloudFormation 스택
|
||||
- `security.tf` - 보안 그룹 및 WAF 설정
|
||||
- `outputs.tf` - 출력 변수
|
||||
- `terraform.tfvars.example` - 변수 설정 예시
|
||||
|
||||
## 주요 기능
|
||||
|
||||
### CloudFront 배포
|
||||
- `origin.servidor.it.com`을 원본 서버로 사용
|
||||
- HTTPS 리디렉션 및 압축 지원
|
||||
- 사용자 정의 도메인(CNAME) 지원
|
||||
- 캐시 정책 및 원본 요청 정책 설정
|
||||
- 커스텀 오류 페이지 설정
|
||||
|
||||
### CloudFormation 스택
|
||||
- VPC 및 네트워킹 리소스 생성
|
||||
- 퍼블릭 서브넷 및 인터넷 게이트웨이
|
||||
- 스택 출력을 통한 리소스 ID 공유
|
||||
|
||||
### 보안 기능
|
||||
- ALB 및 웹 서버용 보안 그룹 (선택사항)
|
||||
- AWS WAF v2 웹 ACL (선택사항)
|
||||
- 레이트 제한 및 관리 규칙 세트
|
||||
|
||||
## 사용 방법
|
||||
|
||||
### 1. 환경 설정
|
||||
|
||||
```bash
|
||||
# OpenTofu 설치 확인
|
||||
tofu version
|
||||
|
||||
# AWS 자격 증명 설정
|
||||
export AWS_ACCESS_KEY_ID="your-access-key"
|
||||
export AWS_SECRET_ACCESS_KEY="your-secret-key"
|
||||
export AWS_DEFAULT_REGION="us-east-1"
|
||||
```
|
||||
|
||||
### 2. 변수 설정
|
||||
|
||||
```bash
|
||||
# 설정 파일 복사
|
||||
cp terraform.tfvars.example terraform.tfvars
|
||||
|
||||
# 필요한 값들 수정
|
||||
vim terraform.tfvars
|
||||
```
|
||||
|
||||
### 3. 배포
|
||||
|
||||
```bash
|
||||
# 초기화
|
||||
tofu init
|
||||
|
||||
# 계획 확인
|
||||
tofu plan
|
||||
|
||||
# 배포 실행
|
||||
tofu apply
|
||||
```
|
||||
|
||||
### 4. 확인
|
||||
|
||||
배포 후 출력된 CloudFront URL을 통해 서비스에 접근할 수 있습니다:
|
||||
|
||||
```bash
|
||||
# CloudFront 배포 상태 확인
|
||||
aws cloudfront get-distribution --id <distribution-id>
|
||||
|
||||
# CloudFormation 스택 상태 확인
|
||||
aws cloudformation describe-stacks --stack-name <stack-name>
|
||||
```
|
||||
|
||||
## 중요 설정
|
||||
|
||||
### SSL 인증서
|
||||
|
||||
이 설정은 **ACM(AWS Certificate Manager) 인증서**를 사용합니다:
|
||||
|
||||
- `servidor.it.com`과 `*.servidor.it.com` 도메인 지원
|
||||
- 자동으로 us-east-1 리전에 ACM 인증서 생성
|
||||
- DNS 검증을 통한 자동 인증서 발급
|
||||
- Route53을 통한 자동 DNS 레코드 관리
|
||||
- CloudFront와 완전 통합된 HTTPS 설정
|
||||
|
||||
### 캐시 정책
|
||||
|
||||
기본 제공되는 AWS 관리 정책:
|
||||
|
||||
- `4135ea2d-6df8-44a3-9df3-4b5a84be39ad` - CachingDisabled
|
||||
- `725fe1d6-8a84-4f3e-8ab1-bc2d5bb10e12` - CachingOptimized
|
||||
- `df3c6b6c-4e41-4d9c-a8c7-6b8b2b8e6b8b` - CachingOptimizedForUncompressedObjects
|
||||
|
||||
### 보안 고려사항
|
||||
|
||||
프로덕션 환경에서는:
|
||||
|
||||
- `ssh_allowed_cidrs`를 특정 IP로 제한
|
||||
- WAF 활성화 (`enable_waf = true`)
|
||||
- 적절한 캐시 정책 선택
|
||||
- CloudTrail 및 CloudWatch 로깅 활성화
|
||||
|
||||
### 도메인 설정
|
||||
|
||||
**전제 조건**:
|
||||
- `servidor.it.com` 도메인의 Route53 호스팅 영역이 존재해야 함
|
||||
- 도메인의 네임서버가 Route53으로 설정되어 있어야 함
|
||||
|
||||
**자동 설정**:
|
||||
- ACM 인증서 자동 생성 및 검증
|
||||
- Route53 A 레코드 자동 생성 (`servidor.it.com` → CloudFront)
|
||||
- Route53 A 레코드 자동 생성 (`www.servidor.it.com` → CloudFront)
|
||||
|
||||
## 출력 정보
|
||||
|
||||
배포 완료 후 다음 정보들이 출력됩니다:
|
||||
|
||||
- CloudFront 배포 ID 및 도메인
|
||||
- CloudFormation 스택 정보
|
||||
- 보안 그룹 ID (활성화된 경우)
|
||||
- WAF Web ACL ARN (활성화된 경우)
|
||||
- VPC 및 서브넷 정보
|
||||
|
||||
## 정리
|
||||
|
||||
```bash
|
||||
# 리소스 삭제
|
||||
tofu destroy
|
||||
```
|
||||
|
||||
## 문제 해결
|
||||
|
||||
### 일반적인 오류
|
||||
|
||||
1. **인증서 오류**: CloudFront용 인증서는 us-east-1에서만 생성 가능
|
||||
2. **도메인 검증**: CNAME 설정 전에 도메인 소유권 확인 필요
|
||||
3. **원본 서버**: `origin.servidor.it.com`이 HTTPS를 지원하는지 확인
|
||||
|
||||
### 로그 확인
|
||||
|
||||
- CloudFront 액세스 로그 활성화
|
||||
- CloudWatch 메트릭 모니터링
|
||||
- WAF 로그 분석 (활성화된 경우)
|
||||
Reference in New Issue
Block a user