머신 설정

첫 번째 머신을 실행하기까지 네 가지 단계가 필요합니다. 구성을 생성하고, 서버를 등록하고, 프로비저닝한 후, 선택적으로 공개 트래픽을 위한 인프라를 설정합니다.

1단계: 설정 생성

설정은 SSH 자격 증명, 머신 정의, 저장소 매핑을 저장하는 이름이 있는 구성 파일입니다. 프로젝트 워크스페이스로 생각하면 됩니다.

rdc config init my-infra --ssh-key ~/.ssh/id_ed25519

CLI 참조: rdc config init

옵션	필수	설명
`--ssh-key <path>`	예	SSH 개인 키 경로. 틸드(`~`)는 자동으로 확장됩니다.
`--renet-path <path>`	아니오	원격 머신의 renet 바이너리 사용자 정의 경로. 기본 설치 위치가 기본값입니다.

이렇게 하면 my-infra라는 설정이 생성되고 ~/.config/rediacc/my-infra.json에 저장됩니다. 이름이 없을 때의 기본 설정은 ~/.config/rediacc/rediacc.json으로 저장됩니다.

여러 설정을 가질 수 있습니다(예: production, staging, dev). 어떤 명령에서든 --config 플래그로 전환하십시오.

2단계: 머신 추가

원격 서버를 설정에 머신으로 등록합니다.

rdc machine add server-1 --ip 203.0.113.50 --user deploy

CLI 참조: rdc machine add

옵션	필수	기본값	설명
`--ip <address>`	예	-	원격 서버의 IP 주소 또는 호스트명
`--user <username>`	예	-	원격 서버의 SSH 사용자명
`--port <port>`	아니오	`22`	SSH 포트
`--datastore <path>`	아니오	`/mnt/rediacc`	Rediacc가 암호화된 저장소를 저장하는 서버 경로

머신을 추가한 후 rdc는 서버의 호스트 키를 가져오기 위해 자동으로 ssh-keyscan을 실행합니다. 수동으로 실행할 수도 있습니다.

rdc machine scan-keys server-1

CLI 참조: rdc machine scan-keys

등록된 모든 머신을 보려면:

rdc machine list

CLI 참조: rdc machine list

3단계: 머신 설정

필요한 모든 의존성으로 원격 서버를 프로비저닝합니다.

rdc machine setup server-1

CLI 참조: rdc machine setup

이 명령은:

SFTP를 통해 renet 바이너리를 서버에 업로드
Docker, containerd, cryptsetup 설치 (설치되지 않은 경우)
rediacc 시스템 사용자 생성 (UID 7111)
데이터스토어 디렉터리 생성 및 암호화된 저장소를 위한 준비

옵션	필수	기본값	설명
`--datastore <path>`	아니오	`/mnt/rediacc`	서버의 데이터스토어 디렉터리
`--datastore-size <size>`	아니오	`95%`	데이터스토어에 할당할 가용 디스크 비율
`--debug`	아니오	`false`	문제 해결을 위한 상세 출력 활성화

설정은 머신당 한 번만 실행해야 합니다. 필요한 경우 다시 실행해도 안전합니다.

데이터스토어 백엔드

데이터스토어는 암호화된 저장소 이미지를 보관하는 머신별 스토리지 풀입니다. machine setup은 기본적으로 로컬 데이터스토어를 생성합니다. 서버 자체 디스크의 루프 장치 기반 BTRFS 파일시스템이며, --datastore-size(기본값은 사용 가능한 디스크의 95%)로 크기를 지정합니다. 거의 모든 단일 머신 배포에 적합한 백엔드이며 서버 외에 다른 것이 필요하지 않습니다.

데이터스토어 크기 조정

--datastore-size는 백분율(95%) 또는 절대 크기(50G, 1T)를 허용합니다. 데이터스토어는 나중에 온라인으로 확장할 수 있습니다.

rdc datastore resize ds-server-1 --size 200G

CLI 참조: rdc datastore resize

데이터스토어 내부의 저장소는 repo create 시점에 독립적으로 크기가 정해지며 실행 중에도 확장할 수 있으므로, 데이터스토어를 미리 과도하게 프로비저닝할 필요가 없습니다.

Ceph RBD 백엔드

공유형, 스케일 아웃형, 또는 Kubernetes를 지원하는 스토리지가 필요하다면 대신 외부 Ceph 클러스터에 데이터스토어를 초기화하십시오. 이 경우 데이터스토어는 RBD 이미지 위에 있게 되며(그 위에 BTRFS, 이미지별 LUKS 계층은 없음), 포크는 BTRFS reflink 대신 RBD 자체의 copy-on-write 클론을 사용합니다.

# 1. 머신의 Ceph 참조를 기록합니다 (pool + RBD 이미지, 비밀 정보 아님)

# 2. Ceph 백엔드에서 데이터스토어를 초기화합니다
rdc datastore create ds-server-1 -m server-1 --backend ceph --pool rbd --image datastore-server1 --size 100G

CLI 참조: rdc datastore create

Ceph 키링은 머신에만 보관되며, 설정 파일에는 비밀이 아닌 pool과 이미지 참조만 저장됩니다. Ceph는 Kubernetes 클러스터가 ceph-csi를 통해 사용하는 스토리지 계층이기도 합니다. 클러스터와 퍼시스턴트 볼륨에 대해서는 Kubernetes 가이드를, 두 백엔드의 비교는 아키텍처를 참조하십시오.

호스트 키 관리

서버의 SSH 호스트 키가 변경된 경우(예: 재설치 후) 저장된 키를 새로 고침하십시오.

rdc machine scan-keys server-1

CLI 참조: rdc machine scan-keys

이렇게 하면 해당 머신의 설정에서 knownHosts 필드가 업데이트됩니다.

SSH 연결 테스트

머신을 추가한 후 접근 가능한지 확인합니다.

rdc term connect server-1 -c "hostname"

CLI 참조: rdc term connect

이렇게 하면 SSH 연결을 열고 명령을 실행합니다. 성공하면 SSH 구성이 올바른 것입니다.

더 자세한 진단을 위해 다음을 실행하십시오.

rdc doctor

CLI 참조: rdc doctor

팁: SSH 연결을 확인하려면 rdc term connect <machine> -c "hostname"을 실행하거나 ssh를 직접 사용하십시오.

인프라 구성

공개적으로 트래픽을 제공해야 하는 머신의 경우 인프라 설정을 구성하십시오.

인프라 설정

rdc machine infra set server-1 \
  --public-ipv4 203.0.113.50 \
  --base-domain example.com \
  --cert-email admin@example.com \
  --cf-dns-token your-cloudflare-api-token

CLI 참조: rdc machine infra set

옵션	범위	설명
`--public-ipv4 <ip>`	머신	공개 IPv4 주소. 구성된 주소 패밀리에 대해서만 프록시 진입점 생성
`--public-ipv6 <ip>`	머신	공개 IPv6 주소. 구성된 주소 패밀리에 대해서만 프록시 진입점 생성
`--base-domain <domain>`	머신	애플리케이션의 기본 도메인(예: `example.com`)
`--cert-email <email>`	설정	Let’s Encrypt TLS 인증서용 이메일(머신 간 공유)
`--cf-dns-token <token>`	설정	ACME DNS-01 챌린지용 Cloudflare DNS API 토큰(머신 간 공유)
`--tcp-ports <ports>`	머신	추가로 포워딩할 TCP 포트 쉼표 구분 목록(예: `25,143,465,587,993`)
`--udp-ports <ports>`	머신	추가로 포워딩할 UDP 포트 쉼표 구분 목록(예: `53`)

머신 범위 옵션은 머신별로 저장됩니다. 설정 범위 옵션(--cert-email, --cf-dns-token)은 설정의 모든 머신에서 공유됩니다. 한 번 설정하면 모든 곳에 적용됩니다.

인프라 보기

rdc machine infra show server-1

CLI 참조: rdc machine infra show

서버에 푸시

Traefik 리버스 프록시 구성을 생성하여 서버에 배포합니다.

rdc machine infra push server-1

CLI 참조: rdc machine infra push

이 명령은:

원격 머신에 renet 바이너리 배포
Traefik 리버스 프록시, 라우터, systemd 서비스 구성
--cf-dns-token이 설정된 경우 머신 서브도메인(server-1.example.com 및 *.server-1.example.com)에 대한 Cloudflare DNS 레코드 생성

DNS 단계는 자동이며 멱등성이 있습니다. 누락된 레코드를 생성하고, 변경된 IP로 레코드를 업데이트하며, 이미 올바른 레코드는 건너뜁니다. Cloudflare 토큰이 구성되지 않은 경우 DNS는 경고와 함께 건너뜁니다. 저장소별 와일드카드 DNS 레코드(자동 경로용)는 rdc repo up을 실행할 때 자동으로 생성됩니다.

클라우드 프로비저닝

VM을 수동으로 생성하는 대신 클라우드 공급자를 구성하고 OpenTofu를 사용하여 rdc가 자동으로 머신을 프로비저닝하도록 할 수 있습니다.

사전 요구 사항

OpenTofu 설치: opentofu.org/docs/intro/install

SSH 설정에 rdc에 등록된 키가 있는지 확인하십시오.

# 키 파일을 읽어 /credentials/ssh 아래에 콘텐츠를 인라인으로 추가합니다.
rdc config ssh set --key ~/.ssh/id_ed25519

CLI 참조: rdc config ssh set

클라우드 공급자 추가

rdc machine provider add my-linode \
  --provider linode/linode \
  --token $LINODE_API_TOKEN \
  --region us-east \
  --type g6-standard-2

CLI 참조: rdc machine provider add

옵션	필수	설명
`--provider <source>`	예*	알려진 공급자 소스(예: `linode/linode`, `hetznercloud/hcloud`)
`--source <source>`	예*	사용자 정의 OpenTofu 공급자 소스(알 수 없는 공급자용)
`--token <token>`	예	클라우드 공급자 API 토큰
`--region <region>`	아니오	새 머신의 기본 리전
`--type <type>`	아니오	기본 인스턴스 타입/크기
`--image <image>`	아니오	기본 OS 이미지
`--ssh-user <user>`	아니오	SSH 사용자명(기본값: `root`)

* --provider 또는 --source 중 하나가 필수입니다. 알려진 공급자(기본값 내장)에는 --provider를 사용하십시오. 사용자 정의 공급자에는 추가 --resource, --ipv4-output, --ssh-key-attr 플래그와 함께 --source를 사용하십시오.

머신 프로비저닝

rdc machine provision prod-2 --provider my-linode

CLI 참조: rdc machine provision

이 단일 명령은:

OpenTofu를 통해 클라우드 공급자에 VM 생성
SSH 연결 대기
설정에 머신 등록
renet 및 모든 의존성 설치
Traefik 프록시 및 Cloudflare DNS 구성(형제 머신에서 기본 도메인 자동 감지 또는 --base-domain으로 명시적 지정)

옵션	설명
`--provider <name>`	클라우드 공급자 이름(`add-provider`에서)
`--region <region>`	공급자의 기본 리전 재정의
`--type <type>`	기본 인스턴스 타입 재정의
`--image <image>`	기본 OS 이미지 재정의
`--base-domain <domain>`	인프라의 기본 도메인. 지정하지 않으면 형제 머신에서 자동 감지
`--no-infra`	인프라 구성(프록시 + DNS) 완전히 건너뜀
`--debug`	상세한 프로비저닝 출력 표시

머신 프로비저닝 해제

rdc machine deprovision prod-2

CLI 참조: rdc machine deprovision

OpenTofu를 통해 VM을 삭제하고 설정에서 제거합니다. --force를 사용하지 않으면 확인이 필요합니다. machine provision으로 생성된 머신에만 작동합니다.

공급자 목록

rdc machine provider list

CLI 참조: rdc machine provider list

기본값 설정

모든 명령에서 지정할 필요가 없도록 기본값을 설정합니다.

rdc config field set --pointer /defaults/machine --new '"server-1"'   # 기본 머신
rdc config set team my-team                   # 설정 저장소의 기본 팀

CLI 참조: rdc config field set · rdc config set

기본 머신을 설정한 후 명령에서 -m server-1을 생략할 수 있습니다.

rdc repo create my-app -m my-server --size 10G

CLI 참조: rdc repo create

다중 설정

명명된 설정으로 여러 환경을 관리합니다.

# 별도의 설정 생성
rdc config init production --ssh-key ~/.ssh/id_prod
rdc config init staging --ssh-key ~/.ssh/id_staging

# 특정 설정 사용
rdc repo list -m server-1 --config production
rdc repo list -m staging-1 --config staging

CLI 참조: rdc config init · rdc repo list

모든 설정 보기:

rdc config list

CLI 참조: rdc config list

현재 설정 세부 정보 표시:

rdc config show

CLI 참조: rdc config show