rdc 빠른 참조: 설정, 리포지터리, 머신, 파일 동기화, 컨테이너. 전체 옵션: 모든 명령에 --help 추가.
RDC CLI 치트 시트
모든 rdc 명령이 나열되어 있지는 않으며, 배포할 때마다 자주 사용되는 명령만 포함되어 있습니다. 전체 옵션 집합을 보려면 모든 rdc 명령을 --help와 함께 실행하세요. 엣지 케이스 및 거의 사용되지 않는 옵션은 전체 참고서에 있습니다.
리포지터리 수명 주기
| 명령 | 설명 |
|---|
rdc repo create <repo> -m <machine> | 머신에 새 리포지터리 생성 |
rdc repo up <repo>@<machine> | 리포지터리 배포 또는 업데이트 |
rdc repo down <repo>@<machine> | 리포지터리 중지 |
rdc repo delete <repo>@<machine> | 리포지터리 삭제 |
rdc repo fork <repo>@<machine> --tag <tag> | 리포지터리 포크 (거의 즉각적, BTRFS reflink) |
rdc repo promote <repo>:<tag> | 검증된 포크를 상위 리포지터리 이름으로 프로덕션에 승격 |
rdc repo list | 이름 및 GUID와 함께 모든 리포지터리 나열 |
rdc repo resize <repo> --size <size> | 중지된 리포지터리의 볼륨 크기 조정 |
rdc repo expand <repo> --size <size> | 실행 중인 리포지터리의 볼륨을 그 자리에서 확장 |
리포지터리별 시크릿
쓰기 전용 배포 시점 자격 증명. get은 다이제스트만 반환합니다. 값은 절대 반환되지 않습니다. 전체 가이드는 리포지터리 § 시크릿을 참조하세요.
| 명령 | 설명 |
|---|
rdc repo secret set <repo> --key <KEY> --value <val> [--mode env|file] --current "" | 새 시크릿 생성 (첫 번째 쓰기에는 --current "") |
rdc repo secret set <repo> --key <KEY> --value <val> --current <prev> | 기존 시크릿 덮어쓰기 (passwd 스타일 사전 조건) |
rdc repo secret set <repo> --key <KEY> --value <val> --rotate-secret | 이전 값 확인 없이 덮어쓰기 (교체로 감사됨) |
rdc repo secret list <repo> | 시크릿 이름 + 전달 모드 나열 (값 및 다이제스트 절대 없음) |
rdc repo secret get <repo> --key <KEY> | 시크릿 다이제스트 + 모드 표시 (평문 값 없음, 절대로) |
rdc repo secret unset <repo> --key <KEY> --current <prev> | 시크릿 삭제 |
rdc repo secret unset <repo> --key <KEY> --rotate-secret | 이전 값 확인 없이 삭제 |
포크는 시크릿을 상속하지 않습니다. rdc repo secret set <repo>:<tag>로 포크에 명시적으로 설정하세요.
백업 및 복원
| 명령 | 설명 |
|---|
rdc repo push ... --bwlimit <limit> | 푸시 중 rsync 대역폭 제한 (예: 10M) |
rdc repo pull ... --bwlimit <limit> | 풀 중 rsync 대역폭 제한 |
rdc repo push ... --checkpoint | 푸시 전 컨테이너 체크포인트 생성 |
rdc backup manifests <repo-ref> | 청크 스토리지가 보관하는 스냅샷 나열 |
rdc backup browse <repo-ref> | 리포지터리에 포함된 파일 나열 (로컬, 읽기 전용) |
rdc backup snapshot <repo> | 청크 스토리지 스냅샷 업로드: 처음에는 전체 인벤토리, 이후에는 변경된 셀만 |
rdc backup snapshot <repo> --dry-run | 업로드 없이 스냅샷 계획; 무엇이 이동할지 보고 |
rdc backup verify <repo> | 레포지토리의 백업 앵커를 청크 스토리지와 대조하여 검증 |
rdc backup usage | 청크 스토리지에 저장된 바이트를 쿼터와 비교하여 표시 |
rdc backup manifests <repo> | 서버에 기록된 스냅샷 매니페스트 나열 |
rdc storage browse <storage> | 스토리지 내용 탐색 |
리포지터리 마이그레이션
| 명령 | 설명 |
|---|
rdc repo migrate <repo>@<machine> --to <machine> | 머신 간 리포지터리 이동 |
rdc repo migrate ... --provision | 전송 전 대상에 프로비저닝 |
rdc repo migrate ... --checkpoint | 마이그레이션 전 체크포인트 생성 |
rdc repo migrate ... --skip-dns | 마이그레이션 후 DNS 업데이트 건너뜀 |
rdc repo migrate ... --bwlimit <limit> | 전송 대역폭 제한 |
백업 전략
| 명령 | 설명 |
|---|
rdc backup strategy set <name> --destination <storage> --cron <expr> --mode <hot|cold> --enable | 명명된 백업 전략 생성 또는 업데이트 |
rdc backup strategy list | 정의된 모든 백업 전략 나열 |
rdc backup strategy show <name> | 전략의 세부 사항 표시 |
rdc backup strategy remove <name> | 전략 제거 |
rdc backup schedule -m <machine> | 구성된 백업 전략을 머신에 배포 |
백업 작업
| 명령 | 설명 |
|---|
rdc backup schedule -m <machine> | 바인딩된 전략을 systemd 타이머로 배포 |
rdc backup schedule -m <machine> --dry-run | 배포 없이 타이머 단위 미리 보기 (토큰 마스킹) |
rdc backup run -m <machine> | 바인딩된 모든 전략 즉시 실행 |
rdc backup run <name> -m <machine> | 특정 전략 즉시 실행 |
rdc backup status -m <machine> | 타이머 상태 및 최근 작업 결과 표시 |
rdc backup status <name> -m <machine> | 특정 전략의 상태 표시 |
rdc backup cancel -m <machine> | 실행 중인 백업 취소 |
rdc backup cancel <name> -m <machine> | 특정 실행 중인 백업 취소 |
머신 관리
| 명령 | 설명 |
|---|
rdc machine status <machine> | 전체 머신 상태 (시스템, 컨테이너, 서비스, 리포지터리, 네트워크) |
rdc machine status <machine> --system | 시스템 정보만 |
rdc machine status <machine> --containers | 컨테이너 목록만 |
rdc machine status <machine> --repositories | 리포지터리 목록만 |
rdc machine status <machine> --services | 서비스 목록만 |
rdc machine status <machine> --network | 네트워크 정보만 |
rdc machine status <machine> --block-devices | 블록 디바이스 정보만 |
rdc machine list | config의 모든 머신 나열 |
rdc machine setup <machine> | 초기 머신 프로비저닝 실행 |
rdc machine health <machine> | 머신 상태 확인 |
rdc machine scan-keys <machine> | 재구축 후 SSH 호스트 키 새로 고침 |
rdc machine prune <machine> | 머신에서 사용하지 않는 리소스 제거 |
rdc machine deprovision <machine> | 머신 완전히 디프로비저닝 |
터미널 및 동기화
| 명령 | 설명 |
|---|
rdc term connect <machine> | 머신으로 SSH 터미널 열기 |
rdc term connect <repo>@<machine> | 리포지터리로 SSH 터미널 열기 (DOCKER_HOST 설정) |
rdc term connect <machine> -c "<command>" | 머신에서 명령 실행 |
rdc repo sync upload <repo>@<machine> --local <paths...> | 하나 이상의 로컬 파일/디렉터리를 리포지터리에 업로드 |
rdc repo sync upload <repo>@<machine> --local <file> --remote-file <path> | 단일 로컬 파일을 명시적인 원격 경로에 업로드 |
rdc repo sync download <repo>@<machine> --local <dir> | 리포지터리 디렉터리를 로컬에 다운로드 |
rdc repo sync download <repo>@<machine> --remote-file <path> --local <dir> | 단일 원격 파일을 로컬 디렉터리로 다운로드 |
rdc vscode connect <repo>@<machine> | VS Code Remote SSH 세션 열기 |
rdc vscode list | vscode connect가 생성한 SSH 설정 나열 |
rdc vscode cleanup --all | vscode connect가 작성한 모든 SSH 설정 제거 |
rdc repo tunnel <repo> -c <container> --port <port> | SSH를 통해 컨테이너 포트 전달 |
구성
| 명령 | 설명 |
|---|
rdc config init <name> | 명명된 config 파일 생성 |
rdc config list | 이 머신의 모든 config 나열 |
rdc config set machine <alias> | 별칭이 다른 머신을 가리키도록 설정 |
rdc machine add <machine> --ip <host> --user <user> | config에 머신 추가 |
rdc storage import rclone.conf | rclone config에서 스토리지 공급자 가져오기 |
rdc storage list | 구성된 스토리지 공급자 나열 |
rdc backup strategy set ... | 명명된 백업 전략 정의 |
rdc --config <name> <command> | 명명된 config 파일 사용 |
디버그 및 이스케이프 해치
| 명령 | 설명 |
|---|
rdc repo logs <repo>@<machine> -c <container> --lines 200 --follow | 컨테이너 로그 스트리밍 (권장) |
rdc repo exec <repo>@<machine> -c <container> -- <command> | 컨테이너에서 명령 실행 (권장) |
rdc repo exec <repo>@<machine> -c <container> -i -- bash | 대화형 컨테이너 셸 연결 |
rdc term connect <repo>@<machine> -c "docker ps" | 리포지터리의 컨테이너 나열 |
rdc term connect <repo>@<machine> -c "docker logs <name>" | 컨테이너 로그 가져오기 |
rdc term connect <repo>@<machine> -c "docker exec <name> <cmd>" | 컨테이너에서 명령 실행 |
rdc term connect <repo>@<machine> -c "docker restart <name>" | 컨테이너 재시작 |