Create and import on-premise images by using Packer

Prerequisites

• You must have the AccessKey ready to fill out the configuration file. .

  	Note
  	The AccessKey has a high level of account privileges. We recommend that you create a RAM user and use the RAM account to create AccessKey to prevent data breach.

• Before uploading your on-premises images to Alibaba Cloud, you must sign up for OSS.

Sample of creating and importing an on-premises image

1. Run egrep "(svm|vmx)" /proc/cpuinfo to check whether your on-premises server or virtual machine supports KVM. If the following output returns, KVM is supported.

   pat pse36 clflush dts acpi mmx fxsr sse sse2 ss ht tm pbe syscall nx pdpe1gb rdtscp lm constant_tsc art arch_perfmon pebs bts rep_good nopl xtopology nonstop_tsc aperfmperf tsc_known_freq pni pclmulqdq dtes64 monitor ds_cpl vmx est tm2 ssse3 sdbg fma cx16 xtpr pdcm pcid sse4_1 sse4_2 x2apic movbe popcnt tsc_deadline_timer aes xsave avx f16c rdrand lahf_lm abm 3dnowprefetch epb intel_pt tpr_shadow vnmi flexpriority ept vpid fsgsbase tsc_adjust bmi1 avx2 smep bmi2 erms invpcid mpx rdseed adx smap clflushopt xsaveopt xsavec xgetbv1 xsaves dtherm ida arat pln pts hwp hwp_notify hwp_act_window hwp_epp
   flags        : fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov

2. Run the following commands to install the KVM:

   sudo apt-get install qemu-kvm qemu virt-manager virt-viewer libvirt-bin bridge-utils # Install KVM and related dependencies.
   sudo virt-manager # Enable virt-manager.

   If a GUI runs in the VM console window, you have successfully installed the KVM.

3. Install Packer.

   To install Packer, see Use Packer to create a custom image.

4. Run the following commands to define a Packer template.

   	Note
   	The on-premises image created in the following configuration is for the CentOS 6.9 operating system only. To create images for other operating systems, customize configuration file centos.json as needed.

   cd /user/local # Switch the directory.
   wget https://raw.githubusercontent.com/alibaba/packer-provider/master/examples/alicloud/local/centos.json # Download file centos.json that is released by Alibaba Cloud.
   wget https://raw.githubusercontent.com/alibaba/packer-provider/master/examples/alicloud/local/http/centos-6.9/ks.cfg # Download file ks.cfg that is released by Alibaba Cloud.
   mkdir -p http/centos-6.9 # Create a directory.
   mv ks.cfg http/centos-6.9/ # Move file ks.cfg to the http/centos-6.9 directory.

5. Run the following commands to create an on-premises image.

   export ALICLOUD_ACCESS_KEY= SpecifyYourAccessKeyIDHere # Import your AccessKeyID,
   export ALICLOUD_SECRET_KEY= SpecifyYourAccessKeySecretHere # Import your AccessKeySecret.
   packer build centos.json # Create an on-premises image.

   The running result of the sample is as follows.

   qemu output will be in this color.
    ==> qemu: Downloading or copying ISO
        qemu: Downloading or copying: http://mirrors.aliyun.com/centos/6.9/isos/x86_64/CentOS-6.9-x86_64-minimal.iso
    ................................................
    ==> qemu: Running post-processor: alicloud-import
        qemu (alicloud-import): Deleting import source https://oss-cn-beijing.aliyuncs.com/packer/centos_x86_64
    Build 'qemu' finished.
    ==> Builds finished. The artifacts of successful builds are:
    --> qemu: Alicloud images were created:
    cn-beijing: XXXXXXXX

6. Wait for a few minutes, log on to the ECS console and check your custom image in the image list that is in the corresponding region. In this sample, the region is China North 2 (cn-beijing).

Customize a Packer template

The image file created in the preceding sample is for the CentOS 6.9 operating system only. To create images for other operating systems, you must customize the Packer template.

For example, the following JSON file is customized based on the template to create an image for the CentOS 6.9.

{"variables": {
        "box_basename": "centos-6.9",
        "build_timestamp": "{{isotime \"20060102150405\"}}",
        "cpus": "1",
        "disk_size": "4096",
        "git_revision": "__unknown_git_revision__",
        "headless": "",
        "http_proxy": "{{env `http_proxy`}}",
        "https_proxy": "{{env `https_proxy`}}",
        "iso_checksum_type": "md5",
        "iso_checksum": "af4a1640c0c6f348c6c41f1ea9e192a2",
        "iso_name": "CentOS-6.9-x86_64-minimal.iso",
        "ks_path": "centos-6.9/ks.cfg",
        "memory": "512",
        "metadata": "floppy/dummy_metadata.json",
        "mirror": "http://mirrors.aliyun.com/centos",
        "mirror_directory": "6.9/isos/x86_64",
        "name": "centos-6.9",
        "no_proxy": "{{env `no_proxy`}}",
        "template": "centos-6.9-x86_64",
        "version": "2.1.TIMESTAMP"
      },
    "builders":[
        {
          "boot_command": [
            "<tab> text ks=http://{{ .HTTPIP }}:{{ .HTTPPort }}/{{user `ks_path`}}<enter><wait>"
          ],
          "boot_wait": "10s",
          "disk_size": "{{user `disk_size`}}",
          "headless": "{{ user `headless` }}",
          "http_directory": "http",
          "iso_checksum": "{{user `iso_checksum`}}",
          "iso_checksum_type": "{{user `iso_checksum_type`}}",
          "iso_url": "{{user `mirror`}}/{{user `mirror_directory`}}/{{user `iso_name`}}",
          "output_directory": "packer-{{user `template`}}-qemu",
          "shutdown_command": "echo 'vagrant'|sudo -S /sbin/halt -h -p",
          "ssh_password": "vagrant",
          "ssh_port": 22,
          "ssh_username": "root",
          "ssh_wait_timeout": "10000s",
          "type": "qemu",
          "vm_name": "{{ user `template` }}.raw",
          "net_device": "virtio-net",
          "disk_interface": "virtio",
          "format": "raw"
        }
      ],
    "provisioners": [{
          "type": "shell",
          "inline": [
                "sleep 30",
                "yum install cloud-util cloud-init -y"
              ]
        }],
      "post-processors":[
        {
          "type":"alicloud-import",
          "oss_bucket_name": "packer",
          "image_name": "packer_import",
          "image_os_type": "linux",
          "image_platform": "CentOS",
          "image_architecture": "x86_64",
          "image_system_size": "40",
          "region":"cn-beijing"
        }
      ]
}

QEMU builder is used in the preceding sample to create a virtual machine image. Required parameters for the builder are as follows.

For more information about other optional parameters, see Packer QEMU Builder.

The provisioner in the preceding sample contains a Post-Processor module that enables automated upload of on-premises images to Alibaba Cloud. Required parameters for the provisioner are as follows:

For more information about other optional parameters, see Packer Alicloud Post-Processor.

Next step

You can use the created image to create an ECS instance. For more information, see Create an instance from a custom image.

References

• For more information about how to use Packer, see Packer documentation.
• For more information about release information, visit the Packer repository on GitHub packer.
• For more information about Alibaba Cloud open source tools, visit Alibaba repository on GitHub opstools.
• For more information about Alibaba Cloud and Packer project, visit the Alibaba & Packer repositories on GitHub packer-provider.
• For more information about configuration file ks.cfg, see Anaconda Kickstart .