Backport of Update docs for the release of Consul API Gateway v0.5 into release/1.13.x

[hc-github-team-consul-core]

Backport

This PR is auto-generated from #15015 to be assessed for backporting due to the inclusion of the label backport/1.13.

WARNING automatic cherry-pick of commits failed. Commits will require human attention.

merge conflict error: POST https://api.github.com/repos/hashicorp/consul/merges: 409 Merge conflict []

The below text is copied from the body of the original PR.

---

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

---

Overview of commits

• 68ee017 - f23b366 - deaba3e - d1f1ff5 - e41ec34 - 72a3bf2 - 41dfa89 - 9d4c77a - 0d8bad1 - 0078296 - a2a2d60 - 5728d69 - caea307 - 1934711 - ad068ae - 86cffa3 - b3585ec - 382ac14 - 17eaeec - 85b5d6b - da86d9d - b13f743 - 018e1dd - 6166022 - 6e567b1 - c2e8b84 - 4fff96e - c9a41f4 - a95ec13 - a7d6946 - 417a942 - 47e2b4d

[hashicorp-cla]

Thank you for your submission! We require that all contributors sign our Contributor License Agreement ("CLA") before we can accept the contribution. Read and sign the agreement

Learn more about why HashiCorp requires a CLA and what the CLA includes

---

2 out of 3 committers have signed the CLA.

• boruszak
• trujillo-adam
• temp

---

temp seems not to be a GitHub user.
You need a GitHub account to be able to sign the CLA. If you already have a GitHub account, please add the email address used for this commit to your account.

_{Have you signed the CLA already but the status is still pending? Recheck it.}