A [Pulumi](https://www.pulumi.com) package to manage [Proxmox Virtual Environment](http://proxmox.com) (Proxmox VE) resources. This provider is built on the [Terraform Proxmox Provider](https://github.com/bpg/terraform-provider-proxmox).
## Installation
This package is available for multiple programming languages. Install using your preferred package manager:
### Node.js (JavaScript/TypeScript)
```bash
npm install @muhlba91/pulumi-proxmoxve
# or
yarn add @muhlba91/pulumi-proxmoxve
```
### Python
```bash
pip install pulumi-proxmoxve
```
### Go
```bash
go get github.com/muhlba91/pulumi-proxmoxve/sdk/v6/go/proxmoxve
```
### .NET
```bash
dotnet add package Pulumi.ProxmoxVE
```
## Configuration
You must configure the provider with your Proxmox VE API credentials. Currently, you must explicitly pass configuration values to the provider constructor. You can use environment variables to manage these secrets:
| Variable | Description |
|------------------------|-----------------------------------------------------------------------------------|
| `PROXMOX_VE_ENDPOINT` | The API endpoint of your Proxmox VE server (e.g., `https://pve.example.com:8006`) |
| `PROXMOX_VE_USERNAME` | Your Proxmox VE username |
| `PROXMOX_VE_PASSWORD` | Your Proxmox VE password or API token |
| `PROXMOX_VE_INSECURE` | Set to `true` to skip TLS certificate verification |
## Example Usage
### TypeScript
```typescript
import * as pulumi from '@pulumi/pulumi';
import * as proxmox from '@muhlba91/pulumi-proxmoxve';
// Initialize the Proxmox provider
const provider = new proxmox.Provider('proxmoxve', {
endpoint: process.env.PROXMOX_VE_ENDPOINT,
username: process.env.PROXMOX_VE_USERNAME,
password: process.env.PROXMOX_VE_PASSWORD,
insecure: process.env.PROXMOX_VE_INSECURE === 'true',
});
// Create a Virtual Machine
const vm = new proxmox.vm.VirtualMachine('my-vm', {
nodeName: 'pve-node-1',
// ... further configuration
}, { provider });
```
## Migration
### v7 to v8 (Breaking Changes)
Version 8 introduces a breaking change in how resources are named to align with the upstream Terraform provider's transition to the modern provider framework.
- **Standardized Resource Names**: Due to the upstream provider introducing the `proxmox_` prefix and standardizing resource identification, custom resource name and ID changes have been deprecated.
- **Legacy Namespacing**: Resources that previously started with `proxmox_virtual_environment_` have been moved to a `Legacy` naming format (e.g., `proxmoxve:VM/virtualMachine:VirtualMachine` is now `proxmoxve:index/vmLegacy:VmLegacy`).
- **Standardized Resource IDs**: Resources which have an `id` input exposed by the Terraform provider are consistently renamed to `resourceId`. In particular, this affects resources created using the Terraform provider framework.
#### State Migration
You can migrate your existing stack by exporting the state, updating the resource tokens, and re-importing:
```bash
pulumi stack export > stack.json
# Example: updating the VirtualMachine resource token
sed -i 's/proxmoxve:VM\/virtualMachine:VirtualMachine/proxmoxve:index\/vmLegacy:VmLegacy/g' stack.json
pulumi stack import < stack.json
```
#### ID Migration
For resources that have an `id` input, you will need to update your code to use `resourceId` instead. For example:
```typescript
// Example: updating a Vnet resource to use resourceId instead of id
// Before
const vnet = new proxmox.sdn.Vnet('my-vnet', {
vnetId: '1',
// ... further configuration
});
// After
const vnet = new proxmox.sdn.Vnet('my-vnet', {
resourceId: '1',
// ... further configuration
});
```
## Reference
- **Upstream Provider Reference**: [Terraform Proxmox Provider Documentation](https://registry.terraform.io/providers/bpg/proxmox/latest/docs)
- **Proxmox API**: [Proxmox VE API Viewer](https://pve.proxmox.com/pve-docs/api-viewer/index.html)
- **Official Documentation**: [Proxmox VE Documentation](https://pve.proxmox.com/pve-docs/)
## Contributors
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
 Daniel Mühlbachler-Pietrzykowski 🚧 💻 📖 |
 Nelson Costa Martins 💡 |
 Guinevere Saenger 📖 |
 Susan Evans 📖 |
 zamrih 💻 |