Session Aruba : L’industrialisation est devenue une clé dans la compétitivité et la rentabilité des entreprises. Ce constat est aussi valable pour les infrastructures informatiques, qui plus est déportées et virtualisées. Aruba met à disposition de ses clients des jeux d’API et drivers leur permettant de procéder à une intégration en profondeur des infrastructures dans le SI, pouvant même être multi-fournisseurs. Lors de cet atelier, nous nous attacherons à présenter nos principales API ainsi que le driver DeltaCloud, comment s’en servir et ainsi tirer la quintessence d’une infrastructure agile.

1. ArubaCloud
API & WebServices

2. Plusieurs API
●WsCommon
●WsCloudStorage
●WsDomains
●WsDns
●WsEndUser
●WsLicense
●WsMonitoring
●Object Storage S3
SOAP REST

3. Repères
●Base de tous les outils Aruba
○Toujours à jour
○100% des fonctionnalités
●Nouvelles versions regulières
○Version actuelle : 2.8
●Retro compatibilité avec les 3 dernières versions

4. WsCommon
●GetUserAuthenticationToken
●GetUserInfo
●DeactivateUserOtp
●GetCredit
●GetPriceList
●...
17 méthodes disponibles
relatives:
-à l’authentification utilisateur et système OTP (One Time Password)
-aux permissions de visibilité et d’utilisation des différents services et actions
-au crédit
-aux informations sur les Datacenters
-aux Price Lists
-à différents services annexes (News, Produits et services personnalisés, …)
Exemples:

5. WsCommon.GetCredit()
OverdraftLimit 0
Value 550.32530000
Paramètres: aucun
Retour:
-> Pas de découvert autorisé (OverdraftLimit)
-> Le crédit actuel est 550,32 Euros.

6. WsCloudStorage
17 méthodes disponibles
Relatives à l’administration du services Cloud Object Storage: gestion utilisateurs et plans tarifaires,
informations générales.
L’utilisation effective du service (accès aux buckets et fichiers) se fait avec l’API Object Storage S3
Exemples:
●GetCloudStorageAccounts
●GetCloudStoragePricingTypes
●GetRegions
●SetCloudStorageAccountPassword
●SetCloudStorageAccountPricingType
●SetCreateCloudStorageAccount
...

7. SetCreateCloudStorageAccount()
Paramètres:
CloudStoragePricingTypeID Obtenu via GetCloudStoragePricingTypes() 10 (pack storage250)
OverLimitBehavior {Rate, Renew, Restrict, PayPerUse} (voir le XSD) Restrict
UserName Choix libre cos-compte001
PrivateKey Choix libre azerty123456789
RegionID Obtenu via GetRegions() 3 (r1-fr)
Type de retour:
booléen + message en cas d’erreurs

8. Le compte est disponible immédiatement sur le Control Panel

9. WsDomains
24 méthodes disponibles
Relatives à la gestion des noms de domaines: inventaire, vérification de disponibilité, achat, renouvellement, transfert,
choix des serveurs DNS….
Exemples:
●GetAllDomains
oListe les domaines associés au compte, leur statut, infos sur le TLD...
●GetAllDomainsCost
oCoûts effectifs des domaines et des services et actions associés
●GetDomainDetails
oAjoute des détails comparé à GetAllDomains(): AuthCodes, contacts, DNS
●GetIsAvailableDomainName
oListe les extensions disponible pour le nom de domaine demandé, avec les détails sur le TLD.
●SetDomainAutoRenew
oActive l’auto renouvellement pour le domaine spécifié.
●SetDomainNameServers
oDéfinie la valeur des serveurs DNS
...

10. GetIsAvailableDomainName()
Paramètres:
DomainFullName nom du domaine désiré (avec TLD) workshoparuba-techdays2015.com
Type de retour:
Liste détaillée des extensions disponibles
DomainFullName workshoparuba-
techdays2015.com
SecondLevelDomain workshoparuba-techdays2015
AuthCodeRequired true
DnsMaxQuantity 13
DomainPrivacyAvailab
le
true
... ...
IsAvailable True
DomainFullName workshoparuba-techdays2015.org
SecondLevelDomain workshoparuba-techdays2015
AuthCodeRequired true
DnsMaxQuantity 13
DomainPrivacyAvailable true
... ...
IsAvailable True
{...}

11. WsDns
14 méthodes disponibles
Relatives au paramétrage des serveurs DNS (Aruba ou externes)
Exemples:
●GetAllDNS
oListe les services DNS associés au compte
●GetDNSRecords
oListes les enregistrements DNS des domaines associés au compte
●GetPurchasedDNS
oListe les serveurs DNS actifs pour chaque domaine associé au compte
●SetDnsRecords
oAjout d’entrée(s) DNS
...

12. SetDnsRecords()
Paramètres:
DNSRecord(s). Plusieurs peuvent être envoyés en même temps pour un même Service DNS.
Content Valeur de l’entrée 185.8.48.77
Name Nom de l’entrée techdays2015.arubafr-test1.com
Priority Priority de L’entrée 0
RecordType A, MX, NS, SPF, TXT… voir le XSD A
TTL Valeur de TTL en secondes 3600
DNSServiceID Obtenu via GetAllDNS() 22 (arubafr-test1)
Type de retour:
booléen + JobID

13. L’entrée apparait au niveau du Control Panel

14. WsEndUser
114 méthodes disponibles
Correspond aux fonctionnalité globale du Panneau de Contrôle Aruba, et également aux services de Cloud Computing
publiques et privés, et les fonctionnalités associées: FTP, Tâches planifiées, Unified Storage, Templates etc...
Exemples:
●GetHypervisors
oListe les hyperviseurs disponibles et leur déclinaison (ex. Pro vs Smart)
●GetLoadBalancers
oListe les services de LoadBalancing associés au compte
●GetPuchasedPrivateClouds
oListes les Clouds Privés associés au compte
●GetServers
oListe les VM définies sur le compte, avec specifications détaillées
●SetEnqueueServerStop
oLance une commande d’arrêt d’une VM*
●SetEnqueueServerCreation
oPermet de créer un VM, avec plus ou moins de détails fournis.
...

15. SetEnqueueServerCreation()
Paramètres:
Ne sont présentés ici que les paramètres essentiels. Peuvent également être spécifiés des Virtual
Switch, des disque dur multiples, des commentaires etc...
AdministratorPassword Mot de passe administrateur xxxxxxxxxxxxxxxxx
CPUQuantity Nombre de vCPU 2
Name Priority de L’entrée serveur-workshop01
NetworkAdaptersConfiguratio
n
Si non spécifié: IP publique sur Ethernet0
OSTemplateId Obtenu via GetHypervisors() 30 (Windows 2012 64bit - HyperV LC)
RAMQuantity En GB 4
VirtualDisks.Size Taille en GB 40
VirtualDisks.VirtualDiskType Disque principal ou secondaire PrimaryVirtualDisk

16. Vm en cours de création (logs) et une fois la création terminée (Control Panel)

17. WsLicense
4 méthodes disponibles
Gestion des licences logicielles.
Exemples:
●GetAvailableLicenses
oListe les licences disponibles
●GetPurchasedLicenses
oListe les licences achetées associées au compte
●SetEnqueuePurchasePleskLicense
oAcheter une licence Plesk
●SetRemoveLicense
oSupprimer une licence

18. GetPurchasedLicenses()
Paramètres: aucun
Retour:
Listes de licences, par exemples des PleskLicense telles que:
CreationDate 2014-11-07 12:21:58.627
LicenseCode PLSK.0XXXXXXXXXXX.0000
LicenseDescription Plesk Panel - 10 Domains - Linux
LicenseID 165
LicenseKey xxxxxxxxxxxxxxxxxxx
... ...
LicenseStatus Active

19. WsMonitoring
25 méthodes disponibles
Correspond à la gestion du service Cloud Monitoring
Exemples:
●GetMonitoringCheckType
oListe les types de services monitorables (HTTP, DNS, SQL, SSL etc…)
●GetMonitoringServicesChecks
oListe les sondes de services avec leur détails
●SetActivateMonitoringService
oActive un service de monitoring
...

20. GetMonitoringServiceChecks()
Paramètres: aucun
Retour:
Listes services de monitoring avec détails (nombreux), tels que:
CreationDate 2013-07-23 11:55:23.54
MonitoringServiceID 91
DataCenterID 1001 (voir wsEndUser)
MonitoringServiceStatus Active
Name MonitoringTest03
MonitoringCheckDetails.Name Ping-Host
MonitoringCheckType Active

21. Cloud Object Storage S3
●Compatible Amazon S3 et la plupart des outils et bibliothèques tierces
●Packs mensuels ou Pay-as-you-go
●Dans les deux cas : trafic entrant et requêtes non payantes
●Résilience: chaque fichier est copié sur 3 serveurs différents
●Gestion multi-comptes
●Présence sur 6 Datacenters Européens

22. Création d’un bucket ‘workshop01’, avec CURL
bucket="workshop01"
resource="/${bucket}/"
contentType="application/octet-stream"
dateValue=`date -Ru`
stringToSign="PUTnn${contentType}n${dateValue}n${resource}"
s3Key=MIDA-FROS1
s3Secret=XXXXXXXXXXXXXXXXXXXXX
signature=`echo -en ${stringToSign} | openssl sha1 -hmac ${s3Secret} -binary | base64`
curl -X PUT -T "/"
-H "Host:${bucket}.r1-fr.storage.arubacloud.fr"
-H "Content-Length:0"
-H "Content-Type:application/octet-stream"
-H "Date:${dateValue}"
-H "Authorization:AWS ${s3Key}:${signature}"
https://${bucket}.r1-fr.storage.arubacloud.fr:443

23. Le bucket ‘workshop01’ est maintenant visible (ici dans Dragondisk)

24. Upload d’un fichier vers le bucket ‘workshop01’, avec CURL
file=fic1.txt
bucket="workshop01"
resource="/${bucket}/${file}"
contentType="text/plain"
dateValue=`date -Ru`
stringToSign="PUTnn${contentType}n${dateValue}n${resource}"
s3Key=MIDA-FROS1
s3Secret=XXXXXXXXXXXXXXXXXXXXX
signature=`echo -en ${stringToSign} | openssl sha1 -hmac ${s3Secret} -binary | base64`
curl -X PUT -T "${file}"
-H "Host: ${bucket}.r1-fr.storage.arubacloud.fr"
-H "Date: ${dateValue}"
-H "Content-Type: ${contentType}"
-H "Authorization: AWS ${s3Key}:${signature}"
https://${bucket}.r1-fr.storage.arubacloud.fr/${file}

25. Le fichier est maintenant visible (ici dans Dragondisk)

26. Lister les buckets Object Storage via une instance Deltacloud
curl -v --user "USERNAME:PASSWORD" "http://IP_DELTACLOUD:3001/api/buckets?format=xml"
<?xml version='1.0' encoding='utf-8' ?>
<buckets>
<bucket href='http://IP_DELTACLOUD:3001/api/buckets/workshop01' id='workshop01'>
<name>workshop01</name>
</bucket>
{...}
<bucket href='http://IP_DELTACLOUD:3001/api/buckets/workshop04' id='workshop04'>
<name>workshop04</name>
</bucket>
</buckets>

27. Références & Liens
●KB Aruba http://assistance.arubacloud.fr/KB/browse.aspx
●Homepage Arubacloud http://www.arubacloud.fr/
●Le Blog Arubacloud http://www.arubacloud-leblog.com/
●WS-SE http://www.oasis-open.org/committees/wss/documents/WSS-Username-02-0223-merged.pdf
TODO: ajouter liens site web, KB etc...