Amazon ECS Express Mode Workshop

Express Mode 아키텍처

ECS Express Mode는 단순히 '쉬운 배포'를 넘어, AWS의 컨테이너 운영 베스트 프랙티스를 자동으로 적용하는 지능적인 오케스트레이션 레이어입니다.

사전 준비 사항

ECS Express Mode 실습을 위해 필요한 도구들을 설치하고 AWS 자격 증명을 구성합니다.

실습 코드

# ============================================
# 1. AWS CLI 설치 확인
# ============================================
aws --version
# aws-cli/2.x.x 이상 필요

# AWS CLI 설치 (macOS)
brew install awscli

# AWS CLI 설치 (Linux)
curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install

# ============================================
# 2. AWS 자격 증명 설정
# ============================================
aws configure
# AWS Access Key ID: [YOUR_ACCESS_KEY]
# AWS Secret Access Key: [YOUR_SECRET_KEY]
# Default region name: ap-northeast-2
# Default output format: json

# 자격 증명 확인
aws sts get-caller-identity

# ============================================
# 3. Docker 설치 확인
# ============================================
docker --version
# Docker version 24.x.x 이상 권장

# Docker 데몬 실행 확인
docker info

# ============================================
# 4. 환경 변수 설정 (이후 단계에서 사용)
# ============================================
export AWS_REGION=ap-northeast-2
export AWS_ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text)
echo "Region: $AWS_REGION"
echo "Account ID: $AWS_ACCOUNT_ID"

Flask 웹 애플리케이션 구현

실제 프로덕션 환경을 시뮬레이션하기 위해 헬스 체크, 메트릭, 환경 변수 등을 포함한 Flask 애플리케이션을 작성합니다.

실습 코드

# ============================================
# 프로젝트 디렉토리 생성
# ============================================
mkdir -p ecs-express-workshop && cd ecs-express-workshop

# ============================================
# app.py - Flask 애플리케이션
# ============================================
cat > app.py << 'EOF'
from flask import Flask, jsonify, request
import os
import socket
import time
from datetime import datetime

app = Flask(__name__)

# 애플리케이션 시작 시간 기록
START_TIME = time.time()

@app.route('/')
def home():
    """메인 엔드포인트 - 애플리케이션 정보 반환"""
    return jsonify({
        "service": "ECS Express Mode Demo",
        "message": "Hello from ECS Express Mode! 🚀",
        "version": os.getenv("APP_VERSION", "1.0.0"),
        "hostname": socket.gethostname(),
        "timestamp": datetime.utcnow().isoformat(),
        "environment": os.getenv("ENVIRONMENT", "development")
    })

@app.route('/health')
def health():
    """헬스 체크 엔드포인트 - ALB가 주기적으로 호출"""
    uptime = time.time() - START_TIME
    return jsonify({
        "status": "healthy",
        "uptime_seconds": round(uptime, 2),
        "version": os.getenv("APP_VERSION", "1.0.0")
    })

@app.route('/info')
def info():
    """상세 정보 엔드포인트"""
    return jsonify({
        "app": {
            "name": "ecs-express-demo",
            "version": os.getenv("APP_VERSION", "1.0.0"),
            "environment": os.getenv("ENVIRONMENT", "development")
        },
        "container": {
            "hostname": socket.gethostname(),
            "platform": os.uname().sysname
        },
        "request": {
            "remote_addr": request.remote_addr,
            "headers": dict(request.headers)
        }
    })

@app.route('/ready')
def ready():
    """Readiness 체크 - 애플리케이션이 트래픽을 받을 준비가 되었는지 확인"""
    # 실제 환경에서는 DB 연결, 캐시 연결 등을 확인
    return jsonify({"ready": True})

if __name__ == '__main__':
    port = int(os.getenv("PORT", 80))
    app.run(host='0.0.0.0', port=port, debug=False)
EOF

# ============================================
# requirements.txt - Python 의존성
# ============================================
cat > requirements.txt << 'EOF'
flask==3.0.0
gunicorn==21.2.0
EOF

# ============================================
# Dockerfile - 멀티 스테이지 빌드
# ============================================
cat > Dockerfile << 'EOF'
# ============================================
# Stage 1: Builder - 의존성 설치
# ============================================
FROM python:3.11-slim as builder

WORKDIR /app

# 의존성 파일 복사 및 설치
COPY requirements.txt .
RUN pip install --no-cache-dir --user -r requirements.txt

# ============================================
# Stage 2: Runtime - 최종 이미지
# ============================================
FROM python:3.11-slim

# 보안: non-root 사용자 생성
RUN useradd --create-home --shell /bin/bash appuser

WORKDIR /app

# Builder에서 설치된 패키지 복사
COPY --from=builder /root/.local /home/appuser/.local

# 애플리케이션 코드 복사
COPY app.py .

# 소유권 변경
RUN chown -R appuser:appuser /app

# non-root 사용자로 전환
USER appuser

# PATH 설정
ENV PATH=/home/appuser/.local/bin:$PATH

# 환경 변수 설정
ENV APP_VERSION=1.0.0
ENV ENVIRONMENT=production
ENV PORT=80

# 포트 노출
EXPOSE 80

# Gunicorn으로 애플리케이션 실행
# workers: CPU 코어 수 * 2 + 1 권장 (Fargate 0.25 vCPU 기준 2)
CMD ["gunicorn", "--bind", "0.0.0.0:80", "--workers", "2", "--threads", "4", "--timeout", "120", "--access-logfile", "-", "--error-logfile", "-", "app:app"]
EOF

# ============================================
# 로컬 테스트
# ============================================
# 이미지 빌드
docker build -t ecs-express-demo:local .

# 로컬 실행
docker run -d -p 8080:80 --name ecs-test ecs-express-demo:local

# 테스트
curl http://localhost:8080/
curl http://localhost:8080/health
curl http://localhost:8080/info

# 정리
docker stop ecs-test && docker rm ecs-test

Amazon ECR (Elastic Container Registry)

ECR은 AWS의 완전 관리형 Docker 컨테이너 레지스트리입니다. ECS Express Mode는 ECR의 이미지를 사용하여 태스크를 실행합니다.

실습 코드

# ============================================
# 환경 변수 확인
# ============================================
echo "Region: $AWS_REGION"
echo "Account ID: $AWS_ACCOUNT_ID"

# 변수가 없으면 설정
export AWS_REGION=${AWS_REGION:-ap-northeast-2}
export AWS_ACCOUNT_ID=${AWS_ACCOUNT_ID:-$(aws sts get-caller-identity --query Account --output text)}
export REPO_NAME=ecs-express-demo

# ============================================
# ECR 리포지토리 생성
# ============================================
aws ecr create-repository \
  --repository-name $REPO_NAME \
  --image-scanning-configuration scanOnPush=true \
  --encryption-configuration encryptionType=AES256 \
  --region $AWS_REGION

# 리포지토리 URI 저장
export ECR_URI=$AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com/$REPO_NAME
echo "ECR URI: $ECR_URI"

# ============================================
# ECR 로그인
# ============================================
aws ecr get-login-password --region $AWS_REGION | \
  docker login --username AWS --password-stdin \
  $AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com

# ============================================
# Docker 이미지 빌드 및 태그
# ============================================
# 프로덕션 이미지 빌드
docker build -t $REPO_NAME:v1 .

# ECR 태그 지정
docker tag $REPO_NAME:v1 $ECR_URI:v1
docker tag $REPO_NAME:v1 $ECR_URI:latest

# ============================================
# ECR에 푸시
# ============================================
docker push $ECR_URI:v1
docker push $ECR_URI:latest

# ============================================
# 푸시 확인
# ============================================
aws ecr describe-images \
  --repository-name $REPO_NAME \
  --region $AWS_REGION \
  --query 'imageDetails[*].[imageTags,imagePushedAt,imageSizeInBytes]' \
  --output table

# 이미지 스캔 결과 확인 (잠시 후)
aws ecr describe-image-scan-findings \
  --repository-name $REPO_NAME \
  --image-id imageTag=v1 \
  --region $AWS_REGION

Express Mode IAM 역할 상세

Express Mode는 두 가지 IAM 역할이 필요합니다. 각 역할의 목적과 권한을 이해하면 보안 모범 사례를 적용하는 데 도움이 됩니다.

실습 코드

# ============================================
# Task Execution Role 생성
# ============================================

# 신뢰 정책 (Trust Policy) 생성
cat > task-execution-trust-policy.json << 'EOF'
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "ecs-tasks.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}
EOF

# IAM 역할 생성
aws iam create-role \
  --role-name ecsExpressTaskExecutionRole \
  --assume-role-policy-document file://task-execution-trust-policy.json \
  --description "ECS Express Mode Task Execution Role"

# AWS 관리형 정책 연결
aws iam attach-role-policy \
  --role-name ecsExpressTaskExecutionRole \
  --policy-arn arn:aws:iam::aws:policy/service-role/AmazonECSTaskExecutionRolePolicy

# (선택) Secrets Manager 접근 권한 추가
cat > secrets-policy.json << 'EOF'
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "secretsmanager:GetSecretValue"
      ],
      "Resource": "arn:aws:secretsmanager:*:*:secret:ecs-express-*"
    }
  ]
}
EOF

aws iam put-role-policy \
  --role-name ecsExpressTaskExecutionRole \
  --policy-name SecretsManagerAccess \
  --policy-document file://secrets-policy.json

# ============================================
# Infrastructure Role 생성
# ============================================

# 신뢰 정책 생성
cat > infra-trust-policy.json << 'EOF'
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "ecs.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}
EOF

# IAM 역할 생성
aws iam create-role \
  --role-name ecsExpressInfraRole \
  --assume-role-policy-document file://infra-trust-policy.json \
  --description "ECS Express Mode Infrastructure Role"

# AWS 관리형 정책 연결
aws iam attach-role-policy \
  --role-name ecsExpressInfraRole \
  --policy-arn arn:aws:iam::aws:policy/service-role/AmazonECSInfrastructureRolePolicyForExpressGateway

# ============================================
# 역할 ARN 저장
# ============================================
export TASK_EXEC_ROLE_ARN=arn:aws:iam::$AWS_ACCOUNT_ID:role/ecsExpressTaskExecutionRole
export INFRA_ROLE_ARN=arn:aws:iam::$AWS_ACCOUNT_ID:role/ecsExpressInfraRole

echo "Task Execution Role: $TASK_EXEC_ROLE_ARN"
echo "Infrastructure Role: $INFRA_ROLE_ARN"

# 역할 확인
aws iam get-role --role-name ecsExpressTaskExecutionRole --query 'Role.Arn'
aws iam get-role --role-name ecsExpressInfraRole --query 'Role.Arn'

Express Mode 배포 옵션

이제 모든 준비가 완료되었습니다. Express Mode는 다양한 배포 옵션을 제공합니다. Default VPC를 사용하는 가장 간단한 방법부터 기존 VPC를 활용하는 방법까지 알아봅니다.

실습 코드

# ============================================
# 환경 변수 확인
# ============================================
echo "ECR URI: $ECR_URI"
echo "Task Execution Role: $TASK_EXEC_ROLE_ARN"
echo "Infrastructure Role: $INFRA_ROLE_ARN"

# ============================================
# 방법 1: Default VPC 사용 (가장 간단)
# ============================================
aws ecs create-express-gateway-service \
  --service-name ecs-express-demo \
  --image $ECR_URI:v1 \
  --execution-role-arn $TASK_EXEC_ROLE_ARN \
  --infrastructure-role-arn $INFRA_ROLE_ARN \
  --region $AWS_REGION

# ============================================
# 방법 2: 리소스 커스터마이즈
# ============================================
aws ecs create-express-gateway-service \
  --service-name ecs-express-demo \
  --image $ECR_URI:v1 \
  --execution-role-arn $TASK_EXEC_ROLE_ARN \
  --infrastructure-role-arn $INFRA_ROLE_ARN \
  --cpu 512 \
  --memory 1024 \
  --container-port 80 \
  --health-check-path /health \
  --environment-variables '[
    {"name": "ENVIRONMENT", "value": "production"},
    {"name": "LOG_LEVEL", "value": "INFO"}
  ]' \
  --region $AWS_REGION

# ============================================
# 방법 3: 기존 VPC/Subnet 사용
# ============================================
# 먼저 VPC 정보 확인
aws ec2 describe-vpcs \
  --query 'Vpcs[*].[VpcId,Tags[?Key==`Name`].Value|[0],CidrBlock]' \
  --output table

# Subnet 확인 (VPC ID로 필터링)
VPC_ID=vpc-xxxxxxxx  # 실제 VPC ID로 변경
aws ec2 describe-subnets \
  --filters "Name=vpc-id,Values=$VPC_ID" \
  --query 'Subnets[*].[SubnetId,AvailabilityZone,CidrBlock,MapPublicIpOnLaunch,Tags[?Key==`Name`].Value|[0]]' \
  --output table

# Security Group 확인
aws ec2 describe-security-groups \
  --filters "Name=vpc-id,Values=$VPC_ID" \
  --query 'SecurityGroups[*].[GroupId,GroupName,Description]' \
  --output table

# 기존 VPC로 배포 (Public Subnet)
aws ecs create-express-gateway-service \
  --service-name ecs-express-demo \
  --image $ECR_URI:v1 \
  --execution-role-arn $TASK_EXEC_ROLE_ARN \
  --infrastructure-role-arn $INFRA_ROLE_ARN \
  --network-configuration '{
    "awsvpcConfiguration": {
      "subnets": ["subnet-aaaa1111", "subnet-bbbb2222"],
      "securityGroups": ["sg-xxxxxxxx"],
      "assignPublicIp": "ENABLED"
    }
  }' \
  --region $AWS_REGION

# ============================================
# 방법 4: Private Subnet 사용 (Internal ALB)
# ============================================
# Private Subnet 사용 시 NAT Gateway가 있어야 ECR 이미지 풀 가능
aws ecs create-express-gateway-service \
  --service-name ecs-express-internal \
  --image $ECR_URI:v1 \
  --execution-role-arn $TASK_EXEC_ROLE_ARN \
  --infrastructure-role-arn $INFRA_ROLE_ARN \
  --network-configuration '{
    "awsvpcConfiguration": {
      "subnets": ["subnet-private-1", "subnet-private-2"],
      "securityGroups": ["sg-xxxxxxxx"],
      "assignPublicIp": "DISABLED"
    }
  }' \
  --region $AWS_REGION
# → Internal ALB 생성됨 (VPC 내부에서만 접근 가능)

# ============================================
# 배포 상태 확인
# ============================================
# 서비스 목록 확인
aws ecs list-services --cluster default --region $AWS_REGION

# 서비스 상세 정보
aws ecs describe-services \
  --cluster default \
  --services ecs-express-demo \
  --region $AWS_REGION \
  --query 'services[0].{
    ServiceName: serviceName,
    Status: status,
    RunningCount: runningCount,
    DesiredCount: desiredCount,
    PendingCount: pendingCount
  }'

배포 검증

Express Mode가 생성한 리소스들을 확인하고 애플리케이션이 정상 동작하는지 테스트합니다. AWS 콘솔과 CLI 모두에서 확인할 수 있습니다.

실습 코드

# ============================================
# Express Mode URL 확인
# ============================================
# ECS 콘솔에서 확인
echo "ECS Console: https://$AWS_REGION.console.aws.amazon.com/ecs/v2/express"

# CLI로 서비스 정보에서 URL 확인
aws ecs describe-services \
  --cluster default \
  --services ecs-express-demo \
  --region $AWS_REGION \
  --query 'services[0].loadBalancers'

# ALB DNS 이름 확인
ALB_ARN=$(aws ecs describe-services \
  --cluster default \
  --services ecs-express-demo \
  --region $AWS_REGION \
  --query 'services[0].loadBalancers[0].loadBalancerArn' \
  --output text)

aws elbv2 describe-load-balancers \
  --load-balancer-arns $ALB_ARN \
  --query 'LoadBalancers[0].DNSName' \
  --output text

# ============================================
# 애플리케이션 테스트
# ============================================
# Express Mode URL로 테스트 (콘솔에서 확인한 URL 사용)
EXPRESS_URL="https://your-service.express.ecs.aws"

# 메인 엔드포인트
curl -s $EXPRESS_URL/ | jq .

# 헬스 체크
curl -s $EXPRESS_URL/health | jq .

# 상세 정보
curl -s $EXPRESS_URL/info | jq .

# 응답 시간 측정
curl -w "\nTotal time: %{time_total}s\n" -o /dev/null -s $EXPRESS_URL/

# ============================================
# 생성된 리소스 확인
# ============================================
# ECS 클러스터
aws ecs describe-clusters --clusters default --region $AWS_REGION

# 태스크 정의
aws ecs list-task-definitions \
  --family-prefix ecs-express-demo \
  --region $AWS_REGION

# 실행 중인 태스크
aws ecs list-tasks \
  --cluster default \
  --service-name ecs-express-demo \
  --region $AWS_REGION

# Target Group 헬스 체크 상태
TG_ARN=$(aws ecs describe-services \
  --cluster default \
  --services ecs-express-demo \
  --region $AWS_REGION \
  --query 'services[0].loadBalancers[0].targetGroupArn' \
  --output text)

aws elbv2 describe-target-health \
  --target-group-arn $TG_ARN \
  --query 'TargetHealthDescriptions[*].{Target:Target.Id,Health:TargetHealth.State}'

# ============================================
# CloudWatch 로그 확인
# ============================================
# 로그 그룹 확인
aws logs describe-log-groups \
  --log-group-name-prefix /ecs/ecs-express-demo \
  --region $AWS_REGION

# 최근 로그 조회
LOG_GROUP="/ecs/ecs-express-demo"
aws logs tail $LOG_GROUP --since 10m --region $AWS_REGION

Canary 배포와 자동 롤백

Express Mode는 기본적으로 Canary 배포 전략을 사용합니다. 새 버전에 소량의 트래픽을 먼저 보내고, 문제가 없으면 전체 트래픽을 전환합니다.

실습 코드

# ============================================
# 새 버전 애플리케이션 작성
# ============================================
cat > app.py << 'EOF'
from flask import Flask, jsonify, request
import os
import socket
import time
from datetime import datetime

app = Flask(__name__)
START_TIME = time.time()

@app.route('/')
def home():
    return jsonify({
        "service": "ECS Express Mode Demo",
        "message": "Hello from ECS Express Mode v2! 🎉",
        "version": os.getenv("APP_VERSION", "2.0.0"),
        "hostname": socket.gethostname(),
        "timestamp": datetime.utcnow().isoformat(),
        "environment": os.getenv("ENVIRONMENT", "development"),
        "features": [
            "Canary Deployment",
            "Auto Rollback",
            "ALB Sharing",
            "Auto Scaling"
        ]
    })

@app.route('/health')
def health():
    uptime = time.time() - START_TIME
    return jsonify({
        "status": "healthy",
        "uptime_seconds": round(uptime, 2),
        "version": os.getenv("APP_VERSION", "2.0.0")
    })

@app.route('/info')
def info():
    return jsonify({
        "app": {
            "name": "ecs-express-demo",
            "version": os.getenv("APP_VERSION", "2.0.0"),
            "environment": os.getenv("ENVIRONMENT", "development")
        },
        "container": {
            "hostname": socket.gethostname(),
            "platform": os.uname().sysname
        },
        "deployment": {
            "strategy": "canary",
            "rollback": "alarm-based"
        }
    })

@app.route('/ready')
def ready():
    return jsonify({"ready": True})

if __name__ == '__main__':
    port = int(os.getenv("PORT", 80))
    app.run(host='0.0.0.0', port=port, debug=False)
EOF

# Dockerfile 버전 업데이트
sed -i '' 's/APP_VERSION=1.0.0/APP_VERSION=2.0.0/' Dockerfile
# Linux의 경우: sed -i 's/APP_VERSION=1.0.0/APP_VERSION=2.0.0/' Dockerfile

# ============================================
# 새 이미지 빌드 및 푸시
# ============================================
docker build -t $REPO_NAME:v2 .
docker tag $REPO_NAME:v2 $ECR_URI:v2
docker push $ECR_URI:v2

# ============================================
# Express Mode 서비스 업데이트
# ============================================
# 서비스 ARN 확인
SERVICE_ARN=$(aws ecs list-services \
  --cluster default \
  --region $AWS_REGION \
  --query 'serviceArns[?contains(@, `ecs-express-demo`)]|[0]' \
  --output text)

echo "Service ARN: $SERVICE_ARN"

# 서비스 업데이트 (새 이미지로)
aws ecs update-express-gateway-service \
  --service-arn $SERVICE_ARN \
  --primary-container "{
    \"image\": \"$ECR_URI:v2\"
  }" \
  --region $AWS_REGION

# ============================================
# 배포 진행 상황 모니터링
# ============================================
# 배포 상태 확인 (반복 실행)
watch -n 5 "aws ecs describe-services \
  --cluster default \
  --services ecs-express-demo \
  --region $AWS_REGION \
  --query 'services[0].deployments[*].{
    Status:status,
    TaskDef:taskDefinition,
    Running:runningCount,
    Desired:desiredCount,
    Pending:pendingCount,
    Rollout:rolloutState
  }'"

# 또는 단일 실행
aws ecs describe-services \
  --cluster default \
  --services ecs-express-demo \
  --region $AWS_REGION \
  --query 'services[0].deployments'

# ============================================
# 배포 완료 후 확인
# ============================================
curl -s $EXPRESS_URL/ | jq .version
# "2.0.0" 출력되어야 함

오토 스케일링 상세

Express Mode는 CPU 사용률 기반 Target Tracking 스케일링을 기본 적용합니다. 트래픽 패턴에 따라 태스크 수가 자동으로 조절됩니다.

실습 코드

# ============================================
# 현재 스케일링 설정 확인
# ============================================
# Scalable Target 확인
aws application-autoscaling describe-scalable-targets \
  --service-namespace ecs \
  --region $AWS_REGION \
  --query 'ScalableTargets[?contains(ResourceId, `ecs-express-demo`)]'

# 스케일링 정책 확인
aws application-autoscaling describe-scaling-policies \
  --service-namespace ecs \
  --region $AWS_REGION \
  --query 'ScalingPolicies[?contains(ResourceId, `ecs-express-demo`)]'

# ============================================
# 스케일링 범위 수정 (최소/최대 태스크)
# ============================================
# 프로덕션 환경: 최소 2개로 설정 (고가용성)
aws application-autoscaling register-scalable-target \
  --service-namespace ecs \
  --resource-id service/default/ecs-express-demo \
  --scalable-dimension ecs:service:DesiredCount \
  --min-capacity 2 \
  --max-capacity 20 \
  --region $AWS_REGION

# ============================================
# 추가 스케일링 정책 (요청 수 기반)
# ============================================
cat > request-scaling-policy.json << 'EOF'
{
  "TargetValue": 1000,
  "PredefinedMetricSpecification": {
    "PredefinedMetricType": "ALBRequestCountPerTarget",
    "ResourceLabel": "app/ecs-express-alb/1234567890/targetgroup/ecs-express-tg/0987654321"
  },
  "ScaleOutCooldown": 60,
  "ScaleInCooldown": 300
}
EOF

# 정책 적용 (ResourceLabel은 실제 값으로 변경 필요)
# aws application-autoscaling put-scaling-policy \
#   --service-namespace ecs \
#   --resource-id service/default/ecs-express-demo \
#   --scalable-dimension ecs:service:DesiredCount \
#   --policy-name request-count-scaling \
#   --policy-type TargetTrackingScaling \
#   --target-tracking-scaling-policy-configuration file://request-scaling-policy.json \
#   --region $AWS_REGION

# ============================================
# 부하 테스트 (선택사항)
# ============================================
# hey 설치 (macOS)
brew install hey

# 부하 테스트 실행
hey -n 10000 -c 100 -q 50 $EXPRESS_URL/

# 또는 Apache Bench 사용
ab -n 10000 -c 100 $EXPRESS_URL/

# ============================================
# 스케일링 동작 모니터링
# ============================================
# 태스크 수 변화 모니터링
watch -n 10 "aws ecs describe-services \
  --cluster default \
  --services ecs-express-demo \
  --region $AWS_REGION \
  --query 'services[0].{Running:runningCount,Desired:desiredCount,Pending:pendingCount}'"

# 스케일링 활동 확인
aws application-autoscaling describe-scaling-activities \
  --service-namespace ecs \
  --resource-id service/default/ecs-express-demo \
  --region $AWS_REGION \
  --query 'ScalingActivities[*].{Time:StartTime,Status:StatusCode,Cause:Cause}'

모니터링 베스트 프랙티스

Express Mode는 CloudWatch와 자동으로 통합됩니다. 효과적인 모니터링을 위한 대시보드와 알람 설정 방법을 알아봅니다.

실습 코드

# ============================================
# Container Insights 활성화
# ============================================
aws ecs update-cluster-settings \
  --cluster default \
  --settings name=containerInsights,value=enabled \
  --region $AWS_REGION

# ============================================
# CloudWatch 로그 설정
# ============================================
# 로그 그룹 확인
aws logs describe-log-groups \
  --log-group-name-prefix /ecs/ecs-express-demo \
  --region $AWS_REGION

# 로그 보존 기간 설정 (30일)
aws logs put-retention-policy \
  --log-group-name /ecs/ecs-express-demo \
  --retention-in-days 30 \
  --region $AWS_REGION

# 최근 로그 조회
aws logs tail /ecs/ecs-express-demo \
  --since 1h \
  --follow \
  --region $AWS_REGION

# 에러 로그 필터링
aws logs filter-log-events \
  --log-group-name /ecs/ecs-express-demo \
  --filter-pattern "ERROR" \
  --start-time $(date -d '1 hour ago' +%s)000 \
  --region $AWS_REGION

# ============================================
# CloudWatch 알람 생성
# ============================================
# 5xx 에러율 알람
aws cloudwatch put-metric-alarm \
  --alarm-name "ECS-Express-Demo-5xx-Errors" \
  --alarm-description "Alert when 5xx error rate exceeds 1%" \
  --metric-name HTTPCode_Target_5XX_Count \
  --namespace AWS/ApplicationELB \
  --statistic Sum \
  --period 60 \
  --threshold 10 \
  --comparison-operator GreaterThanThreshold \
  --evaluation-periods 2 \
  --dimensions Name=LoadBalancer,Value=app/ecs-express-alb/1234567890 \
  --region $AWS_REGION

# CPU 사용률 알람
aws cloudwatch put-metric-alarm \
  --alarm-name "ECS-Express-Demo-High-CPU" \
  --alarm-description "Alert when CPU exceeds 80%" \
  --metric-name CPUUtilization \
  --namespace AWS/ECS \
  --statistic Average \
  --period 300 \
  --threshold 80 \
  --comparison-operator GreaterThanThreshold \
  --evaluation-periods 2 \
  --dimensions Name=ClusterName,Value=default Name=ServiceName,Value=ecs-express-demo \
  --region $AWS_REGION

# ============================================
# CloudWatch 대시보드 생성
# ============================================
cat > dashboard.json << 'EOF'
{
  "widgets": [
    {
      "type": "metric",
      "properties": {
        "title": "ECS Service Metrics",
        "metrics": [
          ["AWS/ECS", "CPUUtilization", "ClusterName", "default", "ServiceName", "ecs-express-demo"],
          [".", "MemoryUtilization", ".", ".", ".", "."]
        ],
        "period": 60,
        "stat": "Average"
      }
    },
    {
      "type": "metric",
      "properties": {
        "title": "ALB Request Count",
        "metrics": [
          ["AWS/ApplicationELB", "RequestCount", "LoadBalancer", "app/ecs-express-alb/xxx"]
        ],
        "period": 60,
        "stat": "Sum"
      }
    }
  ]
}
EOF

aws cloudwatch put-dashboard \
  --dashboard-name ECS-Express-Demo \
  --dashboard-body file://dashboard.json \
  --region $AWS_REGION

리소스 정리

Express Mode로 생성된 리소스들을 순서대로 삭제합니다. 의존성이 있는 리소스는 올바른 순서로 삭제해야 합니다.

실습 코드

# ============================================
# 1. ECS Express 서비스 삭제
# ============================================
SERVICE_ARN=$(aws ecs list-services \
  --cluster default \
  --region $AWS_REGION \
  --query 'serviceArns[?contains(@, `ecs-express-demo`)]|[0]' \
  --output text)

aws ecs delete-service \
  --cluster default \
  --service $SERVICE_ARN \
  --force \
  --region $AWS_REGION

# 서비스 삭제 완료 대기
aws ecs wait services-inactive \
  --cluster default \
  --services ecs-express-demo \
  --region $AWS_REGION

# ============================================
# 2. CloudWatch 알람 삭제
# ============================================
aws cloudwatch delete-alarms \
  --alarm-names "ECS-Express-Demo-5xx-Errors" "ECS-Express-Demo-High-CPU" \
  --region $AWS_REGION

# ============================================
# 3. CloudWatch 로그 그룹 삭제
# ============================================
aws logs delete-log-group \
  --log-group-name /ecs/ecs-express-demo \
  --region $AWS_REGION

# ============================================
# 4. ECR 이미지 및 리포지토리 삭제
# ============================================
# 모든 이미지 삭제
aws ecr batch-delete-image \
  --repository-name ecs-express-demo \
  --image-ids imageTag=v1 imageTag=v2 imageTag=latest \
  --region $AWS_REGION

# 리포지토리 삭제
aws ecr delete-repository \
  --repository-name ecs-express-demo \
  --force \
  --region $AWS_REGION

# ============================================
# 5. IAM 역할 삭제
# ============================================
# Task Execution Role
aws iam detach-role-policy \
  --role-name ecsExpressTaskExecutionRole \
  --policy-arn arn:aws:iam::aws:policy/service-role/AmazonECSTaskExecutionRolePolicy

aws iam delete-role-policy \
  --role-name ecsExpressTaskExecutionRole \
  --policy-name SecretsManagerAccess 2>/dev/null || true

aws iam delete-role --role-name ecsExpressTaskExecutionRole

# Infrastructure Role
aws iam detach-role-policy \
  --role-name ecsExpressInfraRole \
  --policy-arn arn:aws:iam::aws:policy/service-role/AmazonECSInfrastructureRolePolicyForExpressGateway

aws iam delete-role --role-name ecsExpressInfraRole

# ============================================
# 6. 로컬 파일 정리
# ============================================
cd ..
rm -rf ecs-express-workshop

# ============================================
# 정리 확인
# ============================================
echo "✅ 모든 리소스가 삭제되었습니다!"
echo ""
echo "확인 사항:"
echo "- ECS 서비스: 삭제됨"
echo "- ECR 리포지토리: 삭제됨"
echo "- IAM 역할: 삭제됨"
echo "- CloudWatch 로그: 삭제됨"