From b1a38d9604bbce2c9a99016dfe4917b0c8e174e1 Mon Sep 17 00:00:00 2001
From: "Dr. Martin Goik" <goik@hdm-stuttgart.de>
Date: Mon, 18 Jun 2018 08:23:46 +0200
Subject: [PATCH] Sectioning
---
Doc/Sdi/docker.xml | 314 ++++++++++++++++++++++++++++-----------------
1 file changed, 198 insertions(+), 116 deletions(-)
diff --git a/Doc/Sdi/docker.xml b/Doc/Sdi/docker.xml
index 6d9b2ac41..feeddf425 100644
--- a/Doc/Sdi/docker.xml
+++ b/Doc/Sdi/docker.xml
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<chapter annotations="slide" version="5.1" xml:id="sdiDocker"
+<chapter annotations="slide" version="5.1" xml:id="sdiDocker_chap"
xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:xila="http://www.w3.org/2001/XInclude/local-attributes"
@@ -37,15 +37,18 @@
xlink:href="https://hub.docker.com/explore">https://hub.docker.com/explore</uri></para>
</figure>
- <figure xml:id="sdiDocker_figSearchImages">
- <title>Search image</title>
+ <section xml:id="sdiDocker_manageImages_sect">
+ <title>Managing images</title>
- <screen>> <link
- xlink:href="https://docs.docker.com/engine/reference/commandline/search">docker search</link> nextcloud
+ <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
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]
@@ -54,92 +57,110 @@ 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/image_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_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/'|\
+ </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...",
+ "RepoTags": [
+ "nextcloud:13.0.4"
+ ],
+ "RepoDigests": [
+ "nextcloud@sha256:fb3e77f19b21364925e8f02..."
+ ],
+ ...</screen>
+ </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>
+
+ <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
@@ -154,12 +175,13 @@ Status: Downloaded newer image for wonderfall/nextcloud:latest</screen>
"production-apache"
"stable-apache"
"apache"</screen>
- </figure>
+ </figure>
- <figure xml:id="sdiDocker_figNextcloudImageVariant">
- <title><productname>Nextcloud</productname> image variant</title>
+ <figure xml:id="sdiDocker_figNextcloudImageByVersion">
+ <title><productname>Nextcloud</productname> image by version</title>
- <screen>> docker image pull 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
@@ -167,64 +189,124 @@ Status: Downloaded newer image for wonderfall/nextcloud:latest</screen>
f93d7bd342a3: Pull complete
4a2fac611953: Pull complete
87fdfc7d0f94: Pull complete
-Digest: sha256:fb3e77f19b21364925e8f02d6e5ad3a1 ...
-Status: Downloaded newer image for nextcloud:13.0.4</screen>
- </figure>
+Digest: sha256:<emphasis role="red">fb3e77f19b21364925e8f02d6e5ad3a1</emphasis> ...
+Status: Downloaded newer image for <emphasis role="red">nextcloud:13.0.4</emphasis></screen>
+ </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_figCompareMavenArtifacts">
- <title>Maven ringing a bell?</title>
+ <figure xml:id="sdiDocker_figNextcloudImageLatest">
+ <title><productname>Nextcloud</productname> latest image</title>
- <programlisting language="xml"><dependency>
+ <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"/>
+Digest: sha256:<emphasis role="red">fb3e77f19b21364925e8f02d6e5ad3a1</emphasis> ... <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
+REPOSITORY TAG IMAGE ID CREATED SIZE
+nextcloud 13.0.4 <emphasis role="red">dac77467ddcc</emphasis> 4 days ago <emphasis
+ role="red">544MB</emphasis>
+nextcloud latest <emphasis role="red">dac77467ddcc</emphasis> 4 days ago <emphasis
+ role="red">544MB</emphasis>
+...</screen>
+ </figure>
+
+ <figure xml:id="sdiDocker_figCompareMavenArtifacts">
+ <title>Maven ringing a bell?</title>
+
+ <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 xml:id="sdiDocker_figListContainer">
- <title>List container</title>
-
- <screen>> docker ps -a
-CONTAINER ID IMAGE COMMAND CREATED STATUS ... NAMES
-5a5efd5685a1 nextcloud "/entrypoint.sh…" 4 hours ago Exited (0) 42 hours ago ... nc13</screen>
- </figure>
+ </figure>
- <figure xml:id="sdiDocker_figKillProcess">
- <title>Remove container</title>
+ <figure xml:id="sdiDocker_figUntagImage_fig">
+ <title>Un tag image by version</title>
- <screen>CONTAINER ID IMAGE ... NAMES
-5a5efd5685a1 nextcloud ... <emphasis role="red">nc13</emphasis></screen>
-
- <screen>> docker rm <emphasis role="red">nc13</emphasis>
-nc13</screen>
+ <screen>> docker image rm nextcloud:latest
+Untagged: nextcloud:latest
- <screen>> docker ps -a
-CONTAINER ID IMAGE COMMAND CREATED STATUS ... NAMES</screen>
- </figure>
+> docker image ls
+REPOSITORY TAG IMAGE ID CREATED SIZE
+nextcloud 13.0.4 dac77467ddcc 4 days ago 544MB
+...</screen>
+ </figure>
- <figure xml:id="sdiDocker_figRemoveImage">
- <title>Remove image</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>
+ </figure>
+ </section>
+
+ <section xml:id="sdiDocker_runningContainer_sect">
+ <title>Running container</title>
+
+ <figure xml:id="sdiDocker_figListContainer">
+ <title>Listing running containers</title>
+
+ <screen>> docker ps -a
+CONTAINER ID IMAGE COMMAND CREATED STATUS ... NAMES
+5a5efd5685a1 nextcloud "/entrypoint.sh…" 4 hours ago Exited (0) 42 hours ago ... nc13</screen>
+ </figure>
+
+ <figure xml:id="sdiDocker_figKillProcess">
+ <title>Remove container</title>
+
+ <screen>CONTAINER ID IMAGE ... NAMES
+5a5efd5685a1 nextcloud ... <emphasis role="red">nc13</emphasis></screen>
+
+ <screen>> docker rm <emphasis role="red">nc13</emphasis>
+nc13</screen>
+
+ <screen>> docker ps -a
+CONTAINER ID IMAGE COMMAND CREATED STATUS ... NAMES</screen>
+ </figure>
+ </section>
</chapter>
--
GitLab