문서의 모든 페이지를 검색하려면 두 글자 이상 입력하세요.

↑ ↓ 이동 ↵ 열기 esc 닫기

rdev 사용하기

팀

Team 요금제 서버를 사용하는 사람을 관리하세요. 개발자를 초대하고 역할과 전용 환경을 부여할 수 있습니다.

사람 초대

대시보드에서 내 팀을 여세요. 개발자의 이메일 주소를 입력하고 역할을 선택한 뒤 초대를 보내세요. 초대받은 사람은 7일 동안 유효한 링크가 담긴 이메일을 받으며, 같은 주소로 로그인하거나 계정을 만들어 수락합니다.

모든 멤버와 대기 중인 초대는 각각 좌석 하나를 사용합니다. 좌석이 모두 사용 중이면 먼저 대시보드에서 요금제를 변경해 좌석을 추가하세요. 대기 중인 초대를 취소하면 해당 좌석이 즉시 비워집니다.

역할

역할 권한
소유자 모든 권한: 라이선스 비용을 지불하며 제거할 수 없음
관리자 초대 보내기, 다시 보내기, 취소, 역할 변경, 멤버 제거
멤버 팀 서버 사용, 팀에서 나갈 수 있음

멤버별 환경

각 멤버는 내 팀 페이지에 SSH 공개 키를 한 줄에 하나씩 저장합니다. 작업하는 컴퓨터마다 키가 하나씩 필요합니다(예: ~/.ssh/id_ed25519.pub의 내용). 페이지에는 rdev-alice 같은 멤버 환경의 이름이 표시되며, 키가 없는 멤버는 표시됩니다. 서버의 SSH keys 탭은 이 팀 키를 서버 자체 키 위의 별도 카드에 보여 줍니다.

팀 서버에서 Tailscale 계정의 재사용 가능한 인증 키로 root로 한 번 다음을 실행하세요.

sudo rdev host member sync --tailscale-key tskey-auth-…

키를 저장한 모든 멤버의 환경이 만들어지고, 이후 15분마다 스스로 반복됩니다. 새 멤버는 환경을 받고, 변경된 키는 업데이트되고, 팀을 떠난 사람의 환경은 제거됩니다. 해당 데이터는 서버에 남으며, sudo rdev host member remove <name> --delete-data로 삭제할 수 있습니다.

각 멤버는 자체 코드, 데이터베이스, 서비스, 셸이 있는 별도의 컨테이너를 받으며, 멤버끼리는 서로의 작업을 볼 수 없습니다. 컨테이너는 <server name>-<name>이라는 이름으로 테일넷에 참여하고, 멤버는 ssh dev@<server name>-<name>이나 rdev 노트북 앱으로 접속합니다. 소유자는 계속 서버의 메인 환경을 사용합니다.

  • sudo rdev host status는 멤버와 환경의 실행 여부를 나열합니다.
  • sudo rdev host update는 서버의 모든 환경을 함께 업데이트합니다.
  • sudo rdev host member add <name> --ssh-key "…"는 환경을 직접 추가하지만, 해당 사람이 팀에 없으면 다음 동기화 때 제거됩니다.

각 환경에는 자체 동기화 및 환경 변수 설정이 있습니다. 멤버는 내 팀 페이지의 내 환경들에서 자신의 설정을 찾을 수 있습니다: 파일 동기화 켜기/끄기, 노트북으로 전달되는 프로젝트, 제외 항목, 프로젝트의 환경 변수. 자신의 환경은 멤버만 변경할 수 있으며, 메인 환경은 소유자와 관리자가 변경합니다. rdev 노트북 앱에서도 마찬가지입니다.

새 멤버 환경의 PHP. 새 멤버는 메인 환경의 PHP로 시작(내 팀 페이지, 기본값)이 켜져 있으면 새 멤버의 환경은 만들어질 때 메인 환경의 PHP 버전, 기본 버전, 각 버전의 카탈로그 확장을 받으므로 팀의 프로젝트가 바로 실행됩니다. 기존 환경은 변경되지 않으며, 각 멤버는 나중에 자신의 PHP를 변경할 수 있습니다. 이 기능에는 팀 서버에서 rdev 0.2.0-beta.36 이상이 필요하며, 꺼져 있으면 새 환경은 기본 PHP로 시작합니다.

여러 팀 서버. 큰 팀은 환경을 여러 서버에 나눌 수 있습니다. 각 서버에 Team 라이선스로 rdev를 설치하고 각각에서 rdev host member sync를 실행하세요. 팀 서버가 둘 이상이면 Your team 페이지의 Members 표에 서버 열이 생기며, 소유자와 관리자가 각 멤버의 서버를 정합니다. 배정되지 않은 멤버는 팀의 첫 서버에서 작업합니다. 각 서버는 다음 동기화(15분 이내)에 배정된 멤버의 환경을 만들고 나머지 컨테이너를 제거합니다. 파일은 이전 서버에서 sudo rdev host member remove <이름> --delete-data로 지울 때까지 남으니, 옮기기 전에 commit과 push를 하세요. 모든 팀 서버에 rdev 1.1.10 이상이 필요합니다.

프로젝트를 멤버에게 복사하기

소유자와 관리자는 git을 거치지 않고 프로젝트를 멤버에게 넘길 수 있습니다. 서버 페이지에서 프로젝트를 열고, 프로젝트 메뉴에서 팀 멤버에게 복사를 고른 뒤 멤버와 함께 보낼 항목을 선택합니다.

  • 데이터베이스도 복사 (기본값 켜짐): 프로젝트와 이름이 같은 MySQL, MariaDB 또는 PostgreSQL 데이터베이스.
  • .env도 복사 (기본값 꺼짐): 그 안의 비밀번호와 API 키도 함께 전달되며 되돌릴 수 없습니다. 멤버가 자신의 값을 쓰게 하려면 꺼 두세요.

팀 서버는 다음 동기화 때, 15분 안에 프로젝트를 멤버의 환경에 복사합니다. 프로젝트 아래의 팀 멤버에게 보낸 복사본에서 각 복사가 언제 끝났는지, 실패했다면 이유가 무엇인지 볼 수 있습니다. 이후 멤버는 자신의 복사본에서 작업하고, 변경 사항은 git으로 돌아옵니다. 빌드 결과물(target, .next, .nuxt, .svelte-kit, .turbo, .dart_tool, .gradle, __pycache__)은 복사되지 않으므로 복사본의 첫 빌드는 처음부터 시작합니다. vendor와 node_modules는 복사됩니다. 멤버에게 같은 이름의 프로젝트가 이미 있으면, 그 프로젝트를 지우거나 이름을 바꿀 때까지 복사가 실패합니다.

복사는 같은 서버의 환경 사이에서 이루어지며, 그 서버에서 rdev host member sync가 실행되고 있어야 합니다(위 참조). 그 전까지는 복사 창과 내 팀 페이지에 복사가 대기 중이라는 경고가 표시됩니다. 팀 서버에 rdev 1.4.6 이상이 필요합니다.

공유 데이터베이스

소유자의 환경은 팀의 공유 데이터베이스 서버를 겸합니다. 모든 멤버 환경은 자신의 비공개 서비스와 함께 rdev-team이라는 이름으로 소유자의 데이터베이스와 서비스(MySQL, MariaDB, PostgreSQL, MongoDB, Redis 등)에 접근합니다(예: Laravel .env에서 DB_HOST=rdev-team, 포트 3306). 공유 스테이징 사본처럼 팀 전체가 작업하는 데이터에 사용하고, 개인 실험은 자신의 환경 데이터베이스에서 진행하세요.

공유 변수

소유자와 관리자는 내 팀 페이지의 공유 변수에서 API 키 같은 변수를 팀 전체와 공유할 수 있습니다. 변수 추가를 선택하고 이름(예: STRIPE_SECRET), 대상 프로젝트 또는 모든 프로젝트, 값을 입력하세요. 팀의 모든 환경이 몇 초 안에 해당 프로젝트의 .env에 기록하며, 나중에 만들어지는 프로젝트에도 기록합니다. 나중에 참여하는 멤버는 이미 변수가 있는 환경에서 받습니다. 한 프로젝트용 변수는 같은 이름의 모든 프로젝트용 변수보다 우선합니다. 모든 프로젝트용 변수는 .env가 있는 폴더에만 들어가므로 앱이 아닌 폴더는 그대로 유지됩니다.

연필 아이콘으로 값을 변경하거나, 변수를 제거해 모든 .env에서 삭제할 수 있습니다. 표에는 각 변수를 가진 환경 수가 표시되며, 숫자 위에 마우스를 올리면 아직 받지 못한 환경을 볼 수 있습니다.

브라우저가 페이지를 떠나기 전에 환경별로 값을 따로 암호화하므로 rdev 패널은 이름만 저장하고 값은 저장하지 않습니다. 환경 안에서 값은 평범한 .env 줄이므로 다른 .env와 마찬가지로 해당 환경을 사용하는 사람은 읽을 수 있습니다. 공유 변수는 동기화할 때마다 프로젝트 .env의 같은 줄을 덮어쓰므로 파일이 아닌 여기서 변경하세요. 각 환경에서 rdev 0.2.0-beta.34 이상이 필요합니다.

팀 백업 스토리지

소유자와 관리자는 내 팀 페이지의 팀 백업 스토리지에서 모든 멤버용 백업 버킷 하나를 설정할 수 있습니다. 각 환경은 그 안의 자체 폴더에 백업하며, 각 멤버는 여전히 서버 페이지에서 자신의 버킷을 고를 수 있습니다. 백업과 설정을 참고하세요.

팀 시작하기

Team 플랜에서는 소유자의 대시보드에 팀 설정 상자가 나타나 첫 단계를 순서대로 보여 줍니다: 팀의 첫 서버에 rdev 설치, 팀 초대, 멤버가 자신의 환경 설치, 노트북 연결, 첫 프로젝트 추가. 각 단계는 필요한 페이지나 가이드로 연결되고 완료되면 체크됩니다. 라이브 온보딩 통화 예약은 지원 요청을 열어 가능한 시간을 몇 개 보내면 저희가 팀과의 통화를 잡아 드립니다. 필요 없음을 누르면 상자가 영구히 숨겨집니다.

팀 채널

소유자와 관리자는 내 팀 페이지에서 Slack 또는 Discord 수신 웹훅을 팀 채널로 추가할 수 있습니다. 다음 동기화 때 소유자의 환경을 포함한 팀 서버의 모든 환경이 각 멤버가 rdev notify로 설정한 채널과 함께 에이전트 알림(완료, 승인 대기, 오류)을 이곳으로도 보냅니다. 중지하려면 입력란을 비우세요.

AI 에이전트용 팀 규칙

소유자와 관리자는 내 팀 페이지에서 코딩 컨벤션이나 새 프로젝트에 사용할 데이터베이스 같은 AI 에이전트용 팀 규칙을 작성할 수 있습니다. 다음 동기화 때 팀 서버의 모든 환경이 이를 에이전트 프로필에 추가하므로 Claude Code와 Codex가 모든 프로젝트에서 규칙을 따릅니다. 멤버는 같은 페이지에서 규칙을 확인할 수 있습니다.

라이선스가 중지되면

Team 라이선스가 더 이상 활성 상태가 아니면 새 멤버가 팀에 참여할 수 없고, 서버의 모든 환경은 단일 서버와 마찬가지로 새 프로젝트에 대해 읽기 전용이 됩니다.