NetApp Astra Control Python SDK
Änderungen vorschlagen
PDFs
NetApp Astra Control Python SDK ist ein Open-Source-Paket, mit dem Sie eine Astra Control Implementierung automatisieren können. Das Paket ist auch eine wertvolle Ressource, um sich über die Astra Control REST API zu informieren, vielleicht im Rahmen der Erstellung Ihrer eigenen Automatisierungsplattform.
|
Zur Einfachheit wird das NetApp Astra Control Python SDK durchgehend auf dieser Seite als SDK bezeichnet. |
Zwei verwandte Softwaretools
Das SDK enthält zwei verschiedene, wenn auch verwandte Tools, die auf verschiedenen Ebenen der Abstraktion beim Zugriff auf die Astra Control REST API arbeiten.
Das Astra SDK bietet die Kernfunktionen der Plattform. Es enthält eine Reihe von Python-Klassen, in denen die zugrunde liegenden REST-API-Aufrufe abstrahiert werden. Die Klassen unterstützen administrative Aktionen auf verschiedenen Astra Control Ressourcen, einschließlich Apps, Backups, Snapshots und Cluster.
Das Astra SDK ist ein Teil des Pakets und wird in der Single bereitgestellt astraSDK.py Datei: Sie können diese Datei in Ihre Umgebung importieren und die Klassen direkt verwenden.
|
|
Das NetApp Astra Control Python SDK (oder nur SDK) ist der Name des gesamten Pakets. Das Astra SDK bezieht sich auf die Core Python Klassen in der einzelnen Datei astraSDK.py.
|
Neben der Astra SDK-Datei, die toolkit.py Skript ist ebenfalls verfügbar. Dieses Skript wird auf einer höheren Abstraktionsebene ausgeführt und bietet Zugriff auf diskrete, intern als Python-Funktionen definierte administrative Aktionen. Das Skript importiert das Astra SDK und ruft nach Bedarf die Klassen an.
Zugang zu
Sie haben folgende Möglichkeiten, auf das SDK zuzugreifen:
Das SDK ist unter verfügbar "Python-Paketindex" Unter dem Namen acToolkit. Dem Paket wird eine Versionsnummer zugewiesen und bei Bedarf auch weiterhin aktualisiert. Sie müssen das Paketverwaltungsprogramm * PIP* verwenden, um das Paket in Ihrer Umgebung zu installieren.
Nach der Installation können die astraSDK.py Klassen durch Platzieren genutzt werden import astraSDK In Ihren Skripten. Darüber Hinaus actoolkit Kann direkt an Ihrer Eingabeaufforderung aufgerufen werden und entspricht toolkit.py (actoolkit list clusters Ist das gleiche wie ./toolkit.py list clusters).
Siehe "PyPI: NetApp Astra Control Python SDK" Finden Sie weitere Informationen.
Der SDK-Quellcode ist auch bei GitHub erhältlich. Das Repository umfasst Folgendes:
-
astraSDK.py(Astra SDK mit Python-Klassen) -
toolkit.py(Auf höherer Ebene funktionbasiertes Skript) -
Detaillierte Installationsanforderungen und Anweisungen
-
Installationsskripte
-
Zusätzliche Dokumentation
Sie können die klonen "GitHub: NetApp/netapp-astra-Toolkits" Repository in Ihre lokale Umgebung einbinden
Installation und grundlegende Anforderungen
Es gibt verschiedene Optionen und Anforderungen, die bei der Installation des Pakets und bei der Vorbereitung der Verwendung berücksichtigt werden müssen.
Sie können das SDK auf eine der folgenden Arten installieren:
-
Verwenden Sie das vorbereitete "Docker: NetApp/astra-Toolkits" Image, das alle erforderlichen Abhängigkeiten installiert hat, einschließlich
actoolkit -
Verwenden Sie Pip, um den zu installieren
actoolkitPaket von PyPI in Ihre Python-Umgebung -
Klonen Sie das GitHub Repository und kopieren/ändern Sie die beiden Core Python-Dateien, damit sie für Ihren Python-Client-Code zugänglich sind
Weitere Informationen finden Sie auf den Seiten PyPI und GitHub.
Ob direkt die Python-Klassen im Astra SDK oder die Funktionen im toolkit.py Skript, schließlich sind Sie bei einer Implementierung von Astra Control auf DIE REST-API zugreifen. Aus diesem Grund benötigen Sie ein Astra-Konto zusammen mit einem API-Token. Siehe "Bevor Sie beginnen" Und die anderen Seiten im Abschnitt Get Started dieser Dokumentation für weitere Informationen.
Das SDK verfügt über mehrere Voraussetzungen für die lokale Python-Umgebung. Sie müssen beispielsweise Python 3.8 oder höher verwenden. Darüber hinaus sind mehrere Python-Pakete erforderlich. Weitere Informationen finden Sie auf der GitHub Repository-Seite oder auf der Seite des PyPI-Pakets.
Zusammenfassung hilfreicher Ressourcen
Im Folgenden finden Sie einige Ressourcen, die Sie für den Einstieg benötigen.