Kubernetes 클러스터를 Vinchin에 연결

이 문서는 Vinchin 백업 시스템에 Kubernetes 클러스터를 추가하는 방법에 대한 상세한 안내를 제공합니다. 클러스터를 추가하는 방법은 세 가지가 있으며, 모든 방법은 최종적으로 대상 호스트에 에이전트 클라이언트를 설치해야 합니다.

Resources -> Infrasturcture로 이동하여 Kubernetes Cluster Management를 선택한 후 Add 버튼을 클릭하여 Kubernetes 클러스터를 추가합니다.

아래 방법 중 하나를 선택하여 Kubernetes를 추가하세요.

Manual Add
SSH Deployment
Cluster Configuration file

Manual Add

주의

1. 클러스터의 마스터 노드에 Helm 클라이언트가 설치되어 있는지 확인합니다. 2. 백업 서버의 Helm 저장소 주소에 접근 가능한지 확인합니다.

Vinchin 저장소 추가

아래 명령어를 사용하여 Vinchin을 Helm 저장소로 추가합니다. https://backup-server-ip/charts/를 실제 Vinchin 백업 서버의 Helm 저장소 주소로 교체하세요:

helm repo add vinchin https://backup-server-ip/charts/ --insecure-skip-tls-verify
helm search repo vinchin
helm repo update vinchin

클라이언트 에이전트 설치

아래 명령어를 사용하여 Vinchin 에이전트를 Kubernetes에 설치합니다. 아래 명령어 중 하나를 선택하여 실행하세요:

이 모드에서는 Vinchin이 클라이언트에 능동적으로 연결합니다. 다음 명령어를 실행하세요:

helm install vinchin vinchin/client -n vinchin --create-namespace \ --set image.pullPolicy=Always \ --insecure-skip-tls-verify \ --set server.port=23100 \ #23000 for Vinchin server to connect --set server.net_model=1 #1:Vinchin connect to K8S

클라이언트 에이전트는 시작 후 클러스터 정보를 자동으로 등록합니다.

이 모드에서는 클라이언트가 Vinchin에 능동적으로 연결합니다. 다음 명령어를 실행하세요:

helm install vinchin vinchin/client -n vinchin --create-namespace \ --set server.host=backup-server-ip \ #Your Vinchin Server IP --set server.port=22710 \ #22710 for Vinchin server to connect --set image.pullPolicy=Always \ --insecure-skip-tls-verify \ --set server.net_model=2 #2:K8S connect to Vinchin

Vinchin 웹 페이지의 Add Kubernetes Cluster -> Manul Add 기능 페이지에서 마스터 노드의 IP 주소와 클라이언트 리스닝 포트를 수동으로 입력합니다.

원격 클라이언트 배포를 위한 SSH 추가

주의

1. SSH 사용자에게 루트 권한이 있는지 확인합니다. 2. 클라이언트와 서버 네트워크가 상호 연결되어 있는지 확인합니다.

Add 버튼을 클릭한 후 Add Method로 Add via SSH for remote client deployment를 선택합니다.

클러스터 마스터 노드의 SSH 연결 정보(IP 주소, 사용자명, 비밀번호 또는 키 등)를 입력합니다. OK를 클릭하면 Vinchin이 대상 노드에서 설치 명령어를 자동으로 실행하고 클라이언트 에이전트를 배포합니다.

배포 후 Kubernetes 마스터 노드에서 다음 명령어를 사용하여 클라이언트 에이전트의 상태를 확인합니다:

kubectl get pods -n vinchin

모든 Pod가 Running 상태이면 클라이언트 에이전트가 성공적으로 배포되고 시작된 것입니다.

원격 클라이언트 배포를 위한 클러스터 연결 구성 파일을 통한 추가

주의

1. 대상 클러스터의 kubeconfig 파일을 확보했는지 확인합니다. 2. 백업 서버가 대상 클러스터의 API 서버에 접근할 수 있는지 확인합니다.

Add 버튼을 클릭한 후 Add Method로 Add via cluster connection configuration file for remote client deployment를 선택합니다.

kubeconfig 파일(.yaml 또는 .txt 형식 지원)을 업로드하거나 파일 내용을 직접 붙여넣습니다. Vinchin은 Helm 명령어를 사용하여 클라이언트 에이전트를 원격으로 설치합니다.

kubeconfig 파일은 일반적으로 Kubernetes 마스터 노드의 ~/.kube/config 파일에 위치합니다. 다음 명령어를 사용하여 내용을 확인할 수 있습니다:

cat ~/.kube/config

config 파일을 찾을 수 없는 경우 Kubernetes 공식 문서를 참조하여 파일을 생성하거나 획득하세요.

클라이언트 에이전트 제거

클러스터에서 클라이언트 에이전트를 제거해야 하는 경우 다음 명령어를 실행합니다:

helm uninstall vinchin -n vinchin

다음 명령어를 사용하여 제거 진행 상황을 실시간으로 모니터링합니다:

watch -n 1 kubectl get pods -n vinchin

대상 네임스페이스에 실행 중인 Pod가 없으면 제거가 성공적으로 완료된 것입니다.

Kubernetes