feat: 운영 Ingress를 Traefik으로 전환하고 가용성 및 모니터링 강화

.github/workflows/ci-cd.yml

@@ -6,7 +6,7 @@ on:
   push:
     branches:
       - main
-      - feat/week11
+      - cvt/traefik
     paths:
       - 'url-shortener/app/**'
       - 'url-shortener/Dockerfile'

README.md

@@ -12,6 +12,11 @@ FastAPI 애플리케이션을 AWS EKS에 배포하기 위한 인프라, CI/CD, G
 
 ## 아키텍처
 
+### 멀티 AZ 인프라 아키텍처
+<img width="2752" height="1536" alt="AIDrawing_260901_9c28db43-9288-4fec-9dae-449eb76fbda3_0_MiriCanvas" src="https://github.com/user-attachments/assets/ce64e73e-4368-409a-ab73-780ced0ea609" />
+
+### nginx Ingress 기반 트래픽 흐름 구조
+
 <img width="1500" height="1200" alt="image" src="https://github.com/user-attachments/assets/75e00e20-4614-432d-851a-9dd72df3e539" />
 
 

cluster-addons/prometheus/values.yaml

@@ -55,6 +55,10 @@ alertmanager:
       group_wait: 0s          # 알림을 묶어서 보낼 대기 시간
       repeat_interval: 1h      # 해결 안 된 알림 재발송 간격
       receiver: slack-notifications # 알림 수신자
+      routes:
+        - matchers:
+            - alertname="Watchdog"
+          receiver: "null"
 
     receivers:
       - name: "null"              # Watchdog 등 무시할 알림용 no-op receiver

cluster-addons/traefik/application.yaml

@@ -0,0 +1,110 @@
+apiVersion: argoproj.io/v1alpha1
+kind: Application
+metadata:
+  name: traefik
+  namespace: argocd
+spec:
+  project: default
+  source:
+    repoURL: https://traefik.github.io/charts
+    chart: traefik
+    targetRevision: 41.0.2
+    helm:
+      values: |
+        deployment:
+          replicas: 2
+
+        resources:
+          requests:
+            cpu: 200m
+            memory: 256Mi
+          limits:
+            cpu: 1000m
+            memory: 512Mi
+
+        podDisruptionBudget:
+          enabled: true
+          minAvailable: 1
+
+        # DoNotSchedule: 두 번째 replica를 다른 AZ/노드에 둘 수 없으면 Pending으로 두어
+        # 단일 AZ 장애를 Ready replica로 숨기지 않는다.
+        topologySpreadConstraints:
+          - maxSkew: 1
+            topologyKey: topology.kubernetes.io/zone
+            whenUnsatisfiable: DoNotSchedule
+            labelSelector:
+              matchLabels:
+                app.kubernetes.io/name: traefik
+                app.kubernetes.io/instance: traefik-traefik
+          - maxSkew: 1
+            topologyKey: kubernetes.io/hostname
+            whenUnsatisfiable: DoNotSchedule
+            labelSelector:
+              matchLabels:
+                app.kubernetes.io/name: traefik
+                app.kubernetes.io/instance: traefik-traefik
+
+        ingressClass:
+          enabled: true
+          isDefaultClass: false # true 로 설정하면 traefik-ingress-controller 가 ingressClassName 을 쓰지 않은 Ingress 도 처리할 수 있음
+          name: traefik
+
+        # 라우팅 설정을 어디서 읽어 올지 결정하는 설정
+        providers:
+          kubernetesCRD:
+            enabled: true
+            ingressClass: traefik
+          kubernetesIngress:
+            enabled: true
+            ingressClass: traefik
+            publishedService:
+              enabled: true
+
+        service:
+          enabled: true
+          annotations:
+            service.beta.kubernetes.io/aws-load-balancer-type: "external"
+            service.beta.kubernetes.io/aws-load-balancer-nlb-target-type: "ip"
+            service.beta.kubernetes.io/aws-load-balancer-scheme: "internet-facing"
+            service.beta.kubernetes.io/aws-load-balancer-target-group-attributes: "preserve_client_ip.enabled=true"
+          spec:
+            type: LoadBalancer
+
+        ports:
+          web:
+            exposedPort: 80
+            # http:
+            #   redirections:
+            #     entryPoint:
+            #       to: websecure
+            #       scheme: https
+            #       permanent: true
+          websecure:
+            exposedPort: 443
+
+        log:
+          level: INFO
+        accessLog:
+          enabled: true
+
+        metrics:
+          prometheus:
+            addEntryPointsLabels: true
+            addRoutersLabels: true
+            addServicesLabels: true
+            buckets: "0.01,0.025,0.05,0.1,0.25,0.5,1.0,2.0,5.0"
+            service:
+              enabled: true
+            serviceMonitor:
+              enabled: true
+              additionalLabels:
+                release: kube-prometheus-stack
+  destination:
+    server: https://kubernetes.default.svc
+    namespace: traefik
+  syncPolicy:
+    automated:
+      prune: true
+      selfHeal: true
+    syncOptions:
+      - CreateNamespace=true

terraform/github_actions.tf

@@ -16,16 +16,17 @@ module "github_actions_role" {
   version = "~> 6.0"
 
   name            = "${var.project_name}-github-actions-role"
-  use_name_prefix = false  # 타임스탬프 suffix 방지
+  use_name_prefix = false # 타임스탬프 suffix 방지
 
   enable_github_oidc = true # ← 추가 (GitHub OIDC 신뢰 관계 자동 구성)
 
   # 보안: 특정 레포지토리의 main 브랜치만 허용
   # pull_request 이벤트까지 허용하려면 "repo:org/repo:*"으로 변경
   # TODO: dev, prod 환경 구분하기
+  # 현재 저장소의 모든 브랜치와 pull_request 이벤트 허용
   oidc_wildcard_subjects = [
-    "repo:f-lab-edu/Url-Shortener-EKS-Platform:ref:refs/heads/*",  # 모든 브랜치 허용
-    "repo:f-lab-edu/Url-Shortener-EKS-Platform:pull_request"
+    "repo:f-lab-edu/F-Lab-DevOps:ref:refs/heads/*",
+    "repo:f-lab-edu/F-Lab-DevOps:pull_request"
   ]
 
   policies = {

terraform/karpenter.tf

@@ -1,5 +1,10 @@
+# Karpenter가 Spot 인스턴스를 생성할 때 사용하는 AWS 관리형 서비스 연결 역할
+resource "aws_iam_service_linked_role" "ec2_spot" {
+  aws_service_name = "spot.amazonaws.com"
+}
+
 # Karpenter 인프라 — terraform-aws-modules/eks karpenter 서브모듈 사용
-# Controller IRSA + Node Role + Instance Profile + SQS + EventBridge를 한 번에 생성
+# Controller Pod Identity + Node Role + Instance Profile + SQS + EventBridge를 한 번에 생성
 
 module "karpenter" {
   source  = "terraform-aws-modules/eks/aws//modules/karpenter"

terraform/main.tf

@@ -310,7 +310,7 @@ module "eks" {
   eks_managed_node_groups = {
     main = {
       name            = "${var.project_name}-nodegroup"
-      use_name_prefix = false  # 타임스탬프 suffix 방지 - 항상 동일한 이름 유지
+      use_name_prefix = true  # 교체 시 새 노드 그룹을 먼저 생성할 수 있도록 이름 충돌 방지
 
       iam_role_name            = "${var.project_name}-nodegroup-role"
       iam_role_use_name_prefix = false

terraform/variables.tf

@@ -27,13 +27,13 @@ variable "availability_zones" {
 variable "eks_cluster_version" {
   description = "EKS Kubernetes 버전"
   type = string
-  default = "1.34"
+  default = "1.35"
 }
 
 variable "node_instance_type" {
   description = "EKS Worker Node EC2 인스턴스 타입"
   type = string
-  default = "t3.medium"
+  default = "t3.large"
 }
 
 # terraform apply 시 생성되는 노드 수
@@ -61,4 +61,4 @@ variable "db_password" {
   description = "RDS master(user=postgres) password (manage_master_user_password=false 사용 시 필수)"
   type        = string
   sensitive   = true
-}
+}