vagrant

Vagrant & Azure

Mickael Metesreau

• 3 min read

Vagrant est un outil dont l'ambition est d'en finir avec la ô combien célèbre phrase : "Mais ça marche sur ma machine". Il permet de construire de manière reproductible et portable des environnements de développement aussi simplement qu'en exécutant une ligne de commande :

$ vagrant up

Historiquement, Vagrant est un wrapper au dessus de VirtualBox. Cependant il ne doit pas être vue comme un simple moyen de gérer des machines virtuelles. En partant du constat que nos postes de développement ne sont jamais ISO prod (OS différents, multiple versions de runtime, etc), Vagrant va nous permettre de créer des environnements isolés reproduisant la production et donc de tester notre code dans des conditions d'exploitation réelles.

Voici à quoi ressemblerai une machine de développeur travaillant sur des stacks technologiques différentes :

Image

Ca semble sympa non ? Voyons comment l'utiliser avec Windows Azure.

Prérequis

Pour la suite de cet article, vous devez :

Vagrant Azure Provider & VagrantBox

Pour provisionner des machines sur Azure, il est nécessaire d'installer le plugin Vagrant Azure Provider.

Depuis un terminal, lançons la commande suivante :

$ vagrant plugin install vagrant-azure

Une fois le plugin installé, il faut créer ou installer une box. Dans le monde Vagrant, les box sont tout simplement des configurations d’environnement générique.

Afin de démarrer rapidement, installons la dummy box proposée par MsOpenTech :

$ vagrant box add azure https://github.com/msopentech/vagrant-azure/raw/master/dummy.box

Si vous souhaitez créer votre propre box, un exemple est disponible ici.

VagrantFile

Créons un fichier Vagrantfile décrivant notre environnement :

Vagrant.configure('2') do |config|
  config.vm.box = 'azure'
  config.vm.provider :azure do |azure|
    azure.vm_size = 'ExtraSmall'

    azure.mgmt_certificate = 'vagrantdemo.pem'
    azure.mgmt_endpoint = 'https://management.core.windows.net'
    azure.subscription_id = 'AZURE-SUBSCRIPTION-ID'

    azure.vm_image = 'a699494373c04fc0bc8f2bb1389d6106__Windows-Server-2012-R2-201411.01-en.us-127GB.vhd'
 
    azure.vm_user = 'mickael' 
    azure.vm_password = 'VagrantDemoP@ssw0rd' 

    azure.vm_name = 'vagrantdemo'

    azure.deployment_name = 'vagrantdemo'
    azure.vm_location = 'North Europe'

    azure.winrm_transport = [ 'http' ] 

    azure.tcp_endpoints = '80,3389:3390' 
  end

end

Ayant rencontré quelques problèmes lors de mes expérimentations, voici quelques points qu'il me semble intéressant de mentionner :

  • azure.subscription_id : Le subscription id est disponible via le portail Azure dans l'onglet Paramètre, Abonnement.

  • azure.vm_image : Les choix disponibles ne sont pas spécialement documentés... Un moyen simple de trouver le nom de l'image qui vous intéresse est d'utiliser les Cmdlets Azure comme Get-AzureVMImage.

  • azure.mgmt_certificate : Le SDK Azure Ruby sur lequel se repose Vagrant Azure est sensé supporter les certificats .pem et .pfx. Neanmoins due à un bug, vous devez utiliser un .pem. Pour cela, vous trouverez les lectures suivantes utiles : Créer un certificat de mangement pour Azure et Exporter un pfx en pem.

  • azure.vm_name : Je vous conseille de donner un nom en minuscule à votre VM ou vous vous exposerez à des erreurs assez peu parlantes... Cela provient d'un autre bug du SDK Azure Ruby reporté ici.

  • azure.vm_size : Quelques options possibles sont : ExtraSmall, Smal, Medium, Large, ExtraLarge, etc. Elles sont "documentées" ici.

  • azure.vm_location : Les options possibles sont West Europe, North Europe, Southeast Asia, East Asia, East US, West US et sont extraites de la source suivante.

Pour plus d'informations, l'ensemble des options de configurations sont disponibles ici.

Vagrant Up

Notre fichier de configuration terminé, on peut maintenant provisionner une machine avec la commande :

$ ls
      vagrantdemo.pem
      Vagrantfile

$ vagrant up --provider=azure

Image

Une fois, la commande terminée, nous nous retrouvons avec une nouvelle VM tourant sur Windows Azure.

Image

Il est alors possible de se connecter directement à la machine en RDP avec vagrant rdp ou bien de la détruire avec vagrant destroy.

Image

Image

Conclusion

Pour moi, Vagrant répond de manière simple aux besoins de partage, de reproductibilité et de versionning d'environnements. Même s'il est déjà possible de gérer ses VMs Azure depuis powershell, Vagrant possède l'avantage d'offrir une couche d'abstraction vis à vis d'un fournisseur de ressources. Il existe en effet des providers pour VMWare, Amazon, etc...

Pour finir, il est bien entendu rare de pouvoir déployer directement une application sur une machine nue. Afin d'atteindre une configuration donnée, Vagrant supporte des outils comme Puppet, Chef et nous verrons dans un prochain article comment les mettre en place.