Skip to content

Architecture doc describing credentials#11837

Merged
brooke-hamilton merged 7 commits into
mainfrom
brooke-hamilton/credential-docs
Jun 1, 2026
Merged

Architecture doc describing credentials#11837
brooke-hamilton merged 7 commits into
mainfrom
brooke-hamilton/credential-docs

Conversation

@brooke-hamilton

Copy link
Copy Markdown
Member

Description

This pull request updates the architecture documentation to include information about cloud credentials and their management. The main changes add a new reference to a credentials.md document, both in the list of architecture documents and in the recommended reading order for new contributors.

Documentation updates:

  • Added a reference to credentials.md in the main architecture documentation list, describing how cloud credentials are stored and used for deployments, and how clients authenticate to a Radius install.
  • Updated the recommended reading order for new contributors to include credentials.md before application-graph.md.

Type of change

  • This pull request is a minor refactor, code cleanup, test improvement, or other maintenance task and doesn't change the functionality of Radius (issue link optional).

Fixes: N/A

Contributor checklist

Please verify that the PR meets the following requirements, where applicable:

  • 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>
Copilot AI review requested due to automatic review settings May 8, 2026 00:32
@brooke-hamilton brooke-hamilton requested review from a team as code owners May 8, 2026 00:32
@github-actions

github-actions Bot commented May 8, 2026

Copy link
Copy Markdown

Dependency Review

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

Scanned Files

None

Signed-off-by: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Updates the architecture documentation set to cover how Radius manages cloud credentials (outbound) and how clients authenticate to a Radius install (inbound), and adds this new doc to the architecture reading list for contributors.

Changes:

  • Added a new architecture document, docs/architecture/credentials.md, describing credential storage, resolution flows, supported auth kinds, and supported cluster topologies.
  • Updated docs/architecture/README.md to reference credentials.md and include it in the recommended reading order.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File Description
docs/architecture/README.md Adds credentials.md to the architecture index and contributor reading order.
docs/architecture/credentials.md New end-to-end credential/auth architecture doc grounded in current code paths and Helm configuration.

Comment thread docs/architecture/credentials.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>
@brooke-hamilton brooke-hamilton requested a review from zachcasper May 8, 2026 00:39
@github-actions

github-actions Bot commented May 8, 2026

Copy link
Copy Markdown

Unit Tests

    2 files  ±0    435 suites  ±0   7m 32s ⏱️ -8s
5 250 tests ±0  5 248 ✅ ±0  2 💤 ±0  0 ❌ ±0 
6 372 runs  ±0  6 370 ✅ ±0  2 💤 ±0  0 ❌ ±0 

Results for commit 9a16618. ± Comparison against base commit 344c0e5.

♻️ This comment has been updated with latest results.

@codecov

codecov Bot commented May 8, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 51.95%. Comparing base (344c0e5) to head (9a16618).

Additional details and impacted files
@@           Coverage Diff           @@
##             main   #11837   +/-   ##
=======================================
  Coverage   51.95%   51.95%           
=======================================
  Files         732      732           
  Lines       46305    46305           
=======================================
+ Hits        24057    24059    +2     
+ Misses      19949    19948    -1     
+ Partials     2299     2298    -1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@zachcasper zachcasper left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Wow, this is an awesome architecture documentation agent that put this together. The content seems comprehensive given the information the agent had. However, a key piece that is missing is how credentials are handled between Radius and Terraform, and Radius and Bicep. There is a lot of detail about how UCP gets the AWS or Azure credentials, but that is almost immaterial to Radius functionality since all resource create/destroy operations pass through Terraform or Bicep.

@sylvainsf sylvainsf left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

looks great!

@brooke-hamilton brooke-hamilton enabled auto-merge (squash) June 1, 2026 18:16
@radius-functional-tests

radius-functional-tests Bot commented Jun 1, 2026

Copy link
Copy Markdown

Radius functional test overview

🔍 Go to test action run

Click here to see the test run details
Name Value
Repository radius-project/radius
Commit ref 9a16618
Unique ID func4bdb5b63d2
Image tag pr-func4bdb5b63d2
  • gotestsum 1.13.0
  • KinD: v0.29.0
  • Dapr: 1.14.4
  • Azure KeyVault CSI driver: 1.4.2
  • Azure Workload identity webhook: 1.3.0
  • Bicep recipe location ghcr.io/radius-project/dev/test/testrecipes/test-bicep-recipes/<name>:pr-func4bdb5b63d2
  • Terraform recipe location http://tf-module-server.radius-test-tf-module-server.svc.cluster.local/<name>.zip (in cluster)
  • applications-rp test image location: ghcr.io/radius-project/dev/applications-rp:pr-func4bdb5b63d2
  • dynamic-rp test image location: ghcr.io/radius-project/dev/dynamic-rp:pr-func4bdb5b63d2
  • controller test image location: ghcr.io/radius-project/dev/controller:pr-func4bdb5b63d2
  • ucp test image location: ghcr.io/radius-project/dev/ucpd:pr-func4bdb5b63d2
  • deployment-engine test image location: ghcr.io/radius-project/deployment-engine:latest

Test Status

⌛ Building Radius and pushing container images for functional tests...
✅ Container images build succeeded
⌛ Publishing Bicep Recipes for functional tests...
✅ ucp-cloud functional tests succeeded
✅ Recipe publishing succeeded
⌛ Starting corerp-cloud functional tests...
⌛ Starting ucp-cloud functional tests...
✅ ucp-cloud functional tests succeeded
❌ corerp-cloud functional test failed. Please check the logs for more details
✅ corerp-cloud functional tests succeeded

@brooke-hamilton brooke-hamilton merged commit 2fdef03 into main Jun 1, 2026
57 checks passed
@brooke-hamilton brooke-hamilton deleted the brooke-hamilton/credential-docs branch June 1, 2026 19:01
Reshrahim pushed a commit to Reshrahim/radius that referenced this pull request Jun 15, 2026
# Description

This pull request updates the architecture documentation to include
information about cloud credentials and their management. The main
changes add a new reference to a `credentials.md` document, both in the
list of architecture documents and in the recommended reading order for
new contributors.

Documentation updates:

* Added a reference to `credentials.md` in the main architecture
documentation list, describing how cloud credentials are stored and used
for deployments, and how clients authenticate to a Radius install.
* Updated the recommended reading order for new contributors to include
`credentials.md` before `application-graph.md`.

## Type of change

- This pull request is a minor refactor, code cleanup, test improvement,
or other maintenance task and doesn't change the functionality of Radius
(issue link optional).

Fixes: N/A

## Contributor checklist
Please verify that the PR meets the following requirements, where
applicable:

- 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](https://github.com/radius-project/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](https://github.com/radius-project/dashboard/) is
created, if the Radius Dashboard is affected by the changes in this PR.
    - [ ] Yes
    - [ ] Not applicable
- A PR for the [documentation
repository](https://github.com/radius-project/docs) 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>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Reshma Abdul Rahim <reshmarahim.abdul@microsoft.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants