YG Tech Blog

1️⃣ Kubernetes는 어떻게 동작할까? 이전 글에서 **Kubernetes의 기본 개념(Cluster, Node, Pod)**을 배웠습니다.이제 Kubernetes 클러스터의 전체 아키텍처를 깊이 있게 분석해 보겠습니다.  Kubernetes는 **Master Node(제어부)**와 **Worker Node(실행부)**로 구성됩니다.Master Node는 클러스터의 “두뇌” 역할을, Worker Node는 “일꾼” 역할을 수행합니다. 아래 다이어그램을 보며 함께 살펴볼까요? 👀  2️⃣ Kubernetes 아키텍처 개요 📌 Kubernetes 아키텍처의 주요 구성 요소+--------------------------+ +---------------------------+| 🏢 Mast..

1️⃣ Kubernetes는 어떻게 동작할까? Kubernetes는 단순한 컨테이너 오케스트레이션 툴이 아닙니다.Kubernetes는 컨테이너 애플리케이션을 효율적으로 관리하는 분산 시스템입니다.  “Kubernetes는 수천 개의 컨테이너를 자동으로 배포하고, 스케일링하며, 관리하는 역할을 합니다.” Kubernetes의 구조를 이해하려면, Pod, Node, Cluster 개념을 먼저 파악해야 합니다.이제 하나씩 살펴볼까요? 🚀  2️⃣ Kubernetes Cluster란? Kubernetes의 기본 단위는 **클러스터(Cluster)**입니다. 📌 Kubernetes 클러스터의 개념 • **클러스터(Cluster)**는 여러 개의 **노드(Node)**가 모여 하나의 시스템처럼 동작하는 구조입니..

1️⃣ Monolithic 아키텍처란? 과거 대부분의 애플리케이션은 모놀리식(Monolithic) 아키텍처로 개발되었습니다.모놀리식 아키텍처는 모든 기능이 하나의 애플리케이션 내부에서 동작하는 구조를 의미합니다. ✅ Monolithic 구조 예시 하나의 애플리케이션이 다음과 같은 기능을 포함하고 있다고 가정해 봅시다. 📌 쇼핑몰 애플리케이션+-------------------------+| 🛒 쇼핑몰 애플리케이션 ||-------------------------|| 🔍 상품 검색 || 🛍️ 장바구니 || 💳 결제 시스템 || 📦 주문 관리 |+-------------------------+✅ 모든 기능이 하나의 코드베이스..

1️⃣ 컨테이너의 발전과 새로운 문제들 Docker와 같은 컨테이너 기술 덕분에 애플리케이션을 쉽고 빠르게 배포할 수 있게 되었습니다.하지만, 컨테이너를 대량으로 운영하다 보면 수동 관리로는 해결할 수 없는 문제들이 발생하게 됩니다. 👉 예제 시나리오:📦 “내 애플리케이션을 Docker 컨테이너로 배포했어요!”✅ 실행이 잘 됩니다.❌ 하지만… 몇 가지 문제점이 발생합니다. ✅ 문제 1: 컨테이너 장애 발생 시 자동 복구가 필요함 • 특정 컨테이너가 예상치 못하게 종료된다면? • 개발자가 직접 다시 실행해야 할까요? ✅ 문제 2: 서비스 트래픽 증가에 따른 자동 확장이 필요함 • 쇼핑몰의 트래픽이 갑자기 폭증하면? • 미리 컨테이너를 많이 실행해 두어야 할까요? ✅ 문제 3: 컨테이너 간 네트워크 및 ..

1️⃣ Kubernetes의 등장 배경 현대 애플리케이션 개발에서는 컨테이너(Container) 기술이 필수 요소가 되었습니다.Docker 같은 컨테이너 기술 덕분에 애플리케이션을 어디서든 실행할 수 있지만,문제는 수백~수천 개의 컨테이너를 어떻게 관리할 것인가? 하는 것이었습니다. ✅ 컨테이너가 많아질수록 발생하는 문제: • 컨테이너가 실행 중인지 하나하나 확인해야 한다. • 컨테이너가 장애가 나면 자동으로 복구해야 한다. • 서비스 트래픽에 맞춰 컨테이너 개수를 자동으로 조정해야 한다. • 특정 컨테이너로 요청을 보낼 방법이 필요하다. 이 모든 문제를 해결하기 위해 컨테이너 오케스트레이션(Container Orchestration) 기술이 등장했고,그 중 가장 강력한 툴이 바로 **Kubernetes..

Kubernetes를 사용하다 보면 특정 카테고리에 속하지 않는 다양한 오류를 경험할 수 있습니다.이 글에서는 노드 정보 조회 실패, API 서버 문제, 플래그 오류, 명령어 오류 등과 관련된 대표적인 일반적인 Kubernetes 오류 5가지를 정리하고, 각각의 원인과 해결 방법을 설명합니다. 🚀  1️⃣ “failed to fetch node info…” 🔎 오류 설명 이 오류는 노드가 정상적으로 동작하지 않거나, kubelet이 노드 정보를 가져오는 데 실패했을 때 발생합니다.주로 노드 상태가 NotReady이거나, API 서버와 연결이 끊긴 경우입니다. 🔧 해결 방법 1) 노드 상태 확인 노드가 정상적으로 실행되고 있는지 확인합니다.kubectl get nodes 2) 노드의 상세 상태 확인 ..

Kubernetes에서 보안 통신을 위해 TLS 및 인증서를 사용합니다.하지만 잘못된 인증서, 만료된 인증서, CA 신뢰 문제 등의 이유로 TLS 관련 오류가 발생할 수 있습니다.이 글에서는 Kubernetes 환경에서 발생할 수 있는 대표적인 TLS 및 인증서 문제 5가지를 정리하고, 각각의 원인과 해결 방법을 설명합니다. 🚀  1️⃣ “unable to connect to server: x509: certificate signed by unknown authority” 🔎 오류 설명 이 오류는 클라이언트가 API 서버의 인증서를 신뢰하지 않을 때 발생합니다.보통 CA 인증서가 잘못되었거나, 클러스터의 kubeconfig 파일이 올바르게 설정되지 않은 경우입니다. 🔧 해결 방법 1) 현재 클러스터..

Kubernetes에서는 네임스페이스를 사용하여 리소스를 격리하고 관리합니다.하지만 잘못된 네임스페이스 설정, 존재하지 않는 리소스 접근, 잘못된 kubeconfig 파일 등으로 인해 다양한 오류가 발생할 수 있습니다.이 글에서는 Kubernetes 환경에서 발생할 수 있는 대표적인 네임스페이스 및 설정 오류 5가지를 정리하고, 각각의 원인과 해결 방법을 설명합니다. 🚀  1️⃣ “No resources found in default namespace” 🔎 오류 설명 이 오류는 kubectl 명령어를 실행할 때 기본 네임스페이스에서 해당 리소스를 찾을 수 없을 때 발생합니다.Kubernetes에서 특정 네임스페이스를 지정하지 않으면 기본적으로 default 네임스페이스에서 조회를 시도합니다. 🔧 해..

Kubernetes에서 Pod을 배포할 때 노드의 리소스 부족, 스케줄링 조건 미충족, 예약된 리소스 초과 등의 이유로 스케줄링이 실패하는 경우가 많습니다.이 글에서는 Kubernetes 환경에서 발생할 수 있는 대표적인 리소스 제약 및 스케줄링 오류 5가지를 정리하고, 각각의 원인과 해결 방법을 설명합니다. 🚀  1️⃣ “Insufficient memory” 🔎 오류 설명 이 오류는 Pod이 요청한 메모리보다 노드에 가용한 메모리가 부족할 때 발생합니다.특히, 요청된 requests 및 limits 설정이 너무 높으면 문제가 발생할 수 있습니다. 🔧 해결 방법 1) 현재 클러스터의 노드 메모리 사용량 확인 클러스터의 모든 노드에서 가용한 메모리를 확인합니다.kubectl top nodes Pod이..

Kubernetes에서 영구적인 데이터 저장을 위해 Persistent Volume(PV)과 Persistent Volume Claim(PVC)을 사용합니다.하지만 스토리지 프로비저닝 문제, 볼륨 충돌, 마운트 실패 등의 다양한 오류가 발생할 수 있습니다.이 글에서는 Kubernetes 환경에서 발생할 수 있는 대표적인 Persistent Volume(스토리지) 관련 오류 5가지를 정리하고, 각각의 원인과 해결 방법을 설명합니다. 🚀  1️⃣ “Failed to attach volume…” 🔎 오류 설명 이 오류는 볼륨을 Pod에 연결할 수 없을 때 발생합니다.주로 스토리지 플러그인 문제, 볼륨이 이미 다른 노드에 연결된 경우, 또는 권한 문제로 인해 발생할 수 있습니다. 🔧 해결 방법 1) 볼륨 ..