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

[OpenAPI] Add list of tags in overlay #2905

Merged
merged 13 commits into from
Oct 3, 2024
Merged

[OpenAPI] Add list of tags in overlay #2905

merged 13 commits into from
Oct 3, 2024

Conversation

lcawl
Copy link
Contributor

@lcawl lcawl commented Sep 18, 2024

Relates to #2310

As a follow-on to #2961, this PR adds @doc_tag values where we want to override the default tags. There are a few remaining (e.g. health_report, mget, mtermvectors) that we can't override yet because the typescript files for those APIs don't exist yet.

This PR also adds the missing document-level list of tags via an overlay. Doing this in an overlay is not perfect since it means that new tags must be manually added. Any endpoints associated with tags that do not appear in this list will not be published on Bump.sh. I've therefore also changed the operation-tag-defined linting rule to an error instead of a warning.

I've also changed the make commands to only lint the OpenAPI documents that have overlays applied, since the others will contain errors that are fixed by the overlays.

NOTE: Even though the list of tags used differs in the two OpenAPI documents (e.g. some endpoints do not exist in the serverless context), it seems okay to use a single tag list since I've tested in Bump.sh and any tags for which there aren't any endpoints are simply omitted.

@lcawl lcawl added the OpenAPI label Sep 18, 2024
@lcawl lcawl marked this pull request as ready for review September 18, 2024 00:27
@lcawl lcawl requested a review from esdocs September 26, 2024 15:24
@lcawl lcawl changed the title Add list of serverless tags in overlay [OpenAPI] Add list of tags in overlay Sep 26, 2024
Copy link
Contributor

@shainaraskas shainaraskas left a comment

Choose a reason for hiding this comment

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

Couple of comments on funny things, otherwise LGTM

also noting for posterity that trying to preview this with make overlay-docs didn't work for me locally and might need some love to get runnable

Copy link
Contributor

github-actions bot commented Oct 3, 2024

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

API Status Request Response
async_search.delete 🟢 4/4 4/4
async_search.get 🟢 6/6 6/6
async_search.status 🟢 3/3 3/3
async_search.submit 🟢 7/7 7/7
bulk 🟢 433/433 451/451
clear_scroll 🟢 17/17 17/17
close_point_in_time 🟢 7/7 7/7
cluster.health 🟢 154/154 154/154
count 🟢 34/34 34/34
create 🟢 24/24 23/23
delete_by_query 🟢 5/5 4/4
delete_script 🟢 8/8 8/8
delete 🟢 37/37 37/37
exists_source 🟢 3/3 3/3
exists 🟢 19/19 19/19
explain 🟢 15/15 15/15
field_caps 🟢 63/63 63/63
get_script 🟢 12/12 12/12
get_source 🟢 18/18 18/18
get 🟢 307/307 304/304
index 🟢 1143/1143 1145/1145
indices.data_streams_stats 🟢 4/4 4/4
indices.get_data_lifecycle Missing test Missing test
indices.get_data_stream 🟢 11/11 11/11
indices.migrate_to_data_stream Missing test Missing test
indices.modify_data_stream Missing test Missing test
knn_search 🟢 4/4 4/4
msearch_template 🟢 1/1 1/1
nodes.clear_repositories_metering_archive Missing test Missing test
nodes.get_repositories_metering_info Missing test Missing test
nodes.hot_threads 🟢 5/5 5/5
nodes.info 🔴 114/114 1/114
nodes.reload_secure_settings 🟢 2/2 2/2
nodes.stats 🔴 51/51 13/51
nodes.usage 🟢 1/1 1/1
open_point_in_time 🟢 7/7 7/7
ping 🟢 1/1 1/1
put_script 🟢 41/41 41/41
rank_eval Missing test Missing test
reindex_rethrottle 🟢 2/2 2/2
reindex 🟢 15/15 14/14
render_search_template 🟢 1/1 1/1
scripts_painless_execute 🟢 4/4 4/4
search_application.delete_behavioral_analytics 🟢 3/3 3/3
search_application.get_behavioral_analytics 🔴 2/5 5/5
search_application.put_behavioral_analytics 🟢 3/3 3/3
search_mvt 34/34 Missing test
search_shards 🟢 7/7 7/7
search_template 🟢 2/2 1/1
termvectors 🟢 8/8 8/8
update_by_query 🟢 5/5 4/4
update 🟢 35/35 35/35

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

Copy link
Contributor

github-actions bot commented Oct 3, 2024

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

API Status Request Response
async_search.delete 🟢 4/4 4/4
async_search.get 🟢 6/6 6/6
async_search.status 🟢 3/3 3/3
async_search.submit 🟢 7/7 7/7
bulk 🟢 433/433 451/451
clear_scroll 🟢 17/17 17/17
close_point_in_time 🟢 7/7 7/7
cluster.delete_component_template 🟢 2/2 2/2
cluster.exists_component_template Missing test Missing test
cluster.get_component_template 🔴 10/10 8/10
cluster.health 🟢 154/154 154/154
cluster.put_component_template 🔴 21/29 29/29
count 🟢 34/34 34/34
create 🟢 24/24 23/23
delete_by_query 🟢 5/5 4/4
delete_script 🟢 8/8 8/8
delete 🟢 37/37 37/37
exists_source 🟢 3/3 3/3
exists 🟢 19/19 19/19
explain 🟢 15/15 15/15
field_caps 🟢 63/63 63/63
get_script 🟢 12/12 12/12
get_source 🟢 18/18 18/18
get 🟢 307/307 304/304
index 🟢 1143/1143 1145/1145
indices.data_streams_stats 🟢 4/4 4/4
indices.get_data_lifecycle Missing test Missing test
indices.get_data_stream 🟢 11/11 11/11
indices.migrate_to_data_stream Missing test Missing test
indices.modify_data_stream Missing test Missing test
knn_search 🟢 4/4 4/4
msearch_template 🟢 1/1 1/1
nodes.clear_repositories_metering_archive Missing test Missing test
nodes.get_repositories_metering_info Missing test Missing test
nodes.hot_threads 🟢 5/5 5/5
nodes.info 🔴 114/114 1/114
nodes.reload_secure_settings 🟢 2/2 2/2
nodes.stats 🔴 51/51 13/51
nodes.usage 🟢 1/1 1/1
open_point_in_time 🟢 7/7 7/7
ping 🟢 1/1 1/1
put_script 🟢 41/41 41/41
rank_eval Missing test Missing test
reindex_rethrottle 🟢 2/2 2/2
reindex 🟢 15/15 14/14
render_search_template 🟢 1/1 1/1
scripts_painless_execute 🟢 4/4 4/4
search_application.delete_behavioral_analytics 🟢 3/3 3/3
search_application.get_behavioral_analytics 🔴 2/5 5/5
search_application.put_behavioral_analytics 🟢 3/3 3/3
search_mvt 34/34 Missing test
search_shards 🟢 7/7 7/7
search_template 🟢 2/2 1/1
termvectors 🟢 8/8 8/8
update_by_query 🟢 5/5 4/4
update 🟢 35/35 35/35

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

Copy link
Contributor

github-actions bot commented Oct 3, 2024

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

API Status Request Response
async_search.delete 🟢 4/4 4/4
async_search.get 🟢 6/6 6/6
async_search.status 🟢 3/3 3/3
async_search.submit 🟢 7/7 7/7
bulk 🟢 433/433 451/451
clear_scroll 🟢 17/17 17/17
close_point_in_time 🟢 7/7 7/7
cluster.delete_component_template 🟢 2/2 2/2
cluster.exists_component_template Missing test Missing test
cluster.get_component_template 🔴 10/10 8/10
cluster.health 🟢 154/154 154/154
cluster.put_component_template 🔴 21/29 29/29
count 🟢 34/34 34/34
create 🟢 24/24 23/23
delete_by_query 🟢 5/5 4/4
delete_script 🟢 8/8 8/8
delete 🟢 37/37 37/37
exists_source 🟢 3/3 3/3
exists 🟢 19/19 19/19
explain 🟢 15/15 15/15
field_caps 🟢 63/63 63/63
get_script 🟢 12/12 12/12
get_source 🟢 18/18 18/18
get 🟢 307/307 304/304
index 🟢 1143/1143 1145/1145
indices.data_streams_stats 🟢 4/4 4/4
indices.get_data_lifecycle Missing test Missing test
indices.get_data_stream 🟢 11/11 11/11
indices.migrate_to_data_stream Missing test Missing test
indices.modify_data_stream Missing test Missing test
knn_search 🟢 4/4 4/4
msearch_template 🟢 1/1 1/1
nodes.clear_repositories_metering_archive Missing test Missing test
nodes.get_repositories_metering_info Missing test Missing test
nodes.hot_threads 🟢 5/5 5/5
nodes.info 🔴 114/114 1/114
nodes.reload_secure_settings 🟢 2/2 2/2
nodes.stats 🔴 51/51 13/51
nodes.usage 🟢 1/1 1/1
open_point_in_time 🟢 7/7 7/7
ping 🟢 1/1 1/1
put_script 🟢 41/41 41/41
rank_eval Missing test Missing test
reindex_rethrottle 🟢 2/2 2/2
reindex 🟢 15/15 14/14
render_search_template 🟢 1/1 1/1
scripts_painless_execute 🟢 4/4 4/4
search_application.delete_behavioral_analytics 🟢 3/3 3/3
search_application.get_behavioral_analytics 🔴 2/5 5/5
search_application.put_behavioral_analytics 🟢 3/3 3/3
search_mvt 34/34 Missing test
search_shards 🟢 7/7 7/7
search_template 🟢 2/2 1/1
termvectors 🟢 8/8 8/8
update_by_query 🟢 5/5 4/4
update 🟢 35/35 35/35

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

@lcawl lcawl merged commit 4a0eaef into main Oct 3, 2024
7 checks passed
@lcawl lcawl deleted the global-tags branch October 3, 2024 23:50
Copy link
Contributor

github-actions bot commented Oct 3, 2024

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-2905-to-8.x
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick -x --mainline 1 4a0eaef2ce8604220d5e089a69a0c2744a00077d
# Push it to GitHub
git push --set-upstream origin backport-2905-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-2905-to-8.x.

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