Docs on homelab89

Blog 사용법

Sat, 04 Jul 2026 00:00:00 +0000

이 blog(~/blog)에 글을 쓰는 방법 요약. 전체 설계는 ~/Documents/docs/knowledge-base-architecture.md 참조.

번들 구조: 문서 1건 = 폴더 1개

<번들 슬러그>/
├── index.md      <- 본문 (markdown 원본 그대로)
└── files/        <- 이 글에서 나온 코드·그림·스크립트
    └── verify.sh

본문에서는 files/<파일명> 형태의 상대 링크로 부속 산출물을 참조한다. 예: [검증 스크립트](files/sample.sh).

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 파일을 사용합니다.

04. etcd 장애 실험 시나리오

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

etcd Raft 쿼럼 기본 원리

3-node etcd 클러스터:
  - 쿼럼(과반수) = 2
  - 1개 장애: 쿼럼 유지 (2/3 살아있음) → 클러스터 정상 운영
  - 2개 장애: 쿼럼 붕괴 (1/3만 살아있음) → 클러스터 읽기 전용 / 쓰기 불가
  - 3개 장애: 완전 다운

  장애 허용 공식: floor((n-1)/2)
  3노드: floor((3-1)/2) = 1개까지 허용

실험 전 준비

export KUBECONFIG=~/.kube/k8s-etcd-lab.conf

# 실험 전 etcd 상태 베이스라인 기록
kubectl get nodes
kubectl get pods -n kube-system

# etcd 헬스체크 (ctrl1에서)
ssh k8s-ctrl1 "sudo ETCDCTL_API=3 etcdctl \
  --endpoints=https://203.0.113.11:2379,https://203.0.113.12:2379,https://203.0.113.13:2379 \
  --cacert=/etc/ssl/etcd/ssl/ca.pem \
  --cert=/etc/ssl/etcd/ssl/member-k8s-ctrl1.pem \
  --key=/etc/ssl/etcd/ssl/member-k8s-ctrl1-key.pem \
  endpoint health -w table"

시나리오 1: 단일 노드 장애 (쿼럼 유지)

목표: etcd 노드 1개 정지 후 클러스터 운영 영향 확인

05. etcd 복구 절차

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

복구 시나리오 분류

상황	방법
단일 노드 장애 (데이터 intact)	etcd 재시작으로 자동 동기화
단일 노드 장애 (데이터 손상)	멤버 제거 → 재추가
과반수 장애 (데이터 intact)	모든 노드 재시작
전체 장애 / 데이터 손상	스냅샷으로 복구

복구 1: 단일 노드 자동 재동기화

etcd 데이터가 살아있고 단순히 프로세스가 죽은 경우입니다.

Cloudflare 도메인 활성화 런북 — quick tunnel → 고정 도메인 + Named Tunnel (+ Access)

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

Date: 2026-06-29 호스트: ubuntu (home server) 도메인: Networking / 운영 용도: 위키 포털의 임시 *.trycloudflare.com URL(리붓마다 변경)을 고정 커스텀 도메인으로 승격.

0. 왜 필요한가 (동기)

현재 포털은 Cloudflare quick tunnel로 노출 중이다. quick tunnel은 kb-tunnel 컨테이너가 재시작될 때마다 URL이 바뀐다(예: 직전 리붓 후 https://space-recovery-personnel-experimental.trycloudflare.com). 외울 수도, 북마크할 수도, 사내에 고정 공유할 수도 없다. → 본인 소유 도메인 + Named Tunnel로 바꾸면 리붓해도 주소가 불변이고, 선택적으로 Cloudflare Access(SSO)로 private을 보호할 수 있다.

HTTP Tunneling

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

HTTP Tunneling이란?

HTTP Tunneling은 HTTP 프로토콜을 통로(터널)로 사용하여, 원래 HTTP가 아닌 트래픽을 전달하는 기법이다.

많은 기업 네트워크/방화벽은 HTTP(80)와 HTTPS(443) 포트만 허용한다. HTTP tunneling을 사용하면 이 제한된 환경에서도 다른 프로토콜의 트래픽을 주고받을 수 있다.

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/

Linux CFS Scheduler 완전 정리 (Kernel 6.x 기준)

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

작성일: 2026-02-21 커널 버전: 6.17.0-14-generic (Ubuntu 24.04.4 LTS) 목적: CFS 동작 원리, 한계, EEVDF 전환 배경까지 이해

1. 타임라인

Kernel 2.6.23 (2007)  ─── CFS 도입 (Con Kolivas의 아이디어 → Ingo Molnár 구현)
        │
Kernel 2.6 ~ 5.x     ─── CFS가 기본 스케줄러로 약 16년간 사용
        │
Kernel 6.6 (2023.10)  ─── EEVDF로 교체, CFS tunable 제거
        │
Kernel 6.17 (현재)    ─── 현재 커널, EEVDF 기반

2. CFS 핵심 철학

“이상적인 멀티태스킹 CPU"를 소프트웨어로 근사

Neovim + LazyVim DevOps 환경 구성

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

날짜: 2026-02-21 목적: DevOps/SRE 작업(YAML, Bash, Dockerfile, Terraform, JSON)에 최적화된 nvim IDE 환경

설치 요약

항목	내용
Neovim	v0.11.6 (appimage, `/usr/local/bin/nvim`)
배포판	LazyVim (starter template)
LSP	yaml, bash, dockerfile, terraform, json (extras로 자동 구성)
파일 탐색	snacks.nvim (LazyVim 기본 picker) + ripgrep + fd
구문 강조	treesitter
아이콘	JetBrainsMono Nerd Font

설치된 구성 요소

시스템 패키지

sudo apt install -y ripgrep fd-find cmake

Neovim (appimage)

curl -LO https://github.com/neovim/neovim/releases/latest/download/nvim-linux-x86_64.appimage
chmod +x nvim-linux-x86_64.appimage
sudo mv nvim-linux-x86_64.appimage /usr/local/bin/nvim

Nerd Font

JetBrainsMono Nerd Font → ~/.local/share/fonts/
터미널 에뮬레이터에서 “JetBrainsMono Nerd Font” 선택 필요

LazyVim

git clone https://github.com/LazyVim/starter ~/.config/nvim
rm -rf ~/.config/nvim/.git

커스텀 설정 파일

`~/.config/nvim/lua/plugins/devops-extras.lua`

DevOps 관련 LazyVim extras 활성화:

Neovim + LazyVim 사용 가이드

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

날짜: 2026-02-21 대상: DevOps/SRE 워크플로우 (YAML, Bash, Dockerfile, Terraform, JSON)

1. 기본 개념

LazyVim은 Neovim 위에 올라가는 배포판이다. Leader key는 <Space>이며, 거의 모든 기능이 <Space> + 후속 키로 시작한다.

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에서 바이너리를 직접 다운로드하여 설치.

TLS 1.3 over HTTP Tunneling via Squid — 무엇이 문제인가

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

배경

기업 환경에서 Squid 같은 Forward Proxy는 보안·감사·캐싱 목적으로 HTTPS 트래픽을 관찰하거나 검사한다. 그런데 TLS 1.3이 도입되면서, 기존에 프록시가 의존하던 여러 관찰 포인트가 사라졌다.

tmux 설치 및 설정 구성

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

작업일: 2026-02-21
환경: Ubuntu 24.04.4 LTS / tmux 3.4
설정 파일: ~/.tmux.conf
플러그인 경로: ~/.tmux/plugins/

1. 설치

sudo apt install -y tmux

tmux 3.4-1ubuntu0.1 설치됨.

2. 설정 파일 (~/.tmux.conf)

2.1 Prefix 키

Ctrl-a (primary)와 Ctrl-b (secondary) 둘 다 사용 가능하도록 구성.

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이 동작하지 않는다.

virsh를 이용한 KVM/QEMU VM 관리 가이드

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

현재 환경 상태

항목	값
libvirt	10.0.0
QEMU	8.2.2
연결 URI	`qemu:///session` (사용자 세션 모드)
사용자 그룹	`kvm`, `libvirt` 포함
스토리지 풀	`default` → `~/.local/share/libvirt/images/`
OS	Ubuntu 24.04.4 LTS (Kernel 6.17)
CPU	AMD Ryzen 9 5900X (12c/24t)
RAM	40 GB

session vs system 모드: qemu:///session은 일반 사용자 권한으로 동작하며 네트워크 기능이 제한됩니다. 브릿지 네트워크 등 고급 네트워킹이 필요하면 qemu:///system을 사용해야 합니다.

도메인·터널 토큰 발급 가이드 (당신이 직접 하는 부분)

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

Date: 2026-06-29 호스트: ubuntu (home server) 도메인: 운영 / 네트워킹 목적: quick tunnel(리붓마다 URL 변경)을 고정 도메인으로 바꾸기 위해, 본인이 Cloudflare에서 직접 해야 하는 발급 절차(도메인 + Named Tunnel 토큰)만 액션 중심으로 정리. 서버 쪽 배선은 Claude가 처리.

통합 위키 포털 아키텍처 (Wiki Portal Architecture)

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

Date: 2026-06-29 호스트: ubuntu (home server, 192.168.0.2) 도메인: Infra / Networking / 운영 티어: PRIVATE (basic_auth) — 사내·홈랩 내부 사양 포함, 단 자격증명 값은 비포함

1. 개요

통합 위키 포털은 여러 도메인의 markdown 노트를 단일 Caddy 프런트도어(:8080) 뒤에서 브라우저 열람용 HTML 아카이브로 묶어, 공개(open)·비공개(basic_auth)·파일허브(download)를 한 출처(same-origin)로 제공하는 시스템임. md 원본은 md-viz 파이프라인이 보존하고 같은 이름의 시각화 HTML을 생성하며, Cloudflare quick tunnel로 외부에 노출함. 목적은 ① 흩어진 작업 로그·도메인 노트를 한 곳에서 검색·열람, ② 공개해도 되는 자료(public)와 홈랩 내부 사양이 든 자료(private)를 한 코드 경로로 분리 서빙, ③ 사내 프록시 환경에서도 GET만으로 열람·다운로드가 되도록 설계하는 것임.

Claude 작업 결과를 효과적으로 이해·문서화하는 방법

Sun, 28 Jun 2026 00:00:00 +0000

Date: 2026-03-02

배경

매일 Claude를 사용해서 인프라 구성, 코드 작성 등의 작업을 진행할 때, 결과물을 단순히 받아쓰는 것과 직접 이해하고 내 것으로 만드는 것 사이에는 큰 차이가 있다. 아래는 Claude의 작업 결과를 학습 자산으로 전환하기 위한 실전 팁이다.

NVIDIA Driver + vLLM Complete Setup Guide

Sun, 28 Jun 2026 00:00:00 +0000

Ubuntu 24.04 LTS | RTX 3090 | Qwen2.5-7B-Instruct

Verified: 2026-02-17

Verified Environment

Component	Detail
GPU	NVIDIA GeForce RTX 3090 (GA102, Compute Capability 8.6, Ampere)
OS	Ubuntu 24.04.4 LTS, Linux 6.17.0-14-generic
NVIDIA Driver	nvidia-driver-590-open, 590.48.01 (CUDA 13.1)
Docker	29.2.1
NVIDIA Container Toolkit	1.18.2
vLLM Image	vllm/vllm-openai:latest (v0.15.1, ~29.5GB)
Model	Qwen/Qwen2.5-7B-Instruct (bf16, ~22GB VRAM)

Prerequisites

The following must be installed before starting:

# Docker
sudo apt install docker.io
sudo usermod -aG docker $USER

# NVIDIA Container Toolkit (enables --gpus flag)
# https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html
curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | \
  sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg
curl -s -L https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | \
  sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | \
  sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
sudo apt update
sudo apt install nvidia-container-toolkit
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker

Part 1: NVIDIA Driver Installation

Step 1. Check recommended driver

ubuntu-drivers devices

Look for the recommended line:

NVIDIA 드라이버 다운그레이드 작업 기록

Sun, 28 Jun 2026 00:00:00 +0000

문제 상황

vLLM Docker 컨테이너(vllm/vllm-openai:latest, v0.15.1) 실행 시 아래 에러로 시작 실패:

RuntimeError: Unexpected error from cudaGetDeviceCount().
Error 803: system has unsupported display driver / cuda driver combination

원인 분석

호스트와 컨테이너 간 CUDA 버전 불일치:

Runbook: Mount /dev/sdd1 and Configure Samba Share

Sun, 28 Jun 2026 00:00:00 +0000

Date: 2026-02-18 Disk: /dev/sdd1 (ext4, label: data, ~3.6TB) Mount Point: /mnt/data Samba Share Name: Data

1. Create Mount Point

sudo mkdir -p /mnt/data

2. Configure /etc/fstab

The original entry had invalid options for ext4 (uid, gid, iocharset, umask are for NTFS/FAT only).

Before:

UUID=94a20060-e08f-40e4-b846-0f7a9398da04 /mnt/data ext4   defaults,uid=1000,gid=1000,iocharset=utf8,umask=022  0       0

After:

UUID=94a20060-e08f-40e4-b846-0f7a9398da04 /mnt/data ext4   defaults  0  2

3. Mount and Set Ownership

sudo mount -a
sudo chown jinsoo:jinsoo /mnt/data

Added the following section to /etc/samba/smb.conf:

Workstation 스펙 및 용도 분석

Sun, 28 Jun 2026 00:00:00 +0000

작성일: 2026-03-02 | 호스트명: ubuntu | Uptime: 9일+

1. 시스템 개요

DevOps/SRE + LLMOps 실험을 위한 로컬 랩 워크스테이션. 커널, 네트워킹, eBPF, KVM, Kubernetes, LLM 등 5개 도메인의 딥다이브 실험 환경으로 활용 중.

Docs on homelab89

Blog 사용법

번들 구조: 문서 1건 = 폴더 1개

ArgoCD Application 네임스페이스 Watch 범위

1. 핵심 사실

2. 설정 확인 방법

01. 사전 준비

호스트 패키지 확인 및 설치

SSH 키 준비

Ubuntu 22.04 Cloud Image 다운로드

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

리소스 요건 확인

사전 확인 체크리스트

03. kubespray 배포 가이드

kubespray 개요

kubespray Clone 및 환경 구성

인벤토리 구조

04. etcd 장애 실험 시나리오

etcd Raft 쿼럼 기본 원리

실험 전 준비

시나리오 1: 단일 노드 장애 (쿼럼 유지)

05. etcd 복구 절차

복구 시나리오 분류

복구 1: 단일 노드 자동 재동기화

Cloudflare 도메인 활성화 런북 — quick tunnel → 고정 도메인 + Named Tunnel (+ Access)

0. 왜 필요한가 (동기)

HTTP Tunneling

HTTP Tunneling이란?

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

증상

원인 분석

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

KIND Lab Usage Guide

도구 요약

클러스터 라이프사이클

클러스터 생성

Linux CFS Scheduler 완전 정리 (Kernel 6.x 기준)

목차

1. 타임라인

2. CFS 핵심 철학

Neovim + LazyVim DevOps 환경 구성

설치 요약

설치된 구성 요소

시스템 패키지

Neovim (appimage)

Nerd Font

LazyVim

커스텀 설정 파일

~/.config/nvim/lua/plugins/devops-extras.lua

Neovim + LazyVim 사용 가이드

1. 기본 개념

Runbook: KIND-Based Local Kubernetes Lab Setup

Verified Environment

1. KIND 설치

TLS 1.3 over HTTP Tunneling via Squid — 무엇이 문제인가

배경

tmux 설치 및 설정 구성

1. 설치

2. 설정 파일 (~/.tmux.conf)

2.1 Prefix 키

virsh + cloud-init VM 생성 가이드

사전 조건

디렉토리 구조

생성 절차

1. 변수 설정

2. user-data.yaml 작성

virsh를 이용한 KVM/QEMU VM 관리 가이드

현재 환경 상태

도메인·터널 토큰 발급 가이드 (당신이 직접 하는 부분)

통합 위키 포털 아키텍처 (Wiki Portal Architecture)

1. 개요

Claude 작업 결과를 효과적으로 이해·문서화하는 방법

배경

NVIDIA Driver + vLLM Complete Setup Guide

Verified Environment

Prerequisites

Part 1: NVIDIA Driver Installation

Step 1. Check recommended driver

NVIDIA 드라이버 다운그레이드 작업 기록

문제 상황

`~/.config/nvim/lua/plugins/devops-extras.lua`