Including docker, image handling

Doc/Sdi/docker.xml

@@ -29,7 +29,8 @@
   <figure xml:id="sdiDocker_figPullImage">
     <title>Pull image using <xref linkend="glo_CLI"/></title>
 
-    <screen>&gt; docker pull alpine
+    <screen>&gt; <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 
@@ -37,10 +38,31 @@ Digest: sha256:7df6db5aa61ae9480f52f0b3a06a140ab98d427f86d8d5de0bedab9b8df6b1c0
 Status: Downloaded newer image for alpine:latest</screen>
   </figure>
 
+  <figure xml:id="sdiDocker_figSearchImages">
+    <title>Search image</title>
+
+    <screen>&gt; <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>
+nextcloud                  A safe home …    424    [OK]                
+linuxserver/nextcloud      A Nextcloud …    56                                      
+greyltc/nextcloud          Nextcloud: …     34                [OK]
+wonderfall/nextcloud       All-in-one …     27                [OK]
+rootlogin/nextcloud        Nextcloud …      17                [OK]
+lsioarmhf/nextcloud        ARMHF based …    8                                       
+ownyourbits/nextcloudpi    NextCloud ARM …  7                                       
+...                     </screen>
+  </figure>
+
   <figure xml:id="sdiDocker_figPullNextcloudImage">
     <title>Pull <productname>Nextcloud</productname> image</title>
 
-    <screen>&gt; docker <emphasis role="bold">pull wonderfall/nextcloud</emphasis> <co
+    <screen>&gt; <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"/>
 Using default tag: latest <co linkends="sdiDocker_figPullNextcloudImage-2"
@@ -89,12 +111,45 @@ Status: Downloaded newer image for wonderfall/nextcloud:latest</screen>
     </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>&gt; curl 'https://registry.hub.docker.com/v2/repositories/library/<emphasis
+        role="red">nextcloud</emphasis>/tags/'|\
+      jq '."results"[]["name"]'
+  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
+                                 Dload  Upload   Total   Spent    Left  Speed
+100 11856    0 11856    0     0  11856      0 --:--:-- --:--:-- --:--:-- 20371
+"fpm"
+"production"
+"stable"
+"latest"
+"13"
+"13.0"
+"13.0.2"
+"production-apache"
+"stable-apache"
+"apache"</screen>
+  </figure>
+
   <figure xml:id="sdiDocker_figNextcloudImageVariant">
     <title><productname>Nextcloud</productname> image variant</title>
 
-    <screen>&gt; docker pull nextcloud
-Using default tag: latest
-latest: Pulling from library/nextcloud
+    <screen>&gt; docker image pull nextcloud:13.0.2
+13.0.2: Pulling from library/nextcloud
 3d77ce4481b1: Pull complete 
 32bfdb6043a8: Pull complete 
 028453741593: Pull complete 
@@ -102,17 +157,60 @@ f93d7bd342a3: Pull complete
 4a2fac611953: Pull complete 
 87fdfc7d0f94: Pull complete 
 Digest: sha256:c693921e69cb8...50156d973df035
-Status: Downloaded newer image for nextcloud:latest</screen>
+Status: Downloaded newer image for nextcloud:13.0.2</screen>
+  </figure>
+
+  <figure xml:id="sdiDocker_figCompareMavenArtifacts">
+    <title>Maven ringing a bell?</title>
+
+    <programlisting language="xml">&lt;dependency&gt;
+    &lt;groupId&gt;junit&lt;/groupId&gt; &lt;!-- <emphasis role="red">wonderfall</emphasis> --&gt;
+    &lt;artifactId&gt;junit&lt;/artifactId&gt; &lt;!-- <emphasis role="red">nextcloud</emphasis> --&gt;
+    &lt;version&gt;4.12&lt;/version&gt;        
+&lt;/dependency&gt;</programlisting>
   </figure>
 
   <figure xml:id="sdiDocker_figListImages">
-    <title>List images using <xref linkend="glo_CLI"/></title>
+    <title>List images by <xref linkend="glo_CLI"/></title>
 
     <screen>&gt; <link
-        xlink:href="https://docs.docker.com/engine/reference/commandline/images">docker images</link>
+        xlink:href="https://docs.docker.com/engine/reference/commandline/image">docker image ls</link>
 REPOSITORY            TAG      IMAGE ID       CREATED        SIZE
-nextcloud             latest   10ae267ddcf2   2 weeks ago    588MB
+nextcloud             13.0.2   10ae267ddcf2   2 weeks ago    588MB
 wonderfall/nextcloud  latest   57e1fb51b334   2 months ago   328MB
 alpine                latest   3fd9065eaf02   4 months ago   4.15MB</screen>
   </figure>
+
+  <figure xml:id="sdiDocker_figListContainer">
+    <title>List container</title>
+
+    <screen>&gt; 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>&gt; docker rm <emphasis role="red">nc13</emphasis>
+nc13</screen>
+
+    <screen>&gt; docker ps -a
+CONTAINER ID   IMAGE       COMMAND             CREATED      STATUS                   ... NAMES</screen>
+  </figure>
+
+  <figure xml:id="sdiDocker_figRemoveImage">
+    <title>Remove image</title>
+
+    <screen>&gt; 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>
 </chapter>

Doc/lectures.xml

@@ -244,6 +244,8 @@
 
     <xi:include href="Sdi/mail.xml" xpointer="element(/1)"/>
 
+    <xi:include href="Sdi/docker.xml" xpointer="element(/1)"/>
+
     <xi:include href="Sdi/surveillance.xml" xpointer="element(/1)"/>
   </part>