staging.inyokaproject.org

Rechnungstore schrieb:

Allerdings bin ich damit noch nicht am Ende. In Zeile 6 steht:

1	cli = Client(base_url='unix://var/run/docker.sock')

Wird hier einfach eine Variable mit dem Ergebnis der Funktion Client belegt oder wird eine Instanz der Klasse Client erzeugt??

Aus dem Code selbst kannst du nur erkennen, dass ein Objekt zurückgegeben wird (praktisch alles in Python ist ein Objekt), das anhand des weiteren Codes einige Attribute (wie containters und die Methode start()) hat.

Um das selber zu ergründen, habe ich versucht den Quelltext des entsprechenden Moduls zu untersuchen. Am Anfang des Scriptes steht folgende Zeile:

1	from docker import Client

Nur leider gelingt es mir nicht, ein Modul namens "docker" mit einer Funktion oder Klasse "Client" zu finden.

Ich vermute, dass auf dem Server eine ca. 3 Jahre alte Version von docker-py läuft, die Klasse Client wurde laut docker/docker-py/commit/f5ac10c469fca252e69ae780749f4ec6fe369789 zu DockerClient umbenannt.

@seahawk1968

Ich vermute, dass auf dem Server eine ca. 3 Jahre alte Version von docker-py läuft

Wenn docker-py Bestandteil des Pakets python3-docker ist, dann auf jeden Fall.

Ich versuche gerade mittels find eine Datei namens docker.py oder docker-py zu finden. Leider bislang ohne Erfolg. Gibt es denn keine funktionierende Möglichkeit herauszufinden, in welcher Datei die Klasse Client definiert ist (sofern es denn eine Klasse ist)??

Rechnungstore schrieb:

Wenn docker-py Bestandteil des Pakets python3-docker ist, dann auf jeden Fall.

Wenn man sich die Copyright-Datei für das Paket python3-docker ansieht, sieht man, dass das in der Tat das Git-Repository für docker-py als Quelle hat: http://changelogs.ubuntu.com/changelogs/pool/universe/p/python-docker/python-docker_1.8.0-0ubuntu1/copyright

Ich versuche gerade mittels find eine Datei namens docker.py oder docker-py zu finden. Leider bislang ohne Erfolg.

Python bietet einige Besonderheiten, was die Möglichkeiten zur Namensauflösung in Modulen angeht. Du gehst vom einfachsten Fall aus, dass alles in einer Datei steckt. Module können aber auch Verzeichnisstrukturen haben - die Klasse Client aus dem Paket ist in /usr/lib/python3/dist-packages/docker/client.py definiert. Warum man sie über from docker import Client nutzbar machen kann und nicht nur über from docker.client import Client, ist dann die nächste Frage, die man sich stellen sollte - die Antwort darauf findet man in https://docs.python.org/3/tutorial/modules.html#packages - das Modul enthält eine /usr/lib/python3/dist-packages/docker/__init__.py mit der Zeile

1

from .client import Client, AutoVersionClient, from_env # flake8: noqa

Dadurch wird Client direkt über den docker Namespace erreichbar.

Gibt es denn keine funktionierende Möglichkeit herauszufinden, in welcher Datei die Klasse Client definiert ist (sofern es denn eine Klasse ist)??

Importierte Module haben Attribute, die dabei helfen können - siehe https://docs.python.org/3/reference/import.html#import-related-module-attributes:

1
2
3

>>> import docker
>>> docker.__file__
'/usr/lib/python3/dist-packages/docker/__init__.py'

Alternativ kann man auch das Modul importlib bemühen:

1
2
3

>>> import importlib
>>> importlib.find_loader('docker').get_filename()
'/usr/lib/python3/dist-packages/docker/__init__.py'

Dann schaut man sich /usr/lib/python3/dist-packages/docker/__init__.py an, und kann sehen, dass Client aus .client stammt, also muss man in die Datei /usr/lib/python3/dist-packages/docker/client.py schauen.

Hallo,

ich habe mich hier länger nicht mehr gemeldet, da ich sehr viel um die Ohren hatte. Aber so ganz ist das Mysterium um das Python-Script leider noch nicht gelöst:

Importierte Module haben Attribute, die dabei helfen können - siehe https://docs.python.org/3/reference/import.html#import-related-module-attributes:

Danke! Genau so etwas habe ich gesucht.

Dann schaut man sich /usr/lib/python3/dist-packages/docker/init.py an, und kann sehen, dass Client aus .client stammt, also muss man in die Datei /usr/lib/python3/dist-packages/docker/client.py schauen.

hmm, irgendwie nicht. Es gibt in /usr/lib/python3/dist-packages/docker/client.py nur eine Klasse namens DockerClient. Diese enthält aber keine Methode start oder close, die ja in den Zeilen 13,17 und 18 aufgerufen werden.

Rechnungstore schrieb:

hmm, irgendwie nicht. Es gibt in /usr/lib/python3/dist-packages/docker/client.py nur eine Klasse namens DockerClient. Diese enthält aber keine Methode start oder close, die ja in den Zeilen 13,17 und 18 aufgerufen werden.

Die Klasse Client bekommt in dieser alten Version der Bibliothek über eine Mehrfachvererbung ("multiple inheritance") Eigenschaften von einer Reihe anderer Klassen (die gemäß der MRO (Method Resolution Order) aufgelöst werden würden, falls sie in mehreren Klassen definiert wären):

1
2
3
4
5
6
7
8
9

class Client(
        requests.Session,
        api.BuildApiMixin,
        api.ContainerApiMixin,
        api.DaemonApiMixin,
        api.ExecApiMixin,
        api.ImageApiMixin,
        api.VolumeApiMixin,
        api.NetworkApiMixin):

Und in api/container.py steckt die Klasse ContainerApiMixin, die die start-Methode enthält.

Aber wo genau befindet sich denn die Klasse Client?

1
2

root@servernamegeändert:~# grep -r "class Client" /usr/lib/python3/ 
/usr/lib/python3/dist-packages/fail2ban/tests/sockettestcase.py:class ClientMisc(LogCaptureTestCase):

Rechnungstore schrieb:

Hallo Zusammen,

ich bin absoluter Beginner bezüglich Python und muss leider folgenden Codeblock, den ich in einem Script auf einem Server in unsere Firma gefunden habe verstehen:

1 2 3 4 5 6

def start_containers(): """ starting all containers. starts mysql56 container first :return: """ cli = Client(base_url='unix://var/run/docker.sock')

Rechnungstore schrieb:

hmm, irgendwie nicht. Es gibt in /usr/lib/python3/dist-packages/docker/client.py nur eine Klasse namens DockerClient. Diese enthält aber keine Methode start oder close, die ja in den Zeilen 13,17 und 18 aufgerufen werden.

Rechnungstore schrieb:

Aber wo genau befindet sich denn die Klasse Client?

Entweder du hast im initialen Post etwas wichtiges unterschlagen (z.B. wie Client importiert wird) oder musst da zwischendrin einen Versionssprung gemacht haben (eventuell das xenial-System mit etwas modernerem verwechselt?)...

Welche Version der Bibliothek hast du genau (müsste in der /usr/lib/python3/dist-packages/docker/version.py stehen)? Ich habe mir gerade den Inhalt von python3-docker_1.8.0-0ubuntu1_all.deb und python3-docker_1.9.0-1_16.04.1_all.deb angeschaut, die laut https://packages.ubuntu.com/xenial/python3-docker bzw. https://packages.ubuntu.com/xenial-updates/python3-docker die erwarteten Quellen für die installierten Pakete wären - und da heißt die Klasse in der client.py noch Client, in späteren Versionen wurde sie zu DockerClient umbenannt.