Skip to content

Project Lattice PRFAQ#11643

Draft
zachcasper wants to merge 22 commits into
radius-project:mainfrom
zachcasper:github-radius-spec
Draft

Project Lattice PRFAQ#11643
zachcasper wants to merge 22 commits into
radius-project:mainfrom
zachcasper:github-radius-spec

Conversation

@zachcasper

@zachcasper zachcasper commented Apr 14, 2026

Copy link
Copy Markdown
Contributor

Description

This PR contains the PRFAQ for Project Lattice—-the integration of Radius into the GitHub Copilot application for individual developers, small teams, and open-source maintainers. It contains the press release, general FAQs, and internal FAQs covering architecture, Bicep rationale, MVP scope, fast-follow features, recipe ownership, and the relationship to Kubernetes-based Radius.

The previous feature spec and UX walkthrough has been archived here.

Type of change

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

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 PR is created in the design-notes 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 the samples repository is created, if existing samples are 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: Zach Casper <zachcasper@microsoft.com>
@zachcasper zachcasper requested review from a team as code owners April 14, 2026 18:37
Copilot AI review requested due to automatic review settings April 14, 2026 18:37
@zachcasper zachcasper had a problem deploying to external-contributor-approval April 14, 2026 18:37 — with GitHub Actions Failure

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

Adds a design-note feature specification for the “GitHub Radius” prototype, describing GitHub-native Radius + Copilot integration and end-to-end user journeys (with UI mockups) for deploying a GitHub repo to AWS/Azure.

Changes:

  • Add a comprehensive spec document covering user journeys and technical workflow for AWS environment setup and deployment.
  • Add/update a UI mockup image referenced by the spec.

Reviewed changes

Copilot reviewed 1 out of 17 changed files in this pull request and generated 7 comments.

File Description
eng/design-notes/github/2026-03-github-radius-feature-spec.md New feature spec with user journeys, AWS OIDC/IAM workflow, and deployment UX walkthrough (with mockups + example commands/policies).
eng/design-notes/github/2026-03-github-radius-feature-spec/image13.png Adds a mockup image used by the deployment step in the spec.

Comment thread eng/design-notes/github/2026-03-github-radius-feature-spec.md Outdated
Comment thread eng/design-notes/github/2026-03-github-radius-feature-spec.md Outdated
Comment thread eng/design-notes/github/2026-03-github-radius-feature-spec.md Outdated
Comment thread eng/design-notes/github/2026-03-github-radius-feature-spec.md Outdated
Comment thread eng/design-notes/github/2026-03-github-radius-feature-spec.md Outdated
Comment thread eng/design-notes/github/2026-03-github-radius-feature-spec.md Outdated
Comment thread eng/design-notes/github/2026-03-github-radius-feature-spec.md Outdated
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Zach Casper <zachcasper@microsoft.com>
@zachcasper zachcasper had a problem deploying to external-contributor-approval April 14, 2026 18:46 — with GitHub Actions Failure
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Zach Casper <zachcasper@microsoft.com>
@zachcasper zachcasper had a problem deploying to external-contributor-approval April 14, 2026 18:46 — with GitHub Actions Failure
Signed-off-by: Zach Casper <zachcasper@microsoft.com>
Signed-off-by: Zach Casper <zachcasper@microsoft.com>
Signed-off-by: Zach Casper <zachcasper@microsoft.com>
Comment thread eng/design-notes/github/2026-03-github-radius-feature-spec/image2.png Outdated
Comment thread eng/design-notes/github/2026-03-github-radius-feature-spec.md Outdated
Comment on lines +70 to +72
1. The user is taken to the application definition.

![image4](2026-03-github-radius-feature-spec/image4.png)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

We should enable some mechanism for users to provide feedback on the generated definition

Signed-off-by: Zach Casper <zachcasper@microsoft.com>
@zachcasper zachcasper marked this pull request as draft May 11, 2026 18:17
@brooke-hamilton brooke-hamilton self-assigned this May 11, 2026
Signed-off-by: Zach Casper <zachcasper@microsoft.com>
Comment thread eng/design-notes/github/2026-05-github-radius-prfaq.md Outdated
Comment thread eng/design-notes/github/2026-05-github-radius-prfaq.md Outdated
Comment thread eng/design-notes/github/2026-05-github-radius-prfaq.md Outdated
Comment thread eng/design-notes/github/2026-05-github-radius-prfaq.md Outdated
Comment thread eng/design-notes/github/2026-05-github-radius-prfaq.md Outdated
Comment thread eng/design-notes/github/2026-05-github-radius-prfaq.md Outdated
Comment thread eng/design-notes/github/2026-05-github-radius-prfaq.md Outdated
Comment thread eng/design-notes/github/2026-05-github-radius-prfaq.md Outdated

GitHub Radius continues to use resource types and recipes as the mechanism by which abstract application resources become concrete cloud resources. The Radius `resource-types-contrib` recipe library is reused, now with greater importance. What changes is the expectation of how mature and comprehensive the resource types and recipes must be.

In Kubernetes-based Radius, the enterprise's platform engineer was expected to either bring their own recipes or substantially customize Radius' recipes. In GitHub Radius, the Radius project is now responsible for ensuring the resource types and recipes are production ready and follow security and cost best practices. Because of this shift, the Radius project will need to invest more resources in the development, testing, and maturing of the existing recipe library.

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.

or, use @Reshrahim 's direct module design


Our objective remains the broad adoption of Kubernetes-based Radius by enterprises. GitHub Radius is targeted at a distinctly different non-enterprise persona. We believe that, with Radius built into the Copilot app, enterprises will gain greater exposure to Radius, which will drive adoption of Kubernetes-based Radius.

Developers who use GitHub Radius for side projects and prototypes will encounter Radius's application graph, and when they move to an enterprise team with shared infrastructure needs, they will already understand the mental model and advocate for Kubernetes-based Radius.

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.

I think we will need a stronger glue point than this. this seems like two separate projects

Comment thread eng/design-notes/github/2026-05-github-radius-prfaq.md Outdated
Comment thread eng/design-notes/github/2026-05-github-radius-prfaq.md Outdated
Comment thread eng/design-notes/github/2026-05-github-radius-prfaq.md Outdated
@zachcasper zachcasper changed the title GitHub Radius feature spec GitHub Radius PRFAQ May 29, 2026
Signed-off-by: Zach Casper <zachcasper@microsoft.com>

We do not have concrete plans to ship Repo Radius as a standalone deployment option today. GitHub Radius is the priority.

**Q25: Why are application definitions no longer in Bicep? Doesn't that go against our objective with Radius?**

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Missing a crisp, concrete "golden path" example. Suggest adding a simple end‑to‑end scenario showing how a platform team uses this in practice and what improves.

* Guided credentialing can be implemented in `rad init`.

These features will be considered as capacity allows, but the primary investment is in GitHub Radius.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

The FAQ should more directly address "why not alternatives" (Crossplane, Terraform + GitOps, internal platforms, etc). This is critical for credibility with platform engineers.


**Q25: Why are application definitions no longer in Bicep? Doesn't that go against our objective with Radius?**

In GitHub Radius, developers no longer define applications in Bicep. Bicep continues to be used under the hood for deployments but the application definition itself is a JSON graph the Radius skills read and write to directly. When a human authored infrastructure, Bicep provided type checking, IDE autocomplete, schema-driven validation, and reviewable text diffs in pull requests. Every one of those capabilities exists because a human is the one typing, and humans make mistakes that a type system can catch before deployment.

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.

for Q21 above, is the idea that we can export from json graph -> bicep ? or internally it is bicep -> json graph which is stored and for migrating, we generate bicep again?


GitHub Radius is a capability inside the GitHub Copilot application that lets developers define, deploy, and operate cloud-native applications through conversation. It analyzes a repository to produce an application model, walks the developer through connecting a cloud environment, deploys the application on request, and can detect differences between the application deployment's desired and actual state. The developer only needs to interact with the Copilot app.

**Q2: What problem does GitHub Radius solve?**

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

The problem statement still reads somewhat platform-centric. Sharpening toward customer pain (what is hard today, what fails in real setups, why current approaches are insufficient).

>
> **Internal**: Export to Bicep is not a MVP feature. See the fast-follow list in Q27.

**Q22: How does GitHub Radius compare to GitHub Spark?**

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Value is mostly qualitative. Consider adding concrete success metrics (onboarding time, standardization %, drift reduction) to make impact measurable.

Signed-off-by: Zach Casper <zachcasper@microsoft.com>
Signed-off-by: Zach Casper <zachcasper@microsoft.com>
Comment thread eng/design-notes/github/2026-06-application-definition-format.md Outdated
Comment thread eng/design-notes/github/2026-06-application-definition-format.md Outdated
Comment thread eng/design-notes/github/2026-06-application-definition-format.md Outdated
Comment thread eng/design-notes/github/2026-06-application-definition-format.md Outdated
Comment thread eng/design-notes/github/2026-06-application-definition-format.md Outdated
Signed-off-by: Zach Casper <zachcasper@microsoft.com>
Signed-off-by: Zach Casper <zachcasper@microsoft.com>
Signed-off-by: Zach Casper <zachcasper@microsoft.com>
Signed-off-by: Zach Casper <zachcasper@microsoft.com>
Signed-off-by: Zach Casper <zachcasper@microsoft.com>
@zachcasper zachcasper changed the title GitHub Radius PRFAQ Project Lattice PRFAQ Jun 4, 2026
@zachcasper zachcasper marked this pull request as ready for review June 4, 2026 20:31
Signed-off-by: Zach Casper <zachcasper@microsoft.com>
Signed-off-by: Zach Casper <zachcasper@microsoft.com>
@radius-functional-tests

radius-functional-tests Bot commented Jun 8, 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 zachcasper/radius
Commit ref 868f1bc
Unique ID func9e1e3c40d9
Image tag pr-func9e1e3c40d9
  • 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-func9e1e3c40d9
  • 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-func9e1e3c40d9
  • dynamic-rp test image location: ghcr.io/radius-project/dev/dynamic-rp:pr-func9e1e3c40d9
  • controller test image location: ghcr.io/radius-project/dev/controller:pr-func9e1e3c40d9
  • ucp test image location: ghcr.io/radius-project/dev/ucpd:pr-func9e1e3c40d9
  • 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...
✅ 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

@zachcasper zachcasper marked this pull request as draft June 29, 2026 18:49
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.