Provision hosts through OpenTofu

orcharhino can interact with multiple clouds and virtualization solutions through OpenTofu. You can create hosts and control their power management states through orcharhino.

orcharhino uses OpenTofu to act as a unified interface to provision and manage hosts on several clouds and virtualization platforms. After an initial setup, you can create hosts on different compute resource providers with the same workflow.

Enable OpenTofu-based host provisioning

  1. Install the OpenTofu plugin on your orcharhino Server.

  2. Connect orcharhino to a supported compute resource target.

  3. Define an image from your compute resource target in orcharhino.

  4. Create a compute profile to bundle hardware settings.

Customize OpenTofu-based host provisioning

  1. Depending on your use case, create additional compute profiles.

  2. Create a host group as blue print to standardize host deployments.

Provision hosts

  1. Select a host group.

  2. Customize settings to your needs.

  3. Provision a host.

Supported OpenTofu targets

orcharhino integrates with several compute resource targets through OpenTofu. It provides a provisioning template for each supported OpenTofu target.

Hetzner Cloud

You can provision cloud instances on Hetzner Cloud, manage their lifecycle, and decommission them.

Nutanix

You can provision virtual machines on Nutanix AHV, manage their lifecycle, and decommission them.

oVirt/Oracle Linux Virtualization Manager/Red Hat Virtualization

You can provision virtual machines on oVirt, Oracle Linux Virtualization Manager, and Red Hat Virtualization, manage their lifecycle, and decommission them.

Install the OpenTofu plugin

Install the OpenTofu plugin on your orcharhino Server to provision and manage hosts through OpenTofu.

Procedure

  • On your orcharhino Server, install the OpenTofu plugin:

    $ orcharhino-installer --enable-foreman-plugin-opentofu
Verification

  1. In the orcharhino management UI, navigate to Administer > About.

  2. On the Plugins tab, verify the installation of the OpenTofu plugin.

Next steps

Connect orcharhino to Hetzner Cloud by using orcharhino management UI

You can use orcharhino with the OpenTofu plugin to provision, manage, and decommission hosts on Hetzner Cloud.

Prerequisites

  • You have an API token for your Hetzner Cloud account. You can create the token on the Hetzner Console web interface.

Procedure

  1. In the orcharhino management UI, navigate to Infrastructure > Compute Resources.

  2. Click Create Compute Resource.

  3. In the Name field, enter a name for the compute resource, for example, Hetzner Cloud.

    Append the name of your Hetzner Cloud account if you plan to use multiple accounts simultaneously.

  4. From the Provider list, select OpenTofu.

  5. Optional: In the Description field, enter a description for your compute resource.

  6. From the OpenTofu Provider menu, select Hetzner Cloud.

  7. From the OpenTofu Template menu, select Hetzner Cloud provision default.

  8. In the URL and Username fields, enter any arbitrary characters.

    orcharhino ignores them.

  9. In the Password field, enter your Hetzner Cloud token.

  10. Check Enable caching to cache API calls to Hetzner Cloud about clusters, network, or storage lists on orcharhino for 60 minutes.

    ATIX AG recommends to enable caching to improve performance.

  11. Click Submit.

Next steps

  • Create a compute profile to bundle hardware settings.

  • Define an image from your compute resource provider in orcharhino to perform image-based host provisioning.

  • Create a host group to bundle all settings in a blue print in orcharhino for reproducible host deployments.

Create a predefined configuration for hosts on Hetzner Cloud by using orcharhino management UI

You can add Hetzner Cloud hardware settings to a compute profile. When you create a host on Hetzner Cloud using this compute profile, these settings are automatically populated.

Procedure

  1. In the orcharhino management UI, navigate to Infrastructure > Compute Profiles.

  2. Select your compute profile.

  3. Select your Hetzner Cloud compute resource.

  4. From the Server Type list, select the server type to use for provisioning.

  5. From the Location list, select the geographical location of the Hetzner Cloud datacenter.

    The list of available locations is not dynamically reduced to the locations that allow the selected server type. You must check manually if the selected server type is available within the location. If you do not select a location, orcharhino automatically selects a compatible location.

  6. Select Backups if you want to have backups of your hosts enabled on Hetzner Cloud.

  7. Optional: From the Storage section, define additional Storage Volumes.

  8. From the Image list, select the image to use for provisioning.

  9. From the Network list, select the network to use for provisioning.

    The first network-interface will receive a public IP address. Selecting a managed subnet may therefore result in an error.

  10. Click Submit to save the values to your compute profile.

Define an image for hosts on Hetzner Cloud by using orcharhino management UI

Define an image that you use to provision hosts on Hetzner Cloud through orcharhino.

Procedure

  1. In the orcharhino management UI, navigate to Infrastructure > Compute Resources.

  2. Select your Hetzner Cloud compute resource.

  3. Click Create Image.

  4. In the Name field, enter the name of your golden image.

  5. From the Operating System list, select the operating system of the image on Hetzner Cloud.

  6. From the Architecture list, select the architecture of the image on Hetzner Cloud.

  7. In the Username field, enter the user name of your golden image.

  8. Select User Data if the host image supports user data.

  9. In the Password field, enter the password of the user on your golden image.

  10. From the Image list, select the image on Hetzner Cloud.

  11. Click Submit to save the values to orcharhino.

Provision a host on Hetzner Cloud by using orcharhino management UI

You can use orcharhino to provision a host on Hetzner Cloud.

Procedure

  1. In the orcharhino management UI, navigate to Hosts > Create Host.

  2. In the Name field, enter a name for the host.

  3. Optional: Click the Organization tab and change the organization context to match your requirement.

  4. Optional: Click the Location tab and change the location context to match your requirement.

  5. From the Host Group list, select a host group that you want to assign your host to. That host group will populate the form.

  6. From the Deploy on list, select the Hetzner Cloud compute resource.

  7. From the Compute Profile list, select a compute profile to automatically populate virtual machine settings.

  8. From the Lifecycle Environment list, select the environment.

  9. Click the Interfaces tab, and on the interface of the host, click Edit.

  10. Verify that the fields are populated with values. Note in particular:

    • orcharhino automatically assigns the public IP address generated by Hetzner Cloud to the first network interface of the new host.

    • The Name from the Host tab becomes the DNS name.

    • Ensure that orcharhino automatically selects the Managed, Primary, and Provision options for the first interface on the host. If not, select them.

  11. Click OK to save. To add another interface, click Add Interface. You can select only one interface for Provision and Primary.

    For more information about network interfaces, see Configuring network interfaces in Managing Hosts.

  12. On the Operating System tab, confirm that all fields automatically contain values.

  13. Click Resolve next to Provisioning templates to confirm that the host can identify its provisioning templates.

  14. Click the Virtual Machine tab and confirm that these settings are populated with details from the host group and compute profile.

  15. From the Server Type List, select the server type on Hetzner Cloud.

  16. From the Location List, select the geographical location of the host on Hetzner Cloud.

  17. On the Parameters tab, click Add parameter. Add a parameter named kt_activation_keys, select the string type, and enter the name of the activation key as the value. The activation key has to belong to the same organization as your host. You can also enter a comma-separated list of multiple activation keys.

  18. Click Submit to provision a host.

Additional resources

Delete a host on Hetzner Cloud

You can delete hosts running on Hetzner Cloud through orcharhino.

By default, deleting a host entry associated with a virtual machine does not destroy the virtual machine on the compute resource.

To change the default behavior, navigate to Administer > Settings > Provisioning and set Destroy associated VM on host delete to Yes.
Prerequisites

  • Ensure that the destroy_vm_on_host_delete setting is enabled.

Procedure

  1. In the orcharhino management UI, navigate to Hosts > All Hosts.

  2. Select your host.

  3. From the actions menu, click Delete.

  4. Click Delete to delete your host from orcharhino and Hetzner Cloud.

Additional resources

  • destroy_vm_on_host_delete setting

Connect orcharhino to Nutanix by using orcharhino management UI

You can use orcharhino with the OpenTofu plugin to provision, manage, and decommission hosts on Nutanix.

Procedure

  1. In the orcharhino management UI, navigate to Infrastructure > Compute Resources.

  2. Click Create Compute Resource.

  3. In the Name field, enter a name for the compute resource, for example, Nutanix.

    Append the name of your Nutanix account if you plan to use multiple accounts simultaneously.

  4. From the Provider list, select OpenTofu.

  5. Optional: In the Description field, enter a description for your compute resource.

  6. From the OpenTofu Provider menu, select Nutanix.

  7. From the OpenTofu Template menu, select Nutanix provision default.

  8. Check Enable caching to cache API calls to Nutanix about clusters, network, or storage lists on orcharhino for 60 minutes.

    ATIX AG recommends to enable caching to improve performance.

  9. Click Submit.

Next steps

  • Create a compute profile to bundle hardware settings.

  • Define an image from your compute resource provider in orcharhino to perform image-based host provisioning.

  • Create a host group to bundle all settings in a blue print in orcharhino for reproducible host deployments.

Create a predefined configuration for hosts on Nutanix by using orcharhino management UI

You can add Nutanix hardware settings to a compute profile. When you create a host on Nutanix using this compute profile, these settings are automatically populated.

Procedure

  1. In the orcharhino management UI, navigate to Infrastructure > Compute Profiles.

  2. Select your compute profile.

  3. Select your Nutanix compute resource.

  4. Click Submit to save the values to your compute profile.

Define an image for hosts on Nutanix by using orcharhino management UI

Define an image that you use to provision hosts on Nutanix through orcharhino.

Procedure

  1. In the orcharhino management UI, navigate to Infrastructure > Compute Resources.

  2. Select your Nutanix compute resource.

  3. Click Create Image.

  4. In the Name field, enter the name of your golden image.

  5. From the Operating System list, select the operating system of the image on Nutanix.

  6. From the Architecture list, select the architecture of the image on Nutanix.

  7. In the Username field, enter the user name of your golden image.

  8. Select User Data if the host image supports user data.

  9. In the Password field, enter the password of the user on your golden image.

  10. From the Image list, select the image on Nutanix.

  11. Click Submit to save the values to orcharhino.

Provision a host on Nutanix by using orcharhino management UI

You can use orcharhino to provision a host on Nutanix.

Procedure

  1. In the orcharhino management UI, navigate to Hosts > Create Host.

  2. In the Name field, enter a name for the host.

  3. Optional: Click the Organization tab and change the organization context to match your requirement.

  4. Optional: Click the Location tab and change the location context to match your requirement.

  5. From the Host Group list, select a host group that you want to assign your host to. That host group will populate the form.

  6. From the Deploy on list, select the Nutanix compute resource.

  7. From the Compute Profile list, select a compute profile to automatically populate virtual machine settings.

  8. From the Lifecycle Environment list, select the environment.

  9. Click the Interfaces tab, and on the interface of the host, click Edit.

  10. Verify that the fields are populated with values. Note in particular:

    • The Name from the Host tab becomes the DNS name.

    • Ensure that orcharhino automatically selects the Managed, Primary, and Provision options for the first interface on the host. If not, select them.

  11. Click OK to save. To add another interface, click Add Interface. You can select only one interface for Provision and Primary.

    For more information about network interfaces, see Configuring network interfaces in Managing Hosts.

  12. On the Operating System tab, confirm that all fields automatically contain values.

  13. Click Resolve next to Provisioning templates to confirm that the host can identify its provisioning templates.

  14. Click the Virtual Machine tab and confirm that these settings are populated with details from the host group and compute profile.

  15. On the Parameters tab, click Add parameter. Add a parameter named kt_activation_keys, select the string type, and enter the name of the activation key as the value. The activation key has to belong to the same organization as your host. You can also enter a comma-separated list of multiple activation keys.

  16. Click Submit to provision a host.

Additional resources

Delete a host on Nutanix

You can delete hosts running on Nutanix through orcharhino.

By default, deleting a host entry associated with a virtual machine does not destroy the virtual machine on the compute resource.

To change the default behavior, navigate to Administer > Settings > Provisioning and set Destroy associated VM on host delete to Yes.
Prerequisites

  • Ensure that the destroy_vm_on_host_delete setting is enabled.

Procedure

  1. In the orcharhino management UI, navigate to Hosts > All Hosts.

  2. Select your host.

  3. From the actions menu, click Delete.

  4. Click Delete to delete your host from orcharhino and Nutanix.

Additional resources

  • destroy_vm_on_host_delete setting

Appendix A: OpenTofu settings

The OpenTofu settings define how orcharhino interacts with OpenTofu.

Setting Default value Description

TfState Token Timeout

600

Allowed duration in seconds for OpenTofu to report back to orcharhino.

The text and illustrations on this page are licensed by ATIX AG under a Creative Commons Attribution Share Alike 4.0 International ("CC BY-SA 4.0") license. This page also contains text from the official Foreman documentation which uses the same license ("CC BY-SA 4.0").