Utilização do SDK vSphere
Utilização e implementação do SDK vSphere
Última atualização: 11/08/2020
Objetivo
É possível automatizar as ações na sua infraestrutura utilizando o SDK vSphere.
Este manual explica a implementação e a utilização em diferentes linguagens.
Instruções
Python
Implementação do ambiente
OS
Aqui, iremos utilizar uma VM instalada em Debian 9, implementada através dos templates disponibilizados no seu Hosted Private Cloud.
Requisitos
É necessário instalar os seguintes packs:
apt-get install python git python-pip
SDK vSphere
Descarregue o SDK vSphere com o seguinte comando:
git clone https://github.com/vmware/vsphere-automation-sdk-python.git
O diretório “/vsphere-automation-sdk-python” será criado. Aceda a esta pasta para efetuar o seguinte comando de instalação:
pip install --upgrade --force-reinstall -r requirements.txt --extra-index-url file:///<absolute_path_to_sdk>/lib
Neste exemplo, será o seguinte comando:
pip install --upgrade --force-reinstall -r requirements.txt --extra-index-url file:///root/vsphere-automation-sdk-python/lib
O SDK já está instalado e é possível realizar alguns scripts.
Exemplo de script
Ligação
Neste primeiro exemplo, testamos a ligação e a desconexão ao vCenter. Isto permitirá também ver se a instalação foi bem-sucedida:
#!/usr/bin/env python
import time
import atexit
import ssl
from pyVim import connect
from pyVmomi import vim
def vconnect():
s = ssl.SSLContext(ssl.PROTOCOL_TLS)
s.verify_mode = ssl.CERT_NONE
service_instance = connect.SmartConnect(host="pcc-149-202-xxx-xxx.ovh.com",
user="damien",
pwd="MyPassword",
sslContext=s)
atexit.register(connect.Disconnect, service_instance)
print("Connecting....")
time.sleep(2)
print("Disconnecting..")
vconnect()
Listar as VM presentes num Hosted Private Cloud
Neste exemplo, iremos listar todas as VM presentes no Hosted Private Cloud:
#!/usr/bin/env python
import time
import atexit
import ssl
from pyVim import connect
from pyVmomi import vim
def vconnect():
s = ssl.SSLContext(ssl.PROTOCOL_TLS)
s.verify_mode = ssl.CERT_NONE
service_instance = connect.SmartConnect(host="pcc-149-202-xxx-xxx.ovh.com",
user="damien",
pwd="MyPassword",
sslContext=s)
atexit.register(connect.Disconnect, service_instance)
print("Connecting....")
time.sleep(2)
content = service_instance.RetrieveContent()
container = content.rootFolder
viewType = [vim.VirtualMachine]
recursive = True
containerView = content.viewManager.CreateContainerView(container, viewType, recursive)
children = containerView.view
for child in children:
summary = child.summary
print(summary.config.name)
time.sleep(2)
print("Disconnecting...")
vconnect()
Perl
Implementação do ambiente
OS
Aqui, iremos utilizar uma VM instalada em Ubuntu 18.04, implementada através dos templates disponibilizados no seu Hosted Private Cloud.
Requisitos
É necessário instalar os seguintes packs:
apt-get install lib32z1 lib32ncurses5 uuid uuid-dev libssl-dev perl-doc libxml-libxml-perl libcrypt-ssleay-perl libsoap-lite-perl libdata-compare-perl libmodule-build-perl libuuid-perl libsocket6-perl libnet-inet6glue-perl libarchive-zip-perl
cpan install Crypt::OpenSSL::RSA UUID::Random Exception::Class Crypt::X509 List::MoreUtils
SDK vSphere
Descarregue o SDK vSphere disponível nesta ligação:
https://my.vmware.com/group/vmware/get-download?downloadGroup=VS-PERL-SDK67
Descarregue a versão compatível com o seu sistema operativo.
Neste exemplo, iremos descarregar o "VMware-vSphere-Perl-SDK-6.7.0-8156551.x86_64.tar.gz".
Descomprima o ficheiro que acabou de descarregar através do comando:
tar –zxvf VMware-vSphere-Perl-SDK-6.7.0-8156551.x86_64.tar.gz
Inicie o instalador utilizando o seguinte comando:
cd vmware-vsphere-cli-distrib
A partir daí:
./vmware-install.pl
Após ter lido as condições, aceite-as e continue clicando em Enter.
Após a instalação, outros módulos serão instalados. Clique em Enter para continuar a instalação.
Para terminar a instalação, deve escolher um diretório no qual o SDK será instalado. Por predefinição, o diretório é “/usr/bin”.
Exemplo de script
Ligação
Neste primeiro exemplo, testamos a ligação e a desconexão ao vCenter. Isto permitirá também ver se a instalação foi bem-sucedida:
#!/usr/bin/perl
use strict;
use VMware::VIRuntime;
Opts::set_option('server', 'pcc-149-202-xxx-xxx.ovh.com');
Opts::set_option('username', 'damien');
Opts::set_option('password', 'MyPassword')
print "Connecting \n";
Util::connect();
Util::disconnect();
print "Disconnected \n";
Listar as VM presentes num Hosted Private Cloud
Neste exemplo, iremos listar todas as VM presentes no Hosted Private Cloud:
#!/usr/bin/perl
use strict;
use Data::Dumper;
use VMware::VIRuntime;
Opts::set_option('server', 'pcc-149-202-xxx-xxx.ovh.com');
Opts::set_option('username', 'damien');
Opts::set_option('password', 'MyPassword');
print "Connecting \n";
Util::connect();
my $vm_views =
Vim::find_entity_views(view_type => 'VirtualMachine',
properties => ['name'], );
foreach my $view ( sort @$vm_views) {
print ' - '.$view->{'name'}, "\n";
}
Util::disconnect();
print "Disconnected \n";
Utilização das amostras
Neste exemplo, iremos utilizar um script já criado e presente no diretório “vmware-vsphere-cli-distrib/apps/vm/”.
Esta é a lista dos scripts disponíveis neste diretório:
ls vmware-vsphere-cli-distrib/apps/vm/
guestinfo.pl sharesmanager.pl snapshotmanager.pl vdiskcreate.pl vmclone.pl vmcontrol.pl vmcreate.pl vminfo.pl vmmigrate.pl vmreconfig.pl vmregister.pl vmsnapshot.pl vmtemplate.pl
Iremos criar uma snapshot “test” na VM “Debian1”.
Para o fazer, utilize o seguinte comando:
perl snapshotmanager.pl --server pcc-149-202-xxx-xxx.ovh.com --username damien --password MyPassword --operation create --vmname Debian1 --snapshotname test
Quer saber mais?
Fale com a nossa comunidade de utilizadores em https://community.ovh.com.
Esta documentação foi-lhe útil?
Não hesite em propor-nos sugestões de melhoria para fazer evoluir este manual.
Imagens, conteúdo, estrutura... Não hesite em dizer-nos porquê para evoluirmos em conjunto!
Os seus pedidos de assistência não serão tratados através deste formulário. Para isso, utilize o formulário "Criar um ticket" .
Obrigado. A sua mensagem foi recebida com sucesso.