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: Remove note on ingress gateway hosts field needing a port number #11042

Merged
merged 1 commit into from
Aug 25, 2021

Conversation

blake
Copy link
Member

@blake blake commented Aug 11, 2021

Update the ingress gateway documentation to remove the note stating that a port must be specified for values in the hosts field when the ingress gateway is listening on a non-standard HTTP port.

Specifying a port was required in Consul 1.8.0, but that requirement was removed in 1.8.1 with hashicorp/consul#8190 which made Consul include the port number when constructing the Envoy configuration.

Related Consul docs PR: hashicorp/consul#10827

Update the ingress gateway documentation to remove the note stating
that a port must be specified for values in the `hosts` field when
the ingress gateway is listening on a non-standard HTTP port.

Specifying a port was required in Consul 1.8.0, but that requirement
was removed in 1.8.1 with hashicorp/consul#8190 which made Consul
include the port number when constructing the Envoy configuration.

Related Consul docs PR: hashicorp/consul#10827
@blake blake added the theme/docs Documentation issues and enhancements label Aug 11, 2021
@blake blake self-assigned this Aug 11, 2021
Copy link
Member

@jrasell jrasell left a comment

Choose a reason for hiding this comment

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

Hi @blake and thanks for raising this PR. I wonder whether it's worth keeping the note, albeit modified to detail the version of Consul it relates to? My thought being that someone running Consul 1.8.0 could hit this and find it hard to find the appropriate information.

@blake
Copy link
Member Author

blake commented Aug 19, 2021

I wonder whether it's worth keeping the note, albeit modified to detail the version of Consul it relates to? My thought being that someone running Consul 1.8.0 could hit this and find it hard to find the appropriate information.

I initially opted to just remove the callout to specify a port was only required for the 1.8.0 release. There have been a number of bug and security fixes (to address CVEs) in the more recent 1.8.x releases (the latest stable is 1.8.14) which I assume would be enough to encourage operators to use/upgrade to a newer version that does not have this requirement.

I can modify the PR to keep this callout and add the affected version info if you really feel it's necessary.

Copy link
Member

@jrasell jrasell left a comment

Choose a reason for hiding this comment

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

@blake thanks for the context; I completely got the latest version of Consul available wrong in my head, sorry. This LGTM and thanks!

@jrasell jrasell merged commit ecb6e63 into main Aug 25, 2021
@jrasell jrasell deleted the docs-remove-ingress-host-port-callout branch August 25, 2021 10:30
@github-actions
Copy link

I'm going to lock this pull request because it has been closed for 120 days ⏳. This helps our maintainers find and focus on the active contributions.
If you have found a problem that seems related to this change, please open a new issue and complete the issue template so we can capture all the details necessary to investigate further.

@github-actions github-actions bot locked as resolved and limited conversation to collaborators Nov 16, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
theme/docs Documentation issues and enhancements
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants