Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,9 @@ include::modules/proc_creating-a-vmware-user.adoc[leveloffset=+1]

include::modules/proc_adding-a-vmware-connection-to-server.adoc[leveloffset=+1]

include::modules/proc_adding-vmware-images-to-server.adoc[leveloffset=+1]
include::modules/proc_adding-vmware-images-to-project-by-using-web-ui.adoc[leveloffset=+1]

include::modules/proc_adding-vmware-images-to-project-by-using-cli.adoc[leveloffset=+1]

include::modules/proc_adding-vmware-details-to-a-compute-profile.adoc[leveloffset=+1]

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@
[id="adding-proxmox-images-to-{project-context}-by-using-cli"]
= Adding Proxmox images to {Project} by using Hammer CLI

Proxmox uses templates as images for creating virtual machines.
When you use image-based provisioning to create new hosts, add Proxmox template details to your {Project}.
Add Proxmox images to {Project} to perform image-based host provisioning on Proxmox.
Copy link
Contributor

@Lennonka Lennonka Oct 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I struggled to remember why this wording was so strange (in VMware).

The problem is this: what we call "images" in Foreman are called "templates" in VMware. I don't know what they call them in Proxmox. I started calling them "image templates" in provisioning methods.

Now I hesitate to change it because it would be good for users' understanding to create a connection between those two terminologies. Could you try to consider an alternative wording?

This applies to all modules in this PR.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I can drop 9c3aaf4 from the PR and only add the CLI procecures for now. Or is this something I should bring up in the provisioning interest group? cc @goarsna

Or maybe we need to extend our glossary/provisioning overview?


.Procedure
. Optional: View all available images on Proxmox:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@
[id="adding-proxmox-images-to-{project-context}-by-using-web-ui"]
= Adding Proxmox images to {Project} by using {ProjectWebUI}

Proxmox uses templates as images for creating virtual machines.
When you use image-based provisioning to create hosts, add Proxmox template details to your {Project}.
Add Proxmox images to {Project} to perform image-based host provisioning on Proxmox.

.Procedure
. In the {ProjectWebUI}, navigate to *Infrastructure* > *Compute Resources*.
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
:_mod-docs-content-type: PROCEDURE

[id="adding-vmware-images-to-{project-context}-by-using-cli"]
= Adding VMware images to {Project} by using CLI

Add VMware images to {Project} to perform image-based host provisioning on VMware.

.Procedure
. Optional: View all available images on VMware:
+
[options="nowrap" subs="+quotes"]
----
$ hammer compute-resource image available --compute-resource "_My_VMware"
----
. Add your Proxmox image to {Project}:
+
[options="nowrap" subs="+quotes"]
----
$ hammer compute-resource image create \
--architecture "_My_Architecture_" \
--compute-resource "_My_VMware_" \
--name "_My_Image_Name_" \
--operatingsystem "_My_Operating_System_" \
--username _My_User_Name_ \
--uuid "_My_UUID_"
----

.Verification
* Verify that the VMware image is present on your {Project}:
+
[options="nowrap" subs="+quotes"]
----
$ hammer compute-resource image list --compute-resource "_My_VMware_"
----
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
:_mod-docs-content-type: PROCEDURE

[id="adding-vmware-images-to-{project-context}-by-using-web-ui"]
= Adding VMware images to {Project} by using {ProjectWebUI}

Add VMware images to {Project} to perform image-based host provisioning on VMware.

.Procedure
. In the {ProjectWebUI}, navigate to *Infrastructure* > *Compute Resources*.
. Select your VMware compute resource.
. Click *Create Image*.
. In the *Name* field, enter a name for the image.
. From the *Operating System* list, select the base operating system of the image.
. From the *Architecture* list, select the operating system architecture.
. In the *Username* field, enter the SSH user name for image access.
By default, this is set to `root`.
. If your image supports user data input such as `cloud-init` data, click the *User data* checkbox.
. Optional: In the *Password* field, enter the SSH password to access the image.
. From the *Image* list, select an image from VMware.
. Click *Submit* to save the image details.
40 changes: 0 additions & 40 deletions guides/common/modules/proc_adding-vmware-images-to-server.adoc

This file was deleted.

Original file line number Diff line number Diff line change
Expand Up @@ -210,4 +210,4 @@ endif::[]
# unset HISTFILE
----
. Create an image from this virtual machine.
. xref:Adding_VMware_Images_to_Server_{context}[Add your image to {Project}].
. xref:adding-vmware-images-to-{project-context}-by-using-web-ui[Add your image to {Project}].