Automatically configuring a computing environment will be one of the most valuable skills for you to master in your career. You have gained some experience using ansible to automatically run configuration tasks on a virtual machines.
You will start with a starter code base and modify it to fulfill the homework criteria.
Please do the following before you start the homework.
Prepare your GitHub Repo.
Sign into NCSU’s GitHub.
- Create a privaterepo called HW2-DevOps.
- Go to Settings, Collaborators and Teams, and add the TAs and instructor as a collaborator (using their unity id).
Do not create any content, yet
Clone and set-url
Clone this repo:
git clone https://github.com/CSC-DevOps/CM-Template
Create a private HW2-DevOps GitHub repo, change the remote url of the repo you just cloned, and push:
git remote set-url origin https://github.ncsu.edu/<unityid>/HW2-DevOps git push -u origin master
Read the instructions on CM-Template for details about the two commands provided:
In this homework assignment, you will master these skills by completing the following tasks:
Using ansible, be able to automatically configure a server running mattermost.
Perform the following tasks listed in the installation guide for mattermost.
Installing Ubuntu Server 18.04 LTS (This should be mostly done, you already have image! But can still run update/upgrade).
Installing MySQL Database Server (5.7.x is recommended) Installing Mattermost Server
Your goal is to translate those instructions into ansible playbooks and roles.
Demonstrating mattermost server
Finalize configuring the mattermost server by browsing http://192.168.33.80:8065.
Create a team and users.
Demonstrate you can actually use mattermost by posting some messages.
Follow the following constraints when creating your server:
Use best practices (use modules to do work, avoid shell/commands, be idempotent, use your own roles when sensible, manage secrets)
Everything is setup automatically. No manual steps.
Limited use ansible galaxy roles: You are limited to using galaxy roles for setting up mysql. Note you will need to update your ansible server setup script to install galaxy roles on your ansible-srv.
You can also extend your implementation to meet the following extra requirements for more credit:
Automate the creation of teams and other mattermost server configuration using the mattermost CLI (5 points)
Configure the ability to send email notifications (5 points).
Complete the section “Configuring NGINX as a proxy for Mattermost Server” in mattermost instalation instructions (10 points).
Complete the section “Configuring NGINX with SSL and HTTP/2”. Note you can setup a local hosts file for enabling temporary testing of your ssl configuration. (5 points)
Reminder that limited technical assistance will be provided by teaching staff when attempting the extra requirements. Make sure you have completed all the basic requirements before attempting any extra requirements.
Create a screencast of your assignment:
Demonstrate running your code to setup your environment and running your customization and post-configuration steps (cm setup), and running your
mattermost playbook (cm playbook cm/mattermost.yml cm/inventory.ini).
Demonstrate your mattermost server running on your browser. Demonstrate any extra requirements fulfilled. Note some extra requirements supercede the basic requirements.
For guidelines, software, and recommendations see Screencasts.
You can check your progress by running:
opunit verify -i test/inventory.yml
You will want to be able to pass these basic checks:
Basic checks for ansible server
- ansible –version: 2.9.4 >^2.9.x => true reachable check
- [/bakerx] status: true
- [/bakerx/cm/inventory.ini] status: truecontains check
Checking if you have MSDOS style newlines in your bash scripts. Fix
- […run-ansible.sh] does not contain [\r] status: truemessage: NA contains check
- […server-init.sh] does not contain [\r] status: truemessage: NA
Basic checks for dependencies
- mysql –version: bash: mysql: commandnot found > ^5.7.x => false availability check
- [vagrant] http://192.168.33.80:8065/ expected: 200 actual:
ECONNREFUSED reachable check
- [/opt/mattermost/data] status: false
- [/lib/systemd/system/mattermost.service] status: false
- [mattermost] expected: active actual: null contains check
- […config.json] contains [“DriverName”: “mysql”] status: false
message: Error: file doesn’t exist
0.0% of all checks passed.
0 passed · 6 failed
Please submit your repo here
50% Basic requirements.
30% Quality of scripts and following best practices. 20% Screencast and following instructions.
Max possible score: 125/100.