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

Update docs for the release of Consul API Gateway v0.5 #15015

Merged
merged 32 commits into from
Nov 17, 2022

Conversation

trujillo-adam
Copy link
Contributor

@trujillo-adam trujillo-adam commented Oct 17, 2022

Description

This PR updates the Consul API Gateway documentation for 0.5. It covers added support for

  • routing traffic to services imported from a peered cluster
  • deploying the API gateway controller and gateways in a secondary federated datacenter
  • specifying Tolerations in the GatewayClassConfig
  • Kubernetes 1.24

It also breaks our single large usage page up into an extendable directory containing multiple use cases, one page for each.

PR Checklist

  • updated test coverage
  • external facing docs updated
  • not a security concern

@trujillo-adam trujillo-adam added type/docs-cherrypick pr/no-changelog PR does not need a corresponding .changelog entry labels Oct 17, 2022
@github-actions github-actions bot added the type/docs Documentation needs to be created/updated/clarified label Oct 17, 2022
ServiceResolver may eventually be created implicitly by the API gateway controller, but that decision is pending.
@nathancoleman nathancoleman changed the title added usage folder to organize use case docs for CAPIgw Update docs for the release of Consul API Gateway v0.5 Oct 26, 2022
Copy link
Contributor

@boruszak boruszak left a comment

Choose a reason for hiding this comment

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

My suggestions are largely a combination of style guide fixes, combined with granular nitpicks.

Let me know if you have any questions or need any further assistance!

Approving on behalf of consul-docs.

website/content/docs/k8s/helm.mdx Outdated Show resolved Hide resolved
website/content/docs/k8s/helm.mdx Outdated Show resolved Hide resolved
website/content/docs/k8s/helm.mdx Outdated Show resolved Hide resolved
website/content/docs/k8s/helm.mdx Outdated Show resolved Hide resolved
website/content/docs/k8s/helm.mdx Outdated Show resolved Hide resolved
trujillo-adam and others added 2 commits November 16, 2022 07:41
Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com>
Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com>
@trujillo-adam trujillo-adam merged commit ab51aac into main Nov 17, 2022
@trujillo-adam trujillo-adam deleted the docs/capigw-v0.5-peered-services-support branch November 17, 2022 23:42
trujillo-adam added a commit that referenced this pull request Nov 18, 2022
* added usage folder to organize use case docs for CAPIgw

* Add peer field to MeshService configuration page

* Add first pass at guide for routing to peered services

* Add exception to same-datacenter restriction for referenced Consul service

* Add example HTTPRoute referencing the MeshService as backendRef

* Add example ServiceResolver

* Add note about current ServiceResolver requirement

ServiceResolver may eventually be created implicitly by the API gateway controller, but that decision is pending.

* tweaks to the usage page for routing to peered services

* tweaks to the  description in the  configuration reference

* resolved TO-DOs from previous iteration

* Remove datacenter federation from limited support matrix

* added tolerations doc

* Remove note excluding k8s 1.24 since we now support it

* Reorder sections to maintain alphabetical sort

* Add example configuration for MeshService resource

* Adjust wording + indentation of other docs

* Use consistent "example-" prefix for resource names in example code

* reframed the tolerations documentation; STILL A WIP

* add helm chart documentation

* removed tolerations from gwcconfig configuration model reference

* Apply suggestions from code review

Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com>

* update version to 0.5.0

* Update install.mdx

* added release notes for v.0.5.x

Co-authored-by: Nathan Coleman <nathan.coleman@hashicorp.com>
Co-authored-by: Sarah Alsmiller <sarah.alsmiller@hashicorp.com>
Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com>
Co-authored-by: sarahalsmiller <100602640+sarahalsmiller@users.noreply.github.com>

manual cherry-pick because backport to stable website failed
trujillo-adam added a commit that referenced this pull request Nov 18, 2022
…to stable-website (#15450)

* no-op commit due to failed cherry-picking

* Update docs for the release of Consul API Gateway v0.5 (#15015)

* added usage folder to organize use case docs for CAPIgw

* Add peer field to MeshService configuration page

* Add first pass at guide for routing to peered services

* Add exception to same-datacenter restriction for referenced Consul service

* Add example HTTPRoute referencing the MeshService as backendRef

* Add example ServiceResolver

* Add note about current ServiceResolver requirement

ServiceResolver may eventually be created implicitly by the API gateway controller, but that decision is pending.

* tweaks to the usage page for routing to peered services

* tweaks to the  description in the  configuration reference

* resolved TO-DOs from previous iteration

* Remove datacenter federation from limited support matrix

* added tolerations doc

* Remove note excluding k8s 1.24 since we now support it

* Reorder sections to maintain alphabetical sort

* Add example configuration for MeshService resource

* Adjust wording + indentation of other docs

* Use consistent "example-" prefix for resource names in example code

* reframed the tolerations documentation; STILL A WIP

* add helm chart documentation

* removed tolerations from gwcconfig configuration model reference

* Apply suggestions from code review

Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com>

* update version to 0.5.0

* Update install.mdx

* added release notes for v.0.5.x

Co-authored-by: Nathan Coleman <nathan.coleman@hashicorp.com>
Co-authored-by: Sarah Alsmiller <sarah.alsmiller@hashicorp.com>
Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com>
Co-authored-by: sarahalsmiller <100602640+sarahalsmiller@users.noreply.github.com>

manual cherry-pick because backport to stable website failed

Co-authored-by: temp <temp@hashicorp.com>
Co-authored-by: trujillo-adam <47586768+trujillo-adam@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
pr/no-changelog PR does not need a corresponding .changelog entry type/docs Documentation needs to be created/updated/clarified
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants