HowtoPacker: initial commit

HowtoPacker.md

@@ -0,0 +1,134 @@
+# HowtoPacker
+
+Packer est un outil permettant de créer des images identiques destinées à
+différentes plateformes à partir d'une configuration unique.
+
+# Terminologie
+
+## Builder
+Composant permettant de créer une image pour une plateforme donnée. Le résultat
+d'un build est nommé un *artifact*.
+
+(Amazon EC2, Azure, Docker, QEMU, VirtualBox, VMWare, DigitalOcean, etc.)
+
+## Provisionner
+Composant permettant de configurer une image suite au build.
+
+(Ansible, Chef, Puppet, Salt, Shell, etc.)
+
+## Post-processor
+Composant prenant comme entrée le résultat d'un build ou d'un autre post-processor
+pour créer un nouvel *artifact*.
+
+**Examples**
+- [Vagrant] Créer une box vagrant pour VirtualBox en utilisant l'*artifact* du
+builder VirtualBox.
+- [Atlas] Envoyer une box vagrant vers Atlas.
+- [Docker Tag] Tagger l'image résultant d'un build Docker.
+- [Docker Push] Envoyer une image Docker vers un registry (Docker Hub).
+
+## Template
+Fichier JSON définissant les paramètres de tous les composants énumérés
+précedemment.
+
+**Exemple**
+```json
+{
+  "variables": {
+    "atlas_token": "xxxxxxxx"
+  },
+  "builders": [
+    {
+      "type": "virtualbox-iso",
+      "vm_name": "evolinux-debian-8.7.1-amd64",
+      "guest_os_type": "Debian_64",
+      "iso_url": "https://cdimage.debian.org/debian-cd/8.7.1/amd64/iso-cd/debian-8.7.1-amd64-netinst.iso",
+      "iso_checksum": "453312bf56fc45669fec5ebc0f025ac7",
+      "iso_checksum_type": "md5",
+      "disk_size": 10240,
+      "ssh_username": "vagrant",
+      "ssh_password": "vagrant",
+      "ssh_wait_timeout": "10000s",
+      "headless": true,
+      "boot_wait": "10s",
+      "http_directory": "preseed",
+      "boot_command": [
+        "<esc><wait>",
+        "auto url=http://{{ .HTTPIP }}:{{ .HTTPPort }}/jessie.cfg <wait>",
+        "<enter><wait>"
+      ],
+      "shutdown_command": "echo 'vagrant' | sudo -S shutdown -P now",
+      "vboxmanage": [
+        [ "modifyvm", "{{.Name}}", "--memory", "512" ],
+        [ "modifyvm", "{{.Name}}", "--cpus", "1" ]
+      ]
+    },
+    {
+      "type": "docker",
+      "image": "buildpack-deps:jessie",
+      "commit": true
+    }
+  ],
+  "provisioners": [
+    {
+      "only": ["docker"],
+      "type": "ansible",
+      "playbook_file": "./docker.yml",
+      "groups": ["ansible-test"]
+    },
+    {
+      "only": ["virtualbox-iso"],
+      "type": "ansible",
+      "playbook_file": "./playbook.yml",
+      "groups": ["ansible-test"]
+    }
+  ],
+  "post-processors": [
+    [{
+      "type": "vagrant",
+      "compression_level": "9",
+      "output": "debian-{{user `debian_version`}}-amd64_{{.Provider}}.box",
+      "only": ["virtualbox-iso"]
+    },
+    {
+      "type": "atlas",
+      "token": "{{user `atlas_token`}}",
+      "artifact": "evolix/evolinux",
+      "artifact_type": "vagrant.box",
+      "metadata": {
+        "created_at": "{{timestamp}}",
+        "provider": "virtualbox"
+      }
+    }],
+    [
+      {
+        "type": "docker-import",
+        "repository": "evolix/evolinux-base",
+        "tag": "latest"
+      },
+      "docker-push"
+    ]
+  ]
+}
+```
+
+## Utilisation
+
+### Valider un template
+`$ packer validate <template>`
+
+### Afficher les composants d'un template
+`$ packer inspect <template>`
+
+### Lancer un build
+`$ packer build <template>`
+
+
+## Dépannage
+
+## The "metadata.json" file for the box 'evolix/evolinux' was not found.
+Afin de passer le résultat d'un *post-processor* à un autre, il est important
+de les regrouper dans un array comme un seul *post-processor*.
+
+
+Pour plus d'informations: https://www.packer.io/docs/index.html