Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/artioml/hello-world

:school_satchel: Containers Training: Hands-on introduction to Docker and CI/CD
https://github.com/artioml/hello-world

crasher docker dockerfile express hello-world heroku node-js travis-ci

Last synced: 9 days ago
JSON representation

:school_satchel: Containers Training: Hands-on introduction to Docker and CI/CD

Host: GitHub
URL: https://github.com/artioml/hello-world
Owner: ArtiomL
License: mit
Created: 2017-12-10T22:36:57.000Z (about 7 years ago)
Default Branch: develop
Last Pushed: 2019-10-08T21:54:14.000Z (over 5 years ago)
Last Synced: 2023-10-20T10:39:41.207Z (over 1 year ago)
Topics: crasher, docker, dockerfile, express, hello-world, heroku, node-js, travis-ci
Language: Shell
Homepage: https://dhwt.herokuapp.com
Size: 128 KB
Stars: 4
Watchers: 2
Forks: 24
Open Issues: 8
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        #   hello, world

[![Build Status](https://travis-ci.org/ArtiomL/hello-world.svg?branch=master)](https://travis-ci.org/ArtiomL/hello-world)

[![Docker Hub](https://img.shields.io/docker/pulls/artioml/hello-world.svg)](https://hub.docker.com/r/artioml/hello-world/)

  

## Table of Contents

- [Description](#description)

- [Documentation](#documentation)

- [Prerequisites](#prerequisites)

- [Lab](#lab)

	- [monolith](#monolith)

	- [usermod](#usermod)

	- [build](#build)

	- [pull](#pull)

	- [run](#run)

	- [logs](#logs)

	- [exec](#exec)

	- [diff](#diff)

	- [commit](#commit)

	- [push](#push)

	- [rm](#rm)

	- [top](#top)

	- [stats](#stats)

	- [kill](#kill)

	- [--publish-all](#-p---publish-all)

- [Next](#next)

- [License](LICENSE)

  

## Description

Containers Training: Hands-on introduction to Docker and CI/CD.

  

## Documentation

Start [here](https://github.com/veggiemonk/awesome-docker) and [there](https://github.com/wsargent/docker-cheat-sheet).

Awesome images for [security](https://github.com/carpedm20/awesome-hacking#docker-images-for-penetration-testing--security) and [Ansible](https://github.com/ArtiomL/f5-ansible).

  

## Prerequisites

 - A 64-bit Debian / Ubuntu VM with Internet access (tested with `Debian Stretch v9.3`)

 - Version 3.10 or higher of the Linux kernel

 - Install the following tools: git, curl, vim (`sudo apt-get update && sudo apt-get install -y curl git vim`)

 - Take a snapshot of the virtual machine

 - GitHub account: https://github.com/join

 - Travis CI account: https://travis-ci.org (sign in with GitHub)

 - Docker Hub account: https://hub.docker.com

 - Heroku account: https://signup.heroku.com

  

## Lab

Replace `artioml` with your GitHub and Docker Hub username (where applicable) after forking.

#### `monolith`

```shell

# Install Node.js

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -

sudo apt-get install -y nodejs

git clone https://github.com/ArtiomL/hello-world.git

cd hello-world

# Install dependencies

npm install

# Run

node index.js &

# Test and crash the app

curl http://127.0.0.1:8080/app

curl http://127.0.0.1:8080/kill

curl http://127.0.0.1:8080/app

# Restore snapshot

```

 

#### `usermod`

```shell

# Install Docker CE

curl -fsSL https://get.docker.com | sh

# Manage Docker as a non-root user

sudo usermod -aG docker $USER

# Log out and log back in so that your group membership is re-evaluated

```

 

#### `build`

```shell

git clone https://github.com/ArtiomL/hello-world.git

cd hello-world

# Build an image from a Dockerfile

docker build -t hello-world .

# List images

docker images

```

 

#### `pull`

```shell

# Pull an image or a repository from a registry (won't work with your own username, yet)

docker pull artioml/hello-world

```

 

#### `run`

```shell

docker run -dit -p 80:8080 artioml/hello-world

# List running containers

docker ps

# Display listening server sockets (note docker-proxy)

sudo netstat -lnp | grep ':::80'

# Test and crash the app

curl http://127.0.0.1/app

curl http://127.0.0.1/kill

curl http://127.0.0.1/app

# Run again and assign a name

docker run -dit -p 80:8080 --name dhw artioml/hello-world

```

 

#### `logs`

```shell

# Fetch the logs of a container (follow output)

docker logs -f dhw

```

 

#### `exec`

```shell

# Run a command (as root) in a running container

docker exec -it -u 0 dhw /bin/sh

# Update the app

sed -i 's/Node.js app/Node.js app v2.0/' index.js

exit

```

 

#### `diff`

```shell

# Inspect changes to files or directories on a container's filesystem

docker diff dhw

```

 

#### `commit`

```shell

# Create a new image from a container's changes

docker commit dhw artioml/hello-world:2.0

```

 

#### `push`

```shell

docker images

# Log in to a Docker registry

docker login -u  -p 

# Push an image to a registry

docker push artioml/hello-world:2.0

```

 

#### `rm`

```shell

# Remove a container

docker rm -f dhw

# Run (new version) and restart if the container exits with a non-zero exit status

docker run -dit -p 80:8080 --name dhw --restart on-failure artioml/hello-world:2.0

# Test and crash the app

curl http://127.0.0.1/app

curl http://127.0.0.1/kill

docker ps

curl http://127.0.0.1/app

docker logs -f dhw

```

 

#### `top`

```shell

# Display the running processes of a container (note UID)

docker top dhw

```

 

#### `stats`

```shell

# Display a live stream of container(s) resource usage statistics

docker stats dhw

```

 

#### `kill`

```shell

# Kill one or more running containers

docker kill dhw

```

 

#### `-P, --publish-all`

```shell

# Publish all exposed ports to random ports (multiple instances)

for i in {1..3}; do

	docker run -ditP artioml/hello-world:2.0

done

# List running containers and examine the ports

docker ps

# Display listening server sockets (note docker-proxy)

sudo netstat -lnp | grep ':::32'

```

  

## Next

- [Fork](https://github.com/artioml/hello-world/fork) and build it yourself ([Dockerfile](Dockerfile))

- Configure [automated builds](https://docs.docker.com/docker-hub/github/) on Docker Hub

- Setup Continuous Integration with [Travis CI](https://docs.travis-ci.com/user/languages/javascript-with-nodejs/) ([example](scripts/.travis.min.yml))

- Deploy to [Heroku](https://devcenter.heroku.com/articles/container-registry-and-runtime) ([heroku.sh](scripts/heroku.sh))

- **Advanced**: Automate the entire CI/CD pipeline, add Slack notifications ([.travis.yml](.travis.yml))

	- Make sure you [encrypt](https://docs.travis-ci.com/user/encryption-keys/) all credentials and API keys ([encrypt.sh](scripts/encrypt.sh))

- Start using [adct](https://github.com/ArtiomL/adct) or [f5-hello-world](https://github.com/f5devcentral/f5-hello-world)

- Contribute!