Create documentation aimed at "gatekeeper admins"

[tsandall]

We need to explain how people can manage Gatekeeper installations. Some things that come to mind:

• How do you install and upgrade Gatekeeper (gotchas?)
• How do you secure Gatekeeper itself?
• RBAC configuration required to replicate K8s objects into OPA
• How do you monitor Gatekeeper performance?
• Debug FAQ for common problems (webhook misconfigured, network issues, logs, etc.)
• How are webhook certificates provisioned (this is handled by kube-builder but that's an implementation detail from the admin's POV so we should cover it.)

[marccampbell]

@tsandall I'd love to work on this, if nobody else has started or expressed an interest here.

[tsandall]

@marccampbell that would be great. I was originally planning to work on some the "docs" issues myself but happy to collaborate. I was going to wait until there was something to run before starting to work these.

[tsandall]

We should explicitly document that Gatekeeper will not self-manage per #94.

[snuggie12]

I wanted to +1 this specifically wanting to know about how I should diagnose potential performance problems and provide scale numbers as well (i.e. how many X should I expect to run on Y resources/setup).

[brownpanthera]

can I contribute this doc

[maxsmythe]

Happy to have contributions!

I don't think we have any heavy process around docs, just creating/submitting a PR.

@sozercan Do you have any thoughts about a good process here? Do we want to scope the contents we're looking for?

[stale[bot]]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed in 14 days if no further activity occurs. Thank you for your contributions.

[stale[bot]]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed in 14 days if no further activity occurs. Thank you for your contributions.