❄️ snow 사용 가이드

코드 받기 — drinkcode/platform repo (진실원)

platform 코드는 이제 GitHub private repo로 관리됩니다. rsync 복사 대신 clone:

git clone https://github.com/drinkcode/platform.git ~/astro-platform
# private repo 라 GitHub 로그인(또는 PAT) 필요

이후 업데이트는 git pull 한 줄. (구 방식이던 k3s/platform 폴더 rsync 는 폐기)

kubeconfig 받기 (클러스터 접속 “차 키”)

이 PC의 kubectl이 어느 클러스터에 배포할지 알려주는 설정 파일. 서버에서 1번 생성 후 복사합니다.

# 서버에서:
~/Documents/k3s/platform/cli/make-remote-kubeconfig.sh   # → ~/k3s-remote.yaml
# 개발 PC로 복사:  (Windows는 C:\Users\<나>\.kube\config 위치)
scp <user>@192.168.0.4:~/k3s-remote.yaml ~/.kube/config
kubectl get ns        # goddapp 등이 보이면 성공

설치 (Node + 명령어 등록)

확인: snow --help 가 도움말을 출력하면 성공.

컨테이너 엔진 + insecure 레지스트리

이미지를 빌드/푸시하려면 docker(또는 podman)가 필요하고, 평문 HTTP 레지스트리를 허용해야 합니다.

kubectl -n goddapp create secret generic cms-<이름>-godd-app \
  --from-literal=CMS_URL=https://cms.godd.app \
  --from-literal=CMS_TOKEN=<read토큰>

node: Permission denied

증상

/mnt/c/Program Files/nodejs/snow: exec: node: Permission denied

원인 — WSL(리눅스)에서 Windows용 node(/mnt/c/...)를 실행하려다 막힘. 해결 — WSL 안에 리눅스 node 설치:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install --lts
which node        # /home/<나>/.nvm/... 로 바뀌면 OK (더이상 /mnt/c 아님)
# 그 뒤 cli 폴더에서: rm -rf node_modules && npm install && npm link

빌드는 됐는데 apply 단계에서 “✗ 오류: … 실패: undefined”

원인 — kubectl이 WSL에 설치돼 있지 않음(명령을 못 찾아 에러가 undefined로 표시됨). 해결 — kubectl 설치 후 PATH로 이동(받기만 하면 안 됨):

curl -LO "https://dl.k8s.io/release/v1.30.3/bin/linux/amd64/kubectl"
sudo install -m 0755 kubectl /usr/local/bin/kubectl
kubectl version --client

⚠️ /mnt/c에서 직접 실행하면 권한 문제 → 반드시 /usr/local/bin(리눅스 쪽)으로 옮길 것.

kubeconfig는 서버에서 만들어 가져온다

핵심 — make-remote-kubeconfig.sh는 서버(192.168.0.4)에서 실행. 노트북엔 k3s 설정 (/etc/rancher/k3s/k3s.yaml)이 없어서 sudo여도 “읽을 수 없음”이 납니다.

# 서버에서 1번:
~/Documents/k3s/platform/cli/make-remote-kubeconfig.sh      # → ~/k3s-remote.yaml
# WSL에서 가져오기:
mkdir -p ~/.kube
scp drinkcode@192.168.0.4:~/k3s-remote.yaml ~/.kube/config
kubectl get ns

kubectl get ns → no route to host (192.168.0.4:6443)

증상

Unable to connect to the server: dial tcp 192.168.0.4:6443: connect: no route to host

원인 — 서버 firewalld가 6443 포트를 외부에서 막음(22=ssh는 열려 있어 scp는 됨). 해결 — 서버에서 6443 열기(root 필요):

ssh drinkcode@192.168.0.4
sudo firewall-cmd --permanent --add-port=6443/tcp
sudo firewall-cmd --reload
exit
# 다시 WSL: kubectl get ns  → 목록 나오면 완성