Axhub 저장소로 코드 관리하기
회사가 Axhub 저장소를 쓸 때 앱 코드를 내 컴퓨터로 받고, 고친 뒤 push해서 배포하고, 로그인 정보가 만료됐을 때 다시 연결하는 방법이에요.
앱 코드는 회사 설정에 따라 GitHub이나 Axhub 저장소에 있어요.
Axhub 저장소는 AxHub가 직접 보관하는 비공개 git 저장소예요. GitHub 계정이나 연결 없이 쓰고, 고친 코드를 push하면 바로 새 배포가 시작돼요.
어디에 보관할지는 회사 관리자가 정해요. 관리자가 바꿔도 이미 만든 앱의 저장 위치는 그대로예요.
내 앱이 Axhub 저장소를 쓰는지 보기
앱 콘솔 → 저장소 탭을 열어요.
| 화면 | 뜻 |
|---|---|
| 「앱 코드를 보관하고 바뀐 내역을 봐요」와 코드 · 커밋 · Pull requests · 설정 탭 | Axhub 저장소를 쓰는 앱이에요 |
| 「앱 코드가 있는 곳과 지금 운영 중인 코드를 확인해요」 | GitHub을 쓰는 앱이에요 — push하면 자동으로 배포되게를 봐요 |
터미널에서는 axhub repo status <앱>으로 봐요.
status | 뜻 |
|---|---|
ready | 준비 끝 — 저장소 주소(repository_url)와 기본 브랜치(default_branch)가 함께 나와요 |
provisioning | 아직 만드는 중이에요. 잠시 뒤 다시 확인해요 |
failed | 만들지 못했어요. 이유가 함께 나와요 |
not_applicable | Axhub 저장소를 쓰지 않는 앱(GitHub 앱)이에요 |
저장소가 준비되는 과정
Axhub 저장소를 쓰는 회사에서 앱을 만들면 저장소가 자동으로 생겨요. 직접 만들 필요가 없어요.
준비되는 동안 저장소 탭에 저장 위치 확인 → 비공개 저장소 만들기 → 배포 연결 단계가 보여요. 새 저장소에는 AxHub가 넣은 시작 파일이 첫 커밋으로 들어 있어요.
내 컴퓨터로 받기
저장소 탭 오른쪽 위 내 컴퓨터로 받기를 누르면 저장소 주소와 터미널 명령 두 개가 나와요. 복사해서 그대로 쓰면 돼요.
axhub에 로그인
axhub auth login으로 로그인해요. 저장소 로그인 정보는 이 로그인으로 받아요 — 개인 액세스 토큰(PAT)으로 로그인한 상태에서는 안 돼요.로그인 정보 연결 (처음 한 번)
axhub git setup을 실행해요. 이 컴퓨터의 git이 Axhub 저장소에 들어갈 때 쓸 로그인 정보(30일짜리)를 받아서 연결해 줘요. 여러 회사에 속해 있으면 axhub git setup --tenant <회사>처럼 회사를 골라요.저장소 받기
axhub repo clone <앱>을 실행해요. 지금 폴더 아래 <앱> 폴더로 받아요. 다른 폴더로 받으려면 axhub repo clone <앱> <폴더>처럼 뒤에 적어요.Cloned Axhub repository for app …이 나오면 받은 거예요. 이미 받아 둔 폴더면 다시 받지 않고 그대로 성공해요. 다른 파일이 들어 있는 폴더에는 받지 않아요.- HTTPS로만 받고 올릴 수 있어요. SSH와 Git LFS는 아직 안 돼요. 파일 하나는 100MB까지 올릴 수 있어요.
- 앱 소유자 · 공동 소유자 · 회사 관리자는 코드를 받고 올릴 수 있어요.
고친 뒤 push하면 배포돼요
받은 폴더에서 평소처럼 git을 쓰면 돼요.
cd <앱>
git add .
git commit -m "할 일 목록에 마감일 추가"
git push기본 브랜치(axhub repo status의 default_branch)에 push하면 AxHub가 새 배포를 시작해요. 다른 브랜치에 push한 건 배포되지 않아요. 앱에 스테이징을 켜 두었으면 운영이 아니라 스테이징으로 나가요.
push한 뒤 저장소 탭 → 커밋에서 커밋마다 배포 결과가 보여요 — 배포 대기 · 배포 진행 중 · 배포 성공 · 배포 실패 · 배포 취소 · 배포 차단 · 검사 오류. 누르면 그 배포의 상세로 가요. 실패했으면 로그 읽는 법으로 이어가요.
push하기 전에 axhub deploy check --app <앱>으로 배포를 막을 문제를 먼저 볼 수 있어요 — 배포 전에 점검하기. Axhub 저장소 앱에서는 "원격 저장소에 커밋이 있는지" 항목을 확인하지 않아요(unknown). push했는지는 직접 확인해요.
push했는데 배포가 시작되지 않을 때
커밋 옆에 배포 기록 없음이 보이면 그 push로는 배포가 시작되지 않은 거예요. 흔한 이유는 이래요.
| 이유 | 할 일 |
|---|---|
| 기본 브랜치가 아닌 브랜치에 push했어요 | 기본 브랜치로 합쳐서 push해요 |
| 앱에 접속 주소(서브도메인)가 아직 없어요 | 주소를 먼저 정해요 — 접속 주소 정하기 |
| 다른 배포가 아직 돌고 있었어요 | 그 배포가 끝난 뒤 앱 콘솔 → 업데이트·공개 탭의 최신 코드로 다시 만들기를 누르거나, 새 커밋을 push해요 |
| 공개된 앱인데 스테이징이 꺼져 있어요 | 공개된 앱은 스테이징을 거쳐야 해요 — 스테이징으로 배포하기 |
| 앱이 일시정지 · 삭제 상태예요 | 앱 상태 관리하기에서 다시 시작해요 |
| 대회 배포 마감 중인 팀 앱이에요 | 운영진이 배포를 다시 열 때까지 기다려요 |
기본 브랜치 보호
저장소 탭 → 설정 → 브랜치 보호에서 기본 브랜치를 지킬 수 있어요. 기본 브랜치에 바로 push할 수 있는지, Pull request를 병합하려면 승인이 몇 개 필요한지, 배포 검사를 통과해야 병합할 수 있는지 정해요. 앱 소유자 · 공동 소유자 · 회사 관리자가 정할 수 있어요.
로그인 정보가 만료됐을 때
axhub git setup이 받는 로그인 정보는 30일 동안 써요. 다시 실행하면 7일 이상 남은 정보는 그대로 두고 git 설정만 고쳐요. 그래서 push하기 전에 습관처럼 돌려도 괜찮아요.
push나 clone이 로그인 오류로 거절되면 이렇게 해요.
새 로그인 정보 받기
axhub git setup --rotate를 실행해요. 아직 기간이 남아 있어도 새 30일짜리로 바꿔요.axhub 로그인이 끝났다면
Axhub OAuth login is required가 나오면 axhub 로그인 자체가 끝난 거예요. axhub auth login부터 하고 위 명령을 다시 실행해요.다시 push
git push를 다시 실행해요.axhub repo clone이 repository.credential_missing으로 멈추면 오류에 나온 axhub … git setup 명령을 그대로 실행하고 다시 받아요.
이렇게 보이면 성공
push하고 나서 저장소 탭 → 커밋에서 내 커밋 옆에 배포 성공이 보이고, 앱 주소에 고친 내용이 나오면 성공이에요.