====== Portainer Stack Installation ======

Portainer bietet eine grafische Oberfläche zur Verwaltung des Docker Swarm.

===== Vorbereitung =====

Zuerst brauchen wir ein Datenverzeichnis für Portainer auf unserem NFS-Share:
  mkdir /docker/data/volumes/portainer

===== Laden der YML Datei =====

Portainer (dockerman01):

<code>
  curl -L https://downloads.portainer.io/ce2-16/portainer-agent-stack.yml -o portainer-agent-stack.yml
</code>
Damit holt man sich erstmal das YML Manifest welches im Prinzip eine Docker Compose Datei ist. Diese werden wir noch ein bisschen anpassen. Interessant ist das ce2-16 (Community Edition) in der URL da es auch eine ee (Enterprise Edition) Version gibt für die man allerdings Lizenzen braucht.


===== Konfiguration von Portainer =====

<code>
version: '3.2'

services:
  agent:
    image: portainer/agent:latest
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /var/lib/docker/volumes:/var/lib/docker/volumes
    networks:
      - agent_network
    deploy:
      mode: global
      placement:
        constraints: [node.platform.os == linux]

  portainer:
    image: portainer/portainer-ce:latest
    command: -H tcp://tasks.agent:9001 --tlsskipverify
    ports:
      - "9443:9443"
      - "9000:9000"
      - "8000:8000"
    volumes:
      - /docker/data/volumes/portainer:/data
    networks:
      - agent_network
    deploy:
      mode: replicated
      replicas: 1
      placement:
        constraints: [node.role == manager]

networks:
  agent_network:
    driver: overlay
    attachable: true
</code>

Ich habe das volume gändert da ich für jeden Container ein eigenes Verzeichnis für die persistenten Daten habe:
  volumes:
    - portainer_data:/data
in
  volumes:
    - /docker/data/volumes/portainer:/data
Dann kann am Ende die Definition des Docker Volumes gelöscht werden, diese beiden Zeilen kommen ersatzlos weg:
volumes:
  portainer_data:

Ebenso habe ich bei den beiden image: Angaben die Versionsnummer auf "latest" geändert um immer die aktuelle Version zu bekommen.

Anschliessend kann Portainer geladen und gestartet werden:

===== Laden und Starten =====

<code>
  docker stack deploy -c portainer-agent-stack.yml portainer
</code>

Jetzt muss man nur noch einen Moment warten bis die Portainer Container gestartet sind. Direkt nach dem Deploy sieht das noch so aus:
<code>
root@dockerman01:/docker/data/compose/portainer# docker service ls
ID             NAME                  MODE         REPLICAS   IMAGE                           PORTS
sb392p1tmj3v   portainer_agent       global       0/4        portainer/agent:latest          
lb32q69txxhd   portainer_portainer   replicated   0/1        portainer/portainer-ce:latest   *:8000->8000/tcp, *:9000->9000/tcp, *:9443->9443/tcp
</code>
Das heisst die Services sind bekannt, es laufen 0 von 4 Portainer Agenten und 0 von einem Portainer Server. Die Inhalte der Container werden gerade im Hintergrund geladen und dann gestartet. Bei mir hat das so ca. eine Minute gedauert aber das hängt ntürlich auch von der Internetgeschwindigkeit ab da diese aus dem Internet geholt werden.

Irgendwann sieht das dann so aus und Portainer ist installiert und läuft:
<code>
root@dockerman01:/docker/data/compose/portainer# docker service ls
ID             NAME                  MODE         REPLICAS   IMAGE                           PORTS
sb392p1tmj3v   portainer_agent       global       4/4        portainer/agent:latest          
lb32q69txxhd   portainer_portainer   replicated   1/1        portainer/portainer-ce:latest   *:8000->8000/tcp, *:9000->9000/tcp, *:9443->9443/tcp
</code>

===== Aufruf im Browser =====

Und jetzt kann man endlich per https://172.17.200.24:9443 auf Portainer zugreifen und einen Benutzer und Passwort einrichten:

{{:projekte:docker:portainer:docker-portainer-001.png|}}
Danach bekommt man eine erste Übersicht über den Docker Swarm
{{:projekte:docker:portainer:docker-portainer-002.png|}}

Sollte man beim ersten Start zu lange warten bis man Portainer aufruft, z.B. weil man ein Wiki pflegt, kann es zu folgender Fehlermeldung kommen:

{{:projekte:docker:portainer:docker-portainer-003.png|}}

Dann einfach den Portainer Container neu starten:

<code>
root@dockerman02:~# docker container ls
CONTAINER ID   IMAGE                           COMMAND                  CREATED          STATUS          PORTS                          NAMES
abc2e16a8abe   portainer/portainer-ce:latest   "/portainer -H tcp:/…"   33 seconds ago   Up 16 seconds   8000/tcp, 9000/tcp, 9443/tcp   portainer_portainer.1.9go806v5r708c9ngdrce4sfiq
168559a04656   portainer/agent:latest          "./agent"                38 seconds ago   Up 32 seconds                                  portainer_agent.n4u23ksil3wqdp4ee4iz5n43j.6djkwavvrzzomp8b9k5yepdne
</code>
Und mit der ID des containers diesen neu starten:

  docker container restart abc2e16a8abe