wehub-resource-sync
a9cd7750f4
CI / unit-test (push) Has been cancelled
CI / detect-changes (push) Has been cancelled
CI / build (push) Has been cancelled
Publish docs via GitHub Pages / Deploy docs (push) Has been cancelled
CI / test-harness (push) Has been cancelled
CI / generate-e2e-matrix (push) Has been cancelled
CI / e2e (push) Has been cancelled
CI / build-ui (push) Has been cancelled
Release Drafter / update_release_draft (push) Has been cancelled
UI v2 Integration CI / E2E (Integration) (push) Has been cancelled
UI v2 CI / Lint, Format & Test (push) Has been cancelled
UI v2 CI / E2E (Mocked) (push) Has been cancelled
59 lines
1.8 KiB
Markdown
59 lines
1.8 KiB
Markdown
# OpenSearch Persistence - DEPRECATED
|
|
|
|
⚠️ **This module is deprecated and provides only a migration error message.**
|
|
|
|
## What Happened?
|
|
|
|
The generic `conductor.indexing.type=opensearch` configuration has been replaced with version-specific modules:
|
|
|
|
- **`os-persistence-v2`** - For OpenSearch 2.x
|
|
- **`os-persistence-v3`** - For OpenSearch 3.x
|
|
|
|
This change enables proper dependency isolation between OpenSearch 2.x and 3.x clients, which use incompatible package namespaces.
|
|
|
|
## Migration
|
|
|
|
Change your configuration from:
|
|
|
|
```properties
|
|
conductor.indexing.type=opensearch
|
|
conductor.opensearch.url=http://localhost:9200
|
|
```
|
|
|
|
To one of:
|
|
|
|
```properties
|
|
# For OpenSearch 2.x
|
|
conductor.indexing.type=opensearch2
|
|
conductor.opensearch.url=http://localhost:9200
|
|
```
|
|
|
|
```properties
|
|
# For OpenSearch 3.x
|
|
conductor.indexing.type=opensearch3
|
|
conductor.opensearch.url=http://localhost:9200
|
|
```
|
|
|
|
All other `conductor.opensearch.*` properties remain the same.
|
|
|
|
## Why the Change?
|
|
|
|
- OpenSearch 2.x and 3.x clients use identical package names (`org.opensearch.client.*`)
|
|
- Having both on the classpath causes conflicts
|
|
- Version-specific modules use shadow plugin to relocate packages and avoid conflicts
|
|
- Follows the same pattern as `es6-persistence` and `es7-persistence`
|
|
|
|
## Legacy Code Reference
|
|
|
|
If you need the original OpenSearch 1.x persistence module code for reference, it has been archived at:
|
|
|
|
https://github.com/conductor-oss/conductor-os-persistence-v1
|
|
|
|
**Note:** The archived module is no longer maintained and should not be used in production.
|
|
|
|
## See Also
|
|
|
|
- Issue #678: https://github.com/conductor-oss/conductor/issues/678
|
|
- Legacy OpenSearch 1.x Module: https://github.com/conductor-oss/conductor-os-persistence-v1
|
|
- Legacy Elasticsearch 6.x Module: https://github.com/conductor-oss/conductor-es6-persistence
|