wiki/HowtoPacker.md

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

{
  "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