앱 정보 관리하기
앱 이름 · 아이콘 · 소개를 고치고, 접속 주소와 내 도메인을 정하고, 함께 관리할 공동 소유자를 두는 방법이에요.
앱 콘솔 → 앱 정보 탭에 앱 정보가 모여 있어요.
여기서 고친 내용이 곧 동료가 목록과 스토어에서 보게 될 모습이에요.
앱 소유자 · 공동 소유자 · 회사 관리자만 고칠 수 있어요.
무엇을 고치면 어디에 보이나요
| 항목 | 어디에 보이나요 |
|---|---|
| 앱 이름 | 앱 목록과 스토어에서 앱을 가리키는 이름이에요. 동료가 이걸로 앱을 찾아요 |
| 아이콘 | 목록과 스토어에서 이름 옆에 뜨는 그림이에요. 다크모드용을 따로 올리면 어두운 화면에서 그게 쓰여요 |
| 한 줄 소개 | 목록에서 이름 아래에 붙는 짧은 설명이에요. 뭘 하는 앱인지 여기서 판단해요 |
| 상세 설명 | 스토어에서 앱을 눌렀을 때 보이는 긴 설명이에요. 쓰는 법이나 주의사항을 적어요 |
| 카테고리 | 스토어에서 분류되는 갈래예요. 안 정해도 되지만, 정해 두면 같은 갈래에서 함께 찾을 수 있어요 |
이 정보는 앱을 볼 수 있는 사람에게만 보여요. 나만 보는 앱이면 아무리 잘 써 둬도 남에게 안 보여요 — 공개 범위는 공개 · 접근 관리에서 정해요.
함께 보이는 것
같은 화면에서 연결된 GitHub 계정 · 저장소 · 브랜치도 확인할 수 있어요. 지금 이 앱이 어느 코드에서 배포되는지 보는 용도라 읽기 전용이에요. 다른 저장소로 바꾸려면 GitHub 연결을 다시 해요. Axhub 저장소를 쓰는 앱은 저장소 탭에서 코드를 봐요 — Axhub 저장소로 코드 관리하기.
접속 주소
서버 앱(docker · compose)은 서브도메인이 접속 주소가 돼요. 회사 작업공간에서는 앱을 만들 때 정해요 (첫 앱 만들기).
-
주소가 없으면 배포가 시작되지 않아요. 터미널에서 주소 없이 만든 앱은 먼저 주소를 정해요.
axhub apps update <앱> --subdomain my-todo --execute -
운영에 처음 배포되기 전까지는 같은 명령으로 주소를 바꿀 수 있어요. 배포가 도는 동안에는 바꿀 수 없으니 끝난 뒤 다시 해요.
-
운영에 한 번 배포되면 주소는 바꿀 수 없어요(
subdomain_locked). 정적(static) 앱은 사이트가 한 번 게시되면 바꿀 수 없어요. -
배포된 앱에 다른 주소가 필요하면 아래 내 도메인을 연결하거나, 앱을 새로 만들어요.
개인이 쓰는 공개 작업공간(라운지)은 주소를 자동으로 만들어요. 앱 이름을 영문 소문자로 바꾸고 뒤에 영문 · 숫자 4자리를 붙여요(예: my-todo-x7k2). 이름에 영문 · 숫자가 없으면 app-x7k2처럼 돼요. 이 주소는 고를 수도, 나중에 바꿀 수도 없어요. 원하는 주소가 있으면 내 도메인을 연결해요.
내 도메인 연결하기
외부공개 앱은 기본 주소 말고 내 도메인(예: shop.example.com)으로도 열 수 있어요. 기본 주소는 그대로 남아요.
- 외부공개 앱만 연결할 수 있어요. 아니면 외부공개 심사를 먼저 받아요 (공개 · 접근 관리).
- 정적(static) 앱은 아직 연결할 수 없어요. 그래서 정적 앱에는 주소 설정 탭이 보이지 않아요.
- 앱당 10개까지 연결해요.
- 앱 소유자 · 공동 소유자 · 회사 관리자가 할 수 있어요.
도메인 추가
DNS에 레코드 두 개 넣기
_axhub-challenge.<내 도메인>)와, 연결용 A(루트 도메인일 때) 또는 CNAME(서브도메인일 때)이에요. 도메인을 관리하는 곳의 DNS 설정에 값을 그대로 복사해 넣어요. Cloudflare는 프록시(오렌지 구름)를 끄고 DNS 전용으로 넣어요 — 켜져 있으면 확인이 계속 실패해요.다시 확인
| 상태 | 뜻 |
|---|---|
| 대기 | 아직 레코드를 확인하지 못했어요. 레코드를 넣고 다시 확인을 눌러요 |
| 검증 실패 | 확인했는데 레코드가 맞지 않아요. 화면에 나온 원인을 보고 레코드를 고쳐요 |
| 인증서 발급 중 | 레코드는 맞았고 HTTPS를 준비하는 중이에요. 끝나면 저절로 활성이 돼요 |
| 발급 실패 | 인증서 발급이 막혔어요. 화면에 나온 원인을 확인해요 |
| 활성 | 이 도메인으로 앱이 열려요 |
| 연결 끊김 | DNS 레코드가 사라졌어요. 레코드를 되살리면 저절로 다시 활성이 돼요 |
연결을 끊으려면 도메인 줄의 연결 끊기를 눌러요. 그 도메인으로는 더 이상 접속할 수 없고 인증서도 회수돼요. 나중에 공개 범위를 좁혀도 연결한 도메인은 그대로 남지만, 그 주소로 들어와도 바뀐 공개 범위대로 로그인을 요구해요.
터미널에서는 이렇게 해요. 추가 · 제거는 기본이 미리보기라서 --execute를 붙여야 실제로 바뀌어요.
axhub apps domains add --app demo shop.example.com --execute # 등록하고 넣을 DNS 레코드 보기
axhub apps domains list --app demo # 상태와 도메인 ID
axhub apps domains verify --app demo <domain_id> --wait # 활성이 될 때까지 다시 확인
axhub apps domains remove --app demo <domain_id> --execute # 연결 끊기verify · remove에는 도메인 이름이 아니라 list에 나오는 도메인 ID를 넣어요.
공동 소유자 · 소유권 이전
앱을 혼자 관리하지 않으려면 공동 소유자를 둬요. 공동 소유자는 대표 소유자와 똑같이 앱을 관리해요 — 정보 고치기, 배포, 환경변수, 사용자 초대, 저장소 push, 앱 삭제까지 다 할 수 있어요. 그래서 믿을 수 있는 사람만 넣어요.
앱 콘솔 → 앱 정보 탭 → 공동 소유자 카드에서 해요. 대표 소유자 · 공동 소유자 · 회사 관리자가 할 수 있어요.
| 하고 싶은 일 | 콘솔에서 |
|---|---|
| 공동 소유자 넣기 | 공동소유자 추가 → 멤버 고르기 → 추가. 같은 회사의 활성 구성원만 넣을 수 있어요 |
| 공동 소유자 빼기 | 그 사람 줄의 휴지통 버튼. 바로 권한이 사라져요 |
| 내가 공동 소유자에서 나가기 | 내 줄의 나가기 |
| 대표 소유자 넘기기 | 넘겨받을 공동 소유자 줄의 대표 이전 → 이전 |
소유권 이전은 바로 반영되고 취소 버튼이 없어요. 대표가 넘겨받은 사람으로 바뀌고, 지금 대표는 공동 소유자로 남아 접근은 그대로예요. 되돌리려면 다시 이전해야 해요. 대표는 공동 소유자처럼 나갈 수 없으니, 앱을 떠나려면 먼저 대표를 넘겨요.
개인이 쓰는 공개 작업공간(라운지)에는 공동 소유자가 없어요.
터미널에서는 사람을 사용자 ID로 지정해요(이메일은 안 돼요). 넣기 · 빼기 · 이전은 기본이 미리보기예요. 이전은 --execute와 --yes를 둘 다 붙여야 실행돼요.
axhub apps co-owners list --app demo
axhub apps co-owners add --app demo --user <user_id> --execute
axhub apps co-owners remove --app demo --user <user_id> --execute
axhub apps ownership transfer --app demo --to <user_id> --execute --yes바꿀 수 없는 것
| 항목 | 왜 |
|---|---|
| 접속 주소 | 운영에 한 번 배포된 뒤에는 바꿀 수 없어요 — 접속 주소 |
| 슬러그 | 회사 안에서 앱을 가리키는 이름이라, 명령어와 설정이 이걸 기준으로 묶여 있어요 |
| 배포 방식 | docker · compose · static 중 무엇으로 배포할지는 앱을 만들 때 정해져요. 정적(static) 앱만 docker · compose 로 바꿀 수 있어요 — 정적 앱을 docker · compose 앱으로 바꾸기 |
그래서 앱을 만들 때 이 세 가지는 한 번 더 확인하는 게 좋아요.
정적 앱을 docker · compose 앱으로 바꾸기
HTML 만 있던 정적 앱에 서버나 DB 가 필요해졌다면, 앱을 지우지 않고 배포 방식을 바꿀 수 있어요. 정적 → docker · compose 한 방향만 돼요.
axhub apps deploy-method --app <앱> --to docker # 미리보기 — 바뀌는 것과 바꾼 뒤 할 일
axhub apps deploy-method --app <앱> --to docker --execute --yes # 실행--to 는 docker 또는 compose 예요. 미리보기는 앱을 바꾸지 않고, 정적 앱이 아니면 그 자리에서 알려 줘요. 되돌릴 수 없어서 실행에는 --execute 와 --yes 가 함께 필요해요 (CLI 0.61.0 이상).
정적 앱에 서버 코드를 올리다가 배포가 resolve.static_convertible 로 실패하면, CLI 가 이 명령을 알려 줘요.
- 누가 — 앱 소유자 · 공동 소유자, 회사 관리자가 바꿀 수 있어요.
- 바꾼 다음 —
axhub.yaml의build.deploy_method를 새 방식으로 맞추고 Dockerfile(compose 면 compose 파일)을 둔 뒤 서버 코드를 배포해요. 첫 운영 배포가 성공할 때까지 옛 정적 페이지는 그대로 열려 있고, 성공하면 옛 주소는 새 주소로 넘어가요. axhub.yaml만 고쳐서는 안 바뀌어요 —deploy_method값만 고치면 방식이 어긋나 배포가 실패해요. 먼저 위 명령으로 앱의 방식을 바꿔요.- 안 되는 때 — 멈춘 앱(
app_stopped), 배포가 진행 중인 앱(deployment_in_progress), 정적이 아닌 앱(not_static_app).
이렇게 보이면 성공
고친 이름과 아이콘이 앱 목록과 스토어에 그대로 보이면 성공이에요.
다음은 앱 상태 관리하기에서 안 쓰는 앱을 절전 · 일시정지 · 삭제하는 법을 봐요.