메시지 큐 전환
이 가이드에서는 기존 Milvus 배포 환경의 메시지 큐(MQ)를 Woodpecker와 다른 메시지 큐 간에 가동 중지 시간 없이 온라인 상태로 전환하는 방법을 설명합니다.
이 기능은 출시 예정이며 변경될 수 있습니다. 기능을 사용해 보시거나 궁금한 점이 있으시면 Milvus 지원팀에 문의해 주십시오.
필수 조건
- MQ 전환 기능은 Milvus 3.0 이상 버전에서 사용할 수 있습니다. 이 기능을 사용하기 전에 Milvus 인스턴스를 Milvus 3.0 이상으로 업그레이드하십시오. 이전 버전에서는 이 기능을 사용할 수 없습니다.
- 인스턴스가 정상적으로 실행 중이어야 합니다.
범위
이 가이드에서는 Woodpecker와 다른 메시지 큐 간의 전환에 대해서만 다룹니다. Pulsar와 Kafka 간의 직접적인 전환은 이 가이드의 범위에 포함되지 않습니다.
- RocksMQ와 Woodpecker 간 전환 — Milvus Standalone (Docker Compose)
- Pulsar와 Woodpecker 간 전환 — Milvus 클러스터 (Helm / Milvus Operator)
- Kafka와 Woodpecker 간 전환 — Milvus 클러스터 (Helm / Milvus Operator)
일반적인 워크플로우
- Milvus 인스턴스가 정상적으로 실행 중인지 확인하십시오.
- 소스 MQ 유형과 대상 MQ 유형을 확인합니다.
mqType값을 변경하지 않고 대상 MQ의 액세스 설정을 Milvus 구성에 반영합니다.- MixCoord에서 WAL alter API를 호출하여 전환을 트리거합니다.
- 로그를 모니터링하여 전환이 완료되었는지 확인합니다.
전환하기 전에, 대상 MQ에 현재 Milvus 인스턴스에서 사용 중인 것과 동일한 이름의 토픽이 포함되어 있지 않은지 확인하십시오. 대상 MQ가 다른 Milvus 인스턴스에서 사용된 적이 있는 경우, 토픽 이름 충돌로 인해 예기치 않은 동작이 발생할 수 있으므로 이 점은 특히 중요합니다.
지원 매트릭스
| 소스 MQ | 대상 MQ | 배포 | 상태 |
|---|---|---|---|
| RocksMQ | Woodpecker (로컬/MinIO) | 독립형 (Docker Compose) | 지원됨 |
| Woodpecker (로컬/MinIO) | RocksMQ | 독립형 (Docker Compose) | 지원됨 |
| Pulsar (내장/외부) | Woodpecker (MinIO) | 클러스터 (Helm / Operator) | 지원됨 |
| Woodpecker (MinIO) | 펄사 (외부) | 클러스터 (Helm / Operator) | 지원됨 |
| Kafka (내장/외부) | Woodpecker (MinIO) | 클러스터 (Helm / Operator) | 지원됨 |
| Woodpecker (MinIO) | 카프카 (외부) | 클러스터 (Helm / Operator) | 지원됨 |
| Woodpecker MinIO | Woodpecker 로컬 (또는 그 반대) | 어느 것이든 | 지원되지 않음 |
MQ 유형을 반복적으로 전환하지 마십시오. 전환이 필요한 경우, 전환 전마다 관련 데이터를 반드시 정리하십시오. 잔여 데이터로 인해 예기치 않은 동작이 발생할 수 있습니다.
