outscale / omi-packer

Creates fully working Outscale Machine Images using Packer and shell scripts

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Project Graduated

OMI Builder

This project creates fully working Outscale Machine Images using Packer and shell scripts.

It requires an already working Rocky Linux 8 image on the destination Outscale Region (for Linux images) or a working Windows Golden Image in the corresponding version of wanted Windows image (for Windows images).

Requirements

Usage

Set the following environment variables:

export OUTSCALE_ACCESSKEYID=<ACCESS_KEY>
export OUTSCALE_SECRETKEYID=<SECRET_KEY>
export OUTSCALE_REGION=eu-west-2 # Outscale Region
export OMI_NAME=<OMI_NAME>

And, for Linux images only:

export SCRIPT_BASE=centos8 # Any script located in ./script/base/ without .sh extension
export SOURCE_OMI=ami-0dd0ab23 # A working CentOS 8 image

And, for Windows image only:

export BASE_NAME=Windows-10 # Base name, only required for Windows OMI, see below
export PKR_VAR_volsize=50 # Size in GB of produced OMI

You can then build the image using:

packer init -upgrade config.pkr.hcl
packer build linux.pkr.hcl # for Linux image
packer build windows.pkr.hcl # for Windows image

Optional parameters

export PKR_VAR_volsize=<SIZE> # OMI root volume size in GB, default is 10
export PKR_VAR_username=outscale # Builder VM SSH Username

Available images

Linux

Linux images requires a working CentOS 8 or equivalent image present on destination Region, with a username "outscale".
This username can be changed by setting PKR_VAR_username environment variable to a different username.

The following Linux scripts are provided and can be used in SCRIPT_BASE:

  • centos7 (CentOS 7)
  • rocky8 (Rocky Linux 8)
  • rocky9 (Rocky Linux 9)
  • rhel8 (RedHat Enterprise Linux 8 without license)
  • rhel8csp (RedHat Enterprise Linux 8)
  • rhel9 (RedHat Enterprise Linux 9 without license)
  • rhel9csp (RedHat Enterprise Linux 9)
  • ubuntu2004 (Ubuntu 20.04)
  • ubuntu2204 (Ubuntu 22.04)
  • ubuntu2404 (Ubuntu 24.04)
  • debian11 (Debian 11)
  • debian12 (Debian 12)
  • arch (ArchLinux)
  • alma9 (AlmaLinux 9)
  • opensuse154 (OpenSuse 15.4)

Beware: CSP images (rhel8scp) and (rhel9scp) requires edition of ./files/cloudinit-specific/05_rhelx.cfg to set a proper RedHat Satellite Server owned and configured by the customer itself. Failing to do so will result in a violation of Outscale Terms and Conditions.

Windows

Windows images are required to be named <BASE_NAME>-GOLDEN in order to be recognized by the Packer scripts (eg. Windows-10-GOLDEN).
This behaviour can be changed in windows.pkr.hcl.

About

Creates fully working Outscale Machine Images using Packer and shell scripts

License:BSD 3-Clause "New" or "Revised" License


Languages

Language:PowerShell 52.3%Language:Shell 30.8%Language:HCL 12.7%Language:Batchfile 4.2%