6.101. GlusterBricks
이 서비스는 gluster 볼륨에서 gluster 브릭을 관리합니다.
이름 | 요약 |
---|---|
| brick 제거 작업의 brick 게시 데이터 마이그레이션을 활성화합니다. |
| gluster 볼륨에 brick 목록을 추가합니다. |
| gluster 볼륨의 brick을 나열합니다. |
| brick을 제거하기 전에 데이터 마이그레이션을 시작합니다. |
| gluster 볼륨에서 brick을 제거합니다. |
| remove brick 작업의 brick에서 데이터 마이그레이션을 중지합니다. |
6.101.1. POST활성화
brick 제거 작업의 brick 게시 데이터 마이그레이션을 활성화합니다.
brick에서 데이터 마이그레이션이 완료되면 brick을 활성화하는 데 사용되지만 사용자는 더 이상 brick을 제거하지 않습니다. 이전에 제거용으로 표시된 brick이 이제 일반 brick으로 사용됩니다.
예를 들어 데이터가 마이그레이션된 glustervolume 123
의 brick을 유지하려면 다음과 같은 요청을 보냅니다.
POST /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks/activate
다음과 같이 요청 본문이 있는 경우:
<action> <bricks> <brick> <name>host1:/rhgs/brick1</name> </brick> </bricks> </action>
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 활성화를 비동기적으로 수행해야 하는지 여부를 나타냅니다. | |
| in | 다시 활성화해야 하는 brick 목록입니다. |
6.101.2. POST추가
gluster 볼륨에 brick 목록을 추가합니다.
brick을 추가하여 gluster 볼륨을 확장하는 데 사용됩니다. 복제 볼륨 유형의 경우 replica_count
매개 변수를 전달해야 합니다. 복제본 수가 증가하면 복제본 세트 수와 동일한 brick 수가 있어야 합니다.
예를 들어 gluster 볼륨 123
에 brick을 추가하려면 다음과 같은 요청을 보냅니다.
POST /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks
다음과 같이 요청 본문이 있는 경우:
<bricks> <brick> <server_id>111</server_id> <brick_dir>/export/data/brick3</brick_dir> </brick> </bricks>
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in/Out | 볼륨에 추가할 brick 목록 | |
| in | 볼륨 사후 추가 작업의 복제본 수입니다. | |
| in | 볼륨 후 추가 작업의 스트라이프 수입니다. |
6.101.3. GET나열
gluster 볼륨의 brick을 나열합니다.
예를 들어 gluster 볼륨 123
의 brick을 나열하려면 다음과 같은 요청을 보냅니다.
GET /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks
다음과 같이 출력을 제공합니다.
<bricks> <brick id="234"> <name>host1:/rhgs/data/brick1</name> <brick_dir>/rhgs/data/brick1</brick_dir> <server_id>111</server_id> <status>up</status> </brick> <brick id="233"> <name>host2:/rhgs/data/brick1</name> <brick_dir>/rhgs/data/brick1</brick_dir> <server_id>222</server_id> <status>up</status> </brick> </bricks>
반환된 목록의 순서는 gluster 볼륨 생성 시 제공된 brick 순서를 기반으로 합니다.
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| Out | ||
| in | 따라야 할 내부 링크를 나타냅니다. | |
| in | 반환할 최대 brick 수를 설정합니다. |
6.101.3.1. 팔로우
따라야 할 내부 링크를 나타냅니다. 이러한 링크에서 참조하는 오브젝트는 현재 요청의 일부로 가져옵니다. 자세한 내용은 여기를 참조하십시오.
6.101.3.2. max
반환할 최대 brick 수를 설정합니다. 지정하지 않으면 모든 brick이 반환됩니다.
6.101.4. migrate POST
brick을 제거하기 전에 데이터 마이그레이션을 시작합니다.
brick 제거는 제거할 brick의 데이터가 먼저 나머지 brick으로 마이그레이션되는 2단계 프로세스입니다. 마이그레이션이 완료되면 API 제거를 통해 brick 제거를 확인합니다. 언제든지 작업을 취소하려면 중지 마이그레이션 을 호출해야 합니다.
예를 들어 ID 123
이 있는 gluster 볼륨에서 brick을 삭제하려면 요청을 보냅니다.
POST /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks/migrate
다음과 같이 요청 본문이 있는 경우:
<action> <bricks> <brick> <name>host1:/rhgs/brick1</name> </brick> </bricks> </action>
마이그레이션 프로세스는 작업 및 단계를 사용하여 API에서 반환된 작업 ID에서 추적할 수 있습니다. ???
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 마이그레이션을 비동기적으로 수행해야 하는지 여부를 나타냅니다. | |
| in | 데이터 마이그레이션을 시작해야 하는 brick 목록입니다. |
6.101.5. DELETE제거
gluster 볼륨에서 brick을 제거합니다.
데이터 손실 없이 brick을 제거하는 권장 방법은 stopmigrate 를 사용하여 데이터를 먼저 마이그레이션한 다음 제거하는 것입니다. 제거하기 전에 브래킷에서 마이그레이션을 호출하지 않으면 데이터 마이그레이션 없이 brick이 제거되고 이로 인해 데이터가 손실될 수 있습니다.
예를 들어 gluster 볼륨 123
에서 브릭을 삭제하려면 다음과 같은 요청을 보냅니다.
DELETE /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks
다음과 같이 요청 본문이 있는 경우:
<bricks> <brick> <name>host:brick_directory</name> </brick> </bricks>
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 제거가 비동기적으로 수행되어야 하는지 여부를 나타냅니다. | |
| in | 제거할 brick 목록입니다. | |
| in | 볼륨 사후 추가 작업의 복제본 수입니다. |
6.101.6. 마이그레이션 POST중지
remove brick 작업의 brick에서 데이터 마이그레이션을 중지합니다.
사용자가 brick을 계속 사용하려는 경우 2단계 제거 brick 프로세스의 일부로 시작된 데이터 마이그레이션을 취소하려면 다음을 수행합니다. 제거용으로 표시된 brick은 이 작업을 게시한 후 일반 brick으로 작동합니다.
예를 들어 gluster 볼륨 123
의 brick에서 데이터 마이그레이션을 중지하려면 다음과 같은 요청을 보냅니다.
POST /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks/stopmigrate
다음과 같이 요청 본문이 있는 경우:
<bricks> <brick> <name>host:brick_directory</name> </brick> </bricks>
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 비동기적으로 작업을 수행해야 하는지 여부를 나타냅니다.Indicates whether the action should be performed asynchronously. | |
| in | 데이터 마이그레이션을 중지해야 하는 brick 목록입니다. |
6.101.6.1. brick
데이터 마이그레이션을 중지해야 하는 brick 목록입니다. 이 목록은 마이그레이션 하려면 전달된 인수와 일치해야 합니다.