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

↑ ↓ 이동 ↵ 열기 esc 닫기

rdev 사용하기

Git 접근

서버가 직접 저장소를 복제하고 push하므로, GitHub, GitLab, Bitbucket 또는 자체 Git 서버에 접근할 서버 자신만의 방법이 필요합니다. 공개 저장소는 아무것도 필요 없습니다. 비공개 저장소는 서버에 키나 토큰을 한 번 지정하면 이후 모든 프로젝트가 그대로 동작합니다.

키와 토큰은 서버에 남습니다. rdev.cloud는 공개 키만 볼 수 있으며, 패널에 입력한 토큰은 전송되기 전에 브라우저에서 서버용으로 암호화됩니다.

세 가지 방법

방법 접근 범위 적합한 경우
서버 키 Git 계정이 열 수 있는 모든 저장소 개인 계정 하나
계정 나열한 소유자의 저장소(각각 자체 SSH 키 또는 토큰) 업무용과 개인용 등 여러 계정, 다른 호스트
배포 키 저장소 하나 가장 좁은 접근 범위, 클라이언트 저장소

서버가 복제할 때는 맞는 첫 번째 방법을 선택합니다. 프로젝트의 배포 키, 그다음 URL의 호스트와 소유자가 일치하는 계정, 마지막으로 서버 키입니다. SSH 복제가 거부되고 저장소가 공개 저장소라면 HTTPS로 대체합니다. 각 복제는 어떻게 열었는지 기억하므로 git pull과 git push가 계속 동작합니다.

서버 키

서버에서 서버를 열고 접근 탭에서 Git 접근을 찾으세요. 처음에는 키 만들기를 선택하고, 키를 복사해 계정에 추가하세요. GitHub, GitLab, Bitbucket에는 각각 알맞은 페이지를 여는 버튼이 있습니다. 같은 키로 push도 가능하므로 AI 에이전트도 push할 수 있습니다.

서버의 터미널에서는 다음을 사용하세요.

rdev git key            # print the key (made on first use)
rdev git key --rotate   # make a new one; remove the old one from your hosts

계정

원하는 만큼 계정을 추가할 수 있습니다. GitHub 계정 두 개, 회사 GitLab, Bitbucket, 자체 호스팅 Gitea를 나란히 사용할 수 있습니다. 각 계정에는 다음이 있습니다.

  • 이름: work나 personal 같은 짧은 이름
  • 호스트: github.com, gitlab.com, bitbucket.org 또는 자체 호스트이며, SSH가 22번 포트가 아니면 :port를 붙입니다.
  • 소유자: 선택 사항인 사용자 또는 조직. 해당 소유자의 저장소는 이 계정을 사용하며, 소유자가 없으면 호스트의 모든 저장소가 사용합니다.
  • SSH 키 또는 토큰: SSH 계정은 호스트에 추가할 자체 키를 받습니다. 토큰 계정은 개인 액세스 토큰(GitHub 세분화된 토큰, GitLab 개인 또는 프로젝트 토큰, Bitbucket API 토큰, Azure DevOps PAT)으로 HTTPS를 통해 복제합니다. GitLab은 사용자 이름으로 oauth2를, Bitbucket은 이메일을 요구합니다.

패널에서는 계정 추가를 선택하세요. 노트북 앱에서는 같은 목록이 Integrations 탭에 있습니다. 터미널에서는 다음과 같이 합니다.

rdev git account add work --host github.com --owner acme
echo "$TOKEN" | rdev git account add lab --host git.example.com --token --user oauth2
rdev git account list
rdev git account remove lab

배포 키

배포 키는 저장소 하나를 엽니다. 배포 키에서 프로젝트 이름(기존 프로젝트 또는 곧 추가할 프로젝트)을 입력하고 배포 키 만들기를 선택한 다음, 키를 저장소의 배포 키에 추가하세요. 에이전트가 push해야 한다면 쓰기 권한을 부여하세요. 프로젝트를 추가할 때 프로젝트의 배포 키 사용을 선택하거나 다음을 실행하세요.

rdev git key --project shop
rdev project add shop --git [email protected]:acme/shop.git --deploy-key

호스트 신뢰

서버는 GitHub, GitLab, Bitbucket의 키를 이미 알고 있습니다. 다른 호스트를 처음 만나면 무작정 연결하지 않고, 해당 호스트가 지문과 함께 신뢰 대기 중인 호스트에 표시됩니다. Git 호스트가 공개한 지문과 비교한 뒤 신뢰를 선택하거나, rdev git trust git.example.com --fingerprint SHA256:…를 실행하세요.

접근 테스트

프로젝트를 추가하기 전에 접근 테스트에 URL을 붙여넣으세요. 서버가 저장소를 읽어 보고, push 권한도 확인을 선택하면 아무것도 변경하지 않고 push도 시도합니다. 결과에는 어떤 키나 토큰을 사용했는지 또는 다음에 해야 할 일이 표시됩니다. 터미널에서는 rdev git test <url> [--write]를 사용하세요.