[docs] add database discovery overview

gravitational / teleport

The easiest, and most secure way to access and protect all of your infrastructure.

https://goteleport.com

GNU Affero General Public License v3.0

17.39k stars 1.74k forks source link

[docs] add database discovery overview #43149

Closed GavinFrazar closed 2 months ago

GavinFrazar commented 3 months ago

This PR restructures the database discovery docs to have an overview page and a subsection for the AWS db discovery guide. This is in preparation for follow-up PRs that will add a reference subsection and Azure-specific discovery service guide.

It also extracts some common partials from the kube cluster guides for a brief description of how discovery works at the start of the AWS db discovery guide as well as troubleshooting tips at the end.

For context: prior to this PR, we have a single page for "databases" that is really just an AWS db discovery guide, and does not mention Azure at all. The only reference to azure auto discovery remains in the database access section in the Azure db guides. In a follow up PR, I will add an Azure guide for the discovery service as well.

Stacked on top of another PR, will rebase to master once this merges:

https://github.com/gravitational/teleport/pull/43137

Related to docs work for:

https://github.com/gravitational/teleport/issues/41004

github-actions[bot] commented 3 months ago

🤖 Vercel preview here: https://docs-cococ2hcn-goteleport.vercel.app/docs/ver/preview

ptgott commented 3 months ago

Hi @GavinFrazar, I owe you a review of this PR, but want to wait until the conflicts are resolved—let me know when that's done and I'll give this a look!

GavinFrazar commented 3 months ago

Hi @GavinFrazar, I owe you a review of this PR, but want to wait until the conflicts are resolved—let me know when that's done and I'll give this a look!

thanks for reminding me - I've resolved the conflicts

github-actions[bot] commented 3 months ago

🤖 Vercel preview here: https://docs-k7k04gbcj-goteleport.vercel.app/docs/ver/preview