배포와 롤백¶

모든 변경은 저장소에서 시작합니다. 호스트에서 직접 설정을 고치지 않습니다.

PR 전 검증¶

GitHub Actions CI가 기준 빌드 체크입니다. PR을 열기 전에 로컬에서 확인하면 빠르게 문제를 잡을 수 있습니다.

nix flake check --no-build
nix flake show --all-systems

배포¶

표준 배포 경로는 GitHub Actions입니다.

1. PR을 엽니다.
2. CI가 모든 호스트를 빌드할 때까지 기다립니다.
3. 체크가 초록색이면 병합합니다.
4. CD가 yggdrasil, midgard, alfheim을 switch하게 둡니다.

자세한 흐름은 CI/CD 파이프라인을 참고합니다.

명시적 수동 경로¶

just test와 just switch는 비상/부트스트랩용 명령입니다. 운영자가 로컬 활성화를 명시적으로 요청한 경우에만 실행합니다. 이때도 빌드와 활성화는 대상 호스트에서 원격으로 수행됩니다.

just test <host>     # 부팅 기본값으로 만들지 않고 활성화
just switch <host>   # 활성화 + 부팅 기본값으로 설정

호스트: yggdrasil, midgard, alfheim.

내부적으로는 다음과 같이 실행됩니다.

nixos-rebuild <test|switch>
  --no-reexec
  --flake .#<host>
  --build-host <host>
  --target-host <host>
  --sudo

롤백¶

호스트에서 직전 세대로 되돌리기:

sudo nixos-rebuild switch --rollback

부팅이 안 되는 수준의 문제라면 systemd-boot 부팅 메뉴에서 이전 세대를 선택합니다.

주의사항¶

• flake.lock은 손으로 편집하지 않고 nix flake update를 사용합니다.
• system.stateVersion은 초기 설치 시점의 기본값 기록입니다. 릴리스 노트가 명시적으로 요구하지 않는 한 올리지 않습니다.
• 배포는 라이브 호스트를 건드리는 작업입니다. 일반 변경은 CI/CD에 맡기고, 로컬 just test / just switch는 명시적 요청이 있을 때만 실행합니다.