DigitalOcean plugin for Waldur Site Agent

This plugin integrates Waldur Site Agent with DigitalOcean using the python-digitalocean SDK. It provisions droplets based on marketplace orders and exposes droplet metadata back to Waldur.

Configuration

Example configuration for an offering:

offerings:
  - name: DigitalOcean VM
    waldur_api_url: https://waldur.example.com/api/
    waldur_api_token: <TOKEN>
    waldur_offering_uuid: <OFFERING_UUID>
    backend_type: digitalocean
    order_processing_backend: digitalocean
    reporting_backend: digitalocean
    membership_sync_backend: digitalocean
    backend_settings:
      token: <DIGITALOCEAN_API_TOKEN>
      default_region: ams3
      default_image: ubuntu-22-04-x64
      default_size: s-1vcpu-1gb
      default_user_data: |
        #cloud-config
        packages:
          - htop
      default_tags:
        - waldur
    backend_components:
      cpu:
        measured_unit: Cores
        unit_factor: 1
        accounting_type: limit
        label: CPU
      ram:
        measured_unit: MiB
        unit_factor: 1
        accounting_type: limit
        label: RAM
      disk:
        measured_unit: MiB
        unit_factor: 1
        accounting_type: limit
        label: Disk

Resource attributes

You can override defaults per resource using attributes passed from Waldur:

region or backend_region_id
image or backend_image_id
size or backend_size_id
user_data or cloud_init
ssh_key_id, ssh_key_fingerprint, or ssh_public_key
ssh_key_name (optional when using ssh_public_key)
tags (list of strings)

If ssh_public_key is provided, the plugin will create the key in DigitalOcean if it does not already exist.

Resize via limits

To resize droplets from UPDATE orders, you can provide a size mapping:

backend_settings:
  size_mapping:
    s-1vcpu-1gb:
      cpu: 1
      ram: 1024
      disk: 25

When limits match an entry in size_mapping, the droplet will be resized to the corresponding size_slug.

Metadata

Release files for waldur-site-agent-digitalocean 1.0.6rc19

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for waldur-site-agent-digitalocean 1.0.6rc19
File	Size	Uploaded
waldur_site_agent_digitalocean-1.0.6rc19.tar.gz	8.3 kB	Aug 26, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for waldur-site-agent-digitalocean 1.0.6rc19
File	Interpreter	ABI	Platform	Reset
waldur_site_agent_digitalocean-1.0.6rc19-py3-none-any.whl 9.1 kB Aug 26, 2026	Python 3	none	any	Details

Total release size: 17.4 kB

Release files / waldur_site_agent_digitalocean-1.0.6rc19.tar.gz

Download URL	waldur_site_agent_digitalocean-1.0.6rc19.tar.gz
Size	8.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`8e90606f07233bbc8db8c5f577e63afdf7cd2440a616fbb4461aec71532e3563`
BLAKE2b-256 checksum How to use checksums	`bde8c1a9410a3a28fd507205216f7faf851e37aa638d8595ed59302c3924f66f`
Upload date	Aug 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / waldur_site_agent_digitalocean-1.0.6rc19-py3-none-any.whl

Download URL	waldur_site_agent_digitalocean-1.0.6rc19-py3-none-any.whl
Size	9.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`92384e65f58cb3880fa10e3c3b8bfebf806ed615d44e10f86d93650c6a6cae76`
BLAKE2b-256 checksum How to use checksums	`91e93039e2fffcd140fcaef6acf26b22c77c407519013b785c4f3e33913abe76`
Upload date	Aug 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`