O NetApp já está disponível
O NetApp é um pacote de código aberto que você pode usar para automatizar uma implantação do Astra Control. O pacote também é um recurso valioso para aprender sobre a API REST do Astra Control, talvez como parte da criação de sua própria plataforma de automação.
Para simplificar, o SDK do NetApp será referido como o SDK ao longo do restante desta página. |
Duas ferramentas de software relacionadas
O SDK inclui duas ferramentas diferentes, embora relacionadas, que operam em diferentes níveis de abstração ao acessar a API REST do Astra Control.
O Astra SDK fornece a funcionalidade principal da plataforma. Ele inclui um conjunto de classes Python que abstraem as chamadas de API REST subjacentes. As classes dão suporte a ações administrativas em vários recursos do Astra Control, incluindo aplicações, backups, snapshots e clusters.
O Astra SDK é uma parte do pacote e é fornecido em um único astraSDK.py
arquivo. Você pode importar esse arquivo para o seu ambiente e usar as classes diretamente.
O NetApp é o nome de todo o pacote. O *Astra SDK refere-se às classes Python principais no único arquivo astraSDK.py .
|
Além do arquivo Astra SDK, o toolkit.py
script também está disponível. Este script opera em um nível mais alto de abstração, fornecendo acesso a ações administrativas discretas definidas internamente como funções Python. O script importa o Astra SDK e faz chamadas para as classes conforme necessário.
Como aceder
Você pode acessar o SDK das seguintes maneiras.
O SDK está disponível em "Índice do Pacote Python" sob o nome NetApp-astra-toolkits. O pacote recebe um número de versão e continuará a ser atualizado conforme necessário. Você deve usar o utilitário de gerenciamento de pacotes PIP para instalar o pacote em seu ambiente.
Consulte "PyPI: NetApp é um dos nossos selecionados Jogos de Plataforma" para obter mais informações.
O código-fonte do SDK também está disponível no GitHub. O repositório inclui o seguinte:
-
astraSDK.py
(Astra SDK com classes Python) -
toolkit.py
(script baseado em funções de nível superior) -
Requisitos e instruções de instalação detalhadas
-
Scripts de instalação
-
Documentação adicional
Você pode clonar o "GitHub: NetApp/NetApp-astra-toolkits" repositório para o seu ambiente local.
Instalação e requisitos básicos
Existem várias opções e requisitos a considerar como parte da instalação do pacote e preparação para usá-lo.
Você pode instalar o SDK de uma das seguintes maneiras:
-
Use o PIP para instalar o pacote do PyPI em seu ambiente Python
-
Clone o repositório do Git Hub e:
-
Implantar o pacote como um contentor Docker (que inclui tudo o que você precisa)
-
Copie os dois principais arquivos Python para que eles estejam acessíveis ao seu código de cliente Python
-
Consulte as páginas PyPI e GitHub para obter mais informações.
Seja usando diretamente as classes Python no Astra SDK ou as funções no toolkit.py
script, você estará acessando a API REST em uma implantação do Astra Control. Por causa disso, você precisará de uma conta Astra juntamente com um token de API. Consulte "Antes de começar" e as outras páginas na seção Introdução desta documentação para obter mais informações.
O SDK tem vários pré-requisitos relacionados ao ambiente Python local. Por exemplo, você deve usar Python 3,5 ou posterior. Além disso, existem vários pacotes Python que são necessários. Consulte a página do repositório do GitHub ou a página do pacote PyPI para obter mais informações.
Resumo dos recursos úteis
Aqui está um resumo dos recursos que você precisará para começar.