/academy

DevOps content, classes and exercises

Primary LanguageHCLCreative Commons Attribution Share Alike 4.0 InternationalCC-BY-SA-4.0

DevOps Academy

This repository's intention is to help the community in learning the DevOps methodologies and culture throughout a series of classes and hands-on exercises. The content of the classes that will be presented has been designed in a way to prepare you for working as an Automation/Cloud/DevOps Engineer.

These classes start with explaining different concepts at a high level and then goes into some detail. Some of the main topics currently being covered can be seen here.

Feel free to contribute to this repository with content through Pull Requests, help peer reviewing code or just going through the exercises!

If you want to be part of the team behind this, get in touch on help@devopsacademy.com.au.

Table of Content

How it Works

To complete the DevOps Academy, you will have to go through 8 classes with hands-on exercises. For each exercise, you will have to submit your code via pull requests to this repository as per instructions. The last two labs are complete projects based on current industry needs.

You will also be required to peer review at least 5 pull requests from other students to finish this course.

There will be 2 modes of learning the content in these classes:

  1. Self-learning. Where you go through all the classes on your own pace and submit the exercises when you're ready.

  2. Face-to-Face Classes or Virtual Classes. Where the instructors will go through the content of each class and answer any questions or concerns you might have. To sign up for the classes you can email help@devopsacademy.com to get the presentation dates and the availability for the upcoming class.

The first round of classes has been completed and we are starting our second round of classes on the 2nd of June 2020. If you are interested in joining the upcoming classes, email us at help@devopsacademy.com.au or come and chat to us on our Slack channel.

From time to time we also run the live/online classes of the Academy content with a selected group of students. Those classes uses this same repository and have no additional content. The only benefit is to have the opportunity to interact with a group of students as well as with the instructors in a more structured learning process.

Because in this live/online mode the classes occurs every fortnighly, the pace of the exercises completion are based on the course schedule, so students requires a considerable amount of hours available during the week to be able to keep the course pace and complete exercises.

Also, considering the limited number of students that are accepted for each live/online term, we ask people to only apply for those classes if they will be able to commit to have a 100% class attendance and are willing to invest their time in the learning process by doing the exercises and complete th group projects.

Requirements

Please find below the requirements to complete this course:

  • Slack
  • Github Account
  • AWS Account
  • AWS cli
  • Terraform
  • Visual Studio Code
  • Docker

If you need help in any of these topics, a tutorial is available on the pre-class:

Live/Online Applications

If you intend to apply for the Live/Online classes, you'll need to fill the form available here, and as part of your application, you'll need to submit a PR to this repository under the applications folder following the instructions below.

Your application will only be reviewed once you have create a Pull Request with your requirements. It's essential that you have a proper environment setup before being able to undergo the DevOps Academy.

If there is no form available on the link provided, there is no scheduled classes in place. Reach out to any of us through our Slack channel to get more information on next Live/Online classes.

How to Submit a PR as part of your application

  • Make sure you have all the Requirements mentioned above installed on the machine you'll use for the course.
  • Fork this Repository
  • Go into the applications folder and execute the application.sh script. This script will generate an output.txt file with information about the following tools:
    • your computer os version
    • git version
    • docker version
    • aws cli version
    • terraform version
  • Rename the output.txt file to [your_git_account_username].txt
  • Create a PR on this repository from your forked repo including only the file with your GitHub user account name.

If you need instructions on how to fork a repository and how to create a PR from your fork, take a look on this and this tutorials.

Content

  • Version Control (GIT)
    • What is it?
    • Benefits
    • Basic commands
    • How to clone/fork/pr this repository
  • Agile methodology
    • Frameworks
    • Scrum
    • Kanban
  • Infrastructure as Code
    • Concepts
    • Terraform introduction
  • Containers
    • Concepts
    • Docker images
    • Docker Compose
    • 3Musketeers
  • CI/CD
    • What is CI
    • What is CD
    • Pipelines
  • Amazon Web Services (AWS)
    • Cloud concepts
    • Identity and Access Management (IAM) / CloudTrail / CloudWatch
    • VPC / Subnet / Route table / Network ACL / Security Group
    • EC2 / Auto-scaling Group / Load Balancer
    • Simple Storage Service (S3)
    • RDS / DynamoDB
    • Cloudfront / WAF
    • Route53 / Certificate Manager (ACM)
    • Elastic Container Service (ECS) / Elastic Container Registry (ECR)
    • Lambda

The content can be accessed through each specific README link below.

Classes

  • Class 01
    • DevOps Academy Introduction
    • Introduction to AWS
    • Git
  • Class 02
    • Agile Methodologies
    • Networking Introduction
      • AWS VPC
    • AWS IAM (Identity and Access Management)
    • AWS CLI
  • Class 03
    • AWS EC2
      • Load Balancing
      • Auto Scaling Group
    • AWS Route 53
    • Container - Docker
      • Repositories
      • Images
      • Dockerfile
    • Make
    • Docker-Compose
  • Class 04
    • AWS ECS (Elastic Container Service)
    • AWS ECR (Elastic Container Repository)
    • AWS Fargate
    • AWS SSM - Parameter Store
    • IaC - Terraform
    • Project #1 Kick-off
  • Class 05
    • 3 Musketeers
    • AWS S3 (Simple Storage Service)
    • AWS RDS (Relational Database Service)
    • CI/CD Concepts
      • GitHub Actions
    • AWS CloudWatch
    • AWS KMS (Key Management Service)
  • Class 06
    • Project #1 Delivery
    • Serverless introduction
    • AWS API Gateway
    • AWS Lambda
    • AWS DynamoDB
  • Class 07
    • Serverless integration patterns
    • AWS DynamoDB Streams
    • AWS SNS
    • AWS SQS
    • AWS S3 Events
    • AWS CloudWatch Events (EventBridge)
  • Class 08
    • AWS Certifications
    • Next steps
    • Course Closure

Exercises

We highly recommend doing the exercises from this repository. However, you will first need to raise a Pull Request from a fork to add yourself permission to push branches.

i.e: username is caiocezart

members = [
  "aaa",
  "bbb",
  "caiocezart",
  "ccc"
]
  • Save, add and commit the change
  • Raise a Pull Request
  • Send a message on our Slack workspace and one of us will review as soon as possible

As soon as the pull request is approved, the automation will give you Write permission and you will be able to push branches to the repository.

For each class exercise:

  1. Clone this repository
git clone <repo-url>
  1. Switch to master branch and pull it

  2. Create a new branch from master with branch name containing exercise number and your name, e.g <github-username>/<exercise-number>

git checkout -b caiocezart/c01-e01
  1. create a folder with your <github-username> (e.g. denstorti, kikobr82, ...)
cd <repo-name>

mkdir classes/01class/exercises/c01-e01/<my-username>
  1. Add your work on a folder like classes/<class name>/exercises/<exercise-number>/<github-username>/.

Exercise submissions can be textual like a simple .txt file or more complex containing several files and folders.

Example: classes/01class/exercises/c01-e01/caiocezart/<my-files>

  1. Create one or more commits with changes for this exercise
  2. Push it to the remote repo regularly
  3. Only open a Pull Request with the name <github-username>/<exercise-number> when your work is ready to be reviewed
  4. Once you have the approvals, we will merge your code to master branch and complete the exercise. Congrats!
  5. Upon completion of your first exercise, you will be given permission to start/help peer reviewing other community members code!

Example of the submission process

# starting with exercise1
git checkout master
git pull
git checkout -b "my_github_username/exercise1"
# code code code 
# Remember to add files inside the correct folder
# e.g. .../classes/01class/exercises/exercise1/<my_github_username>
git add file1 file2
git commit -m "comment about the changes on this commit"
# ... several commits later
git push origin "my_github_username/exercise1"
# ... several pushes later, when you are ready for a review
# Open a PR via Github website with the name 

# now, doing exercise2
git checkout master
# update your work directory from remote repo
git pull 
git checkout -b "my_github_username/exercise2"
...
...

Available labs

Projects

More info to come..

Projects will be submitted in the respective project submissions folder via PRs.

Example: projects/project01/submissions/caiocezart/<my-files>

Contributors and Instructors

Create a dashboard (CSV file) about exercise submissions

It will use the file labs.txtand students.txtfrom the scripts/dashboard folder. It runs through GitHub Actions, based on the cron definition of the dashboard,yaml and updates the spreadsheet with the latest information.

It can also be executed manually with the following commands:

make dashboard \
  GOOGLE_KEY=[GOOGLE_KEY] \
  SHEET_KEY=[SHEET_KEY] \
  WKS_NAME="Dashboard" \
  GH_USER=[GH_USER] \
  GH_TOKEN=[GH_TOKEN]
VARIABLE DESCRIPTION
GOOGLE_KEY Google Service Account key with permissions to the spreadhseet
SHEET_KEY The Sheet ID
WKS_NAME The Worksheet Name
GH_USER GutHubs user with permission to query the repository
GH_TOKEN The token from the GitHub user above

Presentation format

  • We are using plain README.md files with markdown or GitPitch for slideshow presentations

  • Generate the presentation by running:

    • make presentation
  • Generate a README.md file from the PITCHME.md file:

    • make pitchme_to_readme
  • For GitPitch, use PITCHME.md files and subfolders using query string "p=FOLDERNAME" with the class name

  • GitPitch can run either online (out-of-the-box for Github public repos):

    • Online: access https://gitpitch.com/${ORG_NAME}/${REPO_NAME}/${BRANCH_NAME}?p=${FOLDER_NAME}. Folder must contain a PITCHME.md file.
    • Offline: use a Docker container, run make presentation and open http://localhost:9000/${ORG_NAME}/${REPO_NAME}/${BRANCH_NAME}?p=${FOLDER_NAME} For running in a specific folder: FOLDER_NAME=class2 make presentation

Clean up Ready to Review tag from Closed PRs

To clean up the Read to Review tags of the closed PRs, the below make target can be executed.

Run: make rtr-cleanup

Optionally you can pass the Github User and Token, so the API calls are not throttled.

Run: make rtr-cleanup GH_USER=<YOUR_USER> GH_TOKEN=<YOUR_TOKEN>

Authors

Caio Trevisan

Denis Storti

Francisco Collet

Sponsors

ITBR Australia Community

www.itbr.com.au

Contino

https://www.contino.io