@torarnv
The IPSW data source provides information about Apple IPSW releases based on the filter options provided in the configuration.
- Community
Updated 6 months ago
- GitHub(opens in new tab)
IPSW
Packer Plugin IPSW
The IPSW
data-source plugin can be used with HashiCorp Packer
to fetch information about Apple device firmware,
for example for building macOS images with Tart.
Installation
Using pre-built releases
Using the packer init
command
Starting from version 1.7, Packer supports a new packer init
command allowing
automatic installation of Packer plugins. Read the
Packer documentation for more information.
To install this plugin, copy and paste this code into your Packer configuration .
Then, run packer init
.
packer {
required_plugins {
ipsw = {
version = ">= 0.0.13"
source = "github.com/torarnv/ipsw"
}
}
}
Manual installation
You can find pre-built binary releases of the plugin here. Once you have downloaded the latest archive corresponding to your target OS, uncompress it to retrieve the plugin binary file corresponding to your platform. To install the plugin, please follow the Packer documentation on installing a plugin.
From Sources
If you prefer to build the plugin from sources, clone the GitHub repository
locally and run the command make
from the root
directory. Upon successful compilation, a packer-plugin-ipsw
plugin
binary file can be found in the root directory.
To install the compiled plugin, please follow the official Packer documentation
on installing a plugin.
Usage
To fetch information about the latest macOS Ventura release:
data "ipsw" "ventura" {
os = "macOS"
version = "^13"
device = "VirtualMac2,1"
}
Then use result via e.g. ${data.ipsw.ventura.version}
and ${data.ipsw.ventura.url}
.
Configuration
For more information on how to configure the plugin, please read the documentation located here.
Contributing
- If you think you've found a bug in the code or you have a question regarding the usage of this software, please reach out by opening an issue in this GitHub repository.
- Contributions to this project are welcome: if you want to add a feature or a fix a bug, please do so by opening a Pull Request in this GitHub repository. In case of feature contribution, we kindly ask you to open an issue to discuss it beforehand.