Skip to content

Commit

Permalink
Merge branch 'v0.25' into aacrawfi/tooling
Browse files Browse the repository at this point in the history
  • Loading branch information
AaronCrawfis authored Sep 28, 2023
2 parents 4cc10e5 + 1e51011 commit 727842d
Show file tree
Hide file tree
Showing 6 changed files with 49 additions and 12 deletions.
2 changes: 1 addition & 1 deletion .github/CODEOWNERS
Validating CODEOWNERS rules …
Original file line number Diff line number Diff line change
Expand Up @@ -6,4 +6,4 @@
# All of the people (and only those people) from the matching rule will be notified

# Default rule: anything that doesn't match a more specific rule goes here
* @radius-project/Radius-PM
* @radius-project/maintainers-docs @radius-project/approvers-docs
2 changes: 2 additions & 0 deletions .github/config/en-custom.txt
Original file line number Diff line number Diff line change
Expand Up @@ -469,3 +469,5 @@ HashiCorp
intellisense
itemName
visualstudio
RoleBinding
tcrra
Binary file modified docs/content/getting-started/demo-screenshot.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/content/getting-started/demo-with-redis-screenshot.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
51 changes: 43 additions & 8 deletions docs/content/getting-started/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ weight: 10
description: "Take a tour of Radius by getting started with your first app"
aliases:
- /getting-started/tutorial/
- /getting-started/install/
- /getting-started/first-app/
---

This guide will show you how to quickly get started with Radius. You'll walk through both installing Radius and running your first Radius app.
Expand Down Expand Up @@ -111,11 +113,12 @@ This command:
- Creates a port-forward from localhost to port 3000 inside the container so you can navigate to the app's frontend UI
- Streams container logs to your terminal

<img src="./demo-screenshot.png" alt="Screenshot of the demo container" width=400>
In your browser you should see the demo app:

<img src="./demo-screenshot.png" alt="Screenshot of the demo container" width=600px >
<br /><br />
Congrats! You're running your first Radius app.

When you're ready to move on to the next step, use `CTRL+C` to exit the command.
Congrats! You're running your first Radius app. When you're ready to move on to the next step, use <kbd>CTRL</kbd>+ <kbd>C</kbd> to exit the command.

## 5. Add Database

Expand Down Expand Up @@ -150,17 +153,49 @@ Use the command below to run the updated application again, then open the browse
rad run app.bicep
```

You should see that the environment variables have changed. The `demo` container now has connection information for Redis (`CONNECTION_REDIS_HOST`, `CONNECTION_REDIS_PORT`).
You should see the Radius Connections section with new environment variables added. The `demo` container now has connection information for Redis (`CONNECTION_REDIS_HOST`, `CONNECTION_REDIS_PORT`, etc.):

<img src="./demo-with-redis-screenshot.png" alt="Screenshot of the demo container" width=500>
<img src="./demo-with-redis-screenshot.png" alt="Screenshot of the demo container" width=800px >
<br /><br />

Navigate to the TODO List tab and test out the application. Using the TODO page will update the saved state in Redis.
Navigate to the Todo List tab and test out the application. Using the Todo page will update the saved state in Redis:

<img src="./demo-with-todolist.png" alt="Screenshot of the todolist" width=500>
<img src="./demo-with-todolist.png" alt="Screenshot of the todolist" width=700px >
<br /><br />

Press CTRL+C when you are finished with the website.
Press <kbd>CTRL</kbd>+ <kbd>C</kbd> when you are finished with the website.

## 7. View the application connections

Radius connections are more than just environment variables and configuration. You can also access the "application graph" and understand the connections within your application with the following command:

```bash
rad app connections
```

You should see the following output, detailing the connections between the `demo` container and the `db` Redis Cache, along with information about the underlying Kubernetes resources running the app:

```
Displaying application: demo
Name: demo (Applications.Core/containers)
Connections:
demo -> db (Applications.Datastores/redisCaches)
Resources:
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: db (Applications.Datastores/redisCaches)
Connections:
demo (Applications.Core/containers) -> db
Resources:
redis-r5tcrra3d7uh6 (kubernetes: apps/Deployment)
redis-r5tcrra3d7uh6 (kubernetes: core/Service)
```

## Recap and next steps

Expand Down
6 changes: 3 additions & 3 deletions docs/content/guides/_index.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
type: docs
title: "Radius user guides"
linkTitle: "User guides"
description: "Learn how to use Radius with user guides"
title: "Radius how-to guides"
linkTitle: "How-to guides"
description: "Learn how to use Radius with detailed guides"
weight: 40
---

0 comments on commit 727842d

Please sign in to comment.