mirror of
https://github.com/bpg/terraform-provider-proxmox.git
synced 2025-07-05 05:24:01 +00:00
192cbd5e3d
* Update TF SDK using `tf-sdk-migrator v2upgrade`
Address some linter issues
Clean up `resource_virtual_environment_file.go` (still, error handling is not ideal)
* few minor cleanups
* Clean up, add context and diagnostics to `resource_virtual_environment_vm.go`
* Clean up, add context and diagnostics to `resource_virtual_environment_container.go`
* Clean up, add context and diagnostics to `resource_virtual_environment_container.go`
* Update remaining resources and data sources
* fix `make example`... now it actually uses the built provider 🤦
* propagate Context everywhere
use tflog.* for logging
* add support for debug flag
* fix old issues with:
- setting `resource_virtual_environment_file.changed` attribute
- setting `resource_virtual_environment_cluster_ipset.cidr` attributes
- setting `data_source_virtual_environment_user.groups` and `.keys` attributes
* bump dependencies
* minor cleanups
* Bump Go to v1.18
Dropped support for TF v0.x
* more cleanups
* update README.md
* update PR template
* update release.yml
115 lines
4.4 KiB
Markdown
115 lines
4.4 KiB
Markdown
[](https://goreportcard.com/report/github.com/bpg/terraform-provider-proxmox)
|
|
[](http://godoc.org/github.com/bpg/terraform-provider-proxmox)
|
|
[](https://github.com/bpg/terraform-provider-proxmox/releases/latest)
|
|
[](https://github.com/bpg/terraform-provider-proxmox/releases/latest)
|
|
[](https://github.com/bpg/terraform-provider-proxmox/stargazers)
|
|
|
|
# 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 with several critical fixes to unblock
|
|
VM deployment in Proxmox v7.0, and a few other enhancements.
|
|
|
|
## Compatibility Matrix
|
|
|
|
| Proxmox version | Provider version |
|
|
|-----------------|--------------------------|
|
|
| 6.x | \<= 0.4.4 |
|
|
| 7.x | 0.4.x \> 0.4.4 <br>0.5.x |
|
|
|
|
## Requirements
|
|
- [Terraform](https://www.terraform.io/downloads.html) 1.0+
|
|
- [Go](https://golang.org/doc/install) 1.18+ (to build the provider plugin)
|
|
- [GoReleaser](https://goreleaser.com/install/) v1.10+ (to build the provider plugin)
|
|
|
|
## Table of Contents
|
|
- [Building the provider](#building-the-provider)
|
|
- [Using the provider](#using-the-provider)
|
|
- [Testing the provider](#testing-the-provider)
|
|
- [Known issues](#known-issues)
|
|
|
|
## Building the provider
|
|
- Clone the repository to `$GOPATH/src/github.com/bpg/terraform-provider-proxmox`:
|
|
|
|
```sh
|
|
$ 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:
|
|
|
|
```sh
|
|
$ 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](https://registry.terraform.io/providers/bpg/proxmox/latest).
|
|
|
|
## Testing the provider
|
|
In order to test the provider, you can simply run `make test`.
|
|
|
|
```sh
|
|
$ make test
|
|
```
|
|
|
|
Tests are limited to regression tests, ensuring backwards compatibility.
|
|
|
|
## Deploying the example resources
|
|
|
|
There are number of TF examples in the `examples` directory, which can be used to deploy a Container, VM, or other Proxmox resources on your test Proxmox cluster.
|
|
The following assumptions are made about the test Proxmox cluster:
|
|
- It has one node named `pve`
|
|
- The node has local storages named `local` and `local-lvm`
|
|
|
|
Create `examples/terraform.tfvars` with the following variables:
|
|
|
|
```sh
|
|
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.
|
|
|
|
|
|
|
|
## 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:
|
|
|
|
```hcl
|
|
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).
|