최수정

카카오톡 메시지를 보내도 응답이 없고 '네트워크 오류'만 표시. 503 에러 코드조차 뜨지 않음.

일반 python:3.10-slim 이미지 사용. Lambda는 전용 런타임이 필요하며 Init 단계 자체가 실패해 카카오 측이 연결 거부로 판단.

FROM public.ecr.aws/lambda/python:3.10

Lambda 컨테이너 이미지는 반드시 public.ecr.aws/lambda/ 베이스 이미지 사용. GitHub Actions deploy.yaml에 명시하여 수동 배포 실수 방지.

Lambda 내부 500대 에러 발생 시 카카오 측에서 연결 강제 종료. sam logs로 로그 직접 확인.

handler = Mangum(app, lifespan="off")

CloudWatch Lambda Errors 알람 설정으로 에러 발생 즉시 Slack 알림 수신. 배포 후 에러율 모니터링 습관화.

기존 빌드 캐시(.aws-sam)가 오염된 상태로 올라간 것.

rmdir /s /q .aws-sam
sam build --use-container
sam deploy

GitHub Actions에서 sam build를 자동화하여 로컬 캐시 문제 원천 제거. 수동 배포 프로세스 자체를 없앰.

AWS_REGION은 Lambda 런타임 예약 환경 변수. 사용자가 덮어쓰면 값이 무시되거나 충돌 경고 발생.

Variables:
  MY_APP_REGION: ap-northeast-2

Lambda 예약 환경 변수 목록 숙지. AWS_ 접두사 환경변수 사용 시 공식 문서 확인 습관화.

GitHub Actions에서 terraform apply 시 IAM 유저/그룹 전부 EntityAlreadyExists 에러.

로컬 terraform.tfstate가 .gitignore로 미업로드. Actions가 빈 state에서 시작해 기존 리소스를 새로 만들려다 충돌.

backend "s3" {
  bucket = "aws-sam-cli-managed-..."
  key    = "iam/terraform.tfstate"
}
terraform init -migrate-state

S3 Remote Backend로 state를 중앙 관리. 어떤 환경에서 실행해도 동일한 state 참조. PR 시 terraform plan 자동 검증으로 적용 전 확인.

terraform apply 시 AccessDeniedException: events:PutRule 에러. IAM 정책을 방금 추가했는데도 권한 없음.

Terraform이 IAM 정책 attachment와 EventBridge rule을 병렬로 실행. 정책이 완전히 적용되기 전에 PutRule 호출.

resource "aws_cloudwatch_event_rule" "warmup" {
  depends_on = [aws_iam_group_policy_attachment.deployer]
}

IAM 정책 변경과 해당 권한을 사용하는 리소스가 함께 추가될 때는 항상 depends_on 명시.

local-path-provisioner가 PVC 디렉토리를 root 소유로 생성. runAsUser: 999를 함께 설정하면 오히려 권한이 없어짐.

securityContext:
  fsGroup: 999  # runAsUser, runAsGroup 제거

StatefulSet 배포 시 securityContext 설정 가이드 문서화하여 팀 공유. fsGroup만 단독 사용 원칙 명시.

3-node KRaft는 과반수 노드가 동시에 떠야 리더 선출 가능. StatefulSet 기본 순차 실행으로 kafka-0 혼자 먼저 떠서 쿼럼 불가 → 데드락.

spec:
  podManagementPolicy: Parallel
# headless Service
publishNotReadyAddresses: true

Kafka StatefulSet 배포 템플릿에 Parallel 설정을 기본값으로 포함. 트러블슈팅 문서에 KRaft 쿼럼 요구사항 명시.

Tailscale 설치 후 Calico가 tailscale0을 노드 IP로 착각 → CoreDNS / kube-proxy / local-path-provisioner 연쇄 CrashLoop.

Calico IP 자동 감지가 Tailscale VPN 인터페이스를 우선 선택. Pod 네트워크 라우팅 전체 붕괴.

kubectl patch felixconfiguration default \
  --type=merge \
  -p '{"spec":{"ipv4DetectionMethod":"interface=enp0s8"}}'
sudo tailscale up --accept-routes=false

Tailscale 설치 SOP 문서화: ① felixconfiguration 패치 먼저 ② --accept-routes=false 옵션 필수 ③ 설치 후 전 노드 CNI 상태 확인. 팀 전체 공유.

DNAT 설정 후에도 SYN 패킷만 반복. SYN-ACK 없음 (tcpdump로 확인).

DNAT으로 요청은 worker3으로 전달되나 응답 패킷 출발지가 worker3 IP → 클라이언트가 예상 못한 IP로 판단 거부. MASQUERADE 누락.

sudo iptables -t nat -A PREROUTING -i tailscale0 \
  -p tcp --dport 50007 -j DNAT \
  --to-destination 192.168.56.13:30007
sudo iptables -t nat -A POSTROUTING \
  -p tcp -d 192.168.56.13 --dport 30007 -j MASQUERADE

iptables 설정 스크립트화 + netfilter-persistent save로 영구 저장. DNAT 설정 시 MASQUERADE 세트로 체크리스트화.

Vite는 빌드 타임에 환경변수를 JS 번들에 직접 삽입. 런타임 변경 불가. 기존 이미지에 학원 PC IP 하드코딩.

docker build --no-cache \
  --build-arg VITE_API_URL=http://100.x.x.x:50007/api \
  -t soojungchoi/wattup-fe:v1.6 .

배포 환경별 빌드 스크립트 분리 문서화. 또는 nginx에서 런타임 환경변수 주입 방식으로 개선 예정.

OCI 인스턴스에서 Podman 배포 후 외부 접근 불가. localhost는 정상.

OCI는 Red Hat 계열 OS로 Podman 기본. nftables FORWARD 체인에 reject with icmp type host-prohibited 규칙이 컨테이너 포워딩 차단.

sudo nft flush ruleset
sudo netfilter-persistent save

OCI 인스턴스 초기 설정 가이드 문서화: iptables/nftables 동시 동작 확인, Security List Source Port All 설정, Podman daemonless 특성 명시.