This release is a pre-release and may not be stable for production use.
MUP plugin for Waldur Site Agent
Integrates with MUP, the Portuguese project allocation portal, over its REST API. A Waldur project becomes a MUP project and each Waldur resource becomes one or more MUP allocations in it — one per component with a limit.
| Waldur | MUP |
|---|---|
Project (named <anything> / <grant number>) |
Project, looked up and created by grant number |
| Resource | One allocation per component, with the component's mup_allocation_type |
| Project member | User (a user request when MUP does not know the user yet) and project member |
The grant number is the part of the Waldur project name after the first /; a
project whose name has none cannot be ordered against this offering.
At a glance
| Entry point | Group | Role |
|---|---|---|
mup |
waldur_site_agent.backends |
order processing, membership sync, reporting |
Modes: order_process, membership_sync, report, event_process.
| Operation | Behaviour |
|---|---|
| Create resource | Creates and activates the MUP project if needed, then one allocation per component |
| Terminate resource | Deactivates the MUP project (allocations are not deleted) |
| Update limits | Updates each component's allocation size |
| Add / remove members | Creates the MUP user or user request, adds or deactivates the project member |
| Pause / downscale / restore | No-op — returns False, nothing changes in MUP |
| Usage reporting | Allocation usage from MUP, converted with each component's unit_factor |
Users the agent creates start in MUP's "pending approval" state; a MUP administrator may have to approve them before they can join projects.
Configuration
offerings:
- name: "MUP HPC allocation"
waldur_api_url: "https://waldur.example.com/api/"
waldur_api_token: "<token>"
waldur_offering_uuid: "<offering uuid>"
backend_type: "mup"
order_processing_backend: "mup"
membership_sync_backend: "mup"
reporting_backend: "mup"
backend_settings:
api_url: "https://mup.example.pt/"
username: "<mup user>"
password: "<mup password>"
default_research_field: 1
default_agency: "FCT"
project_prefix: "waldur_"
allocation_prefix: "alloc_"
backend_components:
cpu:
measured_unit: "core-hours"
unit_factor: 1
accounting_type: "limit"
label: "CPU core hours"
mup_allocation_type: "Deucalion x86_64"
storage:
measured_unit: "GB"
unit_factor: 1
accounting_type: "limit"
label: "Storage"
mup_allocation_type: "storage"
Backend settings
Validated by waldur_site_agent_mup.schemas.MUPBackendSettingsSchema; a
misspelt or missing required key is logged as a warning when the agent loads
its configuration, and the backend refuses to start without the three required
ones.
| Setting | Required | Default | Description |
|---|---|---|---|
api_url |
yes | — | MUP base URL |
username |
yes | — | MUP API user |
password |
yes | — | MUP API password |
default_research_field |
no | 1 |
Research field id for new projects |
default_agency |
no | FCT |
Funding agency for new projects |
default_storage_limit |
no | 1000 |
Storage allocation size in GB when an order gives none |
project_prefix |
no | waldur_ |
Prefix of project identifiers |
allocation_prefix |
no | alloc_ |
Prefix of allocation identifiers |
default_user_salutation |
no | Dr. |
Used when creating a user request |
default_user_gender |
no | Other |
Used when the Waldur user has none |
default_user_birth_year |
no | 1990 |
Used when the Waldur user has no birth date |
default_user_country |
no | Portugal |
Full country name |
default_user_institution_type |
no | Academic |
|
default_user_institution |
no | Research Institution |
|
default_user_biography |
no | Researcher using Waldur site agent for resource allocation |
|
user_funding_agency_prefix |
no | WALDUR-SITE-AGENT- |
Prefix of generated grant ids for users |
Keys the agent core reads for every backend (customer_prefix, soft_delete,
backend-id uniqueness) are described in Configuration.
Components
Every component must use accounting_type: limit — the backend refuses to
start otherwise. mup_allocation_type names the MUP allocation type the
component's allocation is created with (default Deucalion x86_64).
Tests
cd plugins/mup && uv run pytest tests/
Metadata
Release files for waldur-site-agent-mup 1.0.8rc13
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| waldur_site_agent_mup-1.0.8rc13.tar.gz | 38.1 kB | Without provenance | Details for waldur_site_agent_mup-1.0.8rc13.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| waldur_site_agent_mup-1.0.8rc13-py3-none-any.whl | Python 3 | none | any | Details for waldur_site_agent_mup-1.0.8rc13-py3-none-any.whl |
Total release size: 60.1 kB
Release files / waldur_site_agent_mup-1.0.8rc13.tar.gz
| Download URL | waldur_site_agent_mup-1.0.8rc13.tar.gz |
|---|---|
| Size | 38.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b611b7b0a6988ebd6bfff89935e778327384a81ebdc1f368645fb0c79a2497ca
|
|
BLAKE2b-256 checksum How to use checksums |
e8b2c8bb6d960d60ae87f4822c800356b44458f746062ea2100c820c66c879c9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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_mup-1.0.8rc13-py3-none-any.whl
| Download URL | waldur_site_agent_mup-1.0.8rc13-py3-none-any.whl |
|---|---|
| Size | 22.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e2906264bdb258118cb6618706f7a0afbc5646ab3576531dd18143754be7fd36
|
|
BLAKE2b-256 checksum How to use checksums |
4d6e6ad3861c38b2eb3467e1296bcaf1a273bcfb08dcb4bebb5d3e978bafe333
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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}
|
Security for waldur-site-agent-mup 1.0.8rc13
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.