MIJI DApp Server Docs

Dev 인프라 가이드 (miji-dapp-server)

개요

• 리전: ap-northeast-2
• VPC/Subnet: 기존 인프라 (VPC vpc-03a92836bbf77c7b4, Subnet subnet-04632c7e469244e6e)
• 도메인: dev.asset.cccv.to (Route53 A 레코드 -> EIP 43.203.16.104)
• 키페어: xxyyzz-public-cicd
• 보안그룹: 80/443 전체 허용, SSH 22는 허용 CIDR 목록(초기 14.52.111.153/32)
• EC2: 단일 t3.small (x86_64, AL2023), 태그 CodeDeploy=asset-dev-app, EIP 연결

CI/CD 연계 포인트

• ECR: asset-dev-server (푸시 대상)
• Artifact S3: asset-dev-codedeploy-artifacts (압축 번들 사용 시)
• CodeDeploy:
  • Application: asset-dev-app
  • Deployment Group: asset-dev-dg
  • 대상 식별: EC2 태그 CodeDeploy=asset-dev-app (단일 인스턴스)

Secrets / 환경 변수

• Secrets Manager: /dapp/dev/config (.env 텍스트 전체 저장)
• 추가 조회 권한: /dapp/dev/corp/* (필요 시 사용)
• 배포 시 CodeDeploy 스크립트에서 /dapp/dev/config 값을 읽어 .env 파일로 렌더링

로깅 / 모니터링

• CloudWatch 로그 그룹: /dapp/dev/nginx, /dapp/dev/app, /dapp/dev/system, /dapp/dev/redis
• 인프라 수집(자동): EC2 부팅 시 CloudWatch Agent가 /var/log/nginx/access.log, /var/log/nginx/error.log, /var/log/cloud-init.log, /var/log/messages를 수집
• 애플리케이션/Redis 수집(앱 측 설정 필요): docker-compose awslogs 드라이버로
  • app: /dapp/dev/app
  • redis: /dapp/dev/redis
• 알람 제안(선택): CPU, StatusCheckFailedAny, Disk 80%+, Nginx 5xx 비율

배포 흐름 예시 (참고용)

1) GitHub Actions: 코드 빌드 → ECR 로그인/푸시(asset-dev-server) 2) (옵션) 배포 번들 압축 후 S3 asset-dev-codedeploy-artifacts 업로드 3) CodeDeploy 배포 트리거: App asset-dev-app, DG asset-dev-dg 4) EC2에서 codedeploy-agent가 태그 CodeDeploy=asset-dev-app 인스턴스에 배포 수행

점검/디버깅 포인트

• codedeploy-agent 동작: systemctl status codedeploy-agent
• Nginx/앱 로그: CloudWatch 로그 그룹 확인
• 도메인 연결: dev.asset.cccv.to → EIP(43.203.16.104) 정상 매핑 여부
• SSH 필요 시: 키페어 xxyyzz-public-cicd, 보안그룹 SSH 허용 CIDR 확인

Redis 데이터 영속화 (dev)

• 별도 EBS 볼륨(gp3) 10GiB를 EC2에 붙여 Redis 데이터를 보존하도록 Terraform 구성됨 (/dev/sdf, delete_on_termination=false)
• 인스턴스 교체 시 볼륨은 유지되며 새 인스턴스에 재부착됨
• 애플리케이션 측에서는 docker-compose에서 Redis 데이터를 EBS 경로(예: /mnt/redis 등)로 바인드 마운트하도록 설정 필요