클라우드와 컨테이너
완전 정복 A-Z

Docker부터 Kubernetes, AWS까지 — 현업 백엔드의 배포 인프라 완전 가이드

# ━━━ 이미지 관리 ━━━
docker pull nginx:latest            # Docker Hub에서 이미지 다운로드
docker images                       # 로컬 이미지 목록 보기
docker rmi nginx:latest             # 이미지 삭제
docker build -t myapp:1.0 .         # Dockerfile로 이미지 빌드

# ━━━ 컨테이너 실행 ━━━
docker run nginx                    # 기본 실행 (포그라운드)
docker run -d nginx                 # 백그라운드(detached) 실행
docker run -d -p 8080:80 nginx      # 포트 매핑 (호스트:컨테이너)
docker run -d   -p 3000:3000   -e NODE_ENV=production            # 환경변수 설정
  -v /data:/app/data               # 볼륨 마운트
  --name myapp                      # 컨테이너 이름 지정
  --restart unless-stopped          # 자동 재시작
  myapp:1.0

# ━━━ 컨테이너 관리 ━━━
docker ps                           # 실행 중인 컨테이너 목록
docker ps -a                        # 모든 컨테이너 (정지 포함)
docker stop myapp                   # 컨테이너 정지
docker start myapp                  # 컨테이너 시작
docker rm myapp                     # 컨테이너 삭제
docker logs -f myapp                # 실시간 로그 확인
docker exec -it myapp bash          # 실행 중인 컨테이너 내부 접속
docker stats                        # 컨테이너 리소스 사용량 모니터링

# ━━━ 이미지 배포 ━━━
docker tag myapp:1.0 myrepo/myapp:1.0
docker push myrepo/myapp:1.0        # Docker Hub에 업로드

# ━━━ 정리 명령어 ━━━
docker system prune -a              # 미사용 이미지/컨테이너 전체 삭제

# .dockerignore — 빌드 컨텍스트에서 제외
node_modules         # 가장 중요! 로컬 node_modules 제외
.git                 # git 이력 제외
.env                 # 환경변수 파일 절대 포함하지 말 것!
.env.*
dist                 # 빌드 결과물 (컨테이너 내에서 빌드)
coverage             # 테스트 커버리지
*.log
*.md
.DS_Store
docker-compose*.yml  # 컴포즈 파일 제외

# docker-compose.yml — 실전 NestJS 풀스택 구성
version: '3.9'

services:
  # ─── 앱 서버 ───
  api:
    build:
      context: .
      dockerfile: Dockerfile
      target: runner           # 멀티스테이지에서 runner 스테이지만 빌드
    container_name: nestjs-api
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
      - DATABASE_URL=postgresql://user:pass@postgres:5432/mydb
      - REDIS_URL=redis://redis:6379
    depends_on:
      postgres:
        condition: service_healthy  # DB 준비 후 시작
      redis:
        condition: service_healthy
    restart: unless-stopped
    networks:
      - app-network

  # ─── PostgreSQL ───
  postgres:
    image: postgres:15-alpine
    container_name: postgres-db
    environment:
      POSTGRES_DB: mydb
      POSTGRES_USER: user
      POSTGRES_PASSWORD: pass
    volumes:
      - postgres-data:/var/lib/postgresql/data  # 데이터 영구 저장
      - ./init.sql:/docker-entrypoint-initdb.d/init.sql  # 초기 SQL 실행
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U user -d mydb"]
      interval: 10s
      timeout: 5s
      retries: 5
    networks:
      - app-network

  # ─── Redis ───
  redis:
    image: redis:7-alpine
    container_name: redis-cache
    command: redis-server --requirepass mypassword --maxmemory 256mb --maxmemory-policy allkeys-lru
    volumes:
      - redis-data:/data
    healthcheck:
      test: ["CMD", "redis-cli", "--no-auth-warning", "-a", "mypassword", "ping"]
      interval: 10s
    networks:
      - app-network

  # ─── Nginx (리버스 프록시) ───
  nginx:
    image: nginx:alpine
    container_name: nginx-proxy
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
      - ./ssl:/etc/ssl/certs:ro
    depends_on:
      - api
    networks:
      - app-network

volumes:
  postgres-data:
  redis-data:

networks:
  app-network:
    driver: bridge

# 기본 조회
kubectl get pods -n production          # Pod 목록
kubectl get pods -n production -w        # 실시간 상태 감시
kubectl get all -n production           # 모든 리소스 조회
kubectl describe pod nestjs-api-xxx     # Pod 상세 정보 (오류 디버깅)
kubectl logs -f nestjs-api-xxx          # Pod 로그 실시간
kubectl exec -it nestjs-api-xxx -- bash # Pod 내부 접속

# 배포
kubectl apply -f ./k8s/                # 디렉토리 내 모든 yaml 적용
kubectl set image deployment/nestjs-api nestjs-api=myrepo/nestjs-api:v1.3.0
kubectl rollout status deployment/nestjs-api   # 배포 진행 상황
kubectl rollout history deployment/nestjs-api  # 배포 이력
kubectl rollout undo deployment/nestjs-api     # 이전 버전으로 롤백!
kubectl scale deployment nestjs-api --replicas=5  # 수동 스케일링

# NestJS RDS 연결 설정 (TypeORM)
TypeOrmModule.forRootAsync({
  useFactory: () => ({
    type: 'postgres',
    host: process.env.DB_HOST,           # RDS 엔드포인트
    port: +process.env.DB_PORT || 5432,
    username: process.env.DB_USER,
    password: process.env.DB_PASSWORD,
    database: process.env.DB_NAME,
    ssl: process.env.NODE_ENV === 'production'
      ? { rejectUnauthorized: false }   # RDS SSL 연결
      : false,
    entities: [__dirname + '/**/*.entity{.ts,.js}'],
    migrations: [__dirname + '/migrations/**/*{.ts,.js}'],
    synchronize: process.env.NODE_ENV !== 'production',  # 운영에서 false!
    logging: process.env.NODE_ENV !== 'production',
    # 커넥션 풀 설정 (RDS 동시 연결 제한 주의)
    extra: {
      max: 10,                # 최대 연결 수
      idleTimeoutMillis: 30000,
      connectionTimeoutMillis: 2000,
    },
  }),
})

// S3 파일 업로드 서비스 (NestJS)
@Injectable()
export class S3Service {
  private s3: S3Client;

  constructor() {
    this.s3 = new S3Client({
      region: process.env.AWS_REGION,
      credentials: {
        accessKeyId: process.env.AWS_ACCESS_KEY_ID,
        secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
      },
    });
  }

  async uploadFile(file: Express.Multer.File, folder: string = 'uploads') {
    const ext = path.extname(file.originalname);
    const key = `${folder}/${Date.now()}-${uuidv4()}${ext}`;

    const command = new PutObjectCommand({
      Bucket: process.env.AWS_S3_BUCKET,
      Key: key,
      Body: file.buffer,
      ContentType: file.mimetype,
      // ACL: 'public-read', // 퍼블릭으로 공개 (CloudFront 사용 시 불필요)
      Metadata: {
        originalName: file.originalname,
        uploadedBy: 'api-server',
      },
    });

    await this.s3.send(command);

    // CloudFront CDN URL 반환 (직접 S3 URL 노출 비권장)
    return {
      key,
      url: `https://${process.env.CLOUDFRONT_DOMAIN}/${key}`,
    };
  }

  // Presigned URL — 클라이언트가 S3에 직접 업로드
  async getPresignedUploadUrl(fileName: string, contentType: string) {
    const key = `uploads/${Date.now()}-${uuidv4()}-${fileName}`;
    const command = new PutObjectCommand({
      Bucket: process.env.AWS_S3_BUCKET,
      Key: key,
      ContentType: contentType,
    });
    const presignedUrl = await getSignedUrl(this.s3, command, { expiresIn: 300 }); // 5분
    return { key, presignedUrl };
  }
}

# main.tf — NestJS 운영 인프라 전체 정의 terraform { required_providers { aws = { source = "hashicorp/aws" version = "~> 5.0" } } backend "s3" { bucket = "myapp-terraform-state" key = "production/terraform.tfstate" region = "ap-northeast-2" } } provider "aws" { region = var.aws_region } # RDS PostgreSQL resource "aws_db_instance" "postgres" { identifier = "myapp-postgres" engine = "postgres" engine_version = "15.4" instance_class = "db.t3.medium" allocated_storage = 20 storage_encrypted = true db_name = var.db_name username = var.db_username password = var.db_password multi_az = true deletion_protection = true backup_retention_period = 7 skip_final_snapshot = false tags = { Name = "myapp-postgres", Env = "production" } } # ElastiCache Redis resource "aws_elasticache_replication_group" "redis" { replication_group_id = "myapp-redis" description = "MyApp Redis Cluster" node_type = "cache.t3.micro" num_cache_clusters = 2 automatic_failover_enabled = true at_rest_encryption_enabled = true transit_encryption_enabled = true } # Terraform 명령어 # terraform init    → 초기화 # terraform plan    → 변경 미리보기 (dry-run) # terraform apply   → 실제 인프라 생성/변경 # terraform destroy → 전체 인프라 삭제

# IAM Policy 예시 — S3 특정 버킷 읽기/쓰기만 허용 { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:GetObject", "s3:PutObject", "s3:DeleteObject" ], "Resource": "arn:aws:s3:::myapp-uploads/*" }, { "Effect": "Allow", "Action": "s3:ListBucket", "Resource": "arn:aws:s3:::myapp-uploads" } ] } # 나쁜 예 (절대 하지 말 것!) # "Action": "*", "Resource": "*" → 모든 서비스 모든 작업 허용! # EC2 인스턴스에 IAM Role 적용 (Access Key 사용 X) resource "aws_iam_role" "ec2_role" { name = "ec2-app-role" assume_role_policy = jsonencode({ Statement = [{ Action = "sts:AssumeRole" Effect = "Allow" Principal = { Service = "ec2.amazonaws.com" } }] }) } # EC2에 Role 적용 시 코드에 AccessKey 하드코딩 불필요! # AWS SDK가 자동으로 인스턴스 메타데이터에서 인증 처리

🚨 절대 하지 말아야 할 보안 실수 TOP 5

// NestJS Prometheus 메트릭 노출 // npm install @willsoto/nestjs-prometheus prom-client @Module({ imports: [ PrometheusModule.register({ defaultMetrics: { enabled: true }, path: '/metrics', }), ], }) // 커스텀 메트릭 정의 @Injectable() export class AppMetrics { private httpRequestsTotal: Counter; private httpRequestDuration: Histogram; constructor() { this.httpRequestsTotal = new Counter({ name: 'http_requests_total', help: 'Total HTTP requests', labelNames: ['method', 'path', 'status'], }); this.httpRequestDuration = new Histogram({ name: 'http_request_duration_seconds', help: 'HTTP request duration in seconds', labelNames: ['method', 'path'], buckets: [0.1, 0.3, 0.5, 1, 3, 5, 10], }); } recordRequest(method: string, path: string, status: number, duration: number) { this.httpRequestsTotal.labels(method, path, String(status)).inc(); this.httpRequestDuration.labels(method, path).observe(duration); } }

🔔 Grafana 핵심 알람 설정 가이드

⚠️ 비용 폭탄 방지 필수 설정

// Lambda 핸들러 — NestJS to Serverless // npm install @vendia/serverless-express import { NestFactory } from '@nestjs/core'; import { AppModule } from './app.module'; import serverlessExpress from '@vendia/serverless-express'; let cachedServer: any; async function bootstrap() { if (!cachedServer) { const app = await NestFactory.create(AppModule); await app.init(); const expressApp = app.getHttpAdapter().getInstance(); cachedServer = serverlessExpress({ app: expressApp }); } return cachedServer; } // Lambda 핸들러 export const handler = async (event: any, context: any) => { const server = await bootstrap(); return server(event, context); }; // Cold Start 최소화 팁: // 1. Provisioned Concurrency 설정 (항상 워밍업) // 2. 번들 크기 최소화 (트리쉐이킹) // 3. 불필요한 의존성 제거