[Modul] Portainer

SDK Module Version Symcon Version
License Check Style Run Tests
PayPal.Me Wunschliste

Portainer

Inhaltsverzeichnis


1. Vorbemerkungen

Diese Library enthält nur wenige Funktionen der sehr umfangreichen Portainer API.
Sie wurde entwickelt um eine einfache Überwachung von laufenden Containern zu ermöglichen und diese zu starten, beenden oder neu zu starten.

2. Voraussetzungen

  • IP-Symcon ab Version 8.1
  • Portainer Installation

3. Enthaltende Module

Folgende Module beinhaltet die Portainer Bibliothek:

  • Portainer Konfigurator (Dokumentation)
    Konfigurator welcher das einfache anlegen von Stack, Container und System Instanzen erlaubt.
  • Portainer IO (Dokumentation)
    IO Instanz zur Kommunikation mit Portainer.
  • Portainer Stack (Dokumentation)
    Instanz welche einen Stack von Portainer abbildet.
  • Docker Container (Dokumentation)
    Instanz welche einen Docker Container in abbildet.
  • Docker System (Dokumentation)
    Instanz welche ein Docker Environment abbildet.

4. Software-Installation

Über den Module-Store in IPS das Modul Portainer hinzufügen.
Bei kommerzieller Nutzung (z.B. als Errichter oder Integrator) wenden Sie sich bitte an den Autor.

Module-Store

5. Einrichten der Instanzen in IP-Symcon

Details sind direkt in der Dokumentation der jeweiligen Module beschrieben.
Es wird empfohlen die Einrichtung mit der Konfigurator-Instanz zu starten Portainer Konfigurator.
Nach der installation aus dem Store wird diese Instanz auf Rückfrage automatisch angelegt. Module-Store
Module-Store
Dabei wird die Konfiguration bis zum Portainer IO durchlaufen.
Module-Store
Sind die Eingaben korrekt, so wird der Portainer Konfigurator geöffnet. Module-Store

6. Anhang

1. GUID der Module

Modul Typ Prefix GUID
Portainer IO IO PORTAINER {FEB4D3D2-AD8A-9C6A-72D8-DF99AC625768}
Portainer Configurator Configurator PORTAINER {781E99AA-6F79-4430-0DF5-388D82E29019}
Portainer Stack Device PORTAINER {B4110D02-0282-F7F6-363C-906280A3510A}
Portainer System Device PORTAINER {80544234-7E77-8F76-8376-D6C285B58443}
Portainer Container Device PORTAINER {80AA764D-EABE-B85E-D997-43A2D244D6E8}

2. Changelog

siehe nächster Beitrag

3. Spenden

Die Library ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:

PayPal.Me

Wunschliste

7. Lizenz

CC BY-NC-SA 4.0

2 „Gefällt mir“

2. Changelog

Version 0.8:

  • Initiale Version

Das ist cool!
Muss ich mal ausprobieren.

was bedeutet eigentlich die Fehlermeldung bzw. der Status im Portainer IO “Not reachable” ? Ich gebe hier die IP Adresse meines QNAP, Nutzername und Password des QNAP ein richtig ?

Wenn du kein portainer installiert hast, dann wird das nix.
Das Modul nutzt die portainer API und nix von Qnap Container Station.

1 „Gefällt mir“

Ich habe den Portainer installiert

Portainer IO laeuft auch

aber beim installieren des Configurators kommt diese Fehlermeldung
Could not load configuration form

Warning: foreach() argument must be of type array|object, null given in /var/lib/symcon/modules/.store/de.nall.chan.portainer/Portainer Configurator/module.php on line 85

Wahrscheinliche Ursachen:

  • Snapshots ist leer oder nicht vorhanden

  • Snapshots[0] existiert, aber DockerSnapshotRaw fehlt

  • DockerSnapshotRaw ist da, aber Containers ist null

Kannst du bitte vom IO einmal das Debug laufen lassen, wenn du versuchst den Konfigurator zu öffnen?

here ist der screenshot

Bitte Debug immer als Text.
Was zum Henker soll ich mit einem Bild anfangen :man_facepalming:

Und dein KI Text bitte weglassen.
Wenn, dann Stelle einen PR per GitHub ein, aber kein KI Geschwafel im Support Thema. Danke.

1 „Gefällt mir“

Damit hat sich das Thema fuer mich erledigt Thanks but no Thanks

Hallo @Nall-chan,

wollte mal Dein Modul testen. Leider komme ich bei der Konfiguration nicht sehr weit: Beim ersten Öffnen des Konfigurators kommt folgende Fehlermeldung:

Konnte Konfigurationsform nicht laden
Warning: foreach() argument must be of type array|object, null given in C:\ProgramData\Symcon\modules\.store\de.nall.chan.portainer\Portainer Configurator\module.php on line 85
{"actions":[{"type":"Configurator","name":"Configurator","add":false,"delete":true,"sort":{"column":"name","direction":"ascending"},"columns":[{"caption":"Id","name":"id","width":"80px"},{"caption":"Type","name":"type","width":"200px"},{"caption":"Name","name":"name","width":"auto"}],"values":[{"id":3,"expanded":true,"type":"Environment","name":"local","instanceID":0,"create":{"moduleID":"{80544234-7E77-8F76-8376-D6C285B58443}","configuration":{"EnvironmentId":3,"Interval":5}}},{"id":1,"parent":3,"type":"Stack","name":"zigbee2mqtt","instanceID":0,"create":{"moduleID":"{B4110D02-0282-F7F6-363C-906280A3510A}","location":["local"],"configuration":{"EnvironmentId":3,"StackId":1,"Interval":5}}}]},{"type":"Label","caption":"This module is free for non-commercial use,\r\nDonations in support of the author are accepted here:"},{"type":"RowLayout","items":[{"type":"Image","onClick":"echo 'https:\/\/paypal.me\/Nall4chan';","image":"data:image\/png;base64,..."},{"type":"Image","onClick":"echo 'https:\/\/www.amazon.de\/hz\/wishlist\/ls\/YU4AI9AQT9F?ref_=wl_share';","image":"data:image\/png;base64,..."}]}]} (Code: -32603)

Die I/O-Instanz scheint ok zu sein („Connected“).

Neuinstallation zeigt keine Änderung. Was kann ich hier tun? Danke…

@doctee Ich konnte das Modul auch ohne Konfigurator installieren. Läuft sauber und erlaubt mir Symcon aus Symcon heraus neu zu starten (Zertifikats Wechsel)