Skip to content

Deployment lineage graph storage proposal#11848

Open
brooke-hamilton wants to merge 2 commits into
mainfrom
brooke-hamilton/radius-graph-storage
Open

Deployment lineage graph storage proposal#11848
brooke-hamilton wants to merge 2 commits into
mainfrom
brooke-hamilton/radius-graph-storage

Conversation

@brooke-hamilton
Copy link
Copy Markdown
Member

Description

Adds a design proposal for a versioned graph storage system that connects deployed Radius resources to the source artifacts (app.bicep files, parameters, recipes, environment configuration, and deployment operations) that produced them.

The proposal introduces:

  • A versioned graph of deployed state and source artifacts, traversable in both directions (from deployed resource back to source, or from source forward to every resource it produced).
  • A comparison of current vs. future storage models.
  • High-level features including versioned graph state, graph querying, multiple runtime modes (local stateless, server stateless, long-running stateful), and ingest from existing tools (Kustomize, KRO, Flux, etc.).

Files added under specs/003-git-app-graph-storage/:

  • radius-graph-proposal.md — the proposal document.
  • design-notes.md — supporting design notes.

This is a documentation-only change; no code or APIs are affected.

Type of change

  • This pull request is a design document and only includes files in the eng/design-notes directory.

Fixes: #N/A

Contributor checklist

  • An overview of proposed schema changes is included in a linked GitHub issue.
    • Yes
    • Not applicable
  • A design document is added or updated under `eng/design-notes/` in this repository, if new APIs are being introduced.
    • Yes
    • Not applicable
  • The design document has been reviewed and approved by Radius maintainers/approvers.
    • Yes
    • Not applicable
  • A PR for resource-types-contrib is created, if resource types or recipes are affected by the changes in this PR.
    • Yes
    • Not applicable
  • A PR for dashboard is created, if the Radius Dashboard is affected by the changes in this PR.
    • Yes
    • Not applicable
  • A PR for the documentation repository is created, if the changes in this PR affect the documentation or any user facing updates are made.
    • Yes
    • Not applicable

Signed-off-by: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>
Signed-off-by: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>
@brooke-hamilton brooke-hamilton requested a review from a team as a code owner May 11, 2026 16:17
Copilot AI review requested due to automatic review settings May 11, 2026 16:17
@brooke-hamilton brooke-hamilton requested a review from a team as a code owner May 11, 2026 16:17
@github-actions
Copy link
Copy Markdown

This PR requires exactly 1 of the following labels: pr:standard, pr:important.
Currently applied labels: .

Label descriptions:

  • pr:important - Major features, breaking changes, deprecations, or other high-impact changes that need special attention during release.
  • pr:standard - Ongoing maintenance, minor improvements, documentation updates, and routine development work.

@brooke-hamilton, please add the appropriate label to this PR before merging.

@github-actions
Copy link
Copy Markdown

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

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 a design proposal describing a versioned “deployment lineage” graph that links deployed Radius resources back to the exact source artifacts (Bicep, params, recipes, env config) and forward from artifacts to all resulting deployments. This fits into the repo’s specs/ design/proposal area as a documentation-only exploration of future storage and query capabilities.

Changes:

  • Add a proposal doc outlining a versioned graph model, current vs. future storage comparison, and high-level feature set.
  • Add supporting design notes covering schema mapping concepts, runtime modes, serialization goals, and migration ideas.

Reviewed changes

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

File Description
specs/003-git-app-graph-storage/radius-graph-proposal.md Introduces the core “deployment lineage” versioned graph proposal and illustrative diagrams.
specs/003-git-app-graph-storage/design-notes.md Adds background/design notes on graph projection, storage modes, schema mappings, and migration concepts.

Comment on lines +1 to +3
# Design Notes: Git App Graph Preview

**Feature Branch**: `001-git-app-graph-preview`

**Feature Branch**: `001-git-app-graph-preview`
**Last Updated**: February 5, 2026
**Related**: [spec.md](spec.md)
Comment on lines +227 to +231
## Implications for Implementation

These conceptual foundations inform several implementation decisions in the [spec](spec.md):

1. **Committed Artifact Model**: The graph is committed to version control (`.radius/app-graph.json`) because it's a derived projection, not primary state
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.

2 participants