Skip to content

Latest commit

 

History

History
103 lines (71 loc) · 4.05 KB

README.md

File metadata and controls

103 lines (71 loc) · 4.05 KB
Raw

Automated ParrotOS Virtual Machine Builder with Packer and Vagrant for Apple Silicon Macs & Parallels Desktop

Create virtual ParrotOS machines or Vagrant boxes in an automated, customizable fashion using Packer. This tool is designed specifically for Macs with Apple Silicon chip and leverages Parallels Desktop.

Overview

This project provides automated Packer scripts to build ParrotOS virtual machines or Vagrant boxes. It offers the flexibility to use any of the available ISO's for the distro. The selected source can be defined by setting the iso_url variable in the variables.pkrvars.hcl file. By default, the script will use and auto-download the ISO for ParrotOS 2023.3 if no source is specified in the variables.pkrvars.hcl file.

Prerequisites

To use these Packer scripts, you'll need to have the following software installed on your machine:

Calculating ISO Checksum

If you opt for an alternate ISO, you'll need to determine and define its checksum. Use the following command to calculate the checksum:

shasum -a 256 <path_to_iso>

You can then specify the resulting checksum in the variables.pkrvars.hcl file as follows:

iso_checksum: "sha256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Usage

Prior to utilizing the Packer script, you must first establish the required variables in the variables.pkrvars.hcl file. You can use the variables_TEMPLATE.pkrvars.hcl file as a template or duplicate it to variables.local.pkrvars.hcl and modify it accordingly. Some of these variables have default values and don't need to be set explicitly.

You can set the following variables:

version="5.3"
machine_name="parrot_os_architect_5.3"
hostname="parrot_os-2023"
machine_specs = {
  cpus = 2,
  memory = 2048,
  disk_size = "65536",
}
addons=[
]
desktop=gnome
create_vagrant_box = false

Refer to the detailed variables guide for information on each variable.

variables

  • version - The version of Ubuntu to build. This can be any version that is available for ARM in the Ubuntu release page.
  • machine_name - The name of the virtual machine in Parallels Desktop.
  • hostname - The hostname of the virtual machine.
  • machine_specs - The specs of the virtual machine. This is a map with the following keys:
    • cpus - The number of CPUs to assign to the virtual machine.
    • memory - The amount of memory to assign to the virtual machine.
    • disk_size - The size of the virtual disk in MB.
  • addons - A list of addons to install. The following addons are available:
    • desktop - Installs the Ubuntu desktop.
    • vscode - Installs Visual Studio code.
  • create_vagrant_box - If set to true a Vagrant box will be created. If set to false only a virtual machine will be created.

Packer Commands

Initialize Plugins

To initialize the Packer plugins, navigate to the directory containing the script and run the following command:

packer init .

Validate Build Configuration

Validate the build configuration with the following command in the directory containing the script:

packer validate -var-file variables.local.pkrvars.hcl .

A successful validation will yield the output:

The configuration is valid.

Build Machine

To initiate the build of the virtual machine, execute the following command in the directory with the script:

packer build -var-file variables.local.pkrvars.hcl .

This action will generate a new virtual machine as per the settings in the Packer script, placing it in the out directory. If the create_vagrant_box variable is set to true, a Vagrant box will also be generated in the out folder.

Note: The build process duration depends on your machine's capabilities and internet connection speed.
Post-build, the machine will not auto-attach to Parallels Desktop. This has to be performed manually.