Terraform Provider for Proxmox

A Terraform Provider which adds support for Proxmox solutions.

This repository is a fork of https://github.com/danitso/terraform-provider-proxmox which is no longer maintained.

Compatibility promise

This provider is compatible with the latest version of Proxmox VE (currently 8.0). While it may work with older 7.x versions, it is not guaranteed to do so.

While provider is on version 0.x, it is not guaranteed to be backwards compatible with all previous minor versions. However, we will try to keep the backwards compatibility between provider versions as much as possible.

Requirements

Proxmox Virtual Environment 8.x
TLS 1.3 for the Proxmox API endpoint
Terraform 1.4+
Go 1.21 (to build the provider plugin)

Building the provider

Clone the repository to $GOPATH/src/github.com/bpg/terraform-provider-proxmox:

mkdir -p "${GOPATH}/src/github.com/bpg"
cd "${GOPATH}/src/github.com/bpg"
git clone git@github.com:bpg/terraform-provider-proxmox

Enter the provider directory and build it:

cd "${GOPATH}/src/github.com/bpg/terraform-provider-proxmox"
make build

Using the provider

You can find the latest release and its documentation in the Terraform Registry.

Testing the provider

In order to test the provider, you can simply run make test.

make test

Tests are limited to regression tests, ensuring backwards compatibility.

A limited number of acceptance tests are available in the proxmoxtf/test directory, mostly for "new" functionality implemented using the Terraform Provider Framework. These tests are not run by default, as they require a Proxmox VE environment to be available. They can be run using make testacc, the Proxmox connection can be configured using environment variables, see provider documentation for details.

Deploying the example resources

There are number of TF examples in the example directory, which can be used to deploy a Container, VM, or other Proxmox resources on your test Proxmox environment. The following assumptions are made about the test environment:

It has one node named pve
The node has local storages named local and local-lvm
The "Snippets" content type is enabled in local storage

Create examples/terraform.tfvars with the following variables:

virtual_environment_username = "root@pam"
virtual_environment_password = "put-your-password-here"
virtual_environment_endpoint = "https://<your-cluster-endpoint>:8006/"

Then run make example to deploy the example resources.

Future work

The provider is using the Terraform SDKv2, which is considered legacy and is in maintenance mode. The work has started to migrate the provider to the new Terraform Plugin Framework, with aim to release it as a new major version 1.0.

Known issues

Disk images cannot be imported by non-PAM accounts

Due to limitations in the Proxmox VE API, certain actions need to be performed using SSH. This requires the use of a PAM account (standard Linux account).

Disk images from VMware cannot be uploaded or imported

Proxmox VE is not currently supporting VMware disk images directly. However, you can still use them as disk images by using this workaround:

resource "proxmox_virtual_environment_file" "vmdk_disk_image" {
  content_type = "iso"
  datastore_id = "datastore-id"
  node_name    = "node-name"

  source_file {
    # We must override the file extension to bypass the validation code
    # in the Proxmox VE API.
    file_name = "vmdk-file-name.img"
    path      = "path-to-vmdk-file"
  }
}

resource "proxmox_virtual_environment_vm" "example" {
  //...

  disk {
    datastore_id = "datastore-id"
    # We must tell the provider that the file format is vmdk instead of qcow2.
    file_format  = "vmdk"
    file_id      = "${proxmox_virtual_environment_file.vmdk_disk_image.id}"
  }

  //...
}

Snippets cannot be uploaded by non-PAM accounts

Due to limitations in the Proxmox VE API, certain files need to be uploaded using SFTP. This requires the use of a PAM account (standard Linux account).

Contributors

_{Dan R. Petersen} 💻	_{Pavel Boldyrev} 💻 🚧	_{Lucas Hahn} 💻	_{Alex Kulikovskikh} 💻	_{Oto Petřík} 💻 💬 🐛 📖	_Boik 💻	_{Abdelfadeel Farag} 💻
_{Szczepan Wiśniowski} 💻	_{Fabian Heib} 💻	_kaje783 💻	_michalg91 💻	_Cameron 💻	_{Chris Jones} 💻	_{Dominik Wombacher} 💻
_{Frank Villaro-Dixon} 💻	_{Gertjan Roggemans} 💻	_{Henri Williams} 💻	_{Jordan Keith} 💻	_{Kai Kahllund} 💻	_Kevin 💻	_{Krzysztof Magosa} 💻
_{Matt Burchett} 💻	_Moyiz 💻	_{Pablo Escobar Lopez} 💻	_Leah 💻	_{Pascal Wiedenbeck} 💻	_{Patrick Collins} 💻	_Prajwal 💻
_{Rafał Safin} 💻	_{Remko Molier} 💻	_{Tuomas Salmi} 💻	_ikiris 💻	_mleone87 💻	_{Ryan Yin} 💻	_zoop 💻
_{Simon Smith} 🐛 ⚠️	_grzeg1 🐛	_{Moustafa Baiou} 🐛 💻	_dandaolrian 💻	_Dmitry 🐛	_{Michael Franzl} 🐛	_{Emmanuel Benoît} 💻 🐛 ⚠️
_mandrav 💻 🐛	_{Michael Iseli} 💻 🐛	_{Risto Oikarinen} 💻	_dawidole 🐛	_{Gerard Krupa} ⚠️	_{Simon Caron} 💻	_{Piotr Maksymiuk} 🐛
_Kristopher 🤔	_{Eric B} ⚠️ 📖	_2b 🐛	_TheNotary 💻 ⚠️ 📖	_zamrih 🐛 💻	_Ratiborus 🐛 ⚠️	_{Sean Kleinjung} 🐛 💵
_{Daniel Mühlbachler-Pietrzykowski} 💻	_{windowsrefund} ⚠️	_Fabiosilvero ⚠️	_{DanielHabenicht} 🐛 📖 💻	_{Daniele De Lorenzi} 💻
Add your contributions

Stargazers

Sponsorship

❤️ This project is sponsored by:

TJ Zimmerman

Thanks again for your support, it is much appreciated! 🙏

License

rgl/terraform-provider-proxmox

ErrorLooks like something went wrong!

About

Resources

License

Code of conduct

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages