앱 정보 관리하기

앱 이름 · 아이콘 · 소개를 고치고, 접속 주소와 내 도메인을 정하고, 함께 관리할 공동 소유자를 두는 방법이에요.

앱 콘솔 → 앱 정보 탭에 앱 정보가 모여 있어요.
여기서 고친 내용이 곧 동료가 목록과 스토어에서 보게 될 모습이에요.

앱 소유자 · 공동 소유자 · 회사 관리자만 고칠 수 있어요.

무엇을 고치면 어디에 보이나요

항목어디에 보이나요
앱 이름앱 목록과 스토어에서 앱을 가리키는 이름이에요. 동료가 이걸로 앱을 찾아요
아이콘목록과 스토어에서 이름 옆에 뜨는 그림이에요. 다크모드용을 따로 올리면 어두운 화면에서 그게 쓰여요
한 줄 소개목록에서 이름 아래에 붙는 짧은 설명이에요. 뭘 하는 앱인지 여기서 판단해요
상세 설명스토어에서 앱을 눌렀을 때 보이는 긴 설명이에요. 쓰는 법이나 주의사항을 적어요
카테고리스토어에서 분류되는 갈래예요. 안 정해도 되지만, 정해 두면 같은 갈래에서 함께 찾을 수 있어요

이 정보는 앱을 볼 수 있는 사람에게만 보여요. 나만 보는 앱이면 아무리 잘 써 둬도 남에게 안 보여요 — 공개 범위는 공개 · 접근 관리에서 정해요.

함께 보이는 것

같은 화면에서 연결된 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개까지 연결해요.
  • 앱 소유자 · 공동 소유자 · 회사 관리자가 할 수 있어요.
1

도메인 추가

앱 콘솔 → 주소 설정 탭 → 커스텀 도메인에서 도메인 추가를 누르고, 연결할 도메인을 적어 추가해요.
2

DNS에 레코드 두 개 넣기

화면에 넣을 레코드 두 개가 나와요 — 소유권 확인용 TXT(_axhub-challenge.<내 도메인>)와, 연결용 A(루트 도메인일 때) 또는 CNAME(서브도메인일 때)이에요. 도메인을 관리하는 곳의 DNS 설정에 값을 그대로 복사해 넣어요. Cloudflare는 프록시(오렌지 구름)를 끄고 DNS 전용으로 넣어요 — 켜져 있으면 확인이 계속 실패해요.
3

다시 확인

레코드가 반영되면(보통 몇 분, 길면 수십 분) 다시 확인을 눌러요. 확인되면 HTTPS 인증서를 자동으로 발급하고, 끝나면 활성이 돼요. AxHub도 1분마다 다시 확인해서, 기다리기만 해도 바뀌어요.
상태뜻
대기아직 레코드를 확인하지 못했어요. 레코드를 넣고 다시 확인을 눌러요
검증 실패확인했는데 레코드가 맞지 않아요. 화면에 나온 원인을 보고 레코드를 고쳐요
인증서 발급 중레코드는 맞았고 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).

이렇게 보이면 성공

고친 이름과 아이콘이 앱 목록과 스토어에 그대로 보이면 성공이에요.

다음은 앱 상태 관리하기에서 안 쓰는 앱을 절전 · 일시정지 · 삭제하는 법을 봐요.