팀과 권한
팀을 만들고, 팀원을 초대하고, 역할별로 할 수 있는 일을 정리했습니다.
모든 앱은 팀 하나에 속합니다. 누가 앱을 볼 수 있고 고칠 수 있는지, 요금을 어디에 청구할지가 모두 팀 단위로 정해집니다.
가입하면 시작 팀이 하나 만들어지고 기본 팀으로 지정됩니다. 시작 팀도 다른 팀과 똑같은 일반 팀이라 권한·삭제 규칙이 같습니다. 팀은 더 만들거나 다른 팀에 초대받아 들어갈 수 있습니다.
팀 만들고 전환하기
ntro teams list # 내가 속한 팀
ntro teams create 'Example Team' --slug example-team
ntro teams switch example-team # 기본 팀 바꾸기
ntro apps create example-app --team example-team # 특정 팀에 앱 만들기명령마다 --team <ID 또는 슬러그>를 붙이면 기본 팀 대신 그 팀으로 실행합니다. 권한이 없는 팀의 리소스는 보이지 않습니다.
기본 팀이 삭제되거나 그 팀에서 나가면, 남아 있는 팀 중 가장 먼저 만들어진 팀이 기본 팀이 됩니다. 속한 팀이 하나도 없어도 계정은 쓸 수 있지만, 앱을 만들려면 먼저 팀을 만들거나 초대를 수락해야 합니다.
역할
| 역할 | 앱 | 팀·멤버 | 사용량·청구 조회 | 청구 설정 변경 |
|---|---|---|---|---|
owner | 관리 | 관리 | ✓ | ✓ |
member | 관리 | — | ✓ | — |
billing | — | — | ✓ | ✓ |
viewer | 읽기 | — | — | — |
viewer는 앱 정보와, 비용을 뺀 앱 트래픽 분석을 볼 수 있습니다. admin 역할은 없습니다.
팀원 초대
초대는 팀 owner만 보낼 수 있습니다. 역할은 member(기본값), billing, viewer 중에서 고릅니다.
ntro teams invitations create colleague@example.com --team example-team --role viewer
ntro teams invitations list --team example-teamntro teams members add colleague@example.com --role viewer도 똑같이 초대를 보냅니다. 대화형 터미널에서는 이메일과 역할을 고르라고 묻지만, 자동화에서는 둘 다 적어야 합니다.
초대받은 사람이 할 일: 이메일의 링크를 열고, 초대받은 이메일 주소의 계정으로 로그인한 뒤 수락합니다. 이미 나이트로쉽 계정이 있어도 수락해야 팀에 들어옵니다. 초대만으로는 추가되지 않습니다.
| 상황 | 동작 |
|---|---|
| 7일이 지남 | 초대가 만료되어 링크로 수락할 수 없습니다. |
같은 이메일로 다시 create | 보류 중인 초대의 링크와 만료 시각을 새로 만들고 이메일을 다시 보냅니다. |
| 초대 취소 | 이메일 또는 초대 ID로 철회합니다. 철회한 링크는 수락할 수 없습니다. |
ntro teams invitations revoke colleague@example.com --team example-team --yes
ntro teams invitations revoke '<invitationId>' --team example-team --yes멤버 제거
ntro teams members remove colleague@example.com --team example-team --yes제거 전에 한 번 더 묻습니다. CI·스크립트에서는 --yes를 붙이세요.
소유권 이전
팀의 owner는 한 명입니다. owner로 바로 초대할 수는 없으므로, 아래 순서로 넘깁니다.
- 새 소유자를
member·billing·viewer중 하나로 초대합니다. - 상대가 초대를 수락해 멤버가 될 때까지 기다립니다.
- 현재 소유자가 그 멤버의 역할을
owner로 바꿉니다.
ntro teams members list --team example-team
ntro teams members role colleague@example.com owner --team example-team역할을 바꾸는 순간 새 소유자가 지정되고, 기존 소유자는 동시에 member가 됩니다. 예전부터 소유자가 여러 명이던 팀이라면 기존 소유자 모두가 member가 되고 새 소유자 한 명만 남습니다.
소유자는 자기 자신을 팀에서 빼거나 자기 역할을 낮출 수 없습니다. 팀을 떠나려면 먼저 소유권을 넘긴 뒤 일반 멤버로 나가세요.
팀 삭제
소유자는 시작 팀을 포함해 자신이 소유한 팀을 삭제할 수 있습니다. 단, 활성 앱이 하나도 없어야 합니다. 활성 앱이 남아 있으면 409 team_has_apps가 반환됩니다. 이미 삭제한 앱은 팀 삭제를 막지 않습니다.