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

doc: update Hubble/Hubble Relay guides for recent CLI changes #15981

Merged
merged 4 commits into from May 4, 2021

Conversation

rolinh
Copy link
Member

@rolinh rolinh commented May 3, 2021

This PR updates the troubleshooting with Hubble/Hubble Relay sections as well as the getting started with Hubble guide to recent Hubble CLI changes. Namely, the output of hubble status and hubble observe is now slightly different and the CLI defaults to localhost:4245 a the server address, which allows removing instructions about setting the server address when targeting Hubble Relay.

This PR also includes other minor improvements, see commits for details.

rolinh added 2 commits May 3, 2021 13:45
To ensure a more logical flow, move the section that explains how to
ensure that Hubble is running before the section that explains how to
observe flows with Hubble.

Signed-off-by: Robin Hahling <robin.hahling@gw-computing.net>
The format of the `hubble status` and `hubble observe` subcommands vary
slightly with the new Hubble CLI. Make sure the examples are consistent
with the new version.

While there, the new CLI also defaults to `localhost:4245` as the server
address. Hence, remove notes that hinted to use `--server
localhost:4245` when running Hubble CLI commands.

Signed-off-by: Robin Hahling <robin.hahling@gw-computing.net>
@rolinh rolinh added area/documentation Impacts the documentation, including textual changes, sphinx, or other doc generation code. release-note/misc This PR makes changes that have no direct user impact. sig/hubble Impacts hubble server or relay needs-backport/1.10 labels May 3, 2021
@rolinh rolinh requested a review from gandro May 3, 2021 14:06
@rolinh rolinh requested a review from a team as a code owner May 3, 2021 14:06
@rolinh rolinh requested review from a team and qmonnet May 3, 2021 14:06
@maintainer-s-little-helper maintainer-s-little-helper bot added this to Needs backport from master in 1.10.0-rc2 May 3, 2021
Copy link
Member

@kaworu kaworu left a comment

Choose a reason for hiding this comment

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

Thanks @rolinh!

Documentation/operations/troubleshooting.rst Show resolved Hide resolved
Copy link
Member

@qmonnet qmonnet left a comment

Choose a reason for hiding this comment

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

Looks good overall, one note below.

Documentation/operations/troubleshooting.rst Show resolved Hide resolved
rolinh added 2 commits May 4, 2021 11:57
The format of the `hubble status` and `hubble observe` subcommands vary
slightly with the new Hubble CLI. Make sure the examples are consistent
with the new version.

While there, the new CLI also defaults to `localhost:4245` as the server
address. Hence, remove notes that hinted to use `--server
localhost:4245` when running Hubble CLI commands.

Signed-off-by: Robin Hahling <robin.hahling@gw-computing.net>
There is already a section that explains how to enable Hubble Relay and
install the Hubble CLI so link to it instead.

While there, hint about using `hubble list nodes`.

Signed-off-by: Robin Hahling <robin.hahling@gw-computing.net>
@rolinh rolinh force-pushed the pr/rolinh/doc-hubble-output branch from d4f16cd to 9a560e6 Compare May 4, 2021 09:58
@rolinh
Copy link
Member Author

rolinh commented May 4, 2021

The CI failures are flakes/unrelated (this PR only touches documentation pages). Got required approval, hence marking ready to merge.

@rolinh rolinh added the ready-to-merge This PR has passed all tests and received consensus from code owners to merge. label May 4, 2021
@ti-mo ti-mo merged commit a009608 into master May 4, 2021
@ti-mo ti-mo deleted the pr/rolinh/doc-hubble-output branch May 4, 2021 13:01
@brb brb mentioned this pull request May 7, 2021
@maintainer-s-little-helper maintainer-s-little-helper bot moved this from Needs backport from master to Backport pending to v1.10 in 1.10.0-rc2 May 7, 2021
@maintainer-s-little-helper maintainer-s-little-helper bot moved this from Backport pending to v1.10 to Backport done to v1.10 in 1.10.0-rc2 May 13, 2021
@maintainer-s-little-helper maintainer-s-little-helper bot moved this from Backport pending to v1.10 to Backport done to v1.10 in 1.10.0-rc2 May 13, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/documentation Impacts the documentation, including textual changes, sphinx, or other doc generation code. ready-to-merge This PR has passed all tests and received consensus from code owners to merge. release-note/misc This PR makes changes that have no direct user impact. sig/hubble Impacts hubble server or relay
Projects
No open projects
1.10.0-rc2
Backport done to v1.10
Development

Successfully merging this pull request may close these issues.

None yet

7 participants