DevOps/Ceph

Cephadm으로 클러스터 초기화와 Host 추가하는 방법

DEBTOLEE 2025. 4. 1. 10:25

Cephadm을 활용하여 Ceph 클러스터를 구축할 때는 클러스터 초기화와 호스트(Host) 추가 작업이 필수적으로 요구됩니다. 이번 글에서는 클러스터의 초기화 단계부터 호스트 추가까지의 전체 과정을 체계적으로 안내합니다.

클러스터 초기화하기

Ceph 클러스터 구축의 첫 단계는 Mon(Monitor) 노드를 초기화하는 것입니다. 초기화 과정을 통해 클러스터의 중심 역할을 수행할 첫 Mon 노드를 설정하고 기본적인 클러스터 환경을 구성할 수 있습니다.

다음 명령어를 사용하여 클러스터 초기화를 진행합니다.

cephadm bootstrap --mon-ip {Mon노드IP} --initial-dashboard-user bioline --initial-dashboard-password {초기비밀번호}
  • {Mon노드IP}에는 초기화할 Mon 노드의 IP 주소를 입력합니다.
  • {초기비밀번호}에는 관리자 계정의 초기 비밀번호를 설정합니다.

SSH 공개 키 복사하기

클러스터 내 모든 노드 간의 원활한 SSH 접근을 위해 SSH 공개 키(Public Key) 설정이 필요합니다. 일반적으로 사용하는 ssh-copy-id 명령어 대신 권한 문제가 발생하는 경우 수동으로 키를 복사할 수 있습니다.

초기화된 Mon 노드에서 공개 키를 확인합니다.

cat /etc/ceph/ceph.pub

확인된 키 내용을 클러스터에 추가할 모든 노드의 /root/.ssh/authorized_keys 파일에 복사하여 붙여 넣습니다.

nano /root/.ssh/authorized_keys

편집이 완료된 후 저장하면 노드 간 SSH 접근 설정이 완료됩니다.

Cephadm 클러스터에 호스트 추가하기

클러스터에 Mon, OSD 등 다양한 역할을 수행할 호스트를 추가할 때는 별도의 도메인 서버(DNS)가 없다면 /etc/hosts 파일에 IP와 호스트명을 등록하여 사용합니다.

다음 명령어를 사용하여 클러스터에 호스트를 추가합니다.

ceph orch host add {호스트명} {해당IP}
  • {호스트명}은 추가할 노드의 호스트명을 입력합니다.
  • {해당IP}는 추가할 노드의 IP 주소를 입력합니다.

예를 들어, IP가 192.168.1.20인 호스트를 추가할 때는 다음 명령어를 입력합니다.

ceph orch host add storage-node-1 192.168.1.20

추가한 호스트의 상태와 목록은 아래 명령어로 확인할 수 있습니다.

ceph orch host ls

주의할 사항

  • 클러스터 초기화 및 호스트 추가 시 입력한 정보를 정확히 확인하여 잘못된 정보 입력으로 인해 발생할 수 있는 문제를 예방하시기 바랍니다.
  • 초기화 이후 추가 작업을 진행할 때는 반드시 클러스터 상태를 점검하여 안정성을 유지하세요.

위 과정을 통해 안정적이고 효율적인 Cephadm 클러스터 구축 및 운영이 가능합니다.