diff --git a/.github/config/en-custom.txt b/.github/config/en-custom.txt index 5e9fbe0d3..5eb05f5f0 100644 --- a/.github/config/en-custom.txt +++ b/.github/config/en-custom.txt @@ -19,6 +19,7 @@ CLI CLIs CMD CNCF +CNCF CQRS CRDs CRUDL @@ -41,6 +42,7 @@ DocumentDB EKS eksClusterName ElastiCache +ElastiCache entrypoint EOF Extensibility @@ -91,6 +93,7 @@ Pre PubSub ProjectRadius radify +radify RBAC RabbitMQ ResourceDeploymentClient @@ -958,6 +961,7 @@ composable CRD nd OSI +OSI scaffolded bb df diff --git a/.github/workflows/redirect.yml b/.github/workflows/redirect.yml new file mode 100644 index 000000000..0390de50b --- /dev/null +++ b/.github/workflows/redirect.yml @@ -0,0 +1,48 @@ +name: Radius Redirect + +on: + workflow_dispatch: + push: + branches: + - edge + - v*.* + paths: + - 'redirect/**' + - '.github/workflows/redirect.yml' + pull_request: + branches: + - edge + - v*.* + paths: + - 'redirect/**' + - '.github/workflows/redirect.yml' + +jobs: + deploy-website: + name: Deploy Redirect Website + runs-on: ubuntu-latest + steps: + - name: Checkout repo + uses: actions/checkout@v4 + with: + submodules: false + - name: Deploy staging site + uses: Azure/static-web-apps-deploy@v1 + with: + azure_static_web_apps_api_token: ${{ secrets.SWA_REDIRECT_TOKEN }} + action: "upload" + app_location: "redirect/src" + skip_api_build: true + skip_app_build: true + + close_pr_site: + name: Close PR Staging Site + if: github.event_name == 'pull_request' && github.event.action == 'closed' + runs-on: ubuntu-latest + steps: + - name: Close Pull Request + id: closepullrequest + uses: Azure/static-web-apps-deploy@v1 + with: + azure_static_web_apps_api_token: ${{ secrets.SWA_REDIRECT_TOKEN }} + action: "close" diff --git a/.github/workflows/validate-bicep.yaml b/.github/workflows/validate-bicep.yaml index 5c1c4679d..4eea5b869 100644 --- a/.github/workflows/validate-bicep.yaml +++ b/.github/workflows/validate-bicep.yaml @@ -27,12 +27,6 @@ jobs: steps: - name: Check out repo uses: actions/checkout@v2 - - name: az CLI login - run: | - az login --service-principal \ - --username ${{ secrets.AZURE_SP_TESTS_APPID }} \ - --password ${{ secrets.AZURE_SP_TESTS_PASSWORD }} \ - --tenant ${{ secrets.AZURE_SP_TESTS_TENANTID }} - name: Parse release version and set environment variables run: python ./.github/scripts/get_docs_version.py - name: Download rad-bicep diff --git a/.github/workflows/website.yaml b/.github/workflows/website.yaml index 830cab0e5..3080fa00b 100644 --- a/.github/workflows/website.yaml +++ b/.github/workflows/website.yaml @@ -38,7 +38,6 @@ jobs: repository: radius-project/radius ref: ${{ env.RELEASE_BRANCH }} path: ./radius - token: ${{ secrets.GH_RAD_CI_BOT_PAT }} - name: Setup Node uses: actions/setup-node@v2 with: @@ -122,29 +121,14 @@ jobs: uses: Azure/static-web-apps-deploy@v1 with: azure_static_web_apps_api_token: ${{ secrets.ENV_STATICWEBAPP_TOKEN }} + skip_deploy_on_missing_secrets: true repo_token: ${{ secrets.GITHUB_TOKEN }} action: "upload" app_location: "site/" api_location: "site/" output_location: "" skip_app_build: true - - name: Find SWA Comment - uses: peter-evans/find-comment@v2 - id: fc - if: github.event_name == 'pull_request' - with: - issue-number: ${{ github.event.pull_request.number }} - comment-author: 'github-actions[bot]' - body-includes: 'Azure Static Web Apps:' - direction: last - - name: Update SWA Comment - if: github.event_name == 'pull_request' && steps.fc.outputs.comment-id != '' - uses: peter-evans/create-or-update-comment@v3 - with: - comment-id: ${{ steps.fc.outputs.comment-id }} - body: | - - **Password**: `Radiu$1234` + close_pr_site: name: Close PR Staging Site @@ -159,6 +143,7 @@ jobs: uses: Azure/static-web-apps-deploy@v1 with: azure_static_web_apps_api_token: ${{ secrets.ENV_STATICWEBAPP_TOKEN }} + skip_deploy_on_missing_secrets: true action: "close" algolia_index: diff --git a/docs/config.toml b/docs/config.toml index ad8051c2e..4ec9b6102 100644 --- a/docs/config.toml +++ b/docs/config.toml @@ -1,4 +1,4 @@ -baseURL = "https://edge.docs.radapp.io/" +baseURL = "https://docs.radapp.io/" languageCode = "en-us" title = "Radius Docs" theme = "docsy" @@ -67,8 +67,7 @@ tag = "tags" [params] copyright = "Radius" - -version = "edge" +version = "v0.26" tag_version = "latest" chart_version = "0.26.0" @@ -78,7 +77,7 @@ algolia_docsearch = true # GitHub Information github_repo = "https://github.com/radius-project/docs" github_subdir = "docs" -github_branch = "edge" +github_branch = "v0.26" github_project_repo = "https://github.com/radius-project/radius" # Versioning diff --git a/docs/content/_index.md b/docs/content/_index.md index 9c0f44944..5915cf8c2 100644 --- a/docs/content/_index.md +++ b/docs/content/_index.md @@ -27,7 +27,7 @@ Radius is a cloud native application platform. It enables developers and IT ope {{< /card >}} {{< /cardpane >}} {{< cardpane >}} - {{< card header="**๐Ÿ’ญ Concepts**" footer="[**Learn the concepts โ†’**]({{< ref tutorials >}})" >}} + {{< card header="**๐Ÿ’ญ Concepts**" footer="[**Learn the concepts โ†’**]({{< ref concepts >}})" >}} Learn about the background and concepts behind Radius with in-depth explanations. We'll cover the main concepts and how Radius works, so you have the broader context to deeply understand Radius and use it most effectively. {{< /card >}} {{< card header="**๐Ÿงพ Reference**" footer="[**Visit reference material โ†’**]({{< ref guides >}})" >}} diff --git a/docs/content/community/_index.md b/docs/content/community/_index.md index f0fd89bda..96daf0a19 100644 --- a/docs/content/community/_index.md +++ b/docs/content/community/_index.md @@ -3,5 +3,5 @@ type: docs title: "Radius Community" linkTitle: "Community" description: "Information about the Radius community" -weight: 80 +weight: 90 --- diff --git a/docs/content/community/overview.md b/docs/content/community/overview.md index 4bf144fb6..85b143b7d 100644 --- a/docs/content/community/overview.md +++ b/docs/content/community/overview.md @@ -12,34 +12,11 @@ Welcome to the Radius community! The best way to interact with the community is via the Radius Discord server: -{{< button link="https://discord.gg/SRG3ePMKNy" text="Radius Discord" newtab="true" >}} +{{< button link="https://aka.ms/radius/discord" text="Radius Discord" newtab="true" >}} ## Community meetings -Every month we host a community meeting to showcase new features, review upcoming milestones, and engage in a Q&A. -Anyone from the Radius community can participate, present a topic, or host. All are welcome! - -### Meeting link - -The meeting link and details are sent out via email. - -### Present your topic - -To present a specific topic on the next Radius community call start by filling out this short form, [Radius community call presenter sign-up form](https://forms.office.com/Pages/ResponsePage.aspx?id=v4j5cvGGr0GRqy180BHbRw_b7M-8iE1NkIMvs0xAJFFUQlozVThYSzI4OVhRU0E3NlI0U05GNzZFTi4u). - -### Calendar - -| Date | Topic(s) | Meeting Link | Recording | -|------|----------|--------------|-----------| -| Thursday Feb 16th 9:00am Pacific Time (PST) | v0.17 release | - | [Stream](https://microsoft.sharepoint.com/:v:/r/teams/radius/Shared%20Documents/General/Community%20Calls/2023-02-16%20Project%20Radius%20Community%20Call.mp4?csf=1&web=1&e=u11ceV) | -| Thursday Mar 16th 9:00am Pacific Time (PST) | v0.18 release | - | [Stream](https://microsoft.sharepoint.com/:v:/r/teams/radius/Shared%20Documents/General/Community%20Calls/2023-03-16%20Project%20Radius%20Community%20Call.mp4?csf=1&web=1&e=LMW6HE) | -| Thursday Apr 20th 9:00am Pacific Time (PST) | v0.19 release | - | [Stream](https://microsoft.sharepoint.com/:v:/r/teams/radius/Shared%20Documents/General/Community%20Calls/2023-04-20%20Project%20Radius%20Community%20Call.mp4?csf=1&web=1&e=RCA5Qx) | -| Thursday May 18th 9:00am Pacific Time (PST) | v0.20 release | - | [Stream](https://microsoft.sharepoint.com/:v:/r/teams/radius/Shared%20Documents/General/Community%20Calls/2023-05-18%20Project%20Radius%20Community%20Call.mp4?csf=1&web=1&e=fKcbzm) | -| Thursday June 15th 9:00am Pacific Time (PST) | v0.21 release | - | [Stream](https://microsoft.sharepoint.com/:v:/r/teams/radius/Shared%20Documents/General/Community%20Calls/2023-06-15%20Project%20Radius%20Community%20Call.mp4?csf=1&web=1&e=WIRhP5) | -| Thursday July 13th 9:00am Pacific Time (PST) | v0.22 release | - | [Stream](https://microsoft.sharepoint.com/:v:/r/teams/radius/Shared%20Documents/General/Community%20Calls/2023-07-13%20Project%20Radius%20Community%20Call.mp4?csf=1&web=1&e=v30w8D) | -| Thursday Aug 8th 9:00am Pacific Time (PST) | v0.23 release | - | [Stream](https://microsoft.sharepoint.com/:v:/r/teams/radius/Shared%20Documents/General/Community%20Calls/2023-08-08%20Project%20Radius%20Community%20Call.mp4?csf=1&web=1&e=6Lew1D&nav=eyJyZWZlcnJhbEluZm8iOnsicmVmZXJyYWxBcHAiOiJTdHJlYW1XZWJBcHAiLCJyZWZlcnJhbFZpZXciOiJTaGFyZURpYWxvZyIsInJlZmVycmFsQXBwUGxhdGZvcm0iOiJXZWIiLCJyZWZlcnJhbE1vZGUiOiJ2aWV3In19) | -| Thursday Aug 31st 9:00am Pacific Time (PST) | v0.24 release | - | [Stream](https://microsoft.sharepoint.com/:v:/r/teams/radius/Shared%20Documents/General/Community%20Calls/2023-08-31%20Radius%20Community%20Call.mp4?csf=1&web=1&e=YBjiMv&nav=eyJyZWZlcnJhbEluZm8iOnsicmVmZXJyYWxBcHAiOiJTdHJlYW1XZWJBcHAiLCJyZWZlcnJhbFZpZXciOiJTaGFyZURpYWxvZyIsInJlZmVycmFsQXBwUGxhdGZvcm0iOiJXZWIiLCJyZWZlcnJhbE1vZGUiOiJ2aWV3In19) | -| Tuesday, Oct 2nd 9:00am Pacific Time (PST) | v0.25 release | - | [Stream](https://microsoft.sharepoint.com/:v:/r/teams/radius/Shared%20Documents/General/Community%20Calls/2023-10-03%20Radius%20Community%20Call.mp4?csf=1&web=1&e=9iXqbg) +Every month we host a community meeting to showcase new features, review upcoming milestones, and engage in a Q&A. Anyone from the Radius community can participate, present a topic, or host. All are welcome! For the meeting schedule, links, and more information, visit the Radius [community repo](https://github.com/radius-project/community#community-meetings). ## GitHub Issues & repositories diff --git a/docs/content/concepts/architecture-concept/index.md b/docs/content/concepts/architecture-concept/index.md index 0f28f3bf7..372764235 100644 --- a/docs/content/concepts/architecture-concept/index.md +++ b/docs/content/concepts/architecture-concept/index.md @@ -43,7 +43,7 @@ The service that performs this central functionality in Radius is called the Uni UCP contains functionality for federating with separate resource managers as well as its resource providers. For example UCP can route requests to Azure or AWS to manage resources on those cloud systems. -UCP is a scalable REST API that can function either with a single global shard or using regional sharing. UCP is based on the design principles of the Azure Resource Manager (ARM) control-plane but generalizes to work across multiple clouds and systems. The UCP codebase is fully open-source and was created from scratch as part of the Radius project. UCP is written in Go. +UCP is a scalable REST API that can function either with a single global shard or using regional sharding. UCP is based on the design principles of the Azure Resource Manager (ARM) control-plane but generalizes to work across multiple clouds and systems. The UCP codebase is fully open-source and was created from scratch as part of the Radius project. UCP is written in Go. UCP provides routing and federation with internal and external services: diff --git a/docs/content/concepts/multi-cloud-concept/index.md b/docs/content/concepts/multi-cloud-concept/index.md index 038d3a5af..132ddd665 100644 --- a/docs/content/concepts/multi-cloud-concept/index.md +++ b/docs/content/concepts/multi-cloud-concept/index.md @@ -3,7 +3,7 @@ type: docs title: "Concept: Open-source and multi-cloud" linkTitle: Open-source and multi-cloud description: For many enterprises, their cloud native computing strategy involves using multiple cloud providers. Open source projects, like Kubernetes, help ensure these enterprises achieve their strategy. As a result, Radius was designed to be open-source and multi-cloud from the start. -weight: 100 +weight: 200 categories: "Concept" --- diff --git a/docs/content/concepts/why-radius-concept/index.md b/docs/content/concepts/why-radius-concept/index.md index aa5a2e25d..68add0a2c 100644 --- a/docs/content/concepts/why-radius-concept/index.md +++ b/docs/content/concepts/why-radius-concept/index.md @@ -3,7 +3,7 @@ type: docs title: "Concept: Why Radius?" linkTitle: "Why Radius?" description: "Describes the motivations for creating Radius." -weight: 300 +weight: 100 categories: "Concept" --- diff --git a/docs/content/getting-started/index.md b/docs/content/getting-started/index.md index 7af15a7ea..65afb255e 100644 --- a/docs/content/getting-started/index.md +++ b/docs/content/getting-started/index.md @@ -22,6 +22,12 @@ The Radius getting-started guide can be [run **for free** in a GitHub Codespace] [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/radius-project/samples) {{< /alert >}} +{{< alert title="๐Ÿš€ Run in a free GitHub Codespace" color="primary" >}} +The Radius getting-started guide can be [run **for free** in a GitHub Codespace](https://github.blog/changelog/2022-11-09-codespaces-for-free-and-pro-accounts/). Visit the following link to get started in seconds: + +[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/radius-project/samples) +{{< /alert >}} + ## 1. Have your Kubernetes cluster handy Radius runs inside [Kubernetes]({{< ref "guides/operations/kubernetes" >}}). However you run Kubernetes, get a cluster ready. diff --git a/docs/content/reference/_index.md b/docs/content/reference/_index.md index 796a51a47..30d41b833 100644 --- a/docs/content/reference/_index.md +++ b/docs/content/reference/_index.md @@ -3,5 +3,5 @@ type: docs title: "Radius reference documentation" linkTitle: "Reference" description: "Detailed reference documentation on various Radius components" -weight: 90 +weight: 100 --- diff --git a/docs/content/tutorials/new-app/index.md b/docs/content/tutorials/new-app/index.md index 3885d0ccd..bc43b9ded 100644 --- a/docs/content/tutorials/new-app/index.md +++ b/docs/content/tutorials/new-app/index.md @@ -252,13 +252,13 @@ In addition to containers, you can add dependencies like Redis caches, Dapr Stat Resources: myapp Applications.Core/applications - frontend Applications.Core/containers + demo Applications.Core/containers mongodb Applications.Datastores/mongoDatabases Starting log stream... ``` -1. Open [localhost:3000](http://localhost:3000) to interact with the frontend container. You should see the container's connections and metadata, this time with a connection to the Mongo database and new environment variables set: +1. Open [localhost:3000](http://localhost:3000) to interact with the demo container. You should see the container's connections and metadata, this time with a connection to the Mongo database and new environment variables set: {{< image src="demo-landing-connection.png" alt="Screenshot of the Radius demo container" width=500px >}} @@ -275,20 +275,20 @@ In addition to containers, you can add dependencies like Redis caches, Dapr Stat ``` Displaying application: myapp - Name: frontend (Applications.Core/containers) + Name: demo (Applications.Core/containers) Connections: - frontend -> mongodb (Applications.Datastores/mongoDatabases) + demo -> mongodb (Applications.Datastores/mongoDatabases) Resources: - frontend (kubernetes: apps/Deployment) - frontend (kubernetes: core/Secret) - frontend (kubernetes: core/Service) - frontend (kubernetes: core/ServiceAccount) - frontend (kubernetes: rbac.authorization.k8s.io/Role) - frontend (kubernetes: rbac.authorization.k8s.io/RoleBinding) + demo (kubernetes: apps/Deployment) + demo (kubernetes: core/Secret) + demo (kubernetes: core/Service) + demo (kubernetes: core/ServiceAccount) + demo (kubernetes: rbac.authorization.k8s.io/Role) + demo (kubernetes: rbac.authorization.k8s.io/RoleBinding) Name: mongodb (Applications.Datastores/mongoDatabases) Connections: - frontend (Applications.Core/containers) -> mongodb + demo (Applications.Core/containers) -> mongodb Resources: mongo-bzmp2btdgzez6 (kubernetes: apps/Deployment) mongo-bzmp2btdgzez6 (kubernetes: core/Service) @@ -302,7 +302,7 @@ In addition to dependencies, you can add more containers to make your applicatio {{% rad file="snippets/3-app-backend.bicep" embed=true marker="//BACKEND" %}} -1. Add a new connection from your `frontend` container to the `backend` container: +1. Add a new connection from your `demo` container to the `backend` container: {{% rad file="snippets/3-app-backend.bicep" embed=true marker="//CONTAINER" markdownConfig="{hl_lines=[\"20-22\"]}" %}} @@ -322,14 +322,14 @@ In addition to dependencies, you can add more containers to make your applicatio Deployment Complete Resources: - frontend Applications.Core/containers + demo Applications.Core/containers backend Applications.Core/containers mongodb Applications.Datastores/mongoDatabases Starting log stream... ``` -1. Open [localhost:3000](http://localhost:3000) to interact with the frontend container. You should see the container's connections and metadata, this time with a connection to the backend container and new environment variables set: +1. Open [localhost:3000](http://localhost:3000) to interact with the demo container. You should see the container's connections and metadata, this time with a connection to the backend container and new environment variables set: {{< image src="demo-landing-backend.png" alt="Screenshot of the demo container with a connection to the backend container" width=600px >}} @@ -359,7 +359,7 @@ Finally, you can add a gateway to your application. Gateways are used to expose Deployment Complete Resources: - frontend Applications.Core/containers + demo Applications.Core/containers backend Applications.Core/containers gateway Applications.Core/gateways mongodb Applications.Datastores/mongoDatabases diff --git a/docs/content/tutorials/new-app/snippets/1-app.bicep b/docs/content/tutorials/new-app/snippets/1-app.bicep index 9e98f38fe..1c9818558 100644 --- a/docs/content/tutorials/new-app/snippets/1-app.bicep +++ b/docs/content/tutorials/new-app/snippets/1-app.bicep @@ -9,7 +9,7 @@ resource demo 'Applications.Core/containers@2023-10-01-preview' = { properties: { application: application container: { - image: 'radius.azurecr.io/tutorial/demo:edge' + image: 'radius.azurecr.io/samples/demo:latest' ports: { web: { containerPort: 3000 diff --git a/docs/content/tutorials/new-app/snippets/2-app-mongo.bicep b/docs/content/tutorials/new-app/snippets/2-app-mongo.bicep index 39076d5db..a31aba8ec 100644 --- a/docs/content/tutorials/new-app/snippets/2-app-mongo.bicep +++ b/docs/content/tutorials/new-app/snippets/2-app-mongo.bicep @@ -10,7 +10,7 @@ resource demo 'Applications.Core/containers@2023-10-01-preview' = { properties: { application: application container: { - image: 'radius.azurecr.io/tutorial/demo:edge' + image: 'radius.azurecr.io/samples/demo:latest' env: { FOO: 'bar' } diff --git a/docs/content/tutorials/new-app/snippets/3-app-backend.bicep b/docs/content/tutorials/new-app/snippets/3-app-backend.bicep index 4cc06a412..4935479ce 100644 --- a/docs/content/tutorials/new-app/snippets/3-app-backend.bicep +++ b/docs/content/tutorials/new-app/snippets/3-app-backend.bicep @@ -8,12 +8,12 @@ param application string param environment string //CONTAINER -resource frontend 'Applications.Core/containers@2023-10-01-preview' = { - name: 'frontend' +resource demo 'Applications.Core/containers@2023-10-01-preview' = { + name: 'demo' properties: { application: application container: { - image: 'radius.azurecr.io/tutorial/demo:edge' + image: 'radius.azurecr.io/samples/demo:latest' env: { FOO: 'bar' } diff --git a/docs/content/tutorials/new-app/snippets/4-app-gateway.bicep b/docs/content/tutorials/new-app/snippets/4-app-gateway.bicep index c6b2ff067..ad67bcd70 100644 --- a/docs/content/tutorials/new-app/snippets/4-app-gateway.bicep +++ b/docs/content/tutorials/new-app/snippets/4-app-gateway.bicep @@ -8,12 +8,12 @@ param application string param environment string //CONTAINER -resource frontend 'Applications.Core/containers@2023-10-01-preview' = { - name: 'frontend' +resource demo 'Applications.Core/containers@2023-10-01-preview' = { + name: 'demo' properties: { application: application container: { - image: 'radius.azurecr.io/tutorial/demo:edge' + image: 'radius.azurecr.io/samples/demo:latest' env: { FOO: 'bar' } @@ -70,7 +70,7 @@ resource gateway 'Applications.Core/gateways@2023-10-01-preview' = { routes: [ { path: '/' - destination: 'http://frontend:3000' + destination: 'http://demo:3000' } ] } diff --git a/docs/layouts/partials/hooks/body-end.html b/docs/layouts/partials/hooks/body-end.html index 3f4109e18..f640ff308 100644 --- a/docs/layouts/partials/hooks/body-end.html +++ b/docs/layouts/partials/hooks/body-end.html @@ -5,7 +5,7 @@ container: '#docsearch', appId: 'ED67NSVSZS', apiKey: '21e2920c3a9c29b98cbc382694413f29', - indexName: 'radapp-dev-edge', + indexName: 'radapp-dev', }); {{ end }} diff --git a/docs/layouts/shortcodes/schemaExample.html b/docs/layouts/shortcodes/schemaExample.html new file mode 100644 index 000000000..1a540eee4 --- /dev/null +++ b/docs/layouts/shortcodes/schemaExample.html @@ -0,0 +1,7 @@ +{{ $bicepExample := "example.bicep" }} +{{ $bicepExamplePath := path.Join .Page.File.Dir $bicepExample }} + +{{ if fileExists $bicepExamplePath }} +{{ $bicepContent := $bicepExamplePath | readFile }} +{{ highlight $bicepContent "bicep" }} +{{ end }} \ No newline at end of file diff --git a/redirect/README.md b/redirect/README.md new file mode 100644 index 000000000..0f2d8e625 --- /dev/null +++ b/redirect/README.md @@ -0,0 +1,3 @@ +# Redirect Page + +Our current domain, `radapp.io`, is the homepage for Radius. We previously operated on `radapp.dev` and may still have some remaining links to that domain. This directory contains a redirect page that we host on `radapp.dev` to redirect to `radapp.io`. diff --git a/redirect/src/index.html b/redirect/src/index.html new file mode 100644 index 000000000..2e9a35686 --- /dev/null +++ b/redirect/src/index.html @@ -0,0 +1,10 @@ + + + + Redirecting to https://radapp.io + + + +

Please wait while you are redirected to https://radapp.io

+ +