\documentclass[10pt,a4paper]{article} % Packages \usepackage{fancyhdr} % For header and footer \usepackage{multicol} % Allows multicols in tables \usepackage{tabularx} % Intelligent column widths \usepackage{tabulary} % Used in header and footer \usepackage{hhline} % Border under tables \usepackage{graphicx} % For images \usepackage{xcolor} % For hex colours %\usepackage[utf8x]{inputenc} % For unicode character support \usepackage[T1]{fontenc} % Without this we get weird character replacements \usepackage{colortbl} % For coloured tables \usepackage{setspace} % For line height \usepackage{lastpage} % Needed for total page number \usepackage{seqsplit} % Splits long words. %\usepackage{opensans} % Can't make this work so far. Shame. Would be lovely. \usepackage[normalem]{ulem} % For underlining links % Most of the following are not required for the majority % of cheat sheets but are needed for some symbol support. \usepackage{amsmath} % Symbols \usepackage{MnSymbol} % Symbols \usepackage{wasysym} % Symbols %\usepackage[english,german,french,spanish,italian]{babel} % Languages % Document Info \author{amicheletti} \pdfinfo{ /Title (docker-basics.pdf) /Creator (Cheatography) /Author (amicheletti) /Subject (Docker Basics Cheat Sheet) } % Lengths and widths \addtolength{\textwidth}{6cm} \addtolength{\textheight}{-1cm} \addtolength{\hoffset}{-3cm} \addtolength{\voffset}{-2cm} \setlength{\tabcolsep}{0.2cm} % Space between columns \setlength{\headsep}{-12pt} % Reduce space between header and content \setlength{\headheight}{85pt} % If less, LaTeX automatically increases it \renewcommand{\footrulewidth}{0pt} % Remove footer line \renewcommand{\headrulewidth}{0pt} % Remove header line \renewcommand{\seqinsert}{\ifmmode\allowbreak\else\-\fi} % Hyphens in seqsplit % This two commands together give roughly % the right line height in the tables \renewcommand{\arraystretch}{1.3} \onehalfspacing % Commands \newcommand{\SetRowColor}[1]{\noalign{\gdef\RowColorName{#1}}\rowcolor{\RowColorName}} % Shortcut for row colour \newcommand{\mymulticolumn}[3]{\multicolumn{#1}{>{\columncolor{\RowColorName}}#2}{#3}} % For coloured multi-cols \newcolumntype{x}[1]{>{\raggedright}p{#1}} % New column types for ragged-right paragraph columns \newcommand{\tn}{\tabularnewline} % Required as custom column type in use % Font and Colours \definecolor{HeadBackground}{HTML}{333333} \definecolor{FootBackground}{HTML}{666666} \definecolor{TextColor}{HTML}{333333} \definecolor{DarkBackground}{HTML}{277AA3} \definecolor{LightBackground}{HTML}{F1F6F9} \renewcommand{\familydefault}{\sfdefault} \color{TextColor} % Header and Footer \pagestyle{fancy} \fancyhead{} % Set header to blank \fancyfoot{} % Set footer to blank \fancyhead[L]{ \noindent \begin{multicols}{3} \begin{tabulary}{5.8cm}{C} \SetRowColor{DarkBackground} \vspace{-7pt} {\parbox{\dimexpr\textwidth-2\fboxsep\relax}{\noindent \hspace*{-6pt}\includegraphics[width=5.8cm]{/web/www.cheatography.com/public/images/cheatography_logo.pdf}} } \end{tabulary} \columnbreak \begin{tabulary}{11cm}{L} \vspace{-2pt}\large{\bf{\textcolor{DarkBackground}{\textrm{Docker Basics Cheat Sheet}}}} \\ \normalsize{by \textcolor{DarkBackground}{amicheletti} via \textcolor{DarkBackground}{\uline{cheatography.com/39488/cs/12295/}}} \end{tabulary} \end{multicols}} \fancyfoot[L]{ \footnotesize \noindent \begin{multicols}{3} \begin{tabulary}{5.8cm}{LL} \SetRowColor{FootBackground} \mymulticolumn{2}{p{5.377cm}}{\bf\textcolor{white}{Cheatographer}} \\ \vspace{-2pt}amicheletti \\ \uline{cheatography.com/amicheletti} \\ \end{tabulary} \vfill \columnbreak \begin{tabulary}{5.8cm}{L} \SetRowColor{FootBackground} \mymulticolumn{1}{p{5.377cm}}{\bf\textcolor{white}{Cheat Sheet}} \\ \vspace{-2pt}Published 17th July, 2017.\\ Updated 14th July, 2017.\\ Page {\thepage} of \pageref{LastPage}. \end{tabulary} \vfill \columnbreak \begin{tabulary}{5.8cm}{L} \SetRowColor{FootBackground} \mymulticolumn{1}{p{5.377cm}}{\bf\textcolor{white}{Sponsor}} \\ \SetRowColor{white} \vspace{-5pt} %\includegraphics[width=48px,height=48px]{dave.jpeg} Measure your website readability!\\ www.readability-score.com \end{tabulary} \end{multicols}} \begin{document} \raggedright \raggedcolumns % Set font size to small. Switch to any value % from this page to resize cheat sheet text: % www.emerson.emory.edu/services/latex/latex_169.html \footnotesize % Small font. \begin{multicols*}{2} \begin{tabularx}{8.4cm}{x{4 cm} x{4 cm} } \SetRowColor{DarkBackground} \mymulticolumn{2}{x{8.4cm}}{\bf\textcolor{white}{Docker Image}} \tn % Row 0 \SetRowColor{LightBackground} `docker images` & See all available images \tn % Row Count 2 (+ 2) % Row 1 \SetRowColor{white} `docker build -t \textless{}name\textgreater{}` & Create an image with a pretty name (you must define the `Dockerfile` in the folder) \tn % Row Count 7 (+ 5) % Row 2 \SetRowColor{LightBackground} `docker tag \textless{}name\textgreater{} \seqsplit{username/repository:tag`} & This tags an image ready to be sent to a repository \tn % Row Count 10 (+ 3) % Row 3 \SetRowColor{white} `docker push \seqsplit{username/repository:tag`} & Push the image to the remote repository \tn % Row Count 12 (+ 2) % Row 4 \SetRowColor{LightBackground} `docker search \textless{}keyword\textgreater{}` & Search for public repositories \tn % Row Count 14 (+ 2) \hhline{>{\arrayrulecolor{DarkBackground}}--} \SetRowColor{LightBackground} \mymulticolumn{2}{x{8.4cm}}{Docker Images are the base for `containers` and are similar to `.iso` files. They can be for example the image of your app and contain everything needed to run the application. \newline \newline These images can be local or in repositories (and marked with an tag) \newline \newline To create images, you must create a `Dockerfile` with some docker commands to specify how that image will be created, for example to setup the environment and a BaseImage.} \tn \hhline{>{\arrayrulecolor{DarkBackground}}--} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{Services}} \tn \SetRowColor{white} \mymulticolumn{1}{x{8.4cm}}{Different pieces of the app are called "services" For example, a service for storing application data in a database, a service for the front-end, etc. \newline % Row Count 4 (+ 4) Services are just "containers in production." A service only runs one image, but it manages for example what ports it should use and how many replicas of the container should run. \newline % Row Count 8 (+ 4) To define a service, you'll need an `docker-compose.yml` file. \newline % Row Count 10 (+ 2) For example: \newline % Row Count 11 (+ 1) `version: "3"` \newline % Row Count 12 (+ 1) `services:` \newline % Row Count 13 (+ 1) ` web:` \newline % Row Count 14 (+ 1) ` image: \seqsplit{amicheletti/get-started:part1`} \newline % Row Count 15 (+ 1) ` deploy:` \newline % Row Count 16 (+ 1) ` replicas: 5` \newline % Row Count 17 (+ 1) ` resources:` \newline % Row Count 18 (+ 1) ` limits:` \newline % Row Count 19 (+ 1) ` cpus: "0.1"` \newline % Row Count 20 (+ 1) ` memory: 50M` \newline % Row Count 21 (+ 1) ` restart\_policy:` \newline % Row Count 22 (+ 1) ` condition: on-failure` \newline % Row Count 23 (+ 1) ` ports:` \newline % Row Count 24 (+ 1) ` - "80:80"` \newline % Row Count 25 (+ 1) ` networks:` \newline % Row Count 26 (+ 1) ` - webnet` \newline % Row Count 27 (+ 1) `networks:` \newline % Row Count 28 (+ 1) ` webnet:` \newline % Row Count 29 (+ 1) Here you define the image to be loaded, how many replicas, the resource limits and the restart conditions. \newline % Row Count 32 (+ 3) } \tn \end{tabularx} \par\addvspace{1.3em} \vfill \columnbreak \begin{tabularx}{8.4cm}{X} \SetRowColor{DarkBackground} \mymulticolumn{1}{x{8.4cm}}{\bf\textcolor{white}{Services (cont)}} \tn \SetRowColor{white} \mymulticolumn{1}{x{8.4cm}}{To run it you must first start: `docker swarm init` \newline % Row Count 2 (+ 2) Then run it giving a name: \newline % Row Count 3 (+ 1) `docker stack deploy -c docker-compose.yml \textless{}app\_name\textgreater{}` \newline % Row Count 5 (+ 2) To see the details of containers running in your service, run: \newline % Row Count 7 (+ 2) `docker stack ps \textless{}app\_name\textgreater{}` \newline % Row Count 8 (+ 1) Now each time you request your app (via browser, for example), the load-balancer will help you distributing the requests to each replica. \newline % Row Count 11 (+ 3) To put it down, `docker stack rm \textless{}app\_name\textgreater{}` \newline % Row Count 12 (+ 1) This puts down the app, but not the "one-node" swarm we created. Use: \newline % Row Count 14 (+ 2) `docker swarm leave -{}-force`% Row Count 15 (+ 1) } \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \SetRowColor{LightBackground} \mymulticolumn{1}{x{8.4cm}}{Docker Swarm is available only for version "3"} \tn \hhline{>{\arrayrulecolor{DarkBackground}}-} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{x{3.28 cm} x{4.72 cm} } \SetRowColor{DarkBackground} \mymulticolumn{2}{x{8.4cm}}{\bf\textcolor{white}{Docker Container}} \tn % Row 0 \SetRowColor{LightBackground} `docker run \textless{}image\textgreater{}` & Run the image, starting a Container \tn % Row Count 2 (+ 2) % Row 1 \SetRowColor{white} `-d` & Run in detached mode (in background) \tn % Row Count 4 (+ 2) % Row 2 \SetRowColor{LightBackground} `-p 4000:80` & Maps the port `80` of the image to the host port `4000` \tn % Row Count 7 (+ 3) % Row 3 \SetRowColor{white} `-{}-rm` & Removes the container when exited \tn % Row Count 9 (+ 2) % Row 4 \SetRowColor{LightBackground} `docker ps` & List the running containers (you can check container id) \tn % Row Count 12 (+ 3) % Row 5 \SetRowColor{white} `docker ps -l` & List all the containers (you can check container id) \tn % Row Count 15 (+ 3) % Row 6 \SetRowColor{LightBackground} `docker stop \textless{}container\_id\textgreater{}` & Stop the container \tn % Row Count 17 (+ 2) \hhline{>{\arrayrulecolor{DarkBackground}}--} \SetRowColor{LightBackground} \mymulticolumn{2}{x{8.4cm}}{When you run an image with you are starting a Container, so container is the runtime instance of an `image`, and consists of the image, an execution environment and a standart set of instructions.} \tn \hhline{>{\arrayrulecolor{DarkBackground}}--} \end{tabularx} \par\addvspace{1.3em} \begin{tabularx}{8.4cm}{x{3.28 cm} x{4.72 cm} } \SetRowColor{DarkBackground} \mymulticolumn{2}{x{8.4cm}}{\bf\textcolor{white}{Swarm}} \tn % Row 0 \SetRowColor{LightBackground} `docker swarm init` & Initialize a swarm and become `swarm manager` \tn % Row Count 2 (+ 2) % Row 1 \SetRowColor{white} `docker swarm join` & Join a swarm as `worker` \tn % Row Count 4 (+ 2) % Row 2 \SetRowColor{LightBackground} `docker swarm leave -{}-force` & Leaves the current swarm \tn % Row Count 6 (+ 2) \hhline{>{\arrayrulecolor{DarkBackground}}--} \SetRowColor{LightBackground} \mymulticolumn{2}{x{8.4cm}}{With Docker you can increase resource and capacities by creating a `swarm`, which are simply several machines (virtual or physical) running a Docker and joined to a cluster. \newline \newline Swarms have the `swarm manager`, which can issue docker commands normally, and the `workers` which are only there to provide capacity.} \tn \hhline{>{\arrayrulecolor{DarkBackground}}--} \end{tabularx} \par\addvspace{1.3em} % That's all folks \end{multicols*} \end{document}