DevOps

Operations And Troubleshooting

Runbooks, troubleshooting records, deployment decisions, bootstrap dependency notes, and infrastructure recovery paths. Conceptual cloud and networking notes live under Notes.

Kubernetes

1 post

devops

K3s kubeconfig: kubectl과 k9s 다중 클러스터 접근 설정

K3s server node의 kubeconfig를 로컬에 등록해 kubectl과 k9s에서 여러 Kubernetes cluster context를 전환하는 정석적인 설정 절차를 정리한다.

Kubernetes runbook
k3skubeconfigkubectlk9s

Troubleshooting

1 post

devops

k3s Registry Bootstrap: Nexus self-dependency 해소

k3s 환경에서 Nexus가 자기 자신에게 의존해 이미지 pull이 막히는 bootstrap deadlock을 끊기 위해 registry:latest 기반 임시 bootstrap registry를 구성하고 검증한 기록이다.

Troubleshooting runbook
k3scontainerdNexusDocker Registry

Networking

3 posts

devops

Nexus3 HTTPS Registry: Root CA 기반 IP SAN 인증서와 Docker 신뢰 설정

DNS 없이 IP와 포트 기반으로 Nexus3 Docker Registry와 Traefik TLSStore를 운영할 때 Root CA, 서버 인증서, Java keystore, Docker ca.crt를 구분해 설정하는 runbook.

Networking runbook
nexus3docker-registryx509root-ca
devops

K3s Traefik: NodePort와 MetalLB VIP 병행 노출

K3s Traefik에서 기존 NodePort 노출을 유지하면서 MetalLB VIP를 추가하고, tls: {} 기본 인증서 문제를 TLSStore로 정리한 운영 기록

Networking troubleshooting
k3straefikmetallbnodeport
devops

K3s MetalLB: ServiceLB/Klipper와 HostPort 충돌 분석

K3s에서 MetalLB를 도입할 때 ServiceLB/Klipper가 LoadBalancer Service의 hostPort를 점유하면서 기존 HostPort/NodePort 노출과 충돌한 문제를 정리한다.

Networking troubleshooting
k3sMetalLBServiceLBKlipper