Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[DOCS] Clarify remote/info and resolve/cluster descriptions #3655

Merged
merged 10 commits into from
Jan 30, 2025

Conversation

quux00
Copy link
Contributor

@quux00 quux00 commented Jan 29, 2025

Relates to elastic/elasticsearch#118993

This PR updates the remote info and resolve cluster specifications to (1) copy some missing descriptions from the docs (https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-remote-info.html and https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-resolve-cluster-api.html) and (2) incorporate the changes from elastic/elasticsearch#118993

Co-authored by @lcawl

Copy link
Contributor

Following you can find the validation results for the APIs you have changed.

API Status Request Response
cluster.remote_info 🟢 3/3 3/3
indices.resolve_cluster 🔴 10/12 12/12

You can validate these APIs yourself by using the make validate target.

* as long as the networking layer is configured to wait for remote clusters that are
* not responding (typically 30 seconds).
*/
timeout?: Duration // default: unset
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lcawl - should I put "unset" here or just remove the // default comment altogether.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The documentation doesn't reflect any comments like that, so it doesn't serve a purpose as far as I know.
For properties that have default values, @server_default xxx works for docs.

Copy link
Contributor

Following you can find the validation results for the APIs you have changed.

API Status Request Response
cluster.remote_info 🟢 3/3 3/3
indices.resolve_cluster 🔴 10/12 12/12

You can validate these APIs yourself by using the make validate target.

@quux00
Copy link
Contributor Author

quux00 commented Jan 29, 2025

You can validate these APIs yourself by using the make validate target.

It would be really nice if this bot would:

  1. show the validation error message
  2. show you what make validate command to run

Figuring out how to run make validate locally appears to be non-trivial, so that would really help.

Copy link
Contributor

Following you can find the validation results for the APIs you have changed.

API Status Request Response
cluster.remote_info 🟢 3/3 3/3
indices.resolve_cluster 🔴 10/12 12/12

You can validate these APIs yourself by using the make validate target.

Copy link
Contributor

@lcawl lcawl left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added some suggestions but otherwise docs LGTM

* as long as the networking layer is configured to wait for remote clusters that are
* not responding (typically 30 seconds).
*/
timeout?: Duration // default: unset
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The documentation doesn't reflect any comments like that, so it doesn't serve a purpose as far as I know.
For properties that have default values, @server_default xxx works for docs.

@quux00 quux00 requested a review from a team as a code owner January 30, 2025 15:26
Copy link
Contributor

Following you can find the validation results for the APIs you have changed.

API Status Request Response
cluster.remote_info 🟢 3/3 3/3
indices.resolve_cluster 🔴 10/12 12/12

You can validate these APIs yourself by using the make validate target.

@quux00 quux00 force-pushed the remote-info-resolve-cluster branch from 58ac301 to 5012324 Compare January 30, 2025 16:03
Copy link
Contributor

Following you can find the validation results for the APIs you have changed.

API Status Request Response
cluster.remote_info 🟢 3/3 3/3
indices.resolve_cluster 🔴 10/12 12/12

You can validate these APIs yourself by using the make validate target.

Copy link
Contributor

Following you can find the validation results for the APIs you have changed.

API Status Request Response
cluster.remote_info 🟢 3/3 3/3
indices.resolve_cluster 🔴 10/12 12/12

You can validate these APIs yourself by using the make validate target.

@quux00 quux00 merged commit 5b17efd into main Jan 30, 2025
8 checks passed
@quux00 quux00 deleted the remote-info-resolve-cluster branch January 30, 2025 17:16
Copy link
Contributor

The backport to 8.x failed:

The process '/usr/bin/git' failed with exit code 1

To backport manually, run these commands in your terminal:

# Fetch latest updates from GitHub
git fetch
# Create a new working tree
git worktree add .worktrees/backport-8.x 8.x
# Navigate to the new working tree
cd .worktrees/backport-8.x
# Create a new branch
git switch --create backport-3655-to-8.x
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick -x --mainline 1 5b17efd2251c5ff382401402288b9a10694cd64f
# Push it to GitHub
git push --set-upstream origin backport-3655-to-8.x
# Go back to the original working tree
cd ../..
# Delete the working tree
git worktree remove .worktrees/backport-8.x

Then, create a pull request where the base branch is 8.x and the compare/head branch is backport-3655-to-8.x.

@lcawl
Copy link
Contributor

lcawl commented Jan 30, 2025

💚 All backports created successfully

Status Branch Result
8.x

Questions ?

Please refer to the Backport tool documentation

lcawl added a commit that referenced this pull request Jan 30, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants