배포 관리

앱을 올린 다음에는 지금 어떤 상태인지 보고, 문제가 생기면 원인을 찾아 되돌릴 수 있어야 해요.
배포 상태 읽는 법부터 자동 배포 붙이기, 로그로 실패 지점 찾기, 이전 버전으로 되돌리기까지 다뤄요.

배포 상태 보는 법

앱 콘솔과 앱 목록에 보이는 배포 상태는 코드가 실제로 떠 있는지를 나타내요. 네 가지 값 중 하나예요.

터미널에서는 axhub로 시작하는 명령어 도구(CLI)로 확인해요.

axhub deploy status --app demo            # 최신 배포 상태
axhub deploy list --app demo              # 배포 이력 목록
axhub deploy watch <deployment_id> --app demo   # 배포가 끝날 때까지 지켜보기
axhub deploy cancel <deployment_id> --app demo --execute   # 도는 중인 배포 멈추기

배포 한 건 한 건의 진행 상태 코드가 궁금하면 axhub deploy codes가 값 하나하나를 설명해 줘요.

내리기 · 보관 같은 상태 바꾸기는 앱 상태 관리하기에서 다뤄요.

push하면 자동으로 배포되게

코드를 GitHub에 올릴 때마다(push) 새 배포가 자동으로 돌게 만들 수 있어요. AxHub GitHub App 연결만 해 두면 workflow를 직접 짤 필요가 없어요.

axhub apps git connect --app <app> --repo owner/repo --branch main --execute
axhub apps git status --app <app>

연결한 뒤로는 그 저장소에 새 커밋을 push할 때마다 GitHub이 AxHub에 알려 자동으로 새 배포가 시작돼요. push하고 나서 앱 콘솔의 배포 탭에 새 배포가 도는 게 보이면 성공이에요.

배포 전에 테스트를 돌리고 싶으면 axhub.yaml에 적어 두면 돼요 — 빌드 전에 실행되고, 실패하면 배포가 멈춰요.

ci:
  commands:
    - npm test

로그 읽는 법

배포가 실패로 떴다면 로그부터 열어요. 앱 콘솔의 배포 탭에서 실패한 배포를 누르면 로그가 보이고, 터미널에서는 이렇게 봐요.

axhub deploy logs --app demo                  # 최근 로그
axhub deploy logs --app demo --follow         # 실시간으로 이어 보기
axhub deploy logs --app demo --since 2026-08-08T09:00:00Z --limit 200

로그에서 볼 것은 하나예요 — 어느 단계에서 멈췄는지. 코드를 실행 형태로 조립하는 빌드 단계에서 멈췄으면 빌드 명령 · 의존성 문제이고, 빌드는 끝났는데 뜨자마자 죽었으면 실행 명령 · 포트 · 환경변수 쪽이에요. 마지막 빨간 줄 근처를 그대로 복사해 두세요 — 증상별 해결은 배포가 안 될 때에 있어요.

로그만으로 부족하면 진단 명령이 있어요.

axhub deploy doctor --app demo     # 앱의 배포 환경 진단
axhub deploy diagnose demo         # 지금 떠 있는 앱의 라이브 상태 진단

이전 버전으로 되돌리기 (롤백)

새 버전에 문제가 있으면 이전 성공 버전으로 되돌려요 — 이걸 롤백이라고 해요. 앱 콘솔의 배포 탭에서 배포 이력의 되돌리기를 눌러도 되고, 터미널에서는 이렇게 해요.

앱 주소에 접속해서 이전 버전 화면이 보이면 성공이에요. 원인을 고친 뒤 다시 배포하면 다시 최신 버전으로 올라가요.