Skip to main content

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.7

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.7
File Size Uploaded
waldur_site_agent_digitalocean-1.0.7.tar.gz 8.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for waldur-site-agent-digitalocean 1.0.7
File Interpreter ABI Platform
waldur_site_agent_digitalocean-1.0.7-py3-none-any.whl Python 3 none any Details

Total release size: 17.4 kB

Release files / waldur_site_agent_digitalocean-1.0.7.tar.gz

Download URL waldur_site_agent_digitalocean-1.0.7.tar.gz
Size 8.3 kB
Tags Source
SHA-256 checksum
How to use checksums
c6254d3dec8d6f2a8830ac0629baf794d24cc769a9657a964cdd10d47312ae5f
BLAKE2b-256 checksum
How to use checksums
1b0263d03bc4f72d32bf064adb965b50b885eac031210fe3c2564150121db388
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","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.7-py3-none-any.whl

Download URL waldur_site_agent_digitalocean-1.0.7-py3-none-any.whl
Size 9.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
de92e1d3126fcb0ffe61dd19d75c9252c99792919e12542520b756735b79218e
BLAKE2b-256 checksum
How to use checksums
f228d10d4b92ef8f305ccfd7fc3e489a870e44a6e6750abefe9cace994fed017
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","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 history Release notifications | RSS feed

This release

1.0.7 This release

2 release files

1.0.5

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.0

2 release files

0.9.9

2 release files

0.9.8

2 release files

0.9.7

2 release files

0.9.6

2 release files

0.9.5

2 release files

0.9.4

2 release files

0.9.3

2 release files

0.9.2

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page