Kubernetes on homelab89

ArgoCD Application 네임스페이스 Watch 범위

Thu, 02 Jul 2026 00:00:00 +0000

작성일: 2026-07-02 | 컴포넌트: argocd-server, argocd-application-controller, argocd-applicationset-controller

1. 핵심 사실

기본 설치 상태에서 ArgoCD는 자신이 설치된 네임스페이스(보통 argocd)에 있는 Application 커스텀 리소스만 list/watch함.
여러 네임스페이스(또는 전체)의 Application을 다루려면 argocd-cmd-params-cm ConfigMap의 application.namespaces 키를 명시적으로 설정해야 함. “Applications in any namespace” 기능 (v2.5+에서 지원).
AppProject는 이 설정과 무관하게 항상 ArgoCD 설치 네임스페이스에만 존재 가능. AppProject에는 네임스페이스 확장 기능 자체가 없음.

2. 설정 확인 방법

kubectl -n argocd get configmap argocd-cmd-params-cm -o jsonpath='{.data.application\.namespaces}'; echo

`data.application.namespaces` 상태	의미
키 없음	기본값 — 설치 네임스페이스만 watch
`"argocd"` (설치 네임스페이스와 동일 값)	명시적 지정, 결과는 기본값과 동일
`"*"`	전체 네임스페이스 watch
`"ns1,ns2"`, `"team-*"` (와일드카드 지원)	지정된 네임스페이스(들)만 watch

주의: ConfigMap 자체의 metadata.namespace: argocd는 이 ConfigMap 리소스가 어디 위치하는지를 나타낼 뿐 watch 범위와 무관함. 반드시 data 블록 안의 application.namespaces 키를 확인해야 함 — 헷갈리기 쉬운 포인트.

01. 사전 준비

Mon, 29 Jun 2026 00:00:00 +0000

호스트 패키지 확인 및 설치

# 필수 패키지 확인
dpkg -l | grep -E "virt-install|qemu-kvm|libvirt-daemon|genisoimage|cloud-image-utils|sshpass"

# 설치 (없는 것만)
sudo apt-get install -y \
  qemu-kvm \
  libvirt-daemon-system \
  libvirt-clients \
  virt-install \
  genisoimage \
  cloud-image-utils \
  sshpass \
  python3-pip \
  python3-venv

# libvirt 그룹 확인 (현재 사용자가 포함되어 있어야 함)
groups $USER | grep libvirt
# 없으면: sudo usermod -aG libvirt $USER && newgrp libvirt

SSH 키 준비

# 랩 전용 SSH 키 생성 (기존 키와 분리 권장)
ssh-keygen -t ed25519 -f ~/.ssh/k8s-lab -N "" -C "k8s-lab"

# 생성 확인
ls -la ~/.ssh/k8s-lab*
# ~/.ssh/k8s-lab      ← private key
# ~/.ssh/k8s-lab.pub  ← public key (cloud-init에 삽입됨)

Ubuntu 22.04 Cloud Image 다운로드

# 저장 위치: OS SSD에 여유 충분 (367GB available)
CLOUD_IMAGE_DIR="/var/lib/libvirt/images"
IMAGE_NAME="ubuntu-22.04-server-cloudimg-amd64.img"
IMAGE_URL="https://cloud-images.ubuntu.com/jammy/current/${IMAGE_NAME}"

sudo wget -O "${CLOUD_IMAGE_DIR}/${IMAGE_NAME}" "${IMAGE_URL}"

# 무결성 확인
sudo qemu-img info "${CLOUD_IMAGE_DIR}/${IMAGE_NAME}"

Python 가상환경 + kubespray 의존성 준비

cd /home/jinsoo/Documents/k8s-etcd-lab

# kubespray clone (03-setup-kubespray.sh에서 자동 처리)
git clone https://github.com/kubernetes-sigs/kubespray.git /tmp/kubespray-src

# Python venv 생성
python3 -m venv .venv
source .venv/bin/activate

# kubespray 의존성 설치
pip install -r /tmp/kubespray-src/requirements.txt

# ansible 버전 확인
ansible --version

리소스 요건 확인

항목	필요	현재 호스트
vCPU	12개 (4×3)	24스레드 ✅
RAM	24GB (8×3)	40GB ✅
디스크	120GB (40×3)	SSD 367GB 여유 ✅
네트워크	NAT 브릿지 1개	libvirt 사용 ✅

사전 확인 체크리스트

# KVM 사용 가능 여부
kvm-ok || sudo apt-get install cpu-checker

# libvirtd 실행 상태
sudo systemctl status libvirtd

# 기존 네트워크 확인 (libvirt default network)
virsh net-list --all

# 기존 VM 목록 확인
virsh list --all

03. kubespray 배포 가이드

Mon, 29 Jun 2026 00:00:00 +0000

kubespray 개요

kubespray는 Ansible 기반의 프로덕션급 Kubernetes 클러스터 배포 도구입니다.

kubespray (Ansible Playbook)
    └── cluster.yml
        ├── 부트스트랩 (python, pip 설치)
        ├── etcd 클러스터 구성 (3-node)
        ├── kube-apiserver, kube-scheduler, kube-controller-manager
        ├── kubelet, kube-proxy
        └── CNI (Calico)

kubespray Clone 및 환경 구성

cd /home/jinsoo/Documents/k8s-etcd-lab

# kubespray clone
git clone https://github.com/kubernetes-sigs/kubespray.git /tmp/kubespray-src

# 인벤토리 복사
cp -rfp /tmp/kubespray-src/inventory/sample kubespray/inventory/k8s-etcd-lab

# Python 가상환경 활성화 후 의존성 설치
source .venv/bin/activate
pip install -r /tmp/kubespray-src/requirements.txt

# ansible 연결 테스트
ansible all -i kubespray/inventory/k8s-etcd-lab/hosts.yaml \
    -m ping \
    --private-key ~/.ssh/k8s-lab \
    -u ubuntu

인벤토리 구조

kubespray/inventory/k8s-etcd-lab/hosts.yaml 파일을 사용합니다.

k8s-cp1 VM 네트워크 접속 불가 트러블슈팅

Mon, 29 Jun 2026 00:00:00 +0000

작성일: 2026-03-05

증상

virsh domifaddr k8s-cp1 결과에 IP가 표시되지 않음
VM에 SSH 접속 불가

원인 분석

원인 1: 네트워크 대역 불일치

VM은 virbr0 (libvirt 기본 NAT 네트워크, 198.51.100.0/24)에 연결되어 있었지만, cloud-init network-config에서는 203.0.113.70/24를 할당하고 있었다.

KIND Lab Usage Guide

Mon, 29 Jun 2026 00:00:00 +0000

Verified: 2026-03-02 환경: Ubuntu 24.04 LTS, Docker 29.2.1, KIND v0.31.0

도구 요약

도구	경로	용도
`kind`	`/usr/local/bin/kind`	클러스터 생성/삭제/관리
`kubectl`	`/usr/local/bin/kubectl` (alias: `k`)	K8s 리소스 조작
`helm`	`/usr/local/bin/helm`	차트 기반 앱 배포
`kubectl krew`	`~/.krew/bin/`	kubectl 플러그인 매니저
`kubectl ctx`	krew 플러그인	컨텍스트 전환
`kubectl ns`	krew 플러그인	네임스페이스 전환
`k9s`	`~/.local/bin/k9s`	터미널 기반 K8s 대시보드

클러스터 라이프사이클

클러스터 생성

구성 파일 위치: ~/kind-configs/

Runbook: KIND-Based Local Kubernetes Lab Setup

Mon, 29 Jun 2026 00:00:00 +0000

Date: 2026-03-02 KIND: v0.31.0 Kubernetes: v1.34.3 (single-node, control-plane only) Cluster Name: lab (context: kind-lab)

Verified Environment

Component	Detail
OS	Ubuntu 24.04.4 LTS, Linux 6.17.0-14-generic
Docker	29.2.1 (cgroup v2, systemd)
kubectl	v1.35.1
KIND	v0.31.0
Helm	v3.20.0
krew	v0.4.5 (플러그인 매니저)
k9s	v0.50.18
Shell	zsh + oh-my-zsh + Powerlevel10k

1. KIND 설치

GitHub releases에서 바이너리를 직접 다운로드하여 설치.

virsh + cloud-init VM 생성 가이드

Mon, 29 Jun 2026 00:00:00 +0000

작성일: 2026-03-05 환경: Ubuntu 24.04 호스트, libvirt/KVM, cloud-init

사전 조건

호스트에 br-host 브릿지가 구성되어 있어야 함 (203.0.113.0/24 대역)
원본 클라우드 이미지: /var/lib/libvirt/images/noble-server-cloudimg-amd64.img
cloud-init 설정 디렉토리: /var/lib/libvirt/cloud-init/

디렉토리 구조

/var/lib/libvirt/
├── images/
│   ├── noble-server-cloudimg-amd64.img   ← 원본 (수정 금지)
│   ├── k8s-cp1.qcow2                     ← VM별 디스크
│   └── ...
└── cloud-init/
    ├── k8s-cp1-user-data.yaml
    ├── k8s-cp1-network-config.yaml
    ├── k8s-cp1-cidata.iso
    └── ...

생성 절차

1. 변수 설정

NAME=k8s-worker1         # VM 이름
IP=203.0.113.71          # 할당할 IP
MEM=2048                 # 메모리 (MB)
VCPU=2                   # vCPU 수
DISK_SIZE=20G            # 디스크 크기
BASE_IMG=/var/lib/libvirt/images/noble-server-cloudimg-amd64.img
IMG=/var/lib/libvirt/images/${NAME}.qcow2
CLOUD_INIT_DIR=/var/lib/libvirt/cloud-init

2. user-data.yaml 작성

sudo tee ${CLOUD_INIT_DIR}/${NAME}-user-data.yaml > /dev/null <<'EOF'
#cloud-config
hostname: k8s-worker1
manage_etc_hosts: true
users:
  - name: kube
    sudo: ALL=(ALL) NOPASSWD:ALL
    shell: /bin/bash
    ssh_authorized_keys:
      - ssh-ed25519 AAAA...REPLACE-WITH-YOUR-PUBLIC-KEY... user@host
package_update: true
packages:
  - curl
  - wget
  - vim
  - net-tools
  - jq
  - tree
  - tcpdump
  - socat
  - conntrack
  - ipset
EOF

주의: 첫 줄의 #cloud-config은 반드시 포함해야 한다. 없으면 cloud-init이 동작하지 않는다.