Skip to content

Conversation

@wntmddus
Copy link
Contributor

@wntmddus wntmddus commented Nov 5, 2025

Description

Enhanced the documentation for the convert_index_to_remote ISM action with comprehensive details and examples:

  • Expanded description: Clarifies that this action converts indexes to searchable snapshots by restoring from a remote repository, with automatic deletion of the original index to complete the conversion process
  • Additional parameters: Documents three optional parameters:
    • include_aliases: Control whether to restore index aliases along with the index
    • ignore_index_settings: Specify settings to ignore during restore for customized configuration
    • number_of_replicas: Set replica count during conversion to prevent cluster yellow state
  • Prerequisites section: Lists requirements before using the action (remote repository setup, snapshot existence, repository name matching)
  • Usage notes: Provides essential operational guidance on automatic deletion, repository matching, variable references, and replica considerations
  • Three comprehensive examples:
    • Basic example with minimum required parameters
    • Advanced configuration example demonstrating all optional parameters
    • Complete policy example showing a full workflow for archiving indexes older than 30 days to searchable snapshots

The resolved documentation provides more explicit guidance for users implementing searchable snapshots with ISM policies.

Issues Resolved

Closes opensearch-project/index-management#1487, opensearch-project/index-management#808 (comment)

Version

All versions with ISM searchable snapshot support.

Frontend features

N/A - Documentation only change.

Checklist

  • [v] By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license and subject to the Developers Certificate of Origin.

Seung Yeon Joo and others added 2 commits November 5, 2025 12:30
- Add detailed description of searchable snapshot conversion process
- Document three optional parameters: include_aliases, ignore_index_settings, number_of_replicas
- Add Prerequisites and Usage notes sections
- Include three examples: basic, advanced configuration, and complete policy
- Provide guidance on automatic deletion, repository matching, and replica considerations

Signed-off-by: Seung Yeon Joo <[email protected]>
…entation

Enhance convert_index_to_remote documentation with comprehensive details
@github-actions
Copy link

github-actions bot commented Nov 5, 2025

Thank you for submitting your PR. The PR states are In progress (or Draft) -> Tech review -> Doc review -> Editorial review -> Merged.

Before you submit your PR for doc review, make sure the content is technically accurate. If you need help finding a tech reviewer, tag a maintainer.

When you're ready for doc review, tag the assignee of this PR. The doc reviewer may push edits to the PR directly or leave comments and editorial suggestions for you to address (let us know in a comment if you have a preference). The doc reviewer will arrange for an editorial review.

@kolchfa-aws
Copy link
Collaborator

@vikasvb90 Could you review this PR?

@kolchfa-aws kolchfa-aws added Tech review PR: Tech review in progress backport 3.3 labels Nov 6, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport 3.3 Tech review PR: Tech review in progress

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[FEATURE] Setting number of replicas in "convert_index_to_remote" or "snapshot" action directly

2 participants