https://github.com/valkiriaaquatica/provider-proxmox-bpg
A Crossplane provider to interact with ProxmoxVE
https://github.com/valkiriaaquatica/provider-proxmox-bpg
crossplane iac infrastructure-as-code kubernetes provider proxmox proxmox-ve terraform
Last synced: about 2 months ago
JSON representation
A Crossplane provider to interact with ProxmoxVE
- Host: GitHub
- URL: https://github.com/valkiriaaquatica/provider-proxmox-bpg
- Owner: valkiriaaquatica
- License: apache-2.0
- Created: 2025-06-06T19:36:34.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-14T01:57:54.000Z (2 months ago)
- Last Synced: 2026-04-14T03:22:55.008Z (2 months ago)
- Topics: crossplane, iac, infrastructure-as-code, kubernetes, provider, proxmox, proxmox-ve, terraform
- Language: Go
- Homepage:
- Size: 32.7 MB
- Stars: 17
- Watchers: 1
- Forks: 1
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
- Dco: DCO
Awesome Lists containing this project
README
# Proxmox BPG Provider
`provider-proxmox-bpg` is a [Crossplane](https://crossplane.io/) provider built using
[Upjet](https://github.com/crossplane/upjet). It exposes XRM-conformant managed
resources for the [Proxmox Virtual Environment](https://www.proxmox.com/) API. This provider it is already compatible with crossplane v2.
## 🚀 Release Automation
This repository automatically publishes a new release every time the upstream Terraform provider releases a new version:
👉 **Original Terraform Provider:** [bpg/terraform-provider-proxmox](https://github.com/bpg/terraform-provider-proxmox)
The automation works through a fully-integrated release pipeline:
1. **Version Detection** – Handled by our configured [Renovate Bot](https://github.com/valkiriaaquatica/provider-proxmox-bpg/blob/main/.github/renovate.json), which tracks new upstream releases.
2. **Version Preparation** – When Renovate opens a PR, the custom [Prepare New Version GitHub Action](https://github.com/valkiriaaquatica/provider-proxmox-bpg/blob/main/.github/workflows/prepare-new-version.yaml) adjusts the module and prepares the next tag.
3. **Automated Publishing** – Once the PR is merged, [Release Please](https://github.com/valkiriaaquatica/provider-proxmox-bpg/blob/main/.github/workflows/release-please.yml) generates changelogs and publishes the release automaticaly
Thanks to this pipeline, **this repository always stays up-to-date with the latest upstream provider version** — no manual intervention required, **JUST** when a new CRD (resource) is added (that will be future automated).
---
## 🔧 For Upjet / Crossplane Developers
If you’re building a Crossplane provider using **Upjet**, feel free to reuse or adapt this release configuration to automate your own provider’s lifecycle.
Having an auto-syncing provider dramatically simplifies maintenance and ensures your Crossplane collection stays aligned with upstream changes.
## Installation (make sure you have Crossplane before installed in your cluster)
- Using [up](https://docs.upbound.io/reference/cli/):
Install the provider by using the following command after changing the image tag
to the [latest release](https://marketplace.upbound.io/providers/upbound/provider-proxmox-bpg):
```
up ctp provider install xpkg.upbound.io/valkiriaaquaticamendi/provider-proxmox-bpg:v1.0.0
```
- Declarative installation
```
cat <