Skip to content

Latest commit

 

History

History
192 lines (115 loc) · 4.24 KB

connecting.md

File metadata and controls

192 lines (115 loc) · 4.24 KB
Raw

class: in-person

Testing the connection to our lab environment

.lab[

  • Connect to your lab environment with your SSH client:

    ssh `user`@`A.B.C.D`
ssh -p `32323` `user`@`A.B.C.D`

    (Make sure to replace the highlighted values with the ones provided to you!)

]

You should see a prompt looking like this:

[A.B.C.D] (...) user@machine ~
$

If anything goes wrong — ask for help!

class: in-person

tailhist

  • The shell history of the instructor is available online in real time

  • The instructor will provide you a "magic URL"

    (typically, the instructor's lab address on port 1088 or 30088)

  • Open that URL in your browser and you should see the history

  • The history is updated in real time

    (using a WebSocket connection)

  • It should be green when the WebSocket is connected

    (if it turns red, reloading the page should fix it)

Doing or re-doing the workshop on your own?

  • Use something like Play-With-Docker or Play-With-Kubernetes

    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)

    Bigger setup effort; ideal for group training

For a consistent Kubernetes experience ...

  • If you are using your own Kubernetes cluster, you can use jpetazzo/shpod

  • shpod provides a shell running in a pod on your own cluster

  • It comes with many tools pre-installed (helm, stern...)

  • These tools are used in many demos and exercises in these slides

  • shpod also gives you completion and a fancy prompt

  • It can also be used as an SSH server if needed

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

.lab[

]

You will need a Docker ID to use Play-With-Docker.

(Creating a Docker ID is free.)

We don't need to connect to ALL the nodes

  • If your cluster has multiple nodes (e.g. node1, node2, ...):

    unless instructed, all commands must be run from the first node

  • We don't need to check out/copy code or manifests on other nodes

  • During normal operations, we do not need access to the other nodes

    (but we could log into these nodes to troubleshoot or examine stuff)

Terminals

Once in a while, the instructions will say:
"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 cheat sheet (basic)

Tmux is a terminal multiplexer like screen.

You don't have to use it or even know about it to follow along.
But some of us like to use it to switch between terminals.
It has been preinstalled on your workshop nodes.

  • You can start a new session with tmux
    (or resume or share an existing session with tmux attach)

  • Then use these keyboard shortcuts:

    • 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 arrows → navigate within split windows

Tmux cheat sheet (advanced)

  • Ctrl-b d → detach session
    (resume it later with tmux attach)

  • Ctrl-b Alt-1 → rearrange windows in columns

  • Ctrl-b Alt-2 → rearrange windows in rows

  • Ctrl-b , → rename window

  • Ctrl-b Ctrl-o → cycle pane position (e.g. switch top/bottom)

  • Ctrl-b PageUp → enter scrollback mode
    (use PageUp/PageDown to scroll; Ctrl-c or Enter to exit scrollback)