Skip to content

Document <resource-tags> element in deployment.xml#4654

Merged
gjoranv merged 1 commit intomasterfrom
resource-tags-docs
Apr 24, 2026
Merged

Document <resource-tags> element in deployment.xml#4654
gjoranv merged 1 commit intomasterfrom
resource-tags-docs

Conversation

@gjoranv
Copy link
Copy Markdown
Member

@gjoranv gjoranv commented Apr 20, 2026

Adds reference documentation for the new <resource-tags> element in deployment.xml, which lets Vespa Cloud Enclave customers apply custom tags to the cloud resources (VMs and attached disks) provisioned in their own cloud accounts.

Changes

  • en/reference/applications/deployment.html: new <h2 id="resource-tags"> section (between backup and upgrade) covering:
    • XML syntax and merging semantics (<deployment> vs <instance> level, instance wins on key conflict)
    • Example with top-level and instance-level tags
    • <tag> attribute table (key, value) with validation rules
    • Template variables: ${tenant}, ${application}, ${instance}, ${environment}, ${region} (lowercased at resolution)
    • Limits: up to 20 tags after merging, vai_ prefix reserved, enclave-only, GCP-strict character rules applied uniformly across AWS/Azure/GCP
    • Reconciliation behavior: VMs and disks, tag removal on delete, customer-added tags preserved
  • en/operations/enclave/operations.md: short "Custom resource tags" section linking to the reference.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds reference documentation for the new <resource-tags> element in deployment.xml, enabling Vespa Cloud Enclave customers to apply custom tags to cloud resources provisioned in their own cloud accounts.

Changes:

  • Documented <resource-tags> syntax, merge semantics, constraints, limits, and reconciliation behavior in deployment.xml reference.
  • Added an Enclave operations note linking to the new reference section.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
en/reference/applications/deployment.html Introduces a new resource-tags reference section with syntax, constraints, template variables, and reconciliation semantics.
en/operations/enclave/operations.md Adds a short “Custom resource tags” section linking to the reference documentation.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

- New reference section for <resource-tags> and <tag> children
- Covers merging, template variables, validation rules, reconciliation
- Link from enclave operations page
@gjoranv gjoranv force-pushed the resource-tags-docs branch from b756054 to c27b97a Compare April 20, 2026 09:23
@gjoranv gjoranv marked this pull request as draft April 20, 2026 09:24
@gjoranv gjoranv requested review from frodelu and kkraune April 20, 2026 09:25
Copy link
Copy Markdown
Member

@kkraune kkraune left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍 Thanks!

Comment thread en/reference/applications/deployment.html
@gjoranv gjoranv marked this pull request as ready for review April 24, 2026 10:39
@gjoranv gjoranv merged commit 9013423 into master Apr 24, 2026
@gjoranv gjoranv deleted the resource-tags-docs branch April 24, 2026 10:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants