https://github.com/tomconte/packer-alpine-azure

https://github.com/tomconte/packer-alpine-azure

alpine azure packer

Last synced: 12 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/tomconte/packer-alpine-azure
• Owner: tomconte
• Created: 2017-11-09T14:21:42.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2019-02-19T10:12:46.000Z (almost 6 years ago)
• Last Synced: 2024-10-26T09:46:34.247Z (25 days ago)
• Topics: alpine, azure, packer
• Language: Shell
• Size: 14.6 KB
• Stars: 19
• Watchers: 1
• Forks: 15
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Packer template for Alpine Linux on Hyper-V and Azure

This Packer template will generate a VHD suitable for use in Hyper-V or Azure.

## How it works

- The Packer template downloads the Alpine 3.6 ISO from the official download site.

- It then uses `setup-alpine` to perform an [installation to disk](https://wiki.alpinelinux.org/wiki/Install_to_disk).

- The `answers` file is served using Packer's built-in HTTP server.

- It also installs the `hvtools` package and enables the `hv_kvp_daemon` service so Hyper-V can detect the VM is running and retrieve its IP address. (Read more about [Hyper-V Integration Services](https://docs.microsoft.com/en-us/windows-server/virtualization/hyper-v/manage/manage-hyper-v-integration-services#start-and-stop-an-integration-service-from-a-linux-guest).)

## Software installed

The Packer provisioning step performs the following actions in order to prepare a proper Azure image:

- Installs Python and OpenSSL, plus `sudo` and `bash`

- Installs the `shadow` package (for `useradd`)

- Installs the [Azure Linux Agent](https://github.com/Azure/WALinuxAgent/)

- Adds recommended boot parameters

- Sets the `ssh` client interval to 180

- Enables the Azure Agent to start at boot

The template also installs a custom `useradd` script (in `/usr/local/sbin`) that changes the behavior of adding password-less accounts (i.e. accounts that log in using SSH keys). By default `useradd` locks the password-less account, preventing it from logging in. The custom script forces an illegal password, so that the password cannot be used to log in, but leaves the account unlocked so it can be access via SSH.

## How to use the template

### On Linux, using `qemu`

Check out the `packer-qemu` branch for a WIP version that builds the Alpine image using `qemu`, allowing you to generate the image from a Linux machine.

Detailed docs TBD, but the Windows instructions below should help.

### On Windows, using Hyper-V

The commands need to be run from an elevated PowerShell prompt so that they can interact with Hyper-V.

First run the template. This will generate a VHDX file locally, in `output-hyperv-iso`.

```

packer build alpinehv.json

```

To use the image in Azure, you need to convert the image to VHD using `convert.ps1`.

The `deploy.cmd` script will upload the VHD to Azure and start a VM based on the image. Please amend the script variables as necessary.

Once the VM is started, you can log on via `ssh` and make any additional changes. Then deprovision the VM to get it ready to be used as an image:

```

waagent -deprovision

```

Finally, `makeimage.cmd` will deallocate the VM, capture it as an image, and start another VM based on that image.

## TODO

- Review/tweak boot command based on [ladar's comment](https://github.com/hashicorp/packer/issues/5049#issuecomment-343531173)

- Investigate `iptables` error messages