# martezr/packer-plugin-hpe-vm-essentials architecture

> Architecture diagram of the GitHub repository martezr/packer-plugin-hpe-vm-essentials, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/martezr/packer-plugin-hpe-vm-essentials
- Repository: https://github.com/martezr/packer-plugin-hpe-vm-essentials

## Overview

This is a Packer plugin for building custom images on HPE VM Essentials and optionally running Morpheus automation. Packer invokes the registered ISO or clone builder: each builder assembles a multistep workflow that provisions an instance, optionally connects and provisions it, and can convert it into a virtual image. The ISO path additionally serves HTTP templates and handles boot commands and IP discovery. Packer can also invoke the Morpheus provisioner to run a task or workflow and poll its execution. Edges reflect registration, builder orchestration, and the shown API calls; unsampled implementation details are not inferred.

Main entry points: [`builder/hpe-vme/iso/builder.go`](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/iso/builder.go) (ISO builder), [`builder/hpe-vme/clone/builder.go`](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/clone/builder.go) (Clone builder), [`main.go`](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/main.go) (Plugin registration), [`builder/hpe-vme/common/step_convert_instance.go`](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/common/step_convert_instance.go) (Image conversion)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Plugin entry"]
  node_plugin["Plugin registration<br/>[main.go]"]
end

subgraph group_builders["Image builders"]
  node_iso["ISO builder<br/>[builder.go]"]
  node_clone["Clone builder<br/>[builder.go]"]
  node_iso_config["ISO configuration<br/>[config.go]"]
  node_clone_config["Clone configuration<br/>[config.go]"]
end

subgraph group_steps["Build stages"]
  node_connect["API connection<br/>[step_connect.go]"]
  node_iso_vm["ISO VM provisioning"]
  node_clone_vm["Clone provisioning"]
  node_http_templates["HTTP templates"]
  node_boot["Boot commands"]
  node_wait_ip["IP discovery"]
  node_stop["Stop instance"]
  node_eject["Eject disks"]
  node_convert["Image conversion"]
  node_remove["Remove instance"]
  node_artifact["Build artifact<br/>[artifact.go]"]
end

subgraph group_automation["Morpheus automation"]
  node_morpheus_provisioner["Morpheus provisioner<br/>[provisioner.go]"]
  node_morpheus_api{{"Morpheus API"}}
end

node_packer(("Packer"))

node_packer -->|"starts plugin"| node_plugin
node_plugin -->|"registers builder"| node_iso
node_plugin -->|"registers builder"| node_clone
node_plugin -->|"registers provisioner"| node_morpheus_provisioner
node_iso -->|"runs step"| node_connect
node_iso -->|"runs step"| node_iso_vm
node_iso -->|"runs step"| node_http_templates
node_iso -->|"runs step"| node_boot
node_iso -->|"runs step"| node_wait_ip
node_iso -->|"runs optional step"| node_stop
node_iso -->|"runs optional step"| node_eject
node_iso -->|"runs optional step"| node_convert
node_iso -->|"runs optional step"| node_remove
node_clone -->|"runs step"| node_connect
node_clone -->|"runs step"| node_clone_vm
node_clone -->|"runs step"| node_stop
node_clone -->|"runs step"| node_convert
node_clone -->|"runs step"| node_remove
node_iso -->|"creates artifact"| node_artifact
node_clone -->|"creates artifact"| node_artifact
node_iso_vm -->|"creates instance"| node_morpheus_api
node_clone_vm -->|"creates instance"| node_morpheus_api
node_convert -->|"imports snapshot"| node_morpheus_api
node_morpheus_provisioner -->|"runs tasks"| node_morpheus_api
node_iso -->|"uses config"| node_iso_config
node_clone -->|"uses config"| node_clone_config

click node_plugin "https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/main.go"
click node_iso "https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/iso/builder.go"
click node_clone "https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/clone/builder.go"
click node_iso_config "https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/iso/config.go"
click node_clone_config "https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/clone/config.go"
click node_connect "https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/common/step_connect.go"
click node_iso_vm "https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/iso/step_provision_vm.go"
click node_clone_vm "https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/clone/step_provision_vm.go"
click node_http_templates "https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/iso/step_generate_http_templates.go"
click node_boot "https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/iso/step_type_boot_command.go"
click node_wait_ip "https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/common/step_wait_for_ip.go"
click node_stop "https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/common/step_stop_instance.go"
click node_eject "https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/common/step_eject_disks.go"
click node_convert "https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/common/step_convert_instance.go"
click node_remove "https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/common/step_remove_instance.go"
click node_artifact "https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/common/artifact.go"
click node_morpheus_provisioner "https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/provisioner/morpheus/provisioner.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_plugin toneBlue
class node_iso,node_clone,node_iso_config,node_clone_config toneAmber
class node_connect,node_iso_vm,node_clone_vm,node_http_templates,node_boot,node_wait_ip,node_stop,node_eject,node_convert,node_remove,node_artifact toneMint
class node_morpheus_provisioner,node_morpheus_api toneRose
class node_packer toneIndigo
```

## Components

### Plugin entry

- [Plugin registration](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/main.go): `main.go`

### Image builders

- [ISO builder](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/iso/builder.go): `builder/hpe-vme/iso/builder.go`
- [Clone builder](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/clone/builder.go): `builder/hpe-vme/clone/builder.go`
- [ISO configuration](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/iso/config.go): `builder/hpe-vme/iso/config.go`
- [Clone configuration](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/clone/config.go): `builder/hpe-vme/clone/config.go`

### Build stages

- [API connection](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/common/step_connect.go): `builder/hpe-vme/common/step_connect.go`
- [ISO VM provisioning](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/iso/step_provision_vm.go): `builder/hpe-vme/iso/step_provision_vm.go`
- [Clone provisioning](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/clone/step_provision_vm.go): `builder/hpe-vme/clone/step_provision_vm.go`
- [HTTP templates](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/iso/step_generate_http_templates.go): `builder/hpe-vme/iso/step_generate_http_templates.go`
- [Boot commands](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/iso/step_type_boot_command.go): `builder/hpe-vme/iso/step_type_boot_command.go`
- [IP discovery](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/common/step_wait_for_ip.go): `builder/hpe-vme/common/step_wait_for_ip.go`
- [Stop instance](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/common/step_stop_instance.go): `builder/hpe-vme/common/step_stop_instance.go`
- [Eject disks](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/common/step_eject_disks.go): `builder/hpe-vme/common/step_eject_disks.go`
- [Image conversion](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/common/step_convert_instance.go): `builder/hpe-vme/common/step_convert_instance.go`
- [Remove instance](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/common/step_remove_instance.go): `builder/hpe-vme/common/step_remove_instance.go`
- [Build artifact](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/builder/hpe-vme/common/artifact.go): `builder/hpe-vme/common/artifact.go`

### Morpheus automation

- [Morpheus provisioner](https://github.com/martezr/packer-plugin-hpe-vm-essentials/blob/main/provisioner/morpheus/provisioner.go): `provisioner/morpheus/provisioner.go`
- **Morpheus API**

### Other components

- **Packer**

## Connections

- Packer → Plugin registration: starts plugin (evidence: `main.go`)
- Plugin registration → ISO builder: registers builder (evidence: `main.go`)
- Plugin registration → Clone builder: registers builder (evidence: `main.go`)
- Plugin registration → Morpheus provisioner: registers provisioner (evidence: `main.go`)
- ISO builder → API connection: runs step (evidence: `builder/hpe-vme/iso/builder.go`)
- ISO builder → ISO VM provisioning: runs step (evidence: `builder/hpe-vme/iso/builder.go`)
- ISO builder → HTTP templates: runs step (evidence: `builder/hpe-vme/iso/builder.go`)
- ISO builder → Boot commands: runs step (evidence: `builder/hpe-vme/iso/builder.go`)
- ISO builder → IP discovery: runs step (evidence: `builder/hpe-vme/iso/builder.go`)
- ISO builder → Stop instance: runs optional step (evidence: `builder/hpe-vme/iso/builder.go`)
- ISO builder → Eject disks: runs optional step (evidence: `builder/hpe-vme/iso/builder.go`)
- ISO builder → Image conversion: runs optional step (evidence: `builder/hpe-vme/iso/builder.go`)
- ISO builder → Remove instance: runs optional step (evidence: `builder/hpe-vme/iso/builder.go`)
- Clone builder → API connection: runs step (evidence: `builder/hpe-vme/clone/builder.go`)
- Clone builder → Clone provisioning: runs step (evidence: `builder/hpe-vme/clone/builder.go`)
- Clone builder → Stop instance: runs step (evidence: `builder/hpe-vme/clone/builder.go`)
- Clone builder → Image conversion: runs step (evidence: `builder/hpe-vme/clone/builder.go`)
- Clone builder → Remove instance: runs step (evidence: `builder/hpe-vme/clone/builder.go`)
- ISO builder → Build artifact: creates artifact (evidence: `builder/hpe-vme/iso/builder.go`)
- Clone builder → Build artifact: creates artifact (evidence: `builder/hpe-vme/clone/builder.go`)
- ISO VM provisioning → Morpheus API: creates instance (evidence: `builder/hpe-vme/iso/step_provision_vm.go`)
- Clone provisioning → Morpheus API: creates instance (evidence: `builder/hpe-vme/clone/step_provision_vm.go`)
- Image conversion → Morpheus API: imports snapshot (evidence: `builder/hpe-vme/common/step_convert_instance.go`)
- Morpheus provisioner → Morpheus API: runs tasks (evidence: `provisioner/morpheus/provisioner.go`)
- ISO builder → ISO configuration: uses config (evidence: `builder/hpe-vme/iso/builder.go`)
- Clone builder → Clone configuration: uses config (evidence: `builder/hpe-vme/clone/builder.go`)
