La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Kit de développement logiciel NetApp Astra Control Python

Contributeurs

Le kit de développement logiciel NetApp Astra Control Python est un logiciel open source qui permet d’automatiser le déploiement d’Astra Control. Il constitue également une ressource précieuse pour en savoir plus sur l’API REST Astra Control, peut-être dans le cadre de la création de votre propre plateforme d’automatisation.

Note Dans un souci de simplicité, le kit de développement NetApp Astra Control Python sera appelé SDK au cours du reste de cette page.

Deux outils logiciels connexes

Le SDK inclut deux outils différents bien que associés qui fonctionnent à différents niveaux d’abstraction lors de l’accès à l’API REST Astra Control.

Kit de développement Astra

Le kit de développement logiciel Astra fournit les principales fonctionnalités de la plateforme. Il inclut un ensemble de classes Python qui abstraite les appels de l’API REST sous-jacente. Ces classes prennent en charge les actions administratives sur diverses ressources Astra Control, notamment les applications, les sauvegardes, les instantanés et les clusters.

Le kit de développement Astra fait partie de l’offre et est fourni en une seule pièce astraSDK.py fichier. Vous pouvez importer ce fichier dans votre environnement et utiliser les classes directement.

Note Le SDK Python de contrôle Astra (ou uniquement SDK) de NetApp est le nom de l’ensemble du package. Le Astra SDK fait référence aux classes Python de base dans le fichier unique astraSDK.py.
Script Toolkit

En plus du fichier Astra SDK, le toolkit.py script également disponible. Ce script fonctionne à un niveau d’abstraction plus élevé en donnant accès à des actions administratives discrètes définies en interne comme des fonctions Python. Le script importe le SDK Astra et fait des appels aux classes selon les besoins.

Comment y accéder

Vous pouvez accéder au SDK de la manière suivante.

Pack Python

Le SDK est disponible à l’adresse "Index des paquets Python" sous le nom actoolkit. Un numéro de version est attribué au package et continuera d’être mis à jour au besoin. Vous devez utiliser l’utilitaire de gestion de paquets PIP pour installer le package dans votre environnement.

Une fois installé, les astraSDK.py classes peuvent être utilisées en plaçant import astraSDK dans vos scripts. En outre, actoolkit peut être appelé directement sur votre invite de commande et équivaut à toolkit.py (actoolkit list clusters est identique à ./toolkit.py list clusters).

Code source GitHub

Le code source du SDK est également disponible sur GitHub. Le référentiel inclut les éléments suivants :

  • astraSDK.py (SDK Astra avec classes Python)

  • toolkit.py (script basé sur les fonctions de niveau supérieur)

  • Conditions requises et instructions détaillées pour l’installation

  • Scripts d’installation

  • Documentation complémentaire

Vous pouvez cloner le "GitHub : kits NetApp/netapp-astra-toolkits" référentiel pour votre environnement local.

Conditions requises pour l’installation et de base

Il y a plusieurs options et conditions requises à considérer dans le cadre de l’installation de l’emballage et de la préparation à l’utilisation.

Résumé des options d’installation

Vous pouvez installer le SDK de l’une des manières suivantes :

  • Utilisez le préparé "Docker : kits de ressources NetApp/astra" image, avec toutes les dépendances nécessaires installées, y compris actoolkit

  • Utiliser le PIP pour installer le actoolkit Package de PyPI dans votre environnement Python

  • Clonez le référentiel GitHub et copiez/modifiez les deux fichiers Python de base afin qu’ils soient accessibles à votre code client Python

Reportez-vous aux pages PyPI et GitHub pour plus d’informations.

Exigences relatives à l’environnement Astra Control

Qu’il s’agisse d’utiliser directement les classes Python du SDK Astra ou des fonctions du toolkit.py À terme, vous accéderez à l’API REST lors d’un déploiement d’Astra Control. Vous aurez donc besoin d’un compte Astra et d’un jeton API. Voir "Avant de commencer" Et les autres pages de la section Get Started de cette documentation pour plus d’informations.

Exigences relatives au kit de développement logiciel NetApp Astra Control Python

Le SDK a plusieurs conditions préalables liées à l’environnement Python local. Par exemple, vous devez utiliser Python 3.8 ou ultérieur. En outre, plusieurs paquets Python sont requis. Pour plus d’informations, consultez la page de référentiel GitHub ou la page de package PyPI.