mirror of
https://github.com/jpetazzo/container.training.git
synced 2026-03-05 10:50:33 +00:00
018282f392
This was discussed and agreed in #246. It will probably break a few outstanding PRs as well as a few external links but it's for the better good long term.
312 lines
6.9 KiB
Markdown
312 lines
6.9 KiB
Markdown
# Pre-requirements
|
|
|
|
- Be comfortable with the UNIX command line
|
|
|
|
- navigating directories
|
|
|
|
- editing files
|
|
|
|
- a little bit of bash-fu (environment variables, loops)
|
|
|
|
- Some Docker knowledge
|
|
|
|
- `docker run`, `docker ps`, `docker build`
|
|
|
|
- ideally, you know how to write a Dockerfile and build it
|
|
<br/>
|
|
(even if it's a `FROM` line and a couple of `RUN` commands)
|
|
|
|
- It's totally OK if you are not a Docker expert!
|
|
|
|
---
|
|
|
|
class: title
|
|
|
|
*Tell me and I forget.*
|
|
<br/>
|
|
*Teach me and I remember.*
|
|
<br/>
|
|
*Involve me and I learn.*
|
|
|
|
Misattributed to Benjamin Franklin
|
|
|
|
[(Probably inspired by Chinese Confucian philosopher Xunzi)](https://www.barrypopik.com/index.php/new_york_city/entry/tell_me_and_i_forget_teach_me_and_i_may_remember_involve_me_and_i_will_lear/)
|
|
|
|
---
|
|
|
|
## Hands-on sections
|
|
|
|
- The whole workshop is hands-on
|
|
|
|
- We are going to build, ship, and run containers!
|
|
|
|
- You are invited to reproduce all the demos
|
|
|
|
- All hands-on sections are clearly identified, like the gray rectangle below
|
|
|
|
.exercise[
|
|
|
|
- This is the stuff you're supposed to do!
|
|
|
|
- Go to @@SLIDES@@ to view these slides
|
|
|
|
- Join the chat room: @@CHAT@@
|
|
|
|
<!-- ```open @@SLIDES@@``` -->
|
|
|
|
]
|
|
|
|
---
|
|
|
|
class: in-person
|
|
|
|
## Where are we going to run our containers?
|
|
|
|
---
|
|
|
|
class: in-person, pic
|
|
|
|
|
|
|
|
---
|
|
|
|
class: in-person
|
|
|
|
## You get a cluster of cloud VMs
|
|
|
|
- Each person gets a private cluster of cloud VMs (not shared with anybody else)
|
|
|
|
- They'll remain up for the duration of the workshop
|
|
|
|
- You should have a little card with login+password+IP addresses
|
|
|
|
- You can automatically SSH from one VM to another
|
|
|
|
- The nodes have aliases: `node1`, `node2`, etc.
|
|
|
|
---
|
|
|
|
class: in-person
|
|
|
|
## Why don't we run containers locally?
|
|
|
|
- Installing that stuff can be hard on some machines
|
|
|
|
(32 bits CPU or OS... Laptops without administrator access... etc.)
|
|
|
|
- *"The whole team downloaded all these container images from the WiFi!
|
|
<br/>... and it went great!"* (Literally no-one ever)
|
|
|
|
- All you need is a computer (or even a phone or tablet!), with:
|
|
|
|
- an internet connection
|
|
|
|
- a web browser
|
|
|
|
- an SSH client
|
|
|
|
---
|
|
|
|
class: in-person
|
|
|
|
## SSH clients
|
|
|
|
- On Linux, OS X, FreeBSD... you are probably all set
|
|
|
|
- On Windows, get one of these:
|
|
|
|
- [putty](http://www.putty.org/)
|
|
- Microsoft [Win32 OpenSSH](https://github.com/PowerShell/Win32-OpenSSH/wiki/Install-Win32-OpenSSH)
|
|
- [Git BASH](https://git-for-windows.github.io/)
|
|
- [MobaXterm](http://mobaxterm.mobatek.net/)
|
|
|
|
- On Android, [JuiceSSH](https://juicessh.com/)
|
|
([Play Store](https://play.google.com/store/apps/details?id=com.sonelli.juicessh))
|
|
works pretty well
|
|
|
|
- Nice-to-have: [Mosh](https://mosh.org/) instead of SSH, if your internet connection tends to lose packets
|
|
|
|
---
|
|
|
|
class: in-person, extra-details
|
|
|
|
## What is this Mosh thing?
|
|
|
|
*You don't have to use Mosh or even know about it to follow along.
|
|
<br/>
|
|
We're just telling you about it because some of us think it's cool!*
|
|
|
|
- Mosh is "the mobile shell"
|
|
|
|
- It is essentially SSH over UDP, with roaming features
|
|
|
|
- It retransmits packets quickly, so it works great even on lossy connections
|
|
|
|
(Like hotel or conference WiFi)
|
|
|
|
- It has intelligent local echo, so it works great even in high-latency connections
|
|
|
|
(Like hotel or conference WiFi)
|
|
|
|
- It supports transparent roaming when your client IP address changes
|
|
|
|
(Like when you hop from hotel to conference WiFi)
|
|
|
|
---
|
|
|
|
class: in-person, extra-details
|
|
|
|
## Using Mosh
|
|
|
|
- To install it: `(apt|yum|brew) install mosh`
|
|
|
|
- It has been pre-installed on the VMs that we are using
|
|
|
|
- To connect to a remote machine: `mosh user@host`
|
|
|
|
(It is going to establish an SSH connection, then hand off to UDP)
|
|
|
|
- It requires UDP ports to be open
|
|
|
|
(By default, it uses a UDP port between 60000 and 61000)
|
|
|
|
---
|
|
|
|
class: in-person
|
|
|
|
## Connecting to our lab environment
|
|
|
|
.exercise[
|
|
|
|
- Log into the first VM (`node1`) with your SSH client
|
|
|
|
<!--
|
|
```bash
|
|
for N in $(awk '/\Wnode/{print $2}' /etc/hosts); do
|
|
ssh -o StrictHostKeyChecking=no $N true
|
|
done
|
|
```
|
|
|
|
```bash
|
|
if which kubectl; then
|
|
kubectl get deploy,ds -o name | xargs -rn1 kubectl delete
|
|
kubectl get all -o name | grep -v service/kubernetes | xargs -rn1 kubectl delete --ignore-not-found=true
|
|
kubectl -n kube-system get deploy,svc -o name | grep -v dns | xargs -rn1 kubectl -n kube-system delete
|
|
fi
|
|
```
|
|
-->
|
|
|
|
- Check that you can SSH (without password) to `node2`:
|
|
```bash
|
|
ssh node2
|
|
```
|
|
- Type `exit` or `^D` to come back to `node1`
|
|
|
|
<!-- ```bash exit``` -->
|
|
|
|
]
|
|
|
|
If anything goes wrong — ask for help!
|
|
|
|
---
|
|
|
|
## Doing or re-doing the workshop on your own?
|
|
|
|
- Use something like
|
|
[Play-With-Docker](http://play-with-docker.com/) or
|
|
[Play-With-Kubernetes](https://training.play-with-kubernetes.com/)
|
|
|
|
Zero setup effort; but environment are short-lived and
|
|
might have limited resources
|
|
|
|
- Create your own cluster (local or cloud VMs)
|
|
|
|
Small setup effort; small cost; flexible environments
|
|
|
|
- Create a bunch of clusters for you and your friends
|
|
([instructions](https://@@GITREPO@@/tree/master/prepare-vms))
|
|
|
|
Bigger setup effort; ideal for group training
|
|
|
|
---
|
|
|
|
class: self-paced
|
|
|
|
## Get your own Docker nodes
|
|
|
|
- If you already have some Docker nodes: great!
|
|
|
|
- If not: let's get some thanks to Play-With-Docker
|
|
|
|
.exercise[
|
|
|
|
- Go to http://www.play-with-docker.com/
|
|
|
|
- Log in
|
|
|
|
- Create your first node
|
|
|
|
<!-- ```open http://www.play-with-docker.com/``` -->
|
|
|
|
]
|
|
|
|
You will need a Docker ID to use Play-With-Docker.
|
|
|
|
(Creating a Docker ID is free.)
|
|
|
|
---
|
|
|
|
## We will (mostly) interact with node1 only
|
|
|
|
*These remarks apply only when using multiple nodes, of course.*
|
|
|
|
- Unless instructed, **all commands must be run from the first VM, `node1`**
|
|
|
|
- We will only checkout/copy the code on `node1`
|
|
|
|
- During normal operations, we do not need access to the other nodes
|
|
|
|
- If we had to troubleshoot issues, we would use a combination of:
|
|
|
|
- SSH (to access system logs, daemon status...)
|
|
|
|
- Docker API (to check running containers and container engine status)
|
|
|
|
---
|
|
|
|
## Terminals
|
|
|
|
Once in a while, the instructions will say:
|
|
<br/>"Open a new terminal."
|
|
|
|
There are multiple ways to do this:
|
|
|
|
- create a new window or tab on your machine, and SSH into the VM;
|
|
|
|
- use screen or tmux on the VM and open a new window from there.
|
|
|
|
You are welcome to use the method that you feel the most comfortable with.
|
|
|
|
---
|
|
|
|
## Tmux cheatsheet
|
|
|
|
[Tmux](https://en.wikipedia.org/wiki/Tmux) is a terminal multiplexer like `screen`.
|
|
|
|
*You don't have to use it or even know about it to follow along.
|
|
<br/>
|
|
But some of us like to use it to switch between terminals.
|
|
<br/>
|
|
It has been preinstalled on your workshop nodes.*
|
|
|
|
- Ctrl-b c → creates a new window
|
|
- Ctrl-b n → go to next window
|
|
- Ctrl-b p → go to previous window
|
|
- Ctrl-b " → split window top/bottom
|
|
- Ctrl-b % → split window left/right
|
|
- Ctrl-b Alt-1 → rearrange windows in columns
|
|
- Ctrl-b Alt-2 → rearrange windows in rows
|
|
- Ctrl-b arrows → navigate to other windows
|
|
- Ctrl-b d → detach session
|
|
- tmux attach → reattach to session
|