예시 1

1. 미디어: Full Flash System (SSDs)
2. 사용 사례: 블록(RBD) 및 파일(CephFS) 또는 오브젝트(Ceph Object Gateway)
3. 노드 수: 3
4. 복제 스키마: 2

예시 2

1. 미디어: SSD(Full Flash System) 또는 회전 장치(HDD)
2. 사용 사례: 블록(RBD), 파일(CephFS), 오브젝트(Ceph Object Gateway)
3. 노드 수: 4
4. 복제 스키마: 3

예시 3

1. 미디어: SSD(Full Flash System) 또는 회전 장치(HDD)
2. 사용 사례: Ceph Object Gateway용 블록(RBD), 오브젝트(Ceph Object Gateway) 및 NFS
3. 노드 수: 4
4. 복제 스키마: 3

절차

1. 노드를 등록하고 메시지가 표시되면 Red Hat 고객 포털 인증 정보를 입력합니다.

   구문

   subscription-manager register

2. CDN에서 최신 서브스크립션 데이터를 가져옵니다.

   구문

   subscription-manager refresh

3. Red Hat Ceph Storage에 사용 가능한 모든 서브스크립션을 나열합니다.

   구문

   subscription-manager list --available --matches 'Red Hat Ceph Storage'

4. 적절한 서브스크립션을 식별하고 해당 풀 ID를 검색합니다.

5. 소프트웨어 인타이틀먼트에 대한 액세스 권한을 얻기 위해 풀 ID를 연결합니다. 이전 단계에서 확인한 풀 ID를 사용합니다.

   구문

   subscription-manager attach --pool=POOL_ID

6. 기본 소프트웨어 리포지토리를 비활성화한 다음 해당 Red Hat Enterprise Linux 버전에서 서버 및 추가 리포지토리를 활성화합니다.

   Red Hat Enterprise Linux 8

   subscription-manager repos --disable=*
   subscription-manager repos --enable=rhel-8-for-x86_64-baseos-rpms
   subscription-manager repos --enable=rhel-8-for-x86_64-appstream-rpms

   Red Hat Enterprise Linux 9

   subscription-manager repos --disable=*
   subscription-manager repos --enable=rhel-9-for-x86_64-baseos-rpms
   subscription-manager repos --enable=rhel-9-for-x86_64-appstream-rpms

7. Red Hat Enterprise Linux의 최신 패키지를 수신하도록 시스템을 업데이트합니다.

   구문

   # dnf update

8. Red Hat Ceph Storage 5 컨텐츠를 구독하십시오. Red Hat Satellite 6으로 Ceph 등록 방법 의 지침을 따르십시오.

9. ceph-tools 리포지토리를 활성화합니다.

   Red Hat Enterprise Linux 8

   subscription-manager repos --enable=rhceph-5-tools-for-rhel-8-x86_64-rpms

   Red Hat Enterprise Linux 9

   subscription-manager repos --enable=rhceph-5-tools-for-rhel-9-x86_64-rpms

10. 클러스터에 추가하는 모든 노드에서 위의 단계를 반복합니다.

11. Red Hat Enterprise Linux 8에 cephadm-ansible 을 설치합니다.

    예제

    dnf install cephadm-ansible

    중요

    Red Hat Enterprise Linux 9의 경우 cephadm-ansible 이 지원되지 않으므로 이 단계를 건너뜁니다.

절차

1. /usr/share/cephadm-ansible/ 디렉토리로 이동합니다.

   [root@admin ~]# cd /usr/share/cephadm-ansible

2. 선택 사항: 스테이징 및 프로덕션에 사용할 하위 디렉터리를 만듭니다.

   [root@admin cephadm-ansible]# mkdir -p inventory/staging inventory/production

3. 선택 사항: ansible.cfg 파일을 편집하고 다음 행을 추가하여 기본 인벤토리 위치를 할당합니다.

   [defaults]
   inventory = ./inventory/staging

4. 선택 사항: 각 환경에 대한 인벤토리 hosts 파일을 생성합니다.

   [root@admin cephadm-ansible]# touch inventory/staging/hosts
   [root@admin cephadm-ansible]# touch inventory/production/hosts

5. 각 hosts 파일을 열고 편집하고 노드 및 [admin] 그룹을 추가합니다.

   NODE_NAME_1
   NODE_NAME_2
   
   [admin]
   ADMIN_NODE_NAME_1

   • NODE_NAME_1 및 NODE_NAME_2 를 모니터, OSD, MDS, 게이트웨이 노드와 같은 Ceph 노드로 바꿉니다.

   • ADMIN_NODE_NAME_1 을 관리 인증 키가 저장된 노드의 이름으로 바꿉니다.

     예제

     host02
     host03
     host04
     
     [admin]
     host01

     참고

     ansible.cfg 파일의 인벤토리 위치를 staging으로 설정하는 경우 다음과 같이 스테이징 환경에서 플레이북을 실행해야 합니다.

     구문

     ansible-playbook -i inventory/staging/hosts PLAYBOOK.yml

     프로덕션 환경에서 플레이북을 실행하려면 다음을 수행합니다.

     구문

     ansible-playbook -i inventory/production/hosts PLAYBOOK.yml

절차

1. etc/ssh/sshd_config 파일을 열고 PermitRootLogin 을 yes 로 설정합니다.

   예제

   [root@admin ~]# echo 'PermitRootLogin yes' >> /etc/ssh/sshd_config.d/01-permitrootlogin.conf

2. SSH 서비스를 다시 시작하십시오.

   예제

   [root@admin ~]# systemctl restart sshd.service

3. root 사용자로 노드에 로그인합니다.

   구문

   ssh root@HOST_NAME

   HOST_NAME 을 Ceph 노드의 호스트 이름으로 바꿉니다.

   예제

   [root@admin ~]# ssh root@host01

   메시지가 표시되면 root 암호를 입력합니다.

절차

1. root 사용자로 노드에 로그인합니다.

   구문

   ssh root@HOST_NAME

   HOST_NAME 을 Ceph 노드의 호스트 이름으로 바꿉니다.

   예제

   [root@admin ~]# ssh root@host01

   메시지가 표시되면 root 암호를 입력합니다.

2. 새 Ansible 사용자를 생성합니다.

   구문

   adduser USER_NAME

   USER_NAME 을 Ansible 사용자의 새 사용자 이름으로 바꿉니다.

   예제

   [root@host01 ~]# adduser ceph-admin

   중요

   ceph 를 사용자 이름으로 사용하지 마십시오. ceph 사용자 이름은 Ceph 데몬용으로 예약되어 있습니다. 클러스터 전체의 균일한 사용자 이름은 쉽게 사용할 수 있지만 일반적으로 무차별 공격에 사용되므로 명확한 사용자 이름을 사용하지 않도록 합니다.

3. 이 사용자의 새 암호를 설정합니다.

   구문

   passwd USER_NAME

   USER_NAME 을 Ansible 사용자의 새 사용자 이름으로 바꿉니다.

   예제

   [root@host01 ~]# passwd ceph-admin

   메시지가 표시되면 새 암호를 두 번 입력합니다.

4. 새로 생성된 사용자에 대해 sudo 액세스를 설정합니다.

   구문

   cat << EOF >/etc/sudoers.d/USER_NAME
   $USER_NAME ALL = (root) NOPASSWD:ALL
   EOF

   USER_NAME 을 Ansible 사용자의 새 사용자 이름으로 바꿉니다.

   예제

   [root@host01 ~]# cat << EOF >/etc/sudoers.d/ceph-admin
   ceph-admin ALL = (root) NOPASSWD:ALL
   EOF

5. 새 파일에 올바른 파일 권한을 할당합니다.

   구문

   chmod 0440 /etc/sudoers.d/USER_NAME

   USER_NAME 을 Ansible 사용자의 새 사용자 이름으로 바꿉니다.

   예제

   [root@host01 ~]# chmod 0440 /etc/sudoers.d/ceph-admin

6. 스토리지 클러스터의 모든 노드에서 위의 단계를 반복합니다.

절차

1. cephadm-ansible 디렉터리로 이동합니다.

2. 새 SSH 키를 생성합니다.

   예제

   [ceph-admin@admin cephadm-ansible]$ ceph cephadm generate-key

3. SSH 키의 공개 부분을 검색합니다.

   예제

   [ceph-admin@admin cephadm-ansible]$ ceph cephadm get-pub-key

4. 현재 저장된 SSH 키를 삭제합니다.

   예제

   [ceph-admin@admin cephadm-ansible]$ceph cephadm clear-key

5. mgr 데몬을 다시 시작하여 구성을 다시 로드합니다.

   예제

   [ceph-admin@admin cephadm-ansible]$ ceph mgr fail

절차

1. SSH 키 쌍을 생성하고 기본 파일 이름을 수락하고 암호를 비워 둡니다.

   [ceph-admin@admin ~]$ ssh-keygen

2. 공개 키를 스토리지 클러스터의 모든 노드에 복사합니다.

   ssh-copy-id USER_NAME@HOST_NAME

   USER_NAME 을 Ansible 사용자의 새 사용자 이름으로 바꿉니다. HOST_NAME 을 Ceph 노드의 호스트 이름으로 바꿉니다.

   예제

   [ceph-admin@admin ~]$ ssh-copy-id ceph-admin@host01

3. 사용자의 SSH config 파일을 생성합니다.

   [ceph-admin@admin ~]$ touch ~/.ssh/config

4. config 파일을 편집하려면 을 엽니다. 스토리지 클러스터의 각 노드에 대한 Hostname 및 User 옵션의 값을 설정합니다.

   Host host01
      Hostname HOST_NAME
      User USER_NAME
   Host host02
      Hostname HOST_NAME
      User USER_NAME
   ...

   HOST_NAME 을 Ceph 노드의 호스트 이름으로 바꿉니다. USER_NAME 을 Ansible 사용자의 새 사용자 이름으로 바꿉니다.

   예제

   Host host01
      Hostname host01
      User ceph-admin
   Host host02
      Hostname host02
      User ceph-admin
   Host host03
      Hostname host03
      User ceph-admin

   중요

   ~/.ssh/config 파일을 구성하면 ansible-playbook 명령을 실행할 때마다 -u USER_NAME 옵션을 지정할 필요가 없습니다.

5. ~/.ssh/config 파일에 대한 올바른 파일 권한을 설정합니다.

   [ceph-admin@admin ~]$ chmod 600 ~/.ssh/config

절차

1. /usr/share/cephadm-ansible 디렉토리로 이동합니다.

2. hosts 파일을 열고 편집하고 노드를 추가합니다.

   예제

   host02
   host03
   host04
   
   [admin]
   host01

3. preflight Playbook을 실행합니다.

   구문

   ansible-playbook -i INVENTORY_FILE cephadm-preflight.yml --extra-vars "ceph_origin=rhcs"

   예제

   [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts cephadm-preflight.yml --extra-vars "ceph_origin=rhcs"

   설치가 완료되면 cephadm 은 /usr/sbin/ 디렉터리에 있습니다.

   • 스토리지 클러스터에서 선택한 호스트 집합에서 preflight 플레이북을 실행하려면 --limit 옵션을 사용합니다.

     구문

     ansible-playbook -i INVENTORY_FILE cephadm-preflight.yml --extra-vars "ceph_origin=rhcs" --limit GROUP_NAME|NODE_NAME

     GROUP_NAME 을 인벤토리 파일의 그룹 이름으로 바꿉니다. NODE_NAME 을 인벤토리 파일의 특정 노드 이름으로 바꿉니다.

     참고

     선택적으로 [mons], [osds] 및 [mgrs] 와 같은 그룹 이름으로 인벤토리 파일의 노드를 그룹화할 수 있습니다. 그러나 관리 노드를 [admin] 그룹에 추가해야 하며 클라이언트가 [clients] 그룹에 추가해야 합니다.

     예제

     [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts cephadm-preflight.yml --extra-vars "ceph_origin=rhcs" --limit clients
     [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts cephadm-preflight.yml --extra-vars "ceph_origin=rhcs" --limit host01

   • preflight 플레이북을 실행하면 cephadm-ansible 이 클라이언트 노드에 chronyd 및 ceph-common 을 자동으로 설치합니다.

     preflight 플레이북은 chronyd 를 설치하지만 단일 NTP 소스를 위해 구성합니다. 여러 소스를 구성하거나 연결이 끊긴 환경이 있는 경우 자세한 내용은 다음 설명서를 참조하십시오.

     • chrony를 어떻게 구성합니까?
     • NTP 모범 사례.
     • 기본 chrony NTP 문제 해결.

절차

1. Ansible 관리 노드에서 /usr/share/cephadm-ansible 디렉토리로 이동합니다.

   예제

   [ansible@admin ~]$ cd /usr/share/cephadm-ansible

2. Ansible 관리 노드에서 SSH 키를 배포합니다. 선택적 cephadm_pubkey_path 매개변수는 ansible 컨트롤러 호스트에 있는 SSH 공개 키 파일의 전체 경로 이름입니다.

   참고

   cephadm_pubkey_path 를 지정하지 않으면 플레이북은 cephadm get-pub-key 명령에서 키를 가져옵니다. 즉, 최소 클러스터를 부트 스트랩했습니다.

   구문

   ansible-playbook -i INVENTORY_HOST_FILE cephadm-distribute-ssh-key.yml -e cephadm_ssh_user=USER_NAME -e cephadm_pubkey_path= home/cephadm/ceph.key -e admin_node=ADMIN_NODE_NAME_1

   예제

   [ansible@admin cephadm-ansible]$ ansible-playbook -i hosts cephadm-distribute-ssh-key.yml -e cephadm_ssh_user=ceph-admin -e cephadm_pubkey_path=/home/cephadm/ceph.key -e admin_node=host01
   
   [ansible@admin cephadm-ansible]$ ansible-playbook -i hosts cephadm-distribute-ssh-key.yml -e cephadm_ssh_user=ceph-admin -e admin_node=host01

1. admin 인증 키가 포함된 노드에서 스토리지 클러스터의 공개 SSH 키를 새 호스트의 root 사용자의 authorized_keys 파일에 설치합니다.

   구문

   ssh-copy-id -f -i /etc/ceph/ceph.pub user@NEWHOST

   예제

   [root@host01 ~]# ssh-copy-id -f -i /etc/ceph/ceph.pub root@host02
   [root@host01 ~]# ssh-copy-id -f -i /etc/ceph/ceph.pub root@host03

2. Ansible 관리 노드의 /usr/share/cephadm-ansible 디렉터리로 이동합니다.

   예제

   [ceph-admin@admin ~]$ cd /usr/share/cephadm-ansible

3. Ansible 관리 노드에서 새 호스트를 Ansible 인벤토리 파일에 추가합니다. 파일의 기본 위치는 /usr/share/cephadm-ansible/hosts 입니다. 다음 예제는 일반적인 인벤토리 파일의 구조를 보여줍니다.

   예제

   [ceph-admin@admin ~]$ cat hosts
   
   host02
   host03
   host04
   
   [admin]
   host01

   참고

   이전에 새 호스트를 Ansible 인벤토리 파일에 추가하고 호스트에서 preflight 플레이북을 실행한 경우 4 단계로 건너뜁니다.

4. Red Hat Enterprise Linux 8의 --limit 옵션을 사용하여 사전 플레이북을 실행합니다.

   구문

   ansible-playbook -i INVENTORY_FILE cephadm-preflight.yml --extra-vars "ceph_origin=rhcs" --limit NEWHOST

   예제

   [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts cephadm-preflight.yml --extra-vars "ceph_origin=rhcs" --limit host02

   preflight Playbook은 새 호스트에 podman,lvm2,chronyd, cephadm 을 설치합니다. 설치가 완료되면 cephadm은 /usr/sbin/ 디렉터리에 있습니다.

   • Red Hat Enterprise Linux 9의 경우 podman,lvm2,chronyd, cephadm 을 수동으로 설치하십시오.

     [root@host01 ~]# dnf install podman lvm2 chronyd cephadm

5. 부트스트랩 노드에서 cephadm orchestrator를 사용하여 스토리지 클러스터에 새 호스트를 추가합니다.

   구문

   ceph orch host add NEWHOST

   예제

   [ceph: root@host01 /]# ceph orch host add host02
   Added host 'host02' with addr '10.10.128.69'
   [ceph: root@host01 /]# ceph orch host add host03
   Added host 'host03' with addr '10.10.128.70'

6. 선택 사항: preflight 플레이북을 실행하기 전과 후에 IP 주소로 노드를 추가할 수도 있습니다. 스토리지 클러스터 환경에 DNS가 구성되지 않은 경우 호스트 이름과 함께 IP 주소로 호스트를 추가할 수 있습니다.

   구문

   ceph orch host add HOSTNAME IP_ADDRESS

   예제

   [ceph: root@host01 /]# ceph orch host add host02 10.10.128.69
   Added host 'host02' with addr '10.10.128.69'

   검증

   • 스토리지 클러스터의 상태를 보고 새 호스트가 추가되었는지 확인합니다. ceph orch host ls 명령의 출력에서 호스트 STATUS가 비어 있습니다.

     예제

     [ceph: root@host01 /]# ceph orch host ls

절차

1. 스토리지 클러스터의 임의의 호스트 5개에 5개의 모니터 데몬을 적용합니다.

   ceph orch apply mon 5

2. 자동 모니터 배포를 비활성화합니다.

   ceph orch apply mon --unmanaged

절차

1. ceph orch host ls 를 사용하여 스토리지 클러스터의 호스트를 확인합니다.

   예제

   [root@host01 ~]# ceph orch host ls
   HOST   ADDR   LABELS  STATUS
   host01        mon,mgr,_admin
   host02        mon
   host03        mon,mgr
   host04
   host05
   host06

2. _admin 레이블을 사용하여 스토리지 클러스터에서 관리 호스트를 지정합니다. 최상의 결과를 얻으려면 이 호스트에 Monitor 및 Manager 데몬이 모두 실행되고 있어야 합니다.

   구문

   ceph orch host label add HOSTNAME _admin

   예제

   [root@host01 ~]#  ceph orch host label add host03 _admin

3. 관리자 호스트에 _admin 레이블이 있는지 확인합니다.

   예제

   [root@host01 ~]#  ceph orch host ls
   HOST   ADDR   LABELS  STATUS
   host01        mon,mgr,_admin
   host02        mon
   host03        mon,mgr,_admin
   host04
   host05
   host06

4. 관리 노드에 로그인하여 스토리지 클러스터를 관리합니다.

절차

1. OSD를 배포하는 데 사용 가능한 장치를 나열합니다.

   구문

   ceph orch device ls [--hostname=HOSTNAME1 HOSTNAME2] [--wide] [--refresh]

   예제

   [ceph: root@host01 /]# ceph orch device ls --wide --refresh

2. 특정 호스트 또는 사용 가능한 모든 장치에 OSD를 배포할 수 있습니다.

   • 특정 호스트의 특정 장치에서 OSD를 생성하려면 다음을 수행합니다.

     구문

     ceph orch daemon add osd HOSTNAME:DEVICE_PATH

     예제

     [ceph: root@host01 /]# ceph orch daemon add osd host02:/dev/sdb

   • 사용 가능한 및 사용되지 않는 장치에 OSD를 배포하려면 --all-available-devices 옵션을 사용합니다.

     예제

     [ceph: root@host01 /]# ceph orch apply osd --all-available-devices

절차

1. Ansible 사용자로 Ansible 관리 노드의 /usr/share/cephadm-ansible 디렉터리로 이동합니다.

   예제

   [ceph-admin@admin ~]$ cd /usr/share/cephadm-ansible

2. hosts 인벤토리 파일을 열고 편집하고 [clients] 그룹 및 클라이언트를 인벤토리에 추가합니다.

   예제

   host02
   host03
   host04
   
   [clients]
   client01
   client02
   client03
   
   [admin]
   host01

3. cephadm-preflight.yml 플레이북을 실행하여 클라이언트에 사전 요구 사항을 설치합니다.

   구문

   ansible-playbook -i INVENTORY_FILE cephadm-preflight.yml --limit CLIENT_GROUP_NAME|CLIENT_NODE_NAME

   예제

   [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts cephadm-preflight.yml --limit clients

4. cephadm-clients.yml 플레이북을 실행하여 인증 키 및 Ceph 구성 파일을 클라이언트 세트에 배포합니다.

   1. 사용자 지정 대상 인증 키 이름을 사용하여 인증 키를 복사하려면 다음을 수행합니다.

      구문

      ansible-playbook -i INVENTORY_FILE cephadm-clients.yml --extra-vars '{"fsid":"FSID","keyring":"KEYRING_PATH","client_group":"CLIENT_GROUP_NAME","conf":"CEPH_CONFIGURATION_PATH","keyring_dest":"KEYRING_DESTINATION_PATH"}'

      • VDD K_FILE 을 Ansible 인벤토리 파일 이름으로 바꿉니다.
      • FSID 를 클러스터의 FSID로 바꿉니다.
      • KEYRING_PATH 를 클라이언트에 복사하려는 관리 호스트의 인증 키의 전체 경로 이름으로 바꿉니다.
      • 선택 사항: CLIENT_GROUP_NAME 을 클라이언트가 설정할 Ansible 그룹 이름으로 교체합니다.
      • 선택 사항: CEPH_CONFIGURATION_PATH 를 관리 노드의 Ceph 구성 파일의 전체 경로로 바꿉니다.

      • 선택 사항: KEYRING_DESTINATION_PATH 를 인증 키가 복사될 대상의 전체 경로 이름으로 바꿉니다.

        참고

        플레이북을 실행할 때 conf 옵션을 사용하여 구성 파일을 지정하지 않으면 플레이북에서 최소 구성 파일을 생성하고 배포합니다. 기본적으로 생성된 파일은 /etc/ceph/ceph.conf 에 있습니다.

        예제

        [ceph-admin@host01 cephadm-ansible]$ ansible-playbook -i hosts cephadm-clients.yml --extra-vars '{"fsid":"266ee7a8-2a05-11eb-b846-5254002d4916","client_group":"clients","keyring":"/etc/ceph/ceph.client.admin.keyring","conf":"/etc/ceph/ceph.conf","keyring_dest":"/etc/ceph/custom.name.ceph.keyring"}'

   2. ceph.keyring 의 기본 대상 키링으로 인증 키를 복사하고 기본 클라이언트 그룹을 사용하여 인증 키를 복사하려면 다음을 수행합니다.

      구문

      ansible-playbook -i INVENTORY_FILE cephadm-clients.yml --extra-vars '{"fsid":"FSID","keyring":"KEYRING_PATH","conf":"CEPH_CONFIGURATION_PATH"}'

      예제

      [ceph-admin@host01 cephadm-ansible]$ ansible-playbook -i hosts cephadm-clients.yml --extra-vars '{"fsid":"266ee7a8-2a05-11eb-b846-5254002d4916","keyring":"/etc/ceph/ceph.client.admin.keyring","conf":"/etc/ceph/ceph.conf"}'

절차

1. 새 데몬 배포를 방지하기 위해 모든 오케스트레이션 작업을 중지하려면 cephadm 을 비활성화합니다.

   예제

   [ceph: root#host01 /]# ceph mgr module disable cephadm

2. 클러스터의 FSID를 가져옵니다.

   예제

   [ceph: root#host01 /]# ceph fsid

3. cephadm 쉘을 종료합니다.

   예제

   [ceph: root@host01 /]# exit

4. 클러스터의 모든 호스트에서 Ceph 데몬을 삭제합니다.

   구문

   cephadm rm-cluster --force --zap-osds  --fsid FSID

   예제

   [root@host01 ~]# cephadm rm-cluster --force --zap-osds  --fsid a6ca415a-cde7-11eb-a41a-002590fc2544

절차

1. Ansible 관리 노드에 로그인합니다.

2. Ansible 관리 노드에서 /usr/share/cephadm-ansible 디렉토리로 이동합니다.

   예제

   [ceph-admin@admin ~]$ cd /usr/share/cephadm-ansible

3. 호스트 파일을 생성하고 호스트, 레이블을 추가하고, 스토리지 클러스터에서 첫 번째 호스트의 IP 주소를 모니터링합니다.

   구문

   sudo vi INVENTORY_FILE
   
   HOST1 labels="['LABEL1', 'LABEL2']"
   HOST2 labels="['LABEL1', 'LABEL2']"
   HOST3 labels="['LABEL1']"
   
   [admin]
   ADMIN_HOST monitor_address=MONITOR_IP_ADDRESS labels="['ADMIN_LABEL', 'LABEL1', 'LABEL2']"

   예제

   [ceph-admin@admin cephadm-ansible]$ sudo vi hosts
   
   host02 labels="['mon', 'mgr']"
   host03 labels="['mon', 'mgr']"
   host04 labels="['osd']"
   host05 labels="['osd']"
   host06 labels="['osd']"
   
   [admin]
   host01 monitor_address=10.10.128.68 labels="['_admin', 'mon', 'mgr']"

4. preflight Playbook을 실행합니다.

   구문

   ansible-playbook -i INVENTORY_FILE cephadm-preflight.yml --extra-vars "ceph_origin=rhcs"

   예제

   [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts cephadm-preflight.yml --extra-vars "ceph_origin=rhcs"

5. 클러스터를 부트스트랩할 플레이북을 생성합니다.

   구문

   sudo vi PLAYBOOK_FILENAME.yml
   
   ---
   - name: NAME_OF_PLAY
     hosts: BOOTSTRAP_HOST
     become: USE_ELEVATED_PRIVILEGES
     gather_facts: GATHER_FACTS_ABOUT_REMOTE_HOSTS
     tasks:
       -name: NAME_OF_TASK
        cephadm_registry_login:
          state: STATE
          registry_url: REGISTRY_URL
          registry_username: REGISTRY_USER_NAME
          registry_password: REGISTRY_PASSWORD
   
       - name: NAME_OF_TASK
         cephadm_bootstrap:
           mon_ip: "{{ monitor_address }}"
           dashboard_user: DASHBOARD_USER
           dashboard_password: DASHBOARD_PASSWORD
           allow_fqdn_hostname: ALLOW_FQDN_HOSTNAME
           cluster_network: NETWORK_CIDR

   예제

   [ceph-admin@admin cephadm-ansible]$ sudo vi bootstrap.yml
   
   ---
   - name: bootstrap the cluster
     hosts: host01
     become: true
     gather_facts: false
     tasks:
       - name: login to registry
         cephadm_registry_login:
           state: login
           registry_url: registry.redhat.io
           registry_username: user1
           registry_password: mypassword1
   
       - name: bootstrap initial cluster
         cephadm_bootstrap:
           mon_ip: "{{ monitor_address }}"
           dashboard_user: mydashboarduser
           dashboard_password: mydashboardpassword
           allow_fqdn_hostname: true
           cluster_network: 10.10.128.0/28

6. 플레이북을 실행합니다.

   구문

   ansible-playbook -i INVENTORY_FILE PLAYBOOK_FILENAME.yml -vvv

   예제

   [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts bootstrap.yml -vvv

절차

1. 다음 절차에 따라 새 호스트를 클러스터에 추가합니다.

   1. Ansible 관리 노드에 로그인합니다.

   2. Ansible 관리 노드에서 /usr/share/cephadm-ansible 디렉토리로 이동합니다.

      예제

      [ceph-admin@admin ~]$ cd /usr/share/cephadm-ansible

   3. 새 호스트 및 레이블을 Ansible 인벤토리 파일에 추가합니다.

      구문

      sudo vi INVENTORY_FILE
      
      NEW_HOST1 labels="['LABEL1', 'LABEL2']"
      NEW_HOST2 labels="['LABEL1', 'LABEL2']"
      NEW_HOST3 labels="['LABEL1']"
      
      [admin]
      ADMIN_HOST monitor_address=MONITOR_IP_ADDRESS labels="['ADMIN_LABEL', 'LABEL1', 'LABEL2']"

      예제

      [ceph-admin@admin cephadm-ansible]$ sudo vi hosts
      
      host02 labels="['mon', 'mgr']"
      host03 labels="['mon', 'mgr']"
      host04 labels="['osd']"
      host05 labels="['osd']"
      host06 labels="['osd']"
      
      [admin]
      host01 monitor_address= 10.10.128.68 labels="['_admin', 'mon', 'mgr']"

      참고

      이전에 새 호스트를 Ansible 인벤토리 파일에 추가하고 호스트에서 preflight 플레이북을 실행한 경우 3 단계로 건너뜁니다.

   4. --limit 옵션을 사용하여 preflight 플레이북을 실행합니다.

      구문

      ansible-playbook -i INVENTORY_FILE cephadm-preflight.yml --extra-vars "ceph_origin=rhcs" --limit NEWHOST

      예제

      [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts cephadm-preflight.yml --extra-vars "ceph_origin=rhcs" --limit host02

      preflight Playbook은 새 호스트에 podman,lvm2,chronyd, cephadm 을 설치합니다. 설치가 완료되면 cephadm은 /usr/sbin/ 디렉터리에 있습니다.

   5. 새 호스트를 클러스터에 추가하는 플레이북을 생성합니다.

      구문

      sudo vi PLAYBOOK_FILENAME.yml
      
      ---
      - name: PLAY_NAME
        hosts: HOSTS_OR_HOST_GROUPS
        become: USE_ELEVATED_PRIVILEGES
        gather_facts: GATHER_FACTS_ABOUT_REMOTE_HOSTS
        tasks:
          - name: NAME_OF_TASK
            ceph_orch_host:
              name: "{{ ansible_facts['hostname'] }}"
              address: "{{ ansible_facts['default_ipv4']['address'] }}"
              labels: "{{ labels }}"
            delegate_to: HOST_TO_DELEGATE_TASK_TO
      
          - name: NAME_OF_TASK
            when: inventory_hostname in groups['admin']
            ansible.builtin.shell:
              cmd: CEPH_COMMAND_TO_RUN
            register: REGISTER_NAME
      
          - name: NAME_OF_TASK
            when: inventory_hostname in groups['admin']
            debug:
              msg: "{{ REGISTER_NAME.stdout }}"

      참고

      기본적으로 Ansible은 플레이북의 hosts 줄과 일치하는 호스트에서 모든 작업을 실행합니다. ceph orch 명령은 관리자 인증 키 및 Ceph 구성 파일이 포함된 호스트에서 실행해야 합니다. delegate_to 키워드를 사용하여 클러스터에서 관리 호스트를 지정합니다.

      예제

      [ceph-admin@admin cephadm-ansible]$ sudo vi add-hosts.yml
      
      ---
      - name: add additional hosts to the cluster
        hosts: all
        become: true
        gather_facts: true
        tasks:
          - name: add hosts to the cluster
            ceph_orch_host:
              name: "{{ ansible_facts['hostname'] }}"
              address: "{{ ansible_facts['default_ipv4']['address'] }}"
              labels: "{{ labels }}"
            delegate_to: host01
      
          - name: list hosts in the cluster
            when: inventory_hostname in groups['admin']
            ansible.builtin.shell:
              cmd: ceph orch host ls
            register: host_list
      
          - name: print current list of hosts
            when: inventory_hostname in groups['admin']
            debug:
              msg: "{{ host_list.stdout }}"

      이 예제에서 플레이북은 새 호스트를 클러스터에 추가하고 현재 호스트 목록을 표시합니다.

   6. 플레이북을 실행하여 클러스터에 추가 호스트를 추가합니다.

      구문

      ansible-playbook -i INVENTORY_FILE PLAYBOOK_FILENAME.yml

      예제

      [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts add-hosts.yml

2. 다음 절차에 따라 클러스터에서 호스트를 제거합니다.

   1. Ansible 관리 노드에 로그인합니다.

   2. Ansible 관리 노드에서 /usr/share/cephadm-ansible 디렉토리로 이동합니다.

      예제

      [ceph-admin@admin ~]$ cd /usr/share/cephadm-ansible

   3. 클러스터에서 호스트 또는 호스트를 제거하는 플레이북을 생성합니다.

      구문

      sudo vi PLAYBOOK_FILENAME.yml
      
      ---
      - name: NAME_OF_PLAY
        hosts: ADMIN_HOST
        become: USE_ELEVATED_PRIVILEGES
        gather_facts: GATHER_FACTS_ABOUT_REMOTE_HOSTS
        tasks:
          - name: NAME_OF_TASK
            ceph_orch_host:
              name: HOST_TO_REMOVE
              state: STATE
      
          - name: NAME_OF_TASK
            ceph_orch_host:
              name: HOST_TO_REMOVE
              state: STATE
            retries: NUMBER_OF_RETRIES
            delay: DELAY
            until: CONTINUE_UNTIL
            register: REGISTER_NAME
      
          - name: NAME_OF_TASK
            ansible.builtin.shell:
              cmd: ceph orch host ls
            register: REGISTER_NAME
      
          - name: NAME_OF_TASK
              debug:
                msg: "{{ REGISTER_NAME.stdout }}"

      예제

      [ceph-admin@admin cephadm-ansible]$ sudo vi remove-hosts.yml
      
      ---
      - name: remove host
        hosts: host01
        become: true
        gather_facts: true
        tasks:
          - name: drain host07
            ceph_orch_host:
              name: host07
              state: drain
      
          - name: remove host from the cluster
            ceph_orch_host:
              name: host07
              state: absent
            retries: 20
            delay: 1
            until: result is succeeded
            register: result
      
           - name: list hosts in the cluster
             ansible.builtin.shell:
               cmd: ceph orch host ls
             register: host_list
      
           - name: print current list of hosts
             debug:
               msg: "{{ host_list.stdout }}"

      이 예제에서 플레이북 작업은 host07 의 모든 데몬을 드레이닝하고, 클러스터에서 호스트를 제거하고 현재 호스트 목록을 표시합니다.

   4. Playbook을 실행하여 클러스터에서 호스트를 제거합니다.

      구문

      ansible-playbook -i INVENTORY_FILE PLAYBOOK_FILENAME.yml

      예제

      [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts remove-hosts.yml

절차

1. Ansible 관리 노드에 로그인합니다.

2. Ansible 관리 노드에서 /usr/share/cephadm-ansible 디렉토리로 이동합니다.

   예제

   [ceph-admin@admin ~]$ cd /usr/share/cephadm-ansible

3. 구성 변경 사항으로 플레이북을 생성합니다.

   구문

   sudo vi PLAYBOOK_FILENAME.yml
   
   ---
   - name: PLAY_NAME
     hosts: ADMIN_HOST
     become: USE_ELEVATED_PRIVILEGES
     gather_facts: GATHER_FACTS_ABOUT_REMOTE_HOSTS
     tasks:
       - name: NAME_OF_TASK
         ceph_config:
           action: GET_OR_SET
           who: DAEMON_TO_SET_CONFIGURATION_TO
           option: CEPH_CONFIGURATION_OPTION
           value: VALUE_OF_PARAMETER_TO_SET
   
       - name: NAME_OF_TASK
         ceph_config:
           action: GET_OR_SET
           who: DAEMON_TO_SET_CONFIGURATION_TO
           option: CEPH_CONFIGURATION_OPTION
         register: REGISTER_NAME
   
       - name: NAME_OF_TASK
         debug:
           msg: "MESSAGE_TO_DISPLAY {{ REGISTER_NAME.stdout }}"

   예제

   [ceph-admin@admin cephadm-ansible]$ sudo vi change_configuration.yml
   
   ---
   - name: set pool delete
     hosts: host01
     become: true
     gather_facts: false
     tasks:
       - name: set the allow pool delete option
         ceph_config:
           action: set
           who: mon
           option: mon_allow_pool_delete
           value: true
   
       - name: get the allow pool delete setting
         ceph_config:
           action: get
           who: mon
           option: mon_allow_pool_delete
         register: verify_mon_allow_pool_delete
   
       - name: print current mon_allow_pool_delete setting
         debug:
           msg: "the value of 'mon_allow_pool_delete' is {{ verify_mon_allow_pool_delete.stdout }}"

   이 예제에서 플레이북은 먼저 mon_allow_pool_delete 옵션을 false 로 설정합니다. 그러면 Playbook이 현재 mon_allow_pool_delete 설정을 가져와서 Ansible 출력에 값을 표시합니다.

4. 플레이북을 실행합니다.

   구문

   ansible-playbook -i INVENTORY_FILE _PLAYBOOK_FILENAME.yml

   예제

   [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts change_configuration.yml

절차

1. Ansible 관리 노드에 로그인합니다.

2. Ansible 관리 노드에서 /usr/share/cephadm-ansible 디렉토리로 이동합니다.

   예제

   [ceph-admin@admin ~]$ cd /usr/share/cephadm-ansible

3. 서비스 사양으로 플레이북을 생성합니다.

   구문

   sudo vi PLAYBOOK_FILENAME.yml
   
   ---
   - name: PLAY_NAME
     hosts: HOSTS_OR_HOST_GROUPS
     become: USE_ELEVATED_PRIVILEGES
     gather_facts: GATHER_FACTS_ABOUT_REMOTE_HOSTS
     tasks:
       - name: NAME_OF_TASK
         ceph_orch_apply:
           spec: |
             service_type: SERVICE_TYPE
             service_id: UNIQUE_NAME_OF_SERVICE
             placement:
               host_pattern: 'HOST_PATTERN_TO_SELECT_HOSTS'
               label: LABEL
             spec:
               SPECIFICATION_OPTIONS:

   예제

   [ceph-admin@admin cephadm-ansible]$ sudo vi deploy_osd_service.yml
   
   ---
   - name: deploy osd service
     hosts: host01
     become: true
     gather_facts: true
     tasks:
       - name: apply osd spec
         ceph_orch_apply:
           spec: |
             service_type: osd
             service_id: osd
             placement:
               host_pattern: '*'
               label: osd
             spec:
               data_devices:
                 all: true

   이 예제에서 플레이북은 osd 레이블이 있는 모든 호스트에 Ceph OSD 서비스를 배포합니다.

4. 플레이북을 실행합니다.

   구문

   ansible-playbook -i INVENTORY_FILE _PLAYBOOK_FILENAME.yml

   예제

   [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts deploy_osd_service.yml

절차

1. Ansible 관리 노드에 로그인합니다.

2. Ansible 관리 노드에서 /usr/share/cephadm-ansible 디렉토리로 이동합니다.

   예제

   [ceph-admin@admin ~]$ cd /usr/share/cephadm-ansible

3. 데몬 상태 변경 사항을 사용하여 플레이북을 생성합니다.

   구문

   sudo vi PLAYBOOK_FILENAME.yml
   
   ---
   - name: PLAY_NAME
     hosts: ADMIN_HOST
     become: USE_ELEVATED_PRIVILEGES
     gather_facts: GATHER_FACTS_ABOUT_REMOTE_HOSTS
     tasks:
       - name: NAME_OF_TASK
         ceph_orch_daemon:
           state: STATE_OF_SERVICE
           daemon_id: DAEMON_ID
           daemon_type: TYPE_OF_SERVICE

   예제

   [ceph-admin@admin cephadm-ansible]$ sudo vi restart_services.yml
   
   ---
   - name: start and stop services
     hosts: host01
     become: true
     gather_facts: false
     tasks:
       - name: start osd.0
         ceph_orch_daemon:
           state: started
           daemon_id: 0
           daemon_type: osd
   
       - name: stop mon.host02
         ceph_orch_daemon:
           state: stopped
           daemon_id: host02
           daemon_type: mon

   이 예제에서 플레이북은 ID가 0 인 OSD를 시작하고, host02 ID가 있는 Ceph Monitor를 중지합니다.

4. 플레이북을 실행합니다.

   구문

   ansible-playbook -i INVENTORY_FILE _PLAYBOOK_FILENAME.yml

   예제

   [ceph-admin@admin cephadm-ansible]$ ansible-playbook -i hosts restart_services.yml