osimager 1.9.0__tar.gz

osimager-1.9.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Steve Shoecraft
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

osimager-1.9.0/PKG-INFO

@@ -0,0 +1,244 @@
+Metadata-Version: 2.4
+Name: osimager
+Version: 1.9.0
+Summary: Multi-platform OS image builder using HashiCorp Packer
+Author: Steve Shoecraft
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/sshoecraft/osimager
+Project-URL: Repository, https://github.com/sshoecraft/osimager
+Project-URL: Documentation, https://sshoecraft.github.io/osimager
+Project-URL: Issues, https://github.com/sshoecraft/osimager/issues
+Keywords: packer,vm,image,builder,kickstart,preseed,ansible
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: System :: Installation/Setup
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ansible>=6.0
+Requires-Dist: dnspython>=2.0
+Requires-Dist: hvac>=1.0
+Requires-Dist: requests>=2.25
+Requires-Dist: tomli>=1.0; python_version < "3.11"
+Dynamic: license-file
+
+# OSImager
+
+Multi-platform OS image builder using HashiCorp Packer. Build virtual machine images for any operating system -- from RHEL 2.1 (2002) to the latest RHEL 9, CentOS, Debian, Ubuntu, SLES, and Windows Server -- on any supported hypervisor, from a single command.
+
+## Quick Install
+
+```bash
+pip install osimager
+```
+
+### Prerequisites
+
+- **Python 3.8+**
+- **HashiCorp Packer** -- https://developer.hashicorp.com/packer/install
+- **Ansible** -- `pip install ansible`
+- **A hypervisor** -- VirtualBox is free and the easiest to start with
+- **Packer plugins** -- At minimum, the Ansible provisioner and your target platform plugin:
+  ```bash
+  packer plugins install github.com/hashicorp/ansible
+  packer plugins install github.com/hashicorp/virtualbox
+  ```
+- **mkisofs** (recommended) -- `brew install cdrtools` (macOS) or `apt install genisoimage` (Linux)
+
+## Getting Started
+
+After installing, run `mkosimage` with no arguments -- it will tell you exactly what to set up:
+
+```
+$ mkosimage
+Usage: mkosimage [OPTIONS] PLATFORM/LOCATION/SPEC [NAME] [IP]
+
+No locations configured.
+  Create a location file in ~/.config/osimager/locations/
+  ...
+```
+
+### 1. Create a location
+
+A location defines your build environment -- network settings, DNS, and where ISOs/VMs live.
+
+Copy the quickstart template and edit it:
+
+```bash
+cp "$(python3 -c "import osimager, os; print(os.path.join(os.path.dirname(osimager.__file__), 'data', 'examples', 'quickstart-location.toml'))")" \
+   ~/.config/osimager/locations/local.toml
+```
+
+Edit `~/.config/osimager/locations/local.toml` -- set your network, gateway, DNS, and paths:
+
+```toml
+platforms = ["virtualbox"]
+
+[defs]
+domain = "home.local"
+gateway = "192.168.1.1"
+cidr = "192.168.1.0/24"
+vms_path = "/vms"
+iso_path = "/iso"
+
+[defs.dns]
+servers = ["192.168.1.1"]
+
+[defs.ntp]
+servers = ["pool.ntp.org"]
+```
+
+Locations support both TOML and JSON formats. If both `lab.toml` and `lab.json` exist, JSON takes priority.
+
+### 2. Set up credentials
+
+OS image builds need credentials for SSH/WinRM access and root passwords. OSImager supports two credential sources:
+
+**Option A: Local secrets file** (simplest)
+
+```bash
+mkosimage --set credential_source=config
+```
+
+Create `~/.config/osimager/secrets`:
+
+```
+images/linux username=root password=YourPassword
+images/windows username=Administrator password=YourPassword
+```
+
+**Option B: HashiCorp Vault**
+
+```bash
+mkosimage --set vault_addr=http://your-vault:8200
+mkosimage --set vault_token=your-token
+```
+
+See the example files shipped with the package for the full secret path reference (including platform credentials for vSphere and Proxmox).
+
+### 3. Build
+
+```bash
+# List all available OS specs
+mkosimage --list
+
+# Dry run -- generates the Packer config without executing
+mkosimage -n virtualbox/local/alma-9.5-x86_64
+
+# Build
+mkosimage virtualbox/local/alma-9.5-x86_64
+```
+
+## How It Works
+
+```
+mkosimage <platform>/<location>/<spec>
+```
+
+- **Platform** = your hypervisor (ships with package)
+- **Location** = your environment: network, DNS, storage paths (you create this)
+- **Spec** = the OS to build (ships with package)
+
+OSImager merges these three configs together, performs template substitution, generates the appropriate answer file (kickstart, preseed, autoyast, or autounattend), produces a Packer build JSON, and executes it.
+
+## Features
+
+- **500+ OS specs** spanning 20+ distributions across decades of releases (see [Supported OS](https://sshoecraft.github.io/osimager/reference/supported-os/) for the generated catalog)
+- **11 platforms**: VirtualBox, VMware, vSphere, Proxmox, QEMU/KVM, Hyper-V, XenServer, Azure, GCP, AWS
+- **Automated installation**: Kickstart (RHEL/CentOS/Alma/Rocky/OEL), preseed (Debian), cloud-init (Ubuntu 20.04+), AutoYaST (SLES), Autounattend (Windows)
+- **Ansible provisioning**: Post-install configuration via Ansible playbooks
+- **Hierarchical configuration**: Platform/location/spec system with deep inheritance and per-version/per-platform overrides
+- **Flexible credentials**: Local secrets file or optional HashiCorp Vault integration
+- **TOML or JSON locations**: User-editable location configs in either format
+
+## Supported Operating Systems
+
+| Distribution | Versions | Install Method |
+|-------------|----------|----------------|
+| RHEL | 2.1, 3.0, 4.8, 5.x, 6.x, 7.x, 8.x, 9.x, 10.x | Kickstart |
+| CentOS | 5.0-5.10, 6.0-6.10, 7.0-7.9, 8.0-8.5 | Kickstart |
+| AlmaLinux | 8.3-8.10, 9.0-9.7, 10.0-10.1 | Kickstart |
+| Rocky Linux | 8.3-8.9, 9.0-9.7, 10.0-10.1 | Kickstart |
+| Oracle Linux | 5.0-5.10, 6.0-6.10, 7.0-7.9, 8.0-8.10, 9.0-9.7, 10.0-10.1 | Kickstart |
+| Debian | 8-13 | Preseed / Cloud-Init |
+| Ubuntu | 18.04, 20.04, 22.04, 24.04 | Cloud-Init |
+| SLES | 12.1-12.5, 15.0-15.7, 16.0 | AutoYaST |
+| VMware ESXi | 5.5U3, 6.0U2, 6.5, 7.0U3n, 8.0U2 | Kickstart |
+| Windows Server | 2016, 2019, 2022, 2025 | Autounattend |
+
+## Supported Platforms
+
+| Platform | Type | Plugin |
+|----------|------|--------|
+| VirtualBox | Local | `github.com/hashicorp/virtualbox` |
+| VMware Workstation/Fusion | Local | `github.com/hashicorp/vmware` |
+| vSphere | Enterprise | `github.com/hashicorp/vsphere` |
+| Proxmox | Enterprise | `github.com/hashicorp/proxmox` |
+| QEMU/KVM | Local | `github.com/hashicorp/qemu` |
+| Hyper-V | Local | Built-in |
+| XenServer | Local | `github.com/ddelnano/xenserver` |
+| Azure | Cloud | `github.com/hashicorp/azure` |
+| GCP | Cloud | `github.com/hashicorp/googlecompute` |
+| AWS | Cloud | `github.com/hashicorp/amazon` |
+
+## Configuration
+
+All user configuration lives in `~/.config/osimager/`:
+
+| File | Purpose |
+|------|---------|
+| `locations/*.toml` or `*.json` | Build environments (you create these) |
+| `secrets` | Credentials when using `credential_source=config` |
+| `config.json` | Persistent settings (managed via `--set`) |
+
+Settings are configured with `--set`:
+
+```bash
+mkosimage --set credential_source=config    # use local secrets file
+mkosimage --set vault_addr=http://vault:8200 # vault server address
+mkosimage --set local_only=True              # only use local ISOs
+mkosimage --set packer_cache_dir=/var/cache  # ISO download cache
+```
+
+## CLI Reference
+
+```
+mkosimage [OPTIONS] PLATFORM/LOCATION/SPEC [NAME] [IP]
+
+Options:
+  -l, --list          List all available specs
+  -a, --avail         List only specs with local ISOs present
+  -n, --dry           Dry run (show commands without executing)
+  -d, --debug         Enable debug output
+  -v, --verbose       Enable verbose output
+  -f, --force         Force rebuild
+  -k, --keep          Keep temporary files after build
+  -F, --fqdn FQDN    Set fully qualified domain name
+  -D, --define K=V    Define custom variables
+  -u, --dump          Dump build configuration as JSON
+  -x, --defs          Dump resolved definitions as JSON
+  --local-only        Use local ISO files only
+  --set KEY=VALUE     Set a persistent configuration value
+  -V, --version       Show version
+```
+
+## Documentation
+
+For detailed documentation on location setup, platform configuration, spec format, template syntax, and the credential system, see the [OSImager Documentation](https://sshoecraft.github.io/osimager).
+
+## License
+
+MIT License -- see [LICENSE](LICENSE) for details.

osimager-1.9.0/README.md

@@ -0,0 +1,207 @@
+# OSImager
+
+Multi-platform OS image builder using HashiCorp Packer. Build virtual machine images for any operating system -- from RHEL 2.1 (2002) to the latest RHEL 9, CentOS, Debian, Ubuntu, SLES, and Windows Server -- on any supported hypervisor, from a single command.
+
+## Quick Install
+
+```bash
+pip install osimager
+```
+
+### Prerequisites
+
+- **Python 3.8+**
+- **HashiCorp Packer** -- https://developer.hashicorp.com/packer/install
+- **Ansible** -- `pip install ansible`
+- **A hypervisor** -- VirtualBox is free and the easiest to start with
+- **Packer plugins** -- At minimum, the Ansible provisioner and your target platform plugin:
+  ```bash
+  packer plugins install github.com/hashicorp/ansible
+  packer plugins install github.com/hashicorp/virtualbox
+  ```
+- **mkisofs** (recommended) -- `brew install cdrtools` (macOS) or `apt install genisoimage` (Linux)
+
+## Getting Started
+
+After installing, run `mkosimage` with no arguments -- it will tell you exactly what to set up:
+
+```
+$ mkosimage
+Usage: mkosimage [OPTIONS] PLATFORM/LOCATION/SPEC [NAME] [IP]
+
+No locations configured.
+  Create a location file in ~/.config/osimager/locations/
+  ...
+```
+
+### 1. Create a location
+
+A location defines your build environment -- network settings, DNS, and where ISOs/VMs live.
+
+Copy the quickstart template and edit it:
+
+```bash
+cp "$(python3 -c "import osimager, os; print(os.path.join(os.path.dirname(osimager.__file__), 'data', 'examples', 'quickstart-location.toml'))")" \
+   ~/.config/osimager/locations/local.toml
+```
+
+Edit `~/.config/osimager/locations/local.toml` -- set your network, gateway, DNS, and paths:
+
+```toml
+platforms = ["virtualbox"]
+
+[defs]
+domain = "home.local"
+gateway = "192.168.1.1"
+cidr = "192.168.1.0/24"
+vms_path = "/vms"
+iso_path = "/iso"
+
+[defs.dns]
+servers = ["192.168.1.1"]
+
+[defs.ntp]
+servers = ["pool.ntp.org"]
+```
+
+Locations support both TOML and JSON formats. If both `lab.toml` and `lab.json` exist, JSON takes priority.
+
+### 2. Set up credentials
+
+OS image builds need credentials for SSH/WinRM access and root passwords. OSImager supports two credential sources:
+
+**Option A: Local secrets file** (simplest)
+
+```bash
+mkosimage --set credential_source=config
+```
+
+Create `~/.config/osimager/secrets`:
+
+```
+images/linux username=root password=YourPassword
+images/windows username=Administrator password=YourPassword
+```
+
+**Option B: HashiCorp Vault**
+
+```bash
+mkosimage --set vault_addr=http://your-vault:8200
+mkosimage --set vault_token=your-token
+```
+
+See the example files shipped with the package for the full secret path reference (including platform credentials for vSphere and Proxmox).
+
+### 3. Build
+
+```bash
+# List all available OS specs
+mkosimage --list
+
+# Dry run -- generates the Packer config without executing
+mkosimage -n virtualbox/local/alma-9.5-x86_64
+
+# Build
+mkosimage virtualbox/local/alma-9.5-x86_64
+```
+
+## How It Works
+
+```
+mkosimage <platform>/<location>/<spec>
+```
+
+- **Platform** = your hypervisor (ships with package)
+- **Location** = your environment: network, DNS, storage paths (you create this)
+- **Spec** = the OS to build (ships with package)
+
+OSImager merges these three configs together, performs template substitution, generates the appropriate answer file (kickstart, preseed, autoyast, or autounattend), produces a Packer build JSON, and executes it.
+
+## Features
+
+- **500+ OS specs** spanning 20+ distributions across decades of releases (see [Supported OS](https://sshoecraft.github.io/osimager/reference/supported-os/) for the generated catalog)
+- **11 platforms**: VirtualBox, VMware, vSphere, Proxmox, QEMU/KVM, Hyper-V, XenServer, Azure, GCP, AWS
+- **Automated installation**: Kickstart (RHEL/CentOS/Alma/Rocky/OEL), preseed (Debian), cloud-init (Ubuntu 20.04+), AutoYaST (SLES), Autounattend (Windows)
+- **Ansible provisioning**: Post-install configuration via Ansible playbooks
+- **Hierarchical configuration**: Platform/location/spec system with deep inheritance and per-version/per-platform overrides
+- **Flexible credentials**: Local secrets file or optional HashiCorp Vault integration
+- **TOML or JSON locations**: User-editable location configs in either format
+
+## Supported Operating Systems
+
+| Distribution | Versions | Install Method |
+|-------------|----------|----------------|
+| RHEL | 2.1, 3.0, 4.8, 5.x, 6.x, 7.x, 8.x, 9.x, 10.x | Kickstart |
+| CentOS | 5.0-5.10, 6.0-6.10, 7.0-7.9, 8.0-8.5 | Kickstart |
+| AlmaLinux | 8.3-8.10, 9.0-9.7, 10.0-10.1 | Kickstart |
+| Rocky Linux | 8.3-8.9, 9.0-9.7, 10.0-10.1 | Kickstart |
+| Oracle Linux | 5.0-5.10, 6.0-6.10, 7.0-7.9, 8.0-8.10, 9.0-9.7, 10.0-10.1 | Kickstart |
+| Debian | 8-13 | Preseed / Cloud-Init |
+| Ubuntu | 18.04, 20.04, 22.04, 24.04 | Cloud-Init |
+| SLES | 12.1-12.5, 15.0-15.7, 16.0 | AutoYaST |
+| VMware ESXi | 5.5U3, 6.0U2, 6.5, 7.0U3n, 8.0U2 | Kickstart |
+| Windows Server | 2016, 2019, 2022, 2025 | Autounattend |
+
+## Supported Platforms
+
+| Platform | Type | Plugin |
+|----------|------|--------|
+| VirtualBox | Local | `github.com/hashicorp/virtualbox` |
+| VMware Workstation/Fusion | Local | `github.com/hashicorp/vmware` |
+| vSphere | Enterprise | `github.com/hashicorp/vsphere` |
+| Proxmox | Enterprise | `github.com/hashicorp/proxmox` |
+| QEMU/KVM | Local | `github.com/hashicorp/qemu` |
+| Hyper-V | Local | Built-in |
+| XenServer | Local | `github.com/ddelnano/xenserver` |
+| Azure | Cloud | `github.com/hashicorp/azure` |
+| GCP | Cloud | `github.com/hashicorp/googlecompute` |
+| AWS | Cloud | `github.com/hashicorp/amazon` |
+
+## Configuration
+
+All user configuration lives in `~/.config/osimager/`:
+
+| File | Purpose |
+|------|---------|
+| `locations/*.toml` or `*.json` | Build environments (you create these) |
+| `secrets` | Credentials when using `credential_source=config` |
+| `config.json` | Persistent settings (managed via `--set`) |
+
+Settings are configured with `--set`:
+
+```bash
+mkosimage --set credential_source=config    # use local secrets file
+mkosimage --set vault_addr=http://vault:8200 # vault server address
+mkosimage --set local_only=True              # only use local ISOs
+mkosimage --set packer_cache_dir=/var/cache  # ISO download cache
+```
+
+## CLI Reference
+
+```
+mkosimage [OPTIONS] PLATFORM/LOCATION/SPEC [NAME] [IP]
+
+Options:
+  -l, --list          List all available specs
+  -a, --avail         List only specs with local ISOs present
+  -n, --dry           Dry run (show commands without executing)
+  -d, --debug         Enable debug output
+  -v, --verbose       Enable verbose output
+  -f, --force         Force rebuild
+  -k, --keep          Keep temporary files after build
+  -F, --fqdn FQDN    Set fully qualified domain name
+  -D, --define K=V    Define custom variables
+  -u, --dump          Dump build configuration as JSON
+  -x, --defs          Dump resolved definitions as JSON
+  --local-only        Use local ISO files only
+  --set KEY=VALUE     Set a persistent configuration value
+  -V, --version       Show version
+```
+
+## Documentation
+
+For detailed documentation on location setup, platform configuration, spec format, template syntax, and the credential system, see the [OSImager Documentation](https://sshoecraft.github.io/osimager).
+
+## License
+
+MIT License -- see [LICENSE](LICENSE) for details.

osimager-1.9.0/osimager/__init__.py

@@ -0,0 +1,2 @@
+
+from .core import OSImager