Add Enforce Overview and Architecture overview to Getting started docs

[amdawson]

Feedback from empathy day:

"I think in general we should have an enforce overview and architecture overview, and a little better explanation of what each part of the onboarding steps do"

My thoughts are a section that explains the basic features of enforce: allows you to implement and enforce security policies on your kubernetes fleet, monitor the status of policies in real time, easily update and distribute policies across clusters, require image signatures, SBOMs, and secure registries, etc.

and also a quick overview of the components:

• enforce platform: a SaaS solution that does blah blah
• enforce agent: lightweight agent that runs on your K8s cluster nodes to distribute policies, continuously monitor the security of clusters, and report information to the enforce platform
• chainctl: a command line utility that lets you manage users, groups, define policies, authenticate to chainguard, and check status of clusters at the command line

[amdawson]

here is a good example from my last company: https://docs.vmware.com/en/VMware-Tanzu-Application-Platform/1.2/tap/GUID-overview.html

[ltagliaferri]

@amdawson — regarding the diagrams, we had these diagrams that we shared with customers directly, are there any modifications you would like on these for this public document?

https://drive.google.com/drive/u/0/folders/10ZcMXQcjl9YVyE4JeSaFumPsLv1kza9h

[amdawson]

I think we should update them - we need to show both agent and agentless mode as well as the Signing service, and of course the style in these is outdated.

I can help create the diagrams but will also need to consult with the eng folks

[ltagliaferri]

Here are a few other (messy) drafts I had (with webhook, & more abstract agent), there were some questions around how much to make public, and I still have the original files to bring into the new style, so let me know how I can help move this forward, I know this is top of mind for @jedsalazar

[ltagliaferri]

Can we use slide 27 from the new slide deck for the diagram?

[amdawson]

Yes was gonna say that

On Fri, Dec 2, 2022, 5:50 PM ltagliaferri @.***> wrote:

Can we use slide 27 from the new slide deck https://docs.google.com/presentation/d/1Awz8Mdi1PwWMpwv79j_XMP5COruuViQPoDSrusD-iLM/edit#slide=id.g1a6f596fd82_0_143 for the diagram?

— Reply to this email directly, view it on GitHub https://github.com/chainguard-dev/edu/issues/99#issuecomment-1335937365, or unsubscribe https://github.com/notifications/unsubscribe-auth/ACANUWIJSPUARJODHWBBR33WLJ4LLANCNFSM6AAAAAAQNM6ACA . You are receiving this because you were mentioned.Message ID: @.***>