Docker and Git Workshop

One Day workshop on understanding Docker and Git

Prerequisite

Machine/VM with Linux, Python3 (3.x) and pip3 installed.

Linux Machine with following packages installed

1. Install Ubuntu 24.04 LTS from here
2. Install Git from your terminal by running following commands:

   sudo apt-get update
   sudo apt-get install git

3. Verify the installation was successful by typing:

   git --version

GitHub Account

1. If you don't have an account on GitHub then create an account on GitHub

2. Configure SSH key by following the below steps:

   • Generating a new SSH key
   • Adding your SSH key to the ssh-agent

   To list all contents of ssh folder:

   ls -al ~/.ssh

   To install xclip:

   sudo apt install xclip

   Copy SSH key:

   xclip -sel clip < ~/.ssh/id_ed25519.pub

   • Adding a new SSH key to your GitHub account

3. Create a new work directory named WORKSHOP inside the /home directory:

   mkdir -p ~/WORKSHOP

4. Fork the current repository

5. Clone your forked repository inside the WORKSHOP directory

Info: You can refer this guide to understand how to fork and clone

Docker Installation

1. To install Docker, follow the steps below:

   • Set up the repository
   • Install Docker Engine

2. Configure Docker to run without sudo:

   • Manage Docker as a non-root user

3. Install Docker Compose plugin (comes with Docker Desktop or as a plugin):

   Verify if already installed:

   docker compose version

   If not installed, install the plugin:

   sudo apt-get update
   sudo apt-get install docker-compose-plugin

   You should see output similar to:

   Docker Compose version v2.30.3
   

4. Download the following Docker images to your local machine:

   docker pull postgres:16-alpine

   Verify the image:

   docker run --rm -ti postgres:16-alpine psql -V

   Output: psql (PostgreSQL) 16.x

VS Code Setup

• Install VS Code
• Install Docker extension on your VS Code

Docker

By the end of this workshop you will understand:

• The concept of containerization and why it's required
• How to build and run your own containers
• How to run multiple services with Docker Compose
• How to expose ports, use volume mounts, utilize networks, and limit resources (the 4 features we use regularly)

Git

• You will be introduced to Git
• You will learn Git commands (push, pull, make Pull requests, etc.)

Schedule

Time	Topics
09:00 - 09:30	Introduction
09:30 - 10:00	Introduction to Git
10:00 - 11:00	Git Commands (push, pull, make Pull requests, etc.)
11:00 - 11:30	What is Docker
11:30 - 12:00	Docker Commands
12:00 - 01:30	Break
01:30 - 4:00	Building Custom Containers & Run Multiple Services with Docker Compose
4:00 - 5:00	Expose Ports, Volume Mounts, Utilizing Networks, Limiting Resources
5:15 - 5:30	Wrapping Up