diff --git a/Doc/Sdi/docker.xml b/Doc/Sdi/docker.xml
index dc8d923fa3e8358bc9f48725f6c3f924985ff7b1..0ebf256ad416ba0ef39587d0835352c997763bfa 100644
--- a/Doc/Sdi/docker.xml
+++ b/Doc/Sdi/docker.xml
@@ -11,44 +11,47 @@
xmlns:db="http://docbook.org/ns/docbook">
<title>Docker</title>
- <figure xml:id="sdiDocker_figInstall">
- <title>Installation</title>
-
- <itemizedlist>
- <listitem>
- <para><uri
- xlink:href="https://docs.docker.com/install">https://docs.docker.com/install</uri></para>
- </listitem>
-
- <listitem>
- <para><link
- xlink:href="https://github.com/wsargent/docker-cheat-sheet">Docker
- Cheat Sheet</link></para>
- </listitem>
- </itemizedlist>
- </figure>
+ <section xml:id="sdiDocker_sect_introduction">
+ <title>Introduction</title>
+
+ <figure xml:id="sdiDocker_figInstall">
+ <title>Installation</title>
+
+ <itemizedlist>
+ <listitem>
+ <para><uri
+ xlink:href="https://docs.docker.com/install">https://docs.docker.com/install</uri></para>
+ </listitem>
+
+ <listitem>
+ <para><link
+ xlink:href="https://github.com/wsargent/docker-cheat-sheet">Docker
+ Cheat Sheet</link></para>
+ </listitem>
+ </itemizedlist>
+ </figure>
- <figure xml:id="sdiDocker_Hub">
- <title>Docker hub</title>
+ <figure xml:id="sdiDocker_Hub">
+ <title>Docker hub</title>
- <para>Repository hosting publicly available Docker images:</para>
+ <para>Repository hosting publicly available Docker images:</para>
- <para><uri
- xlink:href="https://hub.docker.com/explore">https://hub.docker.com/explore</uri></para>
- </figure>
+ <para><uri
+ xlink:href="https://hub.docker.com/explore">https://hub.docker.com/explore</uri></para>
+ </figure>
- <section xml:id="sdiDocker_manageImages_sect">
- <title>Managing images</title>
+ <section xml:id="sdiDocker_manageImages_sect">
+ <title>Managing images</title>
- <figure xml:id="sdiDocker_figSearchImages">
- <title>Search images</title>
+ <figure xml:id="sdiDocker_figSearchImages">
+ <title>Search images</title>
- <screen>> <link
- xlink:href="https://docs.docker.com/engine/reference/commandline/search">docker search</link> nextcloud
+ <screen>> <link
+ xlink:href="https://docs.docker.com/engine/reference/commandline/search">docker search</link> nextcloud
NAME DESCRIPTION <link
- xlink:href="https://docs.docker.com/docker-hub/repos/#stars">STARS</link> <link
- xlink:href="https://docs.docker.com/docker-hub/official_repos">OFFICIAL</link> <link
- xlink:href="https://docs.docker.com/docker-cloud/builds/automated-build">AUTOMATED</link>
+ xlink:href="https://docs.docker.com/docker-hub/repos/#stars">STARS</link> <link
+ xlink:href="https://docs.docker.com/docker-hub/official_repos">OFFICIAL</link> <link
+ xlink:href="https://docs.docker.com/docker-cloud/builds/automated-build">AUTOMATED</link>
nextcloud A safe home … 424 [OK]
linuxserver/nextcloud A Nextcloud … 56
greyltc/nextcloud Nextcloud: … 34 [OK]
@@ -57,91 +60,91 @@ rootlogin/nextcloud Nextcloud … 17 [OK]
lsioarmhf/nextcloud ARMHF based … 8
ownyourbits/nextcloudpi NextCloud ARM … 7
...</screen>
- </figure>
+ </figure>
- <figure xml:id="sdiDocker_figPullImage">
- <title>Pull image using <xref linkend="glo_CLI"/></title>
+ <figure xml:id="sdiDocker_figPullImage">
+ <title>Pull image using <xref linkend="glo_CLI"/></title>
- <screen>> <link
- xlink:href="https://docs.docker.com/engine/reference/commandline/image_pull">docker image pull</link> alpine
+ <screen>> <link
+ xlink:href="https://docs.docker.com/engine/reference/commandline/image_pull">docker image pull</link> alpine
Using default tag: latest
latest: Pulling from library/alpine
<emphasis role="red">ff3a5c916c92</emphasis>: Pull complete
Digest: sha256:7df6db5aa61ae9480f52f0b3a06a140ab98d427f86d8d5de0bedab9b8df6b1c0
Status: Downloaded newer image for alpine:latest</screen>
- </figure>
+ </figure>
- <figure xml:id="sdiDocker_figPullNextcloudImage">
- <title>Pull <productname>Nextcloud</productname> image</title>
+ <figure xml:id="sdiDocker_figPullNextcloudImage">
+ <title>Pull <productname>Nextcloud</productname> image</title>
- <screen>> <link
- xlink:href="https://docs.docker.com/engine/reference/commandline/pull">docker image pull</link> <emphasis
- role="bold">wonderfall/nextcloud</emphasis> <co
- linkends="sdiDocker_figPullNextcloudImage-1"
- xml:id="sdiDocker_figPullNextcloudImage-1-co"/>
+ <screen>> <link
+ xlink:href="https://docs.docker.com/engine/reference/commandline/pull">docker image pull</link> <emphasis
+ role="bold">wonderfall/nextcloud</emphasis> <co
+ linkends="sdiDocker_figPullNextcloudImage-1"
+ xml:id="sdiDocker_figPullNextcloudImage-1-co"/>
Using default tag: latest <co linkends="sdiDocker_figPullNextcloudImage-2"
- xml:id="sdiDocker_figPullNextcloudImage-2-co"/>
+ xml:id="sdiDocker_figPullNextcloudImage-2-co"/>
latest: Pulling from wonderfall/nextcloud
<emphasis role="red">ff3a5c916c92</emphasis>: Already exists <co
- linkends="sdiDocker_figPullNextcloudImage-3"
- xml:id="sdiDocker_figPullNextcloudImage-3-co"/>
+ linkends="sdiDocker_figPullNextcloudImage-3"
+ xml:id="sdiDocker_figPullNextcloudImage-3-co"/>
a542d4c3cffb: Pull complete <co linkends="sdiDocker_figPullNextcloudImage-4"
- xml:id="sdiDocker_figPullNextcloudImage-4-co"/>
+ xml:id="sdiDocker_figPullNextcloudImage-4-co"/>
83001cc0bea0: Pull complete
41a33c66b2c1: Pull complete
a70bf67726f3: Pull complete
fea90b3d29ac: Pull complete
Digest: sha256:472c5c7...2ca20cca45 <co
- linkends="sdiDocker_figPullNextcloudImage-5"
- xml:id="sdiDocker_figPullNextcloudImage-5-co"/>
+ linkends="sdiDocker_figPullNextcloudImage-5"
+ xml:id="sdiDocker_figPullNextcloudImage-5-co"/>
Status: Downloaded newer image for wonderfall/nextcloud:latest</screen>
- </figure>
-
- <calloutlist>
- <callout arearefs="sdiDocker_figPullNextcloudImage-1-co"
- xml:id="sdiDocker_figPullNextcloudImage-1">
- <para>Get docker image from remote server.</para>
- </callout>
-
- <callout arearefs="sdiDocker_figPullNextcloudImage-2-co"
- xml:id="sdiDocker_figPullNextcloudImage-2">
- <para>Version defaults to »latest«: Subject to be overridden.</para>
- </callout>
-
- <callout arearefs="sdiDocker_figPullNextcloudImage-3-co"
- xml:id="sdiDocker_figPullNextcloudImage-3">
- <para>Reference to existing <link
- linkend="sdiDocker_figPullImage">»alpine« layer</link>.</para>
- </callout>
-
- <callout arearefs="sdiDocker_figPullNextcloudImage-4-co"
- xml:id="sdiDocker_figPullNextcloudImage-4">
- <para>Layer downloads.</para>
- </callout>
-
- <callout arearefs="sdiDocker_figPullNextcloudImage-5-co"
- xml:id="sdiDocker_figPullNextcloudImage-5">
- <para>Hash value allowing for image verification.</para>
- </callout>
- </calloutlist>
-
- <figure xml:id="sdiDocker_figNextcloudFromAlpine">
- <title><productname>Nextcloud</productname> based on
- <productname>Alpine</productname></title>
-
- <mediaobject>
- <imageobject>
- <imagedata fileref="Ref/Docker/layer.multi.svg"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <figure xml:id="sdiDocker_inspectImage_fig">
- <title><link
- xlink:href="http://www.googlinux.com/list-all-tags-of-docker-image/index.html">Inspect
- image</link></title>
-
- <screen>> docker image inspect dac77467ddcc
+ </figure>
+
+ <calloutlist>
+ <callout arearefs="sdiDocker_figPullNextcloudImage-1-co"
+ xml:id="sdiDocker_figPullNextcloudImage-1">
+ <para>Get docker image from remote server.</para>
+ </callout>
+
+ <callout arearefs="sdiDocker_figPullNextcloudImage-2-co"
+ xml:id="sdiDocker_figPullNextcloudImage-2">
+ <para>Version defaults to »latest«: Subject to be overridden.</para>
+ </callout>
+
+ <callout arearefs="sdiDocker_figPullNextcloudImage-3-co"
+ xml:id="sdiDocker_figPullNextcloudImage-3">
+ <para>Reference to existing <link
+ linkend="sdiDocker_figPullImage">»alpine« layer</link>.</para>
+ </callout>
+
+ <callout arearefs="sdiDocker_figPullNextcloudImage-4-co"
+ xml:id="sdiDocker_figPullNextcloudImage-4">
+ <para>Layer downloads.</para>
+ </callout>
+
+ <callout arearefs="sdiDocker_figPullNextcloudImage-5-co"
+ xml:id="sdiDocker_figPullNextcloudImage-5">
+ <para>Hash value allowing for image verification.</para>
+ </callout>
+ </calloutlist>
+
+ <figure xml:id="sdiDocker_figNextcloudFromAlpine">
+ <title><productname>Nextcloud</productname> based on
+ <productname>Alpine</productname></title>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="Ref/Docker/layer.multi.svg"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <figure xml:id="sdiDocker_inspectImage_fig">
+ <title><link
+ xlink:href="http://www.googlinux.com/list-all-tags-of-docker-image/index.html">Inspect
+ image</link></title>
+
+ <screen>> docker image inspect dac77467ddcc
[
{
"Id": "sha256:dac77467ddccc2287d99558245bd34707...",
@@ -152,15 +155,15 @@ Status: Downloaded newer image for wonderfall/nextcloud:latest</screen>
"nextcloud@sha256:fb3e77f19b21364925e8f02..."
],
...</screen>
- </figure>
+ </figure>
- <figure xml:id="sdiDocker_figSearchImageTags">
- <title><link
- xlink:href="http://www.googlinux.com/list-all-tags-of-docker-image/index.html">Search
- an image's tags</link></title>
+ <figure xml:id="sdiDocker_figSearchImageTags">
+ <title><link
+ xlink:href="http://www.googlinux.com/list-all-tags-of-docker-image/index.html">Search
+ an image's tags</link></title>
- <screen>> curl 'https://registry.hub.docker.com/v2/repositories/library/<emphasis
- role="red">nextcloud</emphasis>/tags/'|\
+ <screen>> curl 'https://registry.hub.docker.com/v2/repositories/library/<emphasis
+ role="red">nextcloud</emphasis>/tags/'|\
jq '."results"[]["name"]' <emphasis role="red"># requires »aptitude install curl jq«</emphasis>
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
@@ -175,13 +178,13 @@ Status: Downloaded newer image for wonderfall/nextcloud:latest</screen>
"production-apache"
"stable-apache"
"apache"</screen>
- </figure>
+ </figure>
- <figure xml:id="sdiDocker_figNextcloudImageByVersion">
- <title><productname>Nextcloud</productname> image by version</title>
+ <figure xml:id="sdiDocker_figNextcloudImageByVersion">
+ <title><productname>Nextcloud</productname> image by version</title>
- <screen>> <link
- xlink:href="https://docs.docker.com/engine/reference/commandline/pull">docker image pull</link> nextcloud:13.0.4
+ <screen>> <link
+ xlink:href="https://docs.docker.com/engine/reference/commandline/pull">docker image pull</link> nextcloud:13.0.4
13.0.4: Pulling from library/nextcloud
3d77ce4481b1: Pull complete
32bfdb6043a8: Pull complete
@@ -191,127 +194,137 @@ f93d7bd342a3: Pull complete
87fdfc7d0f94: Pull complete
Digest: sha256:<emphasis role="red">fb3e77f19b21364925e8f02d6e5ad3a1</emphasis> ...
Status: Downloaded newer image for <emphasis role="red">nextcloud:13.0.4</emphasis></screen>
- </figure>
+ </figure>
- <figure xml:id="sdiDocker_figListImages">
- <title>List images by <xref linkend="glo_CLI"/></title>
+ <figure xml:id="sdiDocker_figListImages">
+ <title>List images by <xref linkend="glo_CLI"/></title>
- <screen>> <link
- xlink:href="https://docs.docker.com/engine/reference/commandline/image">docker image ls</link>
+ <screen>> <link
+ xlink:href="https://docs.docker.com/engine/reference/commandline/image">docker image ls</link>
REPOSITORY TAG IMAGE ID CREATED SIZE
nextcloud 13.0.4 dac77467ddcc 3 days ago 544MB
wonderfall/nextcloud latest 57e1fb51b334 2 months ago 328MB
alpine latest 3fd9065eaf02 4 months ago 4.15MB</screen>
- </figure>
+ </figure>
- <figure xml:id="sdiDocker_figNextcloudImageLatest">
- <title><productname>Nextcloud</productname> latest image</title>
+ <figure xml:id="sdiDocker_figNextcloudImageLatest">
+ <title><productname>Nextcloud</productname> latest image</title>
- <screen>> <link
- xlink:href="https://docs.docker.com/engine/reference/commandline/pull">docker image pull</link> nextcloud
+ <screen>> <link
+ xlink:href="https://docs.docker.com/engine/reference/commandline/pull">docker image pull</link> nextcloud
Using default tag: latest
latest: Pulling from library/nextcloud <co
- linkends="sdiDocker_figNextcloudImageByVersion-1"
- xml:id="sdiDocker_figNextcloudImageByVersion-1-co"/>
+ linkends="sdiDocker_figNextcloudImageByVersion-1"
+ xml:id="sdiDocker_figNextcloudImageByVersion-1-co"/>
Digest: sha256:<emphasis role="red">fb3e77f19b21364925e8f02d6e5ad3a1</emphasis> ... <co
- linkends="sdiDocker_figNextcloudImageByVersion-2"
- xml:id="sdiDocker_figNextcloudImageByVersion-2-co"/>
+ linkends="sdiDocker_figNextcloudImageByVersion-2"
+ xml:id="sdiDocker_figNextcloudImageByVersion-2-co"/>
Status: Downloaded newer image for <emphasis role="red">nextcloud:latest</emphasis></screen>
- </figure>
-
- <calloutlist>
- <callout arearefs="sdiDocker_figNextcloudImageByVersion-1-co"
- xml:id="sdiDocker_figNextcloudImageByVersion-1">
- <para>No »<link
- xlink:href="https://docs.docker.com/engine/reference/commandline/pull/#examples">Pull
- complete</link>« messages, image is alias of
- <code>nextcloud:13.0.4</code>.</para>
- </callout>
-
- <callout arearefs="sdiDocker_figNextcloudImageByVersion-2-co"
- xml:id="sdiDocker_figNextcloudImageByVersion-2">
- <para>Digest value identical to <xref
- linkend="sdiDocker_figNextcloudImageByVersion"/>.</para>
- </callout>
- </calloutlist>
-
- <figure xml:id="sdiDocker_figListNextcloudImages">
- <title>Duplicate <productname>Nextcloud</productname> images</title>
-
- <screen>> docker image ls
+ </figure>
+
+ <calloutlist>
+ <callout arearefs="sdiDocker_figNextcloudImageByVersion-1-co"
+ xml:id="sdiDocker_figNextcloudImageByVersion-1">
+ <para>No »<link
+ xlink:href="https://docs.docker.com/engine/reference/commandline/pull/#examples">Pull
+ complete</link>« messages, image is alias of
+ <code>nextcloud:13.0.4</code>.</para>
+ </callout>
+
+ <callout arearefs="sdiDocker_figNextcloudImageByVersion-2-co"
+ xml:id="sdiDocker_figNextcloudImageByVersion-2">
+ <para>Digest value identical to <xref
+ linkend="sdiDocker_figNextcloudImageByVersion"/>.</para>
+ </callout>
+ </calloutlist>
+
+ <figure xml:id="sdiDocker_figListNextcloudImages">
+ <title>Duplicate <productname>Nextcloud</productname> images</title>
+
+ <screen>> docker image ls
REPOSITORY TAG IMAGE ID CREATED SIZE
nextcloud 13.0.4 <emphasis role="red">dac77467ddcc</emphasis> 4 days ago <emphasis
- role="red">544MB</emphasis>
+ role="red">544MB</emphasis>
nextcloud latest <emphasis role="red">dac77467ddcc</emphasis> 4 days ago <emphasis
- role="red">544MB</emphasis>
+ role="red">544MB</emphasis>
...</screen>
- </figure>
+ </figure>
- <figure xml:id="sdiDocker_figCompareMavenArtifacts">
- <title>Maven ringing a bell?</title>
+ <figure xml:id="sdiDocker_figCompareMavenArtifacts">
+ <title>Maven ringing a bell?</title>
- <programlisting language="xml"><dependency>
+ <programlisting language="xml"><dependency>
<groupId><emphasis role="red">junit</emphasis></groupId> <!-- <emphasis
- role="red">wonderfall</emphasis> -->
+ role="red">wonderfall</emphasis> -->
<artifactId><emphasis role="red">junit</emphasis></artifactId> <!-- <emphasis
- role="red">nextcloud</emphasis> -->
+ role="red">nextcloud</emphasis> -->
<version><emphasis role="red">4.12</emphasis></version> <!-- <emphasis
- role="red">13.0.4</emphasis> -->
+ role="red">13.0.4</emphasis> -->
</dependency></programlisting>
- </figure>
+ </figure>
- <figure xml:id="sdiDocker_figUntagImage_fig">
- <title>Un tag image by version</title>
+ <figure xml:id="sdiDocker_figUntagImage_fig">
+ <title>Un tag image by version</title>
- <screen>> docker image rm nextcloud:latest
+ <screen>> docker image rm nextcloud:latest
Untagged: nextcloud:latest
> docker image ls
REPOSITORY TAG IMAGE ID CREATED SIZE
nextcloud 13.0.4 dac77467ddcc 4 days ago 544MB
...</screen>
- </figure>
+ </figure>
- <figure xml:id="sdiDocker_figRemoveImage_fig">
- <title>Remove image by version</title>
+ <figure xml:id="sdiDocker_figRemoveImage_fig">
+ <title>Remove image by version</title>
- <screen>> docker image rm nextcloud:13.0.2
+ <screen>> docker image rm nextcloud:13.0.2
Untagged: nextcloud:latest
Untagged: nextcloud@sha256:c693921e69cb89cd0bee7c014280159df647e5ba87f54c895650156d973df035
Deleted: sha256:10ae267ddcf25bfe5cc059685d3d005bcfe7229b44c3a6f93e0a07795d33b5b2
Deleted: sha256:1c271f4f2f19a222cd116c771b02294c5dd596fa8a0366559061f83a0de8de3f
...
Deleted: sha256:2c833f307fd8f18a378b71d3c43c575fabdb88955a2198662938ac2a08a99928</screen>
- </figure>
- </section>
+ </figure>
+ </section>
- <section xml:id="sdiDocker_runningContainer_sect">
- <title>Running container</title>
+ <section xml:id="sdiDocker_runningContainer_sect">
+ <title>Running container</title>
- <figure xml:id="sdiDocker_fig_startNexctcloud">
- <title>Starting <productname>Nextcloud</productname> container</title>
+ <figure xml:id="sdiDocker_fig_startNexctcloud">
+ <title>Starting <productname>Nextcloud</productname> container</title>
- <screen>> docker run -d -p 8080:80 --name nc13 nextcloud
+ <screen>> docker run -d -p 8080:80 --name nc13 nextcloud
517e3dba488763eb615f2c68d417e1b7fb3a9ce5bb4a5ffc346dcb86c00d13d2</screen>
- </figure>
+ </figure>
- <figure xml:id="sdiDocker_figListContainer">
- <title>List running containers</title>
+ <figure xml:id="sdiDocker_figListContainer">
+ <title>List running containers</title>
- <screen>> docker ps -a
+ <screen>> docker ps -a
CONTAINER ID IMAGE COMMAND ... PORTS NAMES
517e3dba4887 nextcloud "/entrypoint.sh apac…" ... 0.0.0.0:8080->80/tcp <emphasis
- role="red">nc13</emphasis></screen>
- </figure>
+ role="red">nc13</emphasis></screen>
+ </figure>
- <figure xml:id="sdiDocker_figKillProcess">
- <title>Remove container</title>
+ <figure xml:id="sdiDocker_figKillProcess">
+ <title>Remove container</title>
- <screen>> docker rm <emphasis role="red">nc13</emphasis>
+ <screen>> docker rm <emphasis role="red">nc13</emphasis>
nc13</screen>
- <screen>> docker ps -a
+ <screen>> docker ps -a
CONTAINER ID IMAGE COMMAND CREATED STATUS ... NAMES</screen>
- </figure>
+ </figure>
+ </section>
+ </section>
+
+ <section xml:id="sdiDocker_sect_exercises">
+ <title>Exercises</title>
+
+ <para>In this exercise you are about to replace your package based
+ <productname>Nextcloud</productname> installation by a
+ <productname>Docker</productname> container based on an already existing
+ image.</para>
</section>
</chapter>