빠른 시작
AxHub CLI를 설치하고, 샘플 앱을 프로덕션에 배포합니다. 평균 소요 시간 약 10분.
준비물
- AxHub 계정 — 가입하기
- macOS, Linux, 또는 WSL2 환경
- Node.js 20+ 또는 Docker 24+
CLI 설치
Homebrew 또는 공식 스크립트로 ax CLI를 설치합니다.
$ brew install axhub/tap/ax
$ ax --version
ax version 2.4.1 (darwin/arm64)로그인
브라우저가 열리면 AxHub 계정으로 인증하세요.
$ ax login
→ 브라우저에서 열기: https://axhub.dev/cli/auth?code=XJ4F-9KQ2
✓ 로그인됨 (taehee@acme.co)프로젝트 만들기
템플릿에서 새 앱을 생성합니다. Next.js, FastAPI, Go 등 15개 템플릿 제공.
$ ax init --template nextjs hello-ax
✓ 템플릿 다운로드
✓ 의존성 설치 (pnpm)
✓ axhub.yaml 생성
✓ Git 초기화
다음 단계:
cd hello-ax
ax deployaxhub.yaml 살펴보기
프로젝트 루트의 axhub.yaml이 배포 설정을 정의합니다.
name: hello-ax
runtime: node-20
build:
command: pnpm build
output: .next
deploy:
region: ap-northeast-2
min_instances: 1
max_instances: 10
env:
- name: DATABASE_URL
from_secret: prod-db-urlTip
ax config validate로 YAML을 사전 검증할 수 있어요.
첫 배포
ax deploy를 실행하면 빌드 → 업로드 → 배포가 순차 진행됩니다.
$ ax deploy
▸ 빌드 중 (0:43) .................... ✓
▸ 이미지 푸시 (0:18) ................. ✓
▸ 롤아웃 (canary 10%) ................ ✓
▸ 헬스 체크 통과 ..................... ✓
배포 완료
URL: https://hello-ax.axhub.app
버전: v1 · 커밋 a3f9c21완료!
첫 앱이 프로덕션에 올라갔어요. URL을 브라우저에서 열어 확인해보세요.