Add portainer

docs/gui/portainer.md

@@ -0,0 +1,43 @@
+Portainer is a lightweight management UI which allows you to easily manage your different Docker environments (Docker hosts or Swarm clusters).
+Portainer is meant to be as simple to deploy as it is to use. It consists of a single container that can run on any Docker engine.
+
+## Installation
+
+```bash
+docker volume create portainer_data
+```
+
+```bash
+docker run -d -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce
+```
+
+## Usage
+
+The UI will be exposed on port `9000` and you will be asked to create the initial administrator setting a password:
+
+![](images/portainer_1.png)
+
+Then choose to manage the local Docker environment and click on Connect:
+
+![](images/portainer_2.png)
+
+If everything works as expected, You will then be shown the Portainer home page:
+
+![](images/portainer_2a.png)
+
+In the menu clicking on `Dashboard` will open a summary view of your docker engine:
+
+![](images/portainer_3.png)
+
+Clicking on `Containers` will allow you to manage containers:
+
+![](images/portainer_4.png)
+
+Then click on one running container to get the container status and menu from which you can see the log and statistics: 
+
+![](images/portainer_5.png)
+
+![](images/portainer_6.png)
+
+!!! question "Exercise"
+    Now go back to the `Containers` page and try to add a new container. 

mkdocs.yml

@@ -1,4 +1,4 @@
-site_name: Docker Tutorial
+site_name: Docker Tutorial - part 1
 repo_url: https://github.com/maricaantonacci/docker-tutorial
 site_author: Marica Antonacci - [email protected]
 theme:
@@ -39,6 +39,8 @@ nav:
     - Docker volumes and bind-mounts: 'container/volumes.md'
     - Docker volume plugins - an example: 'container/volume_plugin.md'
     - Summary: 'container/volume_summary.md'
+  - Docker web UI:
+    - Portainer: 'gui/portainer.md'
 
 
 copyright: Copyright © 2021 INFN