Repository files navigation

This repo contains the labs used as part of Servians DevOps Bootcamp. These labs are designed to be run on Servians Hashiqube/DevOps Lab framework. To run through these labs you will require the following dependencies:

• Vagrant
• Docker
• Git
• Hashiqube
• VSCode

There are a number of different labs included in this repo:

• Continous Integration: This folder is used as part of the Continous Integration & automated testing (Linting, Unit Tests & Integration Test) labs. It will generate a deployable artifact at the end of the pipeline.
• Continous Delivery/Deployment: This folder is used as part of the Docker & Continous Deployment/Delivery labs and will deploy a dockerised version of the todo application into minikube which is hosted on Hashiqube. It includes a dockerfile to create a docker image of the application, helm charts to deploy the application
• Terraform: This folder includes the terraform scafolding required to write a set of terraform files that can be used with localstack.
• Ansible: This folder is used to demo Ansible and apply an ansible playbook to a provisioned ubuntu Vagrantbox.

The application that is used for these labs is a simple NodeJS App that is backed by a MongoDB Database. For details of the application itself, please refer to the README inside the Comntinous Integration & Continous Delivery Labs.

To get started we are now going to install some core dependencies on your local machine (or Azure VD) to get the Lab started:

• Vagrant - Please downloadVagrant fromhttps://www.vagrantup.com/downloads.html and install
• Docker - Please downloadDocker fromhttps://www.docker.com/products/docker-desktop and install
• VSCode - Please downloadVSCode fromhttps://code.visualstudio.com/download and install
• Hashiqube - Please Clone the following repo to your local machine -git clone https://source.servian.com/all-staff/hashiqube.git

Hashiqube requires some configuration before it is ready to be used for these labs to set up hashiqube, first run the following commands from the root folder of your cloned hashiqube repo:

vagrant up --provision-with basetools --provider dockervagrant up --provision-with docker --provider dockervagrant up --provision-with localstack --provider dockervagrant up --provision-with minikube --provider dockervagrant up --provision-with prometheus-grafana --provider dockervagrant up --provision-with gitlab --provider docker

Once the above has been installed into Hashiqube, you will need to set up a few services & items into the Hashiqube Vagrantbox.

1. In your browser, navigate tolocalhost:5580 & using the root credentials provided in the output, login to your gitlab environment and create a new admin user.

2. Log back in as your newly created admin user amd set up a new project (Uncheck the "Initialize repository with a README" box)

4. In your new project, navigate to settings, cicd & expand & copy the Registration Token and hold it for later.

5. From your hashiquibe folder, SSH into the Vagrant Box:

vagrant ssh

6. Install nodejs,npm & gitlab-runner

sudo apt-get install nodejs npm gitlab-runner -y

7. add thegitlab-runner user to thedocker &sudo user groups

sudo usermod -aG docker gitlab-runnersudo usermod -aG sudo gitlab-runner

8. Append the followinggitlab-runner ALL=(ALL) NOPASSWD:ALL to the bottom of the sudoers file

sudo nano /etc/sudoers

9. Add the gitlab.localhosts to the hosts file

sudo nano /etc/host

11. Remove the ./bash_logout from thegitlab-runner user

sudo rm /home/gitlab-runner/.bash_logout

10. Set up the Gitlab Runner, by copying the following line into your terminal

sudo gitlab-runner register --non-interactive --url "http://localhost:5580" --registration-token "TOKEN" --executor "shell" --description "shell-runner" --tag-list "hashiqube" --run-untagged="true" --locked="false"

Where TOKEN is the registration token ID you took down from gitlab earlier.

11. Forward the web port for thegitlab-webservice pod.

kubectl port-forward -n default service/gitlab-webservice-default 80:8181 > /dev/null 2>&1 &

You are good to go! Enjoy the bootcamp.

For suggestions, feedback and queries please branch or and submit a Pull Request or directly contact the architects of the HashiQube via email:

Lead Automation Architectriaan.nolan@servian.com

A Very special mention to contributors that gave your time

• Riaan Nolan
• James Bannan

DevOps Fundamentals Bootcamp is available as open-source under the terms of theMIT License.