Gabeaws/jenkins readme updates

[gabebatista]

Issue number:

Summary

Version one of Jenkins module documentation

Changes

Added Jenkins module documentation.
Sections added:

• Description
• Architecture Diagram
• Prerequisites
  • Creating Route 53 Hosted Zones
  • Creating Public Certificate
  • Upload secrets to AWS Secrets Manager
  • Generate Jenkins Agent AMI
• Installation instructions
• Deploy instructions
• Accessing Jenkins
• Configuring Jenkins
  • Retrieving admin password
  • First-time configurations
  • Installing EC2 Fleet Plugin

User experience

The changes help to improve the users experience by walking them through the setup and configuration of the Jenkins module.

Checklist

If your change doesn't seem to apply, please leave them unchecked.

• I have performed a self-review of this change
• Changes have been tested
• Changes are documented

Is this a breaking change?

No

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created might not be successful.

[henrykie]

Couple minor things. Main concern is that a lot of the details around setup probably belong in sample documentation, not module documentation.

[henrykie]

Minor things, but it looks good.

[kylesomers]

see feedback on jenkins password handling. let's hold off on merging this until that fix is completed.

[kylesomers]

Modify this to write to Secrets Manager, not log output. Cut a PR to fix that in the module

[gabebatista]

I believe that password only works for the first time configuration then gets replaced with the user you create in the setup process. To change this behavior we would need to edit the jenkins docker image we use to setup the service, meaning we would need to distribute our own image to be used. @henrykie please correct me if I'm wrong about this.

[henrykie]

Also @kylesomers we do not have the capacity to update the way that Jenkins writes to logs. This module uses the default image available on Dockerhub without any extensions or adjustments to the entrypoint. For initial release we aren't modifying this, so we cannot adjust the way that Jenkins is initially configured.

[henrykie]

@gabebatista Hey dude - trying to get the commit history on this branch cleaned up. The rebase got messed up. Your PR shouldn't include all these file changes we made to Jenkins pipelines, etc.

[henrykie]

Still pretty messy, but definitely cleaned up a good amount.

Addressed changes. Merging.