RedHatTraining/rht-labs-docs.git

			@@ -4,9 +4,9 @@
			![automation-xkcd](https://imgs.xkcd.com/comics/automation.png)

			## Exercise Intro
			In this exercise we will use automation tooling to create Project namespaces for our `CI/CD` tooling along with the `dev` and `test` namespaces for our deployments to live. We do this to manually using the OpenShift CLI; but as we go from cluster to cluster or project to project Dev and Ops teams often find themselves having to redo these tasks again and again. Configuring our cluster using code; we can easily store this in Git and repeat the process again and again. By minimising the time taken to do these repetitive tasks we can accelerate our ability to deliver value to our customers; working on the hard problems they face.
			In this exercise we will use automation tooling to create Project namespaces for our `CI/CD` tooling along with the `dev` and `test` namespaces for our deployments to live. We do this manually using the OpenShift CLI; but as we go from cluster to cluster or project to project Dev and Ops teams often find themselves having to redo these tasks again and again. Configuring our cluster using code; we can easily store this in Git and repeat the process again and again. By minimising the time taken to do these repetitive tasks we can accelerate our ability to deliver value to our customers; working on the hard problems they face.

			This exercise uses Ansible to drive the creation of the cluster content. In particular; we'll use a play book called the `OpenShift Applier`. Once the project namespace have been created; we will add some tools to support CI/CD such as Jenkins, Git and Nexus. These tools will be needed by later lessons to automate the build and deploy of our apps. Again; we will use OpenShift Templates and drive their creation in the cluster using Ansible. To prove things are working, finally we'll delete all our content and re-apply the inventory to re-create our clusters content.
			This exercise uses Ansible to drive the creation of the cluster content. In particular; we'll use a play book called the `OpenShift Applier`. Once the project namespace have been created; we will add some tools to support CI/CD such as Jenkins, Git and Nexus. These tools will be needed by later lessons to automate the build and deploy of our apps. Again; we will use OpenShift Templates and drive their creation in the cluster using Ansible. To prove things are working, finally we'll delete all our content and re-apply the inventory to re-create our cluster's content.

			#### Why is config-as-code important?
			* Assurance - Prevents unwanted config changes from people making arbitrary changes to environments. No more Snowflake servers!
			@@ -30,11 +30,10 @@
			* [Ansible](https://www.ansible.com/) - IT Automation tool used to provision and manage state of cloud and physical infrastructure.
			* [OpenShift Applier](https://github.com/redhat-cop/openshift-applier) - used to apply OpenShift objects to an OpenShift Cluster.


			## Big Picture
			> The Big Picture is our emerging architecture; starting with an empty cluster we populate it with projects and some ci/cd tooling.

			![ds-messing-around.gif](../images/exercise1/ds-messing-around.gif)
			![big-picture](../images/big-picture/big-picture-1.jpg)

			_____

			@@ -43,20 +42,20 @@

			If you're feeling confident and don't want to follow the step-by-step guide these high-level instructions should provide a challenge for you:

			2. Clone the repo `https://github.com/rht-labs/enablement-ci-cd` which contains the scaffold of the project. Ensure you get all remote branches.
			1. Clone the repo `https://github.com/rht-labs/enablement-ci-cd` which contains the scaffold of the project. Ensure you get all remote branches.

			2. Create `<your-name>-ci-cd`, `<your-name>-dev` and `<your-name>-test` project namespaces using the inventory and run them with the OpenShift Applier to populate the cluster

			2. Use the templates provided to create build of the jenkins-s2i. The templates are in `exercise1/jenkins-s2i`
			3. Use the templates provided to create build of the jenkins-s2i. The templates are in `exercise1/jenkins-s2i`

			2. Use the templates provided to create build and deployment configs in `<your-name>-ci-cd` for. Templates are on a branch called `exercise1/git-nexus` && `exercise1/jenkins`:
			4. Use the templates provided to create build and deployment configs in `<your-name>-ci-cd` for. Templates are on a branch called `exercise1/git-nexus` && `exercise1/jenkins`:
			* Nexus
			* GitLab
			* Jenkins (using an s2i to pre-configure Jenkins)

			2. Commit your `enablement-ci-cd` repository to the GitLab Instance you've created
			5. Commit your `enablement-ci-cd` repository to the GitLab Instance you've created

			2. Burn it all down and re-apply your inventory proving config-as-code works.
			6. Burn it all down and re-apply your inventory proving config-as-code works.

			## Step by Step Instructions
			> This is a structured guide with references to exact filenames and explanations.
			@@ -80,7 +79,7 @@
			./git-pull-all.sh
			```

			3. Open the `innovation-labs` folder in VSCode (or your favourite editor). The project is laid out as follows
			3. Open the `enablement-ci-cd` folder in VSCode (or your favourite editor). The project is laid out as follows
			```
			.
			├── README.md
			@@ -171,7 +170,7 @@
			```
			where the `-e target=bootstrap` is passing an additional variable specifying that we run the `bootstrap` inventory

			3. Once successful you should see an output similar to this (Cow's not included): ![playbook-success](../images/exercise1/play-book-success.png)
			3. Once successful you should see an output similar to this (Cows not included): ![playbook-success](../images/exercise1/play-book-success.png)

			3. You can check to see the projects have been created successfully by running
			```bash
			@@ -294,10 +293,10 @@
			4. Once logged in create a new project called `enablement-ci-cd` and mark it as internal. Once created; copy out the `git url` for use on the next step.
			![gitlab-new-project](../images/exercise1/gitlab-new-project.png)
			<p class="tip">
			Note - we would not normally make the project under your name but create an group and add the project there on residency but for simplicity of the exercise we'll do that here
			Note - we would not normally make the project under your name but create a group and add the project there on residency but for simplicity of the exercise we'll do that here
			</p>

			4. If you have not used Git before; you may need to tell Git who you are and what your email is before we commit. Run the following commands, substitution your email and "Your Name". If you've done this before move on to the next step.
			4. If you have not used Git before; you may need to tell Git who you are and what your email is before we commit. Run the following commands, substituting your email and "Your Name". If you've done this before move on to the next step.
			```bash
			git config --global user.email "yourname@mail.com"
			```
			@@ -444,7 +443,7 @@
			SOURCE_REPOSITORY_PASSWORD=<YOUR_LDAP_PASSWORD>
			```
			where
			* `<GIT_URL>` is the full path clone path of the repo where this project is stored (including the https && .git)
			* `<GIT_URL>` is the full clone path of the repo where this project is stored (including the https && .git)
			* `<YOUR_NAME>` is the prefix for your `-ci-cd` project.
			* Explore some of the other parameters in `templates/jenkins-s2i.yml`
			* `<YOUR_LDAP_USERNAME>` is the username builder pod will use to login and clone the repo with