5.9. 다중 사이트 Ceph Object Gateway 명령줄 사용

영역을 생성하려면 realm create 명령을 실행하고 영역 이름을 지정합니다. 영역이 기본값인 경우 --default 를 지정합니다.

radosgw-admin realm create --rgw-realm=REALM_NAME [--default]

[ceph: root@host01 /]# radosgw-admin realm create --rgw-realm=test_realm --default

--default 를 지정하면 --rgw-realm 및 realm 이름이 명시적으로 제공되지 않는 한 각 radosgw-admin 호출을 사용하여 이 영역을 암시적으로 호출합니다.

영역 목록에 있는 하나의 영역은 기본 영역이어야 합니다. 기본 영역은 하나만 있을 수 있습니다. 영역이 하나만 있고 기본 영역을 만들 때 기본 영역으로 지정되지 않은 경우 기본 영역으로 설정합니다. 또는 기본 영역을 변경하려면 다음 명령을 실행합니다.

[ceph: root@host01 /]# radosgw-admin realm default --rgw-realm=test_realm

영역을 삭제하려면 realm delete 명령을 실행하고 영역 이름을 지정합니다.

radosgw-admin realm delete --rgw-realm=REALM_NAME

[ceph: root@host01 /]# radosgw-admin realm delete --rgw-realm=test_realm

영역을 가져오려면 realm get 명령을 실행하고 영역 이름을 지정합니다.

radosgw-admin realm get --rgw-realm=REALM_NAME

[ceph: root@host01 /]# radosgw-admin realm get --rgw-realm=test_realm >filename.json

CLI는 realm 속성을 사용하여 JSON 오브젝트를 에코합니다.

{
    "id": "0a68d52e-a19c-4e8e-b012-a8f831cb3ebc",
    "name": "test_realm",
    "current_period": "b0c5bbef-4337-4edd-8184-5aeab2ec413b",
    "epoch": 1
}

JSON 오브젝트를 파일에 출력하려면 > 및 출력 파일 이름을 사용합니다.

영역을 설정하려면 realm set 명령을 실행하고 입력 파일 이름으로 영역 이름을 지정하고 --infile= 을 지정합니다.

radosgw-admin realm set --rgw-realm=REALM_NAME --infile=IN_FILENAME

[ceph: root@host01 /]# radosgw-admin realm set --rgw-realm=test_realm --infile=filename.json

realms를 나열하려면 realm list 명령을 실행합니다.

[ceph: root@host01 /]# radosgw-admin realm list

영역 기간을 나열하려면 realm list-periods 명령을 실행합니다.

[ceph: root@host01 /]# radosgw-admin realm list-periods

마스터 영역 그룹 및 마스터 영역을 포함하는 노드에서 보조 영역 그룹 또는 영역이 포함된 노드로 영역을 가져오려면 영역 구성을 수신할 노드에서 realm pull 명령을 실행합니다.

radosgw-admin realm pull --url=URL_TO_MASTER_ZONE_GATEWAY--access-key=ACCESS_KEY --secret=SECRET_KEY

하나의 영역은 해당 기간의 일부가 아닙니다. 결과적으로 영역 이름 변경은 로컬에만 적용되며 realm pull 으로 가져오지 않습니다. 영역 이름을 여러 영역으로 변경할 때 각 영역에서 명령을 실행합니다. 영역 이름을 변경하려면 다음 명령을 실행합니다.

radosgw-admin realm rename --rgw-realm=REALM_NAME --realm-new-name=NEW_REALM_NAME

영역 그룹을 생성하는 것은 영역 그룹 이름을 지정하는 것으로 구성됩니다. 영역 생성은 --rgw-realm=realM_NAME 이 지정되지 않은 경우 기본 영역에 있다고 가정합니다. zonegroup이 기본 zonegroup인 경우 --default 플래그를 지정합니다. zonegroup이 마스터 영역 그룹인 경우 --master 플래그를 지정합니다.

radosgw-admin zonegroup create --rgw-zonegroup=ZONE_GROUP_NAME [--rgw-realm=REALM_NAME] [--master] [--default]

zonegroups 목록에 있는 하나의 zonegroup은 기본 zonegroup이어야 합니다. 하나의 기본 영역 그룹만 있을 수 있습니다. zonegroup이 하나만 있고 기본 zonegroup이 생성되면 기본 zonegroup으로 지정되지 않은 경우 기본 zonegroup으로 만듭니다. 또는 기본값인 zonegroup을 변경하려면 다음 명령을 실행합니다.

[ceph: root@host01 /]# radosgw-admin zonegroup default --rgw-zonegroup=us

그런 다음 기간을 업데이트합니다.

[ceph: root@host01 /]# radosgw-admin period update --commit

영역 그룹에 영역을 추가하려면 영역에 있을 호스트에서 이 명령을 실행해야 합니다. 영역 그룹에 영역을 추가하려면 다음 명령을 실행합니다.

radosgw-admin zonegroup add --rgw-zonegroup=ZONE_GROUP_NAME --rgw-zone=ZONE_NAME

그런 다음 기간을 업데이트합니다.

[ceph: root@host01 /]# radosgw-admin period update --commit

영역 그룹에서 영역을 제거하려면 다음 명령을 실행합니다.

radosgw-admin zonegroup remove --rgw-zonegroup=ZONE_GROUP_NAME --rgw-zone=ZONE_NAME

그런 다음 기간을 업데이트합니다.

[ceph: root@host01 /]# radosgw-admin period update --commit

zonegroup의 이름을 변경하려면 다음 명령을 실행합니다.

radosgw-admin zonegroup rename --rgw-zonegroup=ZONE_GROUP_NAME --zonegroup-new-name=NEW_ZONE_GROUP_NAME

그런 다음 기간을 업데이트합니다.

[ceph: root@host01 /]# radosgw-admin period update --commit

zonegroup을 삭제하려면 다음 명령을 실행합니다.

radosgw-admin zonegroup delete --rgw-zonegroup=ZONE_GROUP_NAME

그런 다음 기간을 업데이트합니다.

[ceph: root@host01 /]# radosgw-admin period update --commit

Ceph 클러스터에는 영역 그룹 목록이 포함되어 있습니다. 영역 그룹을 나열하려면 다음 명령을 실행합니다.

[ceph: root@host01 /]# radosgw-admin zonegroup list

radosgw-admin 은 JSON 형식의 영역 그룹 목록을 반환합니다.

{
    "default_info": "90b28698-e7c3-462c-a42d-4aa780d24eda",
    "zonegroups": [
        "us"
    ]
}

영역 그룹의 구성을 보려면 다음 명령을 실행합니다.

radosgw-admin zonegroup get [--rgw-zonegroup=ZONE_GROUP_NAME]

영역 그룹 구성은 다음과 같습니다.

{
    "id": "90b28698-e7c3-462c-a42d-4aa780d24eda",
    "name": "us",
    "api_name": "us",
    "is_master": "true",
    "endpoints": [
        "http:\/\/rgw1:80"
    ],
    "hostnames": [],
    "hostnames_s3website": [],
    "master_zone": "9248cab2-afe7-43d8-a661-a40bf316665e",
    "zones": [
        {
            "id": "9248cab2-afe7-43d8-a661-a40bf316665e",
            "name": "us-east",
            "endpoints": [
                "http:\/\/rgw1"
            ],
            "log_meta": "true",
            "log_data": "true",
            "bucket_index_max_shards": 11,
            "read_only": "false"
        },
        {
            "id": "d1024e59-7d28-49d1-8222-af101965a939",
            "name": "us-west",
            "endpoints": [
                "http:\/\/rgw2:80"
            ],
            "log_meta": "false",
            "log_data": "true",
            "bucket_index_max_shards": 11,
            "read_only": "false"
        }
    ],
    "placement_targets": [
        {
            "name": "default-placement",
            "tags": []
        }
    ],
    "default_placement": "default-placement",
    "realm_id": "ae031368-8715-4e27-9a99-0c9468852cfe"
}

영역 그룹을 정의하는 것은 필요한 설정을 지정하여 JSON 오브젝트를 생성하는 것으로 구성됩니다.

영역 그룹을 설정하려면 필수 필드로 구성된 JSON 오브젝트를 생성하고 오브젝트를 파일에 저장합니다(예: zonegroup.json ). 다음 명령을 실행합니다.

[ceph: root@host01 /]# radosgw-admin zonegroup set --infile zonegroup.json

여기서 zonegroup.json 은 사용자가 생성한 JSON 파일입니다.

마지막으로 기간을 업데이트합니다.

[ceph: root@host01 /]# radosgw-admin period update --commit

영역 그룹 맵을 설정하면 하나 이상의 영역 그룹으로 구성된 JSON 오브젝트를 생성하고 클러스터의 master_zonegroup 을 설정하는 것으로 구성됩니다. 영역 그룹 맵의 각 영역 그룹은 키/값 쌍으로 구성됩니다. 여기서 키 설정은 개별 영역 그룹 구성의 name 설정과 동일하며 val 은 개별 영역 그룹 구성으로 구성된 JSON 오브젝트입니다.

is_master 가 true 인 하나의 영역 그룹만 있을 수 있으며 영역 그룹 맵 끝에 master_zonegroup 으로 지정해야 합니다. 다음 JSON 오브젝트는 기본 영역 그룹 맵의 예입니다.

{
    "zonegroups": [
        {
            "key": "90b28698-e7c3-462c-a42d-4aa780d24eda",
            "val": {
                "id": "90b28698-e7c3-462c-a42d-4aa780d24eda",
                "name": "us",
                "api_name": "us",
                "is_master": "true",
                "endpoints": [
                    "http:\/\/rgw1:80"
                ],
                "hostnames": [],
                "hostnames_s3website": [],
                "master_zone": "9248cab2-afe7-43d8-a661-a40bf316665e",
                "zones": [
                    {
                        "id": "9248cab2-afe7-43d8-a661-a40bf316665e",
                        "name": "us-east",
                        "endpoints": [
                            "http:\/\/rgw1"
                        ],
                        "log_meta": "true",
                        "log_data": "true",
                        "bucket_index_max_shards": 11,
                        "read_only": "false"
                    },
                    {
                        "id": "d1024e59-7d28-49d1-8222-af101965a939",
                        "name": "us-west",
                        "endpoints": [
                            "http:\/\/rgw2:80"
                        ],
                        "log_meta": "false",
                        "log_data": "true",
                        "bucket_index_max_shards": 11,
                        "read_only": "false"
                    }
                ],
                "placement_targets": [
                    {
                        "name": "default-placement",
                        "tags": []
                    }
                ],
                "default_placement": "default-placement",
                "realm_id": "ae031368-8715-4e27-9a99-0c9468852cfe"
            }
        }
    ],
    "master_zonegroup": "90b28698-e7c3-462c-a42d-4aa780d24eda",
    "bucket_quota": {
        "enabled": false,
        "max_size_kb": -1,
        "max_objects": -1
    },
    "user_quota": {
        "enabled": false,
        "max_size_kb": -1,
        "max_objects": -1
    }
}

영역 그룹 맵을 설정하려면 다음 명령을 실행합니다.

[ceph: root@host01 /]# radosgw-admin zonegroup-map set --infile zonegroupmap.json

여기서 zonegroupmap.json 은 생성한 JSON 파일입니다. 영역 그룹 맵에 지정된 영역에 대해 생성된 영역이 있는지 확인합니다. 마지막으로 기간을 업데이트합니다.

[ceph: root@host01 /]#  radosgw-admin period update --commit

영역을 생성하려면 영역 이름을 지정합니다. 마스터 영역인 경우 --master 옵션을 지정합니다. 영역 그룹의 하나의 영역만 마스터 영역일 수 있습니다. 영역 그룹에 영역을 추가하려면 zonegroup 이름으로 --rgw-zonegroup 옵션을 지정합니다.

radosgw-admin zone create --rgw-zone=ZONE_NAME \
                [--zonegroup=ZONE_GROUP_NAME]\
                [--endpoints=ENDPOINT_PORT [,<endpoint:port>] \
                [--master] [--default] \
                --access-key ACCESS_KEY --secret SECRET_KEY

그런 다음 기간을 업데이트합니다.

[ceph: root@host01 /]# radosgw-admin period update --commit

영역을 삭제하려면 먼저 zonegroup에서 제거합니다.

삭제된 영역의 풀이 다른 위치에서 사용되지 않는 경우 풀을 삭제하는 것이 좋습니다. 아래 예제에서 DELETED_ZONE_NAME 을 삭제된 영역의 이름으로 바꿉니다.

ceph osd pool delete DELETED_ZONE_NAME.rgw.control DELETED_ZONE_NAME.rgw.control --yes-i-really-really-mean-it
ceph osd pool delete DELETED_ZONE_NAME.rgw.data.root DELETED_ZONE_NAME.rgw.data.root --yes-i-really-really-mean-it
ceph osd pool delete DELETED_ZONE_NAME.rgw.log DELETED_ZONE_NAME.rgw.log --yes-i-really-really-mean-it
ceph osd pool delete DELETED_ZONE_NAME.rgw.users.uid DELETED_ZONE_NAME.rgw.users.uid --yes-i-really-really-mean-it

영역을 수정하려면 영역 이름과 수정할 매개변수를 지정합니다.

radosgw-admin zone modify [options]

--access-key=<key>
--secret/--secret-key=<key>
--master
--default
--endpoints=<list>

그런 다음 기간을 업데이트합니다.

[ceph: root@host01 /]# radosgw-admin period update --commit

root 로서 클러스터의 영역을 나열하려면 다음 명령을 실행합니다.

[ceph: root@host01 /]# radosgw-admin zone list

root 로서 영역 구성을 가져오려면 다음 명령을 실행합니다.

radosgw-admin zone get [--rgw-zone=ZONE_NAME]

기본 영역은 다음과 같습니다.

{ "domain_root": ".rgw",
  "control_pool": ".rgw.control",
  "gc_pool": ".rgw.gc",
  "log_pool": ".log",
  "intent_log_pool": ".intent-log",
  "usage_log_pool": ".usage",
  "user_keys_pool": ".users",
  "user_email_pool": ".users.email",
  "user_swift_pool": ".users.swift",
  "user_uid_pool": ".users.uid",
  "system_key": { "access_key": "", "secret_key": ""},
  "placement_pools": [
      {  "key": "default-placement",
         "val": { "index_pool": ".rgw.buckets.index",
                  "data_pool": ".rgw.buckets"}
      }
    ]
  }

영역을 구성하려면 일련의 Ceph Object Gateway 풀을 지정해야 합니다. 일관성을 위해 영역 이름과 동일한 풀 접두사를 사용하는 것이 좋습니다. 풀 구성에 대한 자세한 내용은 Red Hat Ceph Storage Storage Strategies Guide 의 풀 장을 참조하십시오.

영역을 설정하려면 풀로 구성된 JSON 오브젝트를 생성하고 오브젝트를 파일에 저장합니다(예: zone.json;) 다음 명령을 실행하여 ZONE_NAME 을 영역 이름으로 교체합니다.

[ceph: root@host01 /]# radosgw-admin zone set --rgw-zone=test-zone --infile zone.json

여기서 zone.json 은 사용자가 생성한 JSON 파일입니다.

그런 다음 root 로 기간을 업데이트합니다.

[ceph: root@host01 /]# radosgw-admin period update --commit

영역 이름을 변경하려면 영역 이름과 새 영역 이름을 지정합니다. 영역 내의 호스트에서 다음 명령을 실행합니다.

radosgw-admin zone rename --rgw-zone=ZONE_NAME --zone-new-name=NEW_ZONE_NAME

그런 다음 기간을 업데이트합니다.

[ceph: root@host01 /]# radosgw-admin period update --commit