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

Initial pass at some vtadmin docs #8526

Merged
merged 2 commits into from
Jul 24, 2021
Merged

Conversation

ajm188
Copy link
Contributor

@ajm188 ajm188 commented Jul 23, 2021

Signed-off-by: Andrew Mason [email protected]

Description

This is all I had time to put together before a vacation, and something is better than nothing!

Related Issue(s)

Checklist

  • Tests were added or are not required
  • Documentation was added or is not required

Deployment Notes

@ajm188 ajm188 requested a review from doeg July 23, 2021 20:41
@ajm188 ajm188 requested a review from rohit-nayak-ps as a code owner July 23, 2021 20:41
Copy link
Contributor

@doeg doeg left a comment

Choose a reason for hiding this comment

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

This looks so great!!! Thank you so much for writing all this down. I'll do a documentation pass soon, too, especially to consolidate some of the front-end docs.

At some point (per our conversation with @deepthi) we could consider moving these to https://vitess.io, which might make them more generally discoverable (at the expense of colocating it with the code, I guess).

Thank you again!

# to the regex:
# ^discovery-(?P<impl>\w+)-(?P<flag>.+)$
# The full set of options for each discovery implementation is defined in that
# implementations factory function, e.g. NewConsul in
Copy link
Contributor

Choose a reason for hiding this comment

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

typo: "implementations" -> "implementation's"

# go/vt/vtadmin/cluster/discovery/discovery_consul.go and NewStaticFile in
# discovery_static_file.go in the same directory.

# Service name to use when discovery vtctlds from consul.
Copy link
Contributor

Choose a reason for hiding this comment

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

"when discovering vtctlds" maybe?

VTAdmin is in alpha, you may use it if you wish, but should not treat it as stable.
It does not meet the standard Vitess backwards compatibility guarantees, and is subject to change at any time.
VTAdmin is an experimental replacement for the vtctld2 web UI, that also allows
users to manage multiple Vitess clusters from a single API and web UI.
Copy link
Contributor

Choose a reason for hiding this comment

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

Could probably link to our original RFC for breadcrumbs/historical interest, if ya like: #7117

@ajm188 ajm188 merged commit fb27dc7 into vitessio:main Jul 24, 2021
@ajm188 ajm188 deleted the am_vtadmin_docs branch July 24, 2021 14:57
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.

3 participants