├── src
    ├── requests-frontend
    │   ├── .gitignore
    │   ├── Shared
    │   │   ├── MainLayout.razor
    │   │   ├── FetchSummaryRequests.razor
    │   │   └── NewSummaryRequest.razor
    │   ├── wwwroot
    │   │   ├── favicon.png
    │   │   └── css
    │   │   │   └── site.css
    │   ├── appsettings.json
    │   ├── appsettings.Development.json
    │   ├── Pages
    │   │   ├── Index.razor
    │   │   ├── Error.cshtml.cs
    │   │   ├── _Host.cshtml
    │   │   └── Error.cshtml
    │   ├── Frontend.csproj
    │   ├── App.razor
    │   ├── _Imports.razor
    │   ├── Dockerfile
    │   ├── Properties
    │   │   └── launchSettings.json
    │   ├── Data
    │   │   ├── SummaryRequest.cs
    │   │   ├── AppSettings.cs
    │   │   └── SummaryRequestService.cs
    │   └── Program.cs
    ├── requests-api
    │   ├── requirements.txt
    │   ├── Dockerfile
    │   ├── settings.py
    │   ├── request_entities.py
    │   ├── app.py
    │   └── request_state.py
    ├── requests-processor
    │   ├── requirements.txt
    │   ├── Dockerfile
    │   ├── app.py
    │   ├── request_entities.py
    │   ├── request_handler.py
    │   └── settings.py
    └── job
    │   ├── Dockerfile
    │   ├── Cargo.toml
    │   └── src
    │       └── main.rs
├── docs
    ├── .gitignore
    ├── assets
    │   └── images
    │   │   ├── aca-banner.png
    │   │   ├── summarizer-web.png
    │   │   ├── summarizer-assets.png
    │   │   └── summarizer-dapr-aca.png
    ├── lab
    │   ├── 2-dapr-components
    │   │   ├── images
    │   │   │   ├── queue.png
    │   │   │   ├── dapr-local.png
    │   │   │   ├── redis-keys.png
    │   │   │   ├── blazor-summary.png
    │   │   │   └── dapr-overview.png
    │   │   ├── index.md
    │   │   ├── 2-2-summarizer-overview.md
    │   │   ├── 2-1-dapr-overview.md
    │   │   ├── 2-5-requests-processor.md
    │   │   ├── 2-4-blazor-app.md
    │   │   └── 2-3-requests-api.md
    │   ├── 1-get-ready
    │   │   ├── images
    │   │   │   ├── open-codespaces-1.png
    │   │   │   ├── open-codespaces-2.png
    │   │   │   ├── open-codespaces-3.png
    │   │   │   ├── open-codespaces-4.png
    │   │   │   └── open-codespaces-5.png
    │   │   ├── index.md
    │   │   ├── 1-1-prerequisites.md
    │   │   ├── 1-2-codespaces.md
    │   │   └── 1-3-connectivity.md
    │   ├── 3-container-apps
    │   │   ├── images
    │   │   │   ├── aca-components.jpg
    │   │   │   ├── aca-provisioned.png
    │   │   │   ├── container-apps.png
    │   │   │   ├── aca-example-scenarios.png
    │   │   │   └── request-processor-logs.png
    │   │   ├── index.md
    │   │   ├── 3-2-aca-deployment.md
    │   │   ├── 3-1-aca-overview.md
    │   │   └── 3-3-apps-deployment.md
    │   └── 4-learn-more
    │   │   └── index.md
    ├── _sass
    │   └── color_schemes
    │   │   └── lab.scss
    ├── 404.html
    ├── _includes
    │   └── text-expand.html
    ├── Gemfile
    ├── _layouts
    │   └── default.html
    ├── index.markdown
    ├── _config.yml
    └── Gemfile.lock
├── dapr
    ├── summarizer-secrets-sample.json
    ├── local
    │   └── components
    │   │   ├── summarizer-pubsub.yaml
    │   │   ├── summarizer-secretstore.yaml
    │   │   ├── summarizer-smtp.yaml
    │   │   └── summarizer-statestore.yaml
    └── azure
    │   └── components
    │       └── summarizer-statestore-cosmos.yaml
├── .gitignore
├── .github
    ├── ISSUE_TEMPLATE
    │   ├── bug_report.md
    │   └── suggestion_report.md
    └── workflows
    │   ├── brokenlinks.yml
    │   └── jekyll-gh-pages.yml
├── infra
    ├── modules
    │   ├── infra
    │   │   ├── service-bus.bicep
    │   │   ├── openai.bicep
    │   │   ├── webmail.bicep
    │   │   ├── cosmos-db.bicep
    │   │   ├── container-registry.bicep
    │   │   ├── container-apps-env.bicep
    │   │   └── keyvault.bicep
    │   ├── dapr
    │   │   ├── smtp.bicep
    │   │   ├── pubsub.bicep
    │   │   ├── secretstore.bicep
    │   │   └── statestore.bicep
    │   └── apps
    │   │   ├── requests-api.bicep
    │   │   ├── requests-frontend.bicep
    │   │   └── requests-processor.bicep
    ├── setup.sh
    ├── naming-rules.json
    ├── apps.bicep
    └── infra.bicep
├── .devcontainer
    ├── on-setup.sh
    └── devcontainer.json
├── dapr.yaml
└── README.md


/src/requests-frontend/.gitignore:
--------------------------------------------------------------------------------
1 | bin
2 | obj


--------------------------------------------------------------------------------
/docs/.gitignore:
--------------------------------------------------------------------------------
1 | _site
2 | .sass-cache
3 | .jekyll-cache
4 | .jekyll-metadata
5 | vendor
6 | 


--------------------------------------------------------------------------------
/src/requests-frontend/Shared/MainLayout.razor:
--------------------------------------------------------------------------------
1 | @inherits LayoutComponentBase
2 | <PageTitle>Summarizer</PageTitle>
3 | @Body


--------------------------------------------------------------------------------
/docs/assets/images/aca-banner.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/docs/assets/images/aca-banner.png


--------------------------------------------------------------------------------
/docs/assets/images/summarizer-web.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/docs/assets/images/summarizer-web.png


--------------------------------------------------------------------------------
/src/requests-api/requirements.txt:
--------------------------------------------------------------------------------
1 | dapr
2 | dapr-ext-fastapi 
3 | cloudevents
4 | openai
5 | fastapi
6 | pydantic
7 | uvicorn
8 | retry


--------------------------------------------------------------------------------
/docs/assets/images/summarizer-assets.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/docs/assets/images/summarizer-assets.png


--------------------------------------------------------------------------------
/src/requests-processor/requirements.txt:
--------------------------------------------------------------------------------
1 | dapr
2 | dapr-ext-fastapi 
3 | cloudevents
4 | openai
5 | fastapi
6 | pydantic
7 | uvicorn
8 | retry


--------------------------------------------------------------------------------
/dapr/summarizer-secrets-sample.json:
--------------------------------------------------------------------------------
1 | {
2 |   "OPENAI-API-KEY": "",
3 |   "OPENAI-API-ENDPOINT": "",
4 |   "SMTP-HOST": "",
5 |   "SMTP-PORT": ""
6 | }


--------------------------------------------------------------------------------
/docs/assets/images/summarizer-dapr-aca.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/docs/assets/images/summarizer-dapr-aca.png


--------------------------------------------------------------------------------
/docs/lab/2-dapr-components/images/queue.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/docs/lab/2-dapr-components/images/queue.png


--------------------------------------------------------------------------------
/src/requests-frontend/wwwroot/favicon.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/src/requests-frontend/wwwroot/favicon.png


--------------------------------------------------------------------------------
/docs/lab/2-dapr-components/images/dapr-local.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/docs/lab/2-dapr-components/images/dapr-local.png


--------------------------------------------------------------------------------
/docs/lab/2-dapr-components/images/redis-keys.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/docs/lab/2-dapr-components/images/redis-keys.png


--------------------------------------------------------------------------------
/docs/lab/1-get-ready/images/open-codespaces-1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/docs/lab/1-get-ready/images/open-codespaces-1.png


--------------------------------------------------------------------------------
/docs/lab/1-get-ready/images/open-codespaces-2.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/docs/lab/1-get-ready/images/open-codespaces-2.png


--------------------------------------------------------------------------------
/docs/lab/1-get-ready/images/open-codespaces-3.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/docs/lab/1-get-ready/images/open-codespaces-3.png


--------------------------------------------------------------------------------
/docs/lab/1-get-ready/images/open-codespaces-4.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/docs/lab/1-get-ready/images/open-codespaces-4.png


--------------------------------------------------------------------------------
/docs/lab/1-get-ready/images/open-codespaces-5.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/docs/lab/1-get-ready/images/open-codespaces-5.png


--------------------------------------------------------------------------------
/docs/lab/2-dapr-components/images/blazor-summary.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/docs/lab/2-dapr-components/images/blazor-summary.png


--------------------------------------------------------------------------------
/docs/lab/2-dapr-components/images/dapr-overview.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/docs/lab/2-dapr-components/images/dapr-overview.png


--------------------------------------------------------------------------------
/docs/lab/3-container-apps/images/aca-components.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/docs/lab/3-container-apps/images/aca-components.jpg


--------------------------------------------------------------------------------
/docs/lab/3-container-apps/images/aca-provisioned.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/docs/lab/3-container-apps/images/aca-provisioned.png


--------------------------------------------------------------------------------
/docs/lab/3-container-apps/images/container-apps.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/docs/lab/3-container-apps/images/container-apps.png


--------------------------------------------------------------------------------
/docs/lab/3-container-apps/images/aca-example-scenarios.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/docs/lab/3-container-apps/images/aca-example-scenarios.png


--------------------------------------------------------------------------------
/docs/lab/3-container-apps/images/request-processor-logs.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/reidav/aca-dapr-openai-workshop/HEAD/docs/lab/3-container-apps/images/request-processor-logs.png


--------------------------------------------------------------------------------
/docs/lab/1-get-ready/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: Get Ready
 3 | has_children: true
 4 | permalink: /lab1
 5 | nav_order: 1
 6 | ---
 7 | 
 8 | ## Get Ready
 9 | 
10 | Check that you have everything ready to do the workshop.
11 | 


--------------------------------------------------------------------------------
/docs/_sass/color_schemes/lab.scss:
--------------------------------------------------------------------------------
1 | // Custom scheme implemented as per these directions: https://github.com/pmarsceill/just-the-docs/blob/master/docs/customization.md#custom-schemes
2 | $content-width: 70rem;
3 | $nav-width-md: 5rem;
4 | 


--------------------------------------------------------------------------------
/src/requests-frontend/appsettings.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "Logging": {
 3 |     "LogLevel": {
 4 |       "Default": "Information",
 5 |       "Microsoft.AspNetCore": "Warning"
 6 |     }
 7 |   },
 8 |   "AllowedHosts": "*"
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/requests-api/Dockerfile:
--------------------------------------------------------------------------------
 1 | FROM python:3.7-slim
 2 | 
 3 | WORKDIR /app
 4 | 
 5 | ADD requirements.txt .
 6 | RUN pip install -r requirements.txt
 7 | 
 8 | COPY *.py /app/
 9 | 
10 | CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "80"]


--------------------------------------------------------------------------------
/src/requests-frontend/appsettings.Development.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "DetailedErrors": true,
 3 |   "Logging": {
 4 |     "LogLevel": {
 5 |       "Default": "Information",
 6 |       "Microsoft.AspNetCore": "Warning"
 7 |     }
 8 |   }
 9 | }
10 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | # dapr
 2 | .dapr
 3 | dapr/summarizer-secrets.json
 4 | 
 5 | # macOS
 6 | .DS_Store
 7 | 
 8 | # VS Code
 9 | .vscode/
10 | 
11 | # dotnet
12 | target
13 | bin
14 | obj
15 | .mono
16 | *.sln
17 | 
18 | # Python
19 | __pycache__


--------------------------------------------------------------------------------
/src/requests-processor/Dockerfile:
--------------------------------------------------------------------------------
 1 | FROM python:3.7-slim
 2 | 
 3 | WORKDIR /app
 4 | 
 5 | ADD requirements.txt .
 6 | RUN pip install -r requirements.txt
 7 | 
 8 | COPY *.py /app/
 9 | 
10 | CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "80"]


--------------------------------------------------------------------------------
/docs/lab/3-container-apps/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: Container Apps
 3 | has_children: true
 4 | permalink: /lab3
 5 | nav_order: 3
 6 | ---
 7 | 
 8 | ## Container Apps
 9 | 
10 | Now that we have a working application, let's deploy it to Azure Container Apps.
11 | 


--------------------------------------------------------------------------------
/src/requests-frontend/Pages/Index.razor:
--------------------------------------------------------------------------------
 1 | @page "/"
 2 | 
 3 | 
 4 | <div class="container">
 5 |     <PageTitle>Summarizer</PageTitle>
 6 | 
 7 |     <h1>Hey, I'm doing summaries using GPT !</h1>
 8 |     <NewSummaryRequest />
 9 |     <FetchSummaryRequests />
10 | </div>


--------------------------------------------------------------------------------
/dapr/local/components/summarizer-pubsub.yaml:
--------------------------------------------------------------------------------
 1 | apiVersion: dapr.io/v1alpha1
 2 | kind: Component
 3 | metadata:
 4 |   name: summarizer-pubsub
 5 | spec:
 6 |   type: pubsub.redis
 7 |   version: v1
 8 |   metadata:
 9 |   - name: redisHost
10 |     value: localhost:6379
11 |   - name: redisPassword
12 |     value: ""


--------------------------------------------------------------------------------
/docs/lab/2-dapr-components/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: Implement Dapr Components
 3 | has_children: true
 4 | permalink: /lab2
 5 | nav_order: 2
 6 | ---
 7 | 
 8 | ## Implement Dapr Components
 9 | 
10 | Let's implement Dapr components for the Summarizer application. 
11 | In this chapter we will be using Redis for both state and pub/sub provider.


--------------------------------------------------------------------------------
/dapr/local/components/summarizer-secretstore.yaml:
--------------------------------------------------------------------------------
 1 | apiVersion: dapr.io/v1alpha1
 2 | kind: Component
 3 | metadata:
 4 |   name: summarizer-secretstore
 5 | spec:
 6 |   type: secretstores.local.file
 7 |   version: v1
 8 |   metadata:
 9 |     - name: secretsFile
10 |       value: /workspace/dapr/summarizer-secrets.json
11 |     - name: nestedSeparator
12 |       value: ":"
13 | 


--------------------------------------------------------------------------------
/src/job/Dockerfile:
--------------------------------------------------------------------------------
 1 | FROM rust:1.70 as builder
 2 | WORKDIR /usr/src/job
 3 | COPY . .
 4 | RUN apt-get -y update \
 5 |     && apt-get install -y protobuf-compiler
 6 | RUN cargo install --path .
 7 | 
 8 | FROM debian:bookworm-slim
 9 | RUN apt-get update & apt-get install -y extra-runtime-dependencies & rm -rf /var/lib/apt/lists/*
10 | COPY --from=builder /usr/local/cargo/bin/job /usr/local/bin/job
11 | CMD ["job"]


--------------------------------------------------------------------------------
/src/requests-frontend/Frontend.csproj:
--------------------------------------------------------------------------------
 1 | <Project Sdk="Microsoft.NET.Sdk.Web">
 2 | 
 3 |   <PropertyGroup>
 4 |     <TargetFramework>net8.0</TargetFramework>
 5 |     <Nullable>enable</Nullable>
 6 |     <ImplicitUsings>enable</ImplicitUsings>
 7 |     <RootNamespace>Frontend</RootNamespace>
 8 |   </PropertyGroup>
 9 | 
10 |   <ItemGroup>
11 |     <PackageReference Include="Dapr.AspNetCore" Version="1.11.0" />
12 |   </ItemGroup>
13 | 
14 | </Project>
15 | 


--------------------------------------------------------------------------------
/src/requests-frontend/App.razor:
--------------------------------------------------------------------------------
 1 | <Router AppAssembly="@typeof(App).Assembly">
 2 |     <Found Context="routeData">
 3 |         <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
 4 |     </Found>
 5 |     <NotFound>
 6 |         <PageTitle>Not found</PageTitle>
 7 |         <LayoutView Layout="@typeof(MainLayout)">
 8 |             <p role="alert">Sorry, there's nothing at this address.</p>
 9 |         </LayoutView>
10 |     </NotFound>
11 | </Router>
12 | 


--------------------------------------------------------------------------------
/src/requests-frontend/_Imports.razor:
--------------------------------------------------------------------------------
 1 | @using System.Net.Http
 2 | @using Microsoft.AspNetCore.Authorization
 3 | @using Microsoft.AspNetCore.Components.Authorization
 4 | @using Microsoft.AspNetCore.Components.Forms
 5 | @using Microsoft.AspNetCore.Components.Routing
 6 | @using Microsoft.AspNetCore.Components.Web
 7 | @using Microsoft.AspNetCore.Components.Web.Virtualization
 8 | @using Microsoft.JSInterop
 9 | @using Frontend
10 | @using Frontend.Shared
11 | @using Dapr.Client
12 | 


--------------------------------------------------------------------------------
/dapr/local/components/summarizer-smtp.yaml:
--------------------------------------------------------------------------------
 1 | apiVersion: dapr.io/v1alpha1
 2 | kind: Component
 3 | metadata:
 4 |   name: summarizer-smtp
 5 | spec:
 6 |   type: bindings.smtp
 7 |   version: v1
 8 |   metadata:
 9 |   - name: host
10 |     secretKeyRef:
11 |       name: SMTP-HOST
12 |       key:  SMTP-HOST
13 |   - name: port
14 |     secretKeyRef:
15 |       name: SMTP-PORT
16 |       key:  SMTP-PORT
17 |   - name: emailFrom
18 |     value: "noreply@summarize.io"
19 | auth:
20 |   secretStore: summarizer-secretstore


--------------------------------------------------------------------------------
/dapr/azure/components/summarizer-statestore-cosmos.yaml:
--------------------------------------------------------------------------------
 1 | apiVersion: dapr.io/v1alpha1
 2 | kind: Component
 3 | metadata:
 4 |   name: summarizer-statestore
 5 | spec:
 6 |   type: state.azure.cosmosdb
 7 |   version: v1
 8 |   initTimeout: 5m
 9 |   metadata:
10 |   - name: url
11 |     value: https://<url>.documents.azure.com:443/
12 |   - name: masterKey
13 |     value: "<masterKey>"
14 |   - name: database
15 |     value: "summarizer"
16 |   - name: collection
17 |     value: "state"
18 |   - name: actorStateStore
19 |     value: "true"


--------------------------------------------------------------------------------
/docs/404.html:
--------------------------------------------------------------------------------
 1 | ---
 2 | permalink: /404.html
 3 | layout: default
 4 | ---
 5 | 
 6 | <style type="text/css" media="screen">
 7 |   .container {
 8 |     margin: 10px auto;
 9 |     max-width: 600px;
10 |     text-align: center;
11 |   }
12 |   h1 {
13 |     margin: 30px 0;
14 |     font-size: 4em;
15 |     line-height: 1;
16 |     letter-spacing: -1px;
17 |   }
18 | </style>
19 | 
20 | <div class="container">
21 |   <h1>404</h1>
22 | 
23 |   <p><strong>Page not found :(</strong></p>
24 |   <p>The requested page could not be found.</p>
25 | </div>
26 | 


--------------------------------------------------------------------------------
/src/requests-frontend/Dockerfile:
--------------------------------------------------------------------------------
 1 | ARG NET_IMAGE=8.0-bookworm-slim
 2 | FROM mcr.microsoft.com/dotnet/aspnet:${NET_IMAGE} AS base
 3 | WORKDIR /app
 4 | EXPOSE 80
 5 | 
 6 | FROM mcr.microsoft.com/dotnet/sdk:${NET_IMAGE} AS build
 7 | WORKDIR /src/frontend
 8 | COPY . .
 9 | RUN dotnet restore "Frontend.csproj"
10 | 
11 | 
12 | FROM build AS publish
13 | RUN dotnet publish --no-restore "Frontend.csproj" -c Release -o /app/publish
14 | 
15 | FROM base AS final
16 | WORKDIR /app
17 | COPY --from=publish /app/publish/ .
18 | ENTRYPOINT ["dotnet", "Frontend.dll"]


--------------------------------------------------------------------------------
/.github/ISSUE_TEMPLATE/bug_report.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | name: Bug report
 3 | about: Create a report to help us improve
 4 | 
 5 | ---
 6 | 
 7 | **Describe the bug**
 8 | A clear and concise description of what the bug is.
 9 | 
10 | **To Reproduce**
11 | Steps to reproduce the behavior:
12 | 1. Go to '...'
13 | 2. Click on '....'
14 | 3. Scroll down to '....'
15 | 4. See error
16 | 
17 | **Expected behavior**
18 | A clear and concise description of what you expected to happen.
19 | 
20 | **Screenshots**
21 | If applicable, add screenshots to help explain your problem.
22 | 
23 | **Additional context**
24 | Add any other context about the problem here.


--------------------------------------------------------------------------------
/.github/ISSUE_TEMPLATE/suggestion_report.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | name: Suggestion request
 3 | about: Suggest an idea for this project
 4 | 
 5 | ---
 6 | 
 7 | **Is your feature request related to a problem? Please describe.**
 8 | A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
 9 | 
10 | **Describe the solution you'd like**
11 | A clear and concise description of what you want to happen.
12 | 
13 | **Describe alternatives you've considered**
14 | A clear and concise description of any alternative solutions or features you've considered.
15 | 
16 | **Additional context**
17 | Add any other context or screenshots about the feature request here.


--------------------------------------------------------------------------------
/src/job/Cargo.toml:
--------------------------------------------------------------------------------
 1 | [package]
 2 | name = "job"
 3 | version = "0.1.0"
 4 | edition = "2021"
 5 | 
 6 | # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
 7 | 
 8 | [dependencies]
 9 | azure_messaging_servicebus = "0.21.0"
10 | chrono = "0.4.39"
11 | dapr = "0.15.1"
12 | serde_json = "1.0.138"
13 | tokio = { version = "1.43.0", features = ["full"] }
14 | url = "2.5.4"
15 | uuid = {version ="1.13.1", features = [
16 |     "v4",                # Lets you generate random UUIDs
17 |     "fast-rng",          # Use a faster (but still sufficiently random) RNG
18 |     "macro-diagnostics", # Enable better diagnostics for compile-time UUIDs
19 | ]}
20 | 


--------------------------------------------------------------------------------
/dapr/local/components/summarizer-statestore.yaml:
--------------------------------------------------------------------------------
 1 | apiVersion: dapr.io/v1alpha1
 2 | kind: Component
 3 | metadata:
 4 |   name: summarizer-statestore
 5 | spec:
 6 |   type: state.redis
 7 |   version: v1
 8 |   metadata:
 9 |   - name: redisHost
10 |     value: localhost:6379
11 |   - name: redisPassword
12 |     value: ""
13 |   - name: queryIndexes
14 |     value: |
15 |       [
16 |         {
17 |           "name": "orgIndx",
18 |           "indexes": [
19 |             {
20 |               "key": "id",
21 |               "type": "TEXT"
22 |             },
23 |             {
24 |               "key": "url",
25 |               "type": "TEXT"
26 |             },
27 |             {
28 |               "key": "url_hashed",
29 |               "type": "TEXT"
30 |             }
31 |           ]
32 |         }
33 |       ] 


--------------------------------------------------------------------------------
/src/requests-frontend/Pages/Error.cshtml.cs:
--------------------------------------------------------------------------------
 1 | using System.Diagnostics;
 2 | using Microsoft.AspNetCore.Mvc;
 3 | using Microsoft.AspNetCore.Mvc.RazorPages;
 4 | 
 5 | namespace Frontend.Pages;
 6 | 
 7 | [ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)]
 8 | [IgnoreAntiforgeryToken]
 9 | public class ErrorModel : PageModel
10 | {
11 |     public string? RequestId { get; set; }
12 | 
13 |     public bool ShowRequestId => !string.IsNullOrEmpty(RequestId);
14 | 
15 |     private readonly ILogger<ErrorModel> _logger;
16 | 
17 |     public ErrorModel(ILogger<ErrorModel> logger)
18 |     {
19 |         _logger = logger;
20 |     }
21 | 
22 |     public void OnGet()
23 |     {
24 |         RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/requests-frontend/Properties/launchSettings.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "iisSettings": {
 3 |     "windowsAuthentication": false,
 4 |     "anonymousAuthentication": true,
 5 |     "iisExpress": {
 6 |       "applicationUrl": "http://localhost:59423",
 7 |       "sslPort": 0
 8 |     }
 9 |   },
10 |   "profiles": {
11 |     "http": {
12 |       "commandName": "Project",
13 |       "dotnetRunMessages": true,
14 |       "launchBrowser": true,
15 |       "applicationUrl": "http://localhost:11000",
16 |       "environmentVariables": {
17 |         "ASPNETCORE_ENVIRONMENT": "Development"
18 |       }
19 |     },
20 |     "IIS Express": {
21 |       "commandName": "IISExpress",
22 |       "launchBrowser": true,
23 |       "environmentVariables": {
24 |         "ASPNETCORE_ENVIRONMENT": "Development"
25 |       }
26 |     }
27 |   }
28 | }
29 | 


--------------------------------------------------------------------------------
/infra/modules/infra/service-bus.bicep:
--------------------------------------------------------------------------------
 1 | // ------------------
 2 | //    PARAMETERS
 3 | // ------------------
 4 | 
 5 | @description('The name of the Service Bus namespace.')
 6 | param serviceBusName string
 7 | 
 8 | @description('The location of the Service Bus namespace.')
 9 | param location string
10 | 
11 | // ------------------
12 | //    RESOURCES
13 | // ------------------
14 | 
15 | resource serviceBus 'Microsoft.ServiceBus/namespaces@2021-06-01-preview' = {
16 |   name: serviceBusName
17 |   location: location
18 |   sku: {
19 |     name: 'Standard'
20 |     tier: 'Standard'
21 |   }
22 | }
23 | 
24 | output connectionString string = 'Endpoint=sb://${serviceBus.name}.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=${listKeys('${serviceBus.id}/AuthorizationRules/RootManageSharedAccessKey', serviceBus.apiVersion).primaryKey}'
25 | 


--------------------------------------------------------------------------------
/src/requests-frontend/Data/SummaryRequest.cs:
--------------------------------------------------------------------------------
 1 | namespace Frontend.Data;
 2 | using System.ComponentModel.DataAnnotations;
 3 | using System.Text.Json.Serialization;
 4 | 
 5 | public record SummaryRequest
 6 | {
 7 |     [JsonPropertyName("email")]
 8 |     [Required]
 9 |     [EmailAddress]
10 |     public string? Email { get; set; }
11 | 
12 |     [JsonPropertyName("url")]
13 |     [Required]
14 |     [Url]
15 |     public string? Url { get; set; }
16 | 
17 |     [JsonPropertyName("summary")]
18 |     public string? Summary { get; set; }
19 | 
20 |     [JsonPropertyName("id")]
21 |     public string? Id { get; set; }
22 | }
23 | 
24 | public record NewSummaryRequestPayload
25 | {
26 |     [JsonPropertyName("email")]
27 |     [Required]
28 |     [EmailAddress]
29 |     public string? Email { get; set; }
30 | 
31 |     [JsonPropertyName("url")]
32 |     [Required]
33 |     [Url]
34 |     public string? Url { get; set; }
35 | }


--------------------------------------------------------------------------------
/docs/lab/1-get-ready/1-1-prerequisites.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: Prerequisites
 3 | parent: Get Ready
 4 | has_children: false
 5 | permalink: /lab1/prerequisites
 6 | nav_order: 1
 7 | ---
 8 | 
 9 | # Technical requirements
10 | 
11 | Please check that you have the following requirements to complete the hands-on lab:
12 | 
13 | - <b>A valid GitHub Account</b>
14 | 
15 |   - If you don't have one, you can create one [here](https://github.com/signup)
16 | 
17 |   - Access to Git Hub Codespaces to be able to create a development environment
18 | 
19 | - <b>Azure requirements</b>
20 | 
21 |   - Access to the [Azure Portal](https://www.portal.azure.com)
22 | 
23 |   - Access to an active [Azure subscription](https://portal.azure.com/#blade/Microsoft_Azure_Billing/SubscriptionsBlade)
24 | 
25 |   - <b>Owner</b> role in a resource group to be able to deploy Summarizer application
26 | 
27 |   - Azure Open AI instance (API Key and API  Endpoint)
28 | 
29 |   - An existing SMTP server (host, port) to be used in the lab.


--------------------------------------------------------------------------------
/.github/workflows/brokenlinks.yml:
--------------------------------------------------------------------------------
 1 | # Checks for broken links in the repo markdown
 2 | 
 3 | name: Broken Link Checker
 4 | 
 5 | on:
 6 |   schedule:
 7 |     - cron: 0 0 1 * * # run monthly
 8 | 
 9 |   workflow_dispatch: # run manually
10 | 
11 | jobs:
12 |   repoLinkChecker:
13 |     runs-on: ubuntu-latest
14 |     steps:
15 |       - uses: actions/checkout@v3
16 | 
17 |       - name: Link Checker
18 |         id: lychee
19 |         uses: lycheeverse/lychee-action@v1.5.1
20 |         env:
21 |           GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
22 |         with:
23 |           # Check all markdown and html files in repo (default)
24 |           args: './**/*.md'
25 | 
26 |       - name: Create Issue From File
27 |         if: steps.lychee.outputs.exit_code != 0
28 |         uses: peter-evans/create-issue-from-file@v4
29 |         with:
30 |           title: 'Bot: Broken Links Detected in Repo'
31 |           content-filepath: ./lychee/out.md
32 |           labels: automated issue


--------------------------------------------------------------------------------
/docs/_includes/text-expand.html:
--------------------------------------------------------------------------------
 1 | <script>
 2 |     
 3 |     var elements = document.querySelectorAll('p');
 4 |     Array.prototype.forEach.call(elements, function(el, i){
 5 |         if(el.innerHTML=='[expand]') {
 6 |             var parentcontent = el.parentNode.innerHTML.replace('<p>[expand]</p>','<div class="expand" style="display: none; height: 0; overflow: hidden;">').replace('<p>[/expand]</p>','</div>');
 7 |             el.parentNode.innerHTML = parentcontent;
 8 |         }
 9 |     });
10 | 
11 |     var elements = document.querySelectorAll('div.expand');
12 |     Array.prototype.forEach.call(elements, function(el, i){
13 |         el.previousElementSibling.innerHTML = el.previousElementSibling.innerHTML + '<span>..&nbsp; <a href="#" style="cursor: pointer;" onclick="this.parentNode.parentNode.nextElementSibling.style.display = \'block\'; this.parentNode.parentNode.nextElementSibling.style.height = \'auto\'; this.parentNode.style.display = \'none\';">read&nbsp;more&nbsp;&rarr;</a></span>';
14 |     });
15 | 
16 | </script>


--------------------------------------------------------------------------------
/src/requests-frontend/Shared/FetchSummaryRequests.razor:
--------------------------------------------------------------------------------
 1 | @using Frontend.Data
 2 | @inject SummaryRequestService SummaryRequestService
 3 | @inject AppSettings AppSettings
 4 | @inject ILogger<FetchSummaryRequests> Logger
 5 | 
 6 | 
 7 | <div id="summary-list">
 8 | 
 9 | @if (requests == null)
10 | {
11 |     <p><em>Loading...</em></p>
12 | }
13 | else
14 | {
15 |         @foreach (var request in requests)
16 |         {
17 |             <div class="summary-card">
18 |                <a href="@request.Url">@request.Url</a>
19 |                 <p>@request.Summary</p>
20 |             </div>
21 |         }
22 | }
23 | </div>
24 | 
25 | @functions {
26 |     private SummaryRequest[]? requests;
27 |      
28 |     protected override async Task OnInitializedAsync()
29 |     {
30 |         try {
31 |             this.requests = await SummaryRequestService.GetSummaryRequestsAsync();
32 |         }
33 |         catch(Exception ex)
34 |         {
35 |             Logger.LogError(ex, "Error loading summary requests");
36 |         }
37 |     }
38 | }


--------------------------------------------------------------------------------
/src/requests-api/settings.py:
--------------------------------------------------------------------------------
 1 | import logging
 2 | import os
 3 | from dapr.clients import DaprClient
 4 | 
 5 | class Settings:
 6 |     def __init__(self, dapr_client : DaprClient):
 7 |         self.dapr_client = dapr_client
 8 | 
 9 |         # Dapr settings        
10 |         self.state_store_name = self.__get_environment_variable("STATE_STORE_NAME")
11 |         self.state_store_query_index_name = self.__get_environment_variable("STATE_STORE_QUERY_INDEX_NAME", False)
12 |         self.binding_smtp = self.__get_environment_variable("BINDING_SMTP")
13 | 
14 |         logging.info(f"""
15 | <environment-variables>
16 |     state_store_name:{self.state_store_name}
17 |     state_store_query_index_name:{self.state_store_query_index_name}
18 |     binding_smtp:{self.binding_smtp}
19 | </environment-variables>""")
20 |        
21 |     def __get_environment_variable(self, variable_name, mandatory=True):
22 |         variable = os.environ.get(variable_name)
23 |         if not variable and mandatory:
24 |             raise Exception(f"Environment variable {variable_name} is not set")
25 |         return variable


--------------------------------------------------------------------------------
/src/requests-frontend/Data/AppSettings.cs:
--------------------------------------------------------------------------------
 1 | namespace Frontend.Data;
 2 | 
 3 | public class AppSettings
 4 | {
 5 |     public readonly string requestsApiAppId;
 6 |     public readonly string requestsApiEndpoint;
 7 |     public readonly string PubRequestName;
 8 |     public readonly string PubRequestTopic;
 9 | 
10 |     public AppSettings()
11 |     {
12 |         this.PubRequestName = GetEnvironmentVariable("PUBSUB_REQUESTS_NAME");
13 |         this.PubRequestTopic = GetEnvironmentVariable("PUBSUB_REQUESTS_TOPIC");
14 |         this.requestsApiAppId = GetEnvironmentVariable("REQUESTS_API_APP_ID");
15 |         this.requestsApiEndpoint = GetEnvironmentVariable("REQUESTS_API_ENDPOINT");
16 |     }
17 | 
18 |     public string GetEnvironmentVariable(string name, bool mandatory = true)
19 |     {
20 |         var value = Environment.GetEnvironmentVariable(name);
21 |         if (mandatory && string.IsNullOrEmpty(value))
22 |         {
23 |             throw new Exception($"Environment variable {name} is not set.");
24 |         }
25 |         return string.IsNullOrEmpty(value) ? string.Empty : value;
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/requests-frontend/Program.cs:
--------------------------------------------------------------------------------
 1 | using Microsoft.AspNetCore.Components;
 2 | using Microsoft.AspNetCore.Components.Web;
 3 | using Frontend.Data;
 4 | using System.Text.Json;
 5 | 
 6 | var builder = WebApplication.CreateBuilder(args);
 7 | 
 8 | // Add environment variables
 9 | builder.Configuration.AddEnvironmentVariables();
10 | 
11 | // Add services to the container.
12 | builder.Services.AddRazorPages();
13 | builder.Services.AddServerSideBlazor();
14 | builder.Services.AddSingleton<SummaryRequestService>();
15 | builder.Services.AddSingleton<AppSettings>();
16 | builder.Services.AddDaprClient(client =>
17 | {
18 |     client.UseJsonSerializationOptions(new JsonSerializerOptions()
19 |     {
20 |         PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
21 |         PropertyNameCaseInsensitive = true
22 |     });
23 | });
24 | 
25 | var app = builder.Build();
26 | 
27 | // Configure the HTTP request pipeline.
28 | if (!app.Environment.IsDevelopment())
29 | {
30 |     app.UseExceptionHandler("/Error");
31 | }
32 | 
33 | 
34 | app.UseStaticFiles();
35 | 
36 | app.UseRouting();
37 | 
38 | app.MapBlazorHub();
39 | app.MapFallbackToPage("/_Host");
40 | 
41 | app.Run();
42 | 


--------------------------------------------------------------------------------
/src/requests-frontend/Pages/_Host.cshtml:
--------------------------------------------------------------------------------
 1 | @page "/"
 2 | @using Microsoft.AspNetCore.Components.Web
 3 | @namespace Frontend.Pages
 4 | @addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
 5 | 
 6 | <!DOCTYPE html>
 7 | <html lang="en">
 8 | <head>
 9 |     <meta charset="utf-8" />
10 |     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
11 |     <base href="~/" />
12 |     <link href="css/site.css" rel="stylesheet" />
13 |     <link rel="icon" type="image/png" href="favicon.png"/>
14 |     <component type="typeof(HeadOutlet)" render-mode="ServerPrerendered" />
15 | </head>
16 | <body>
17 |     <component type="typeof(App)" render-mode="ServerPrerendered" />
18 | 
19 |     <div id="blazor-error-ui">
20 |         <environment include="Staging,Production">
21 |             An error has occurred. This application may no longer respond until reloaded.
22 |         </environment>
23 |         <environment include="Development">
24 |             An unhandled exception has occurred. See browser dev tools for details.
25 |         </environment>
26 |         <a href="" class="reload">Reload</a>
27 |         <a class="dismiss">🗙</a>
28 |     </div>
29 | 
30 |     <script src="_framework/blazor.server.js"></script>
31 | </body>
32 | </html>
33 | 


--------------------------------------------------------------------------------
/docs/lab/4-learn-more/index.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: Learn more
 3 | has_children: false
 4 | nav_order: 4
 5 | ---
 6 | 
 7 | # Learn more
 8 | 
 9 | ## Distributed Application Runtime (Dapr) 
10 | Dapr is an open source project with a vibrant community. Here are some resources to learn more about Dapr:
11 | * [Dapr Documentation](https://docs.dapr.io)
12 | * [Dapr GitHub repository](https://github.com/dapr/dapr)
13 | * [Dapr Free Book](https://learn.microsoft.com/fr-fr/dotnet/architecture/dapr-for-net-developers/dapr-at-20000-feet)
14 | 
15 | - Other Workshops :
16 |     * [Dapr Workshops (Long version)](https://daprbuildworkshop.z6.web.core.windows.net/)
17 | 
18 | ## Azure Container Apps
19 | 
20 | Azure Container Apps is a new fully managed service that allows you to deploy containerized applications without having to manage any infrastructure. Here are some resources to learn more about Azure Container Apps:
21 | * [Azure Container Apps Documentation](https://docs.microsoft.com/en-us/azure/container-apps/)
22 | * [Azure Container Apps GitHub repository](https://github.com/microsoft/azure-container-apps)
23 | 
24 | * Other Workshops : 
25 |     * [Azure Container Apps .NET Workshop](https://azure.github.io/aca-dotnet-workshop/)
26 |     * [Azure Container Apps Workshop](https://stoacawks.z6.web.core.windows.net/)


--------------------------------------------------------------------------------
/infra/modules/dapr/smtp.bicep:
--------------------------------------------------------------------------------
 1 | targetScope = 'resourceGroup'
 2 | 
 3 | // ------------------
 4 | //    PARAMETERS
 5 | // ------------------
 6 | 
 7 | @description('Name of the Dapr Output Binding component')
 8 | param daprComponentName string
 9 | 
10 | @description('Name of the Azure Container Apps environment')
11 | param containerAppsEnvironmentName string
12 | 
13 | @description('SMTP Host')
14 | @secure()
15 | param smtpHost string
16 | 
17 | @description('SMTP Port')
18 | param smtpPort int
19 | 
20 | resource containerAppsEnvironment 'Microsoft.App/managedEnvironments@2022-03-01' existing = {
21 |   name: containerAppsEnvironmentName
22 | 
23 |   resource daprComponent 'daprComponents@2022-03-01' = {
24 |     name: daprComponentName
25 |     properties: {
26 |       componentType: 'bindings.smtp'
27 |       version: 'v1'
28 |       metadata: [
29 |         {
30 |           name: 'emailFrom'
31 |           value: 'noreply@summarize.io'
32 |         }
33 |         {
34 |           name: 'host'
35 |           value: smtpHost
36 |         }
37 |         {
38 |           name: 'port'
39 |           value: string(smtpPort)
40 |         }
41 |       ]
42 |       scopes:[
43 |         'summarizer-requests-api'
44 |       ]
45 |     }
46 |   }
47 | }
48 | 
49 | output daprEmailOutputBindingName string = containerAppsEnvironment::daprComponent.name
50 | 


--------------------------------------------------------------------------------
/infra/modules/dapr/pubsub.bicep:
--------------------------------------------------------------------------------
 1 | targetScope = 'resourceGroup'
 2 | 
 3 | // ------------------
 4 | //    PARAMETERS
 5 | // ------------------
 6 | 
 7 | @description('Name of the Dapr PubSub component')
 8 | param daprComponentName string
 9 | 
10 | @description('Name of the Azure Container Apps environment')
11 | param containerAppsEnvironmentName string
12 | 
13 | @description('Service Bus connection string')
14 | @secure()
15 | param serviceBusConnectionString string
16 | 
17 | resource containerAppsEnvironment 'Microsoft.App/managedEnvironments@2022-03-01' existing = {
18 |   name: containerAppsEnvironmentName
19 | 
20 |   resource daprComponent 'daprComponents@2022-03-01' = {
21 |     name: daprComponentName
22 |     properties: {
23 |       componentType: 'pubsub.azure.servicebus'
24 |       version: 'v1'
25 |       secrets: [
26 |         {
27 |           name: 'service-bus-connection-string'
28 |           value: serviceBusConnectionString
29 |         }
30 |       ]
31 |       metadata: [
32 |         {
33 |           name: 'connectionString'
34 |           secretRef: 'service-bus-connection-string'
35 |         }
36 |       ]
37 |       scopes:[
38 |         'summarizer-requests-processor'
39 |         'summarizer-frontend'
40 |       ]
41 |     }
42 |   }
43 | }
44 | 
45 | output daprPubSubName string = containerAppsEnvironment::daprComponent.name
46 | 


--------------------------------------------------------------------------------
/.devcontainer/on-setup.sh:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env bash
 2 | 
 3 | set -e
 4 | 
 5 | set_tools() {
 6 |     sudo apt-get update && sudo apt-get install protobuf-compiler redis -y
 7 |     az extension add --name containerapp --upgrade
 8 | }
 9 | 
10 | set_ruby_for_docs_management() {
11 |     sudo apt-get update && sudo apt-get install ruby-full build-essential zlib1g-dev -y
12 |     echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
13 |     echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
14 |     echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
15 |     source ~/.bashrc
16 |     sudo gem install jekyll bundler
17 | }
18 | 
19 | set_dapr_config() {
20 |     dapr uninstall # clean if needed
21 |     dapr init
22 | 
23 |     # Swapping dapr provided redis with latest redislabs/redismod
24 |     # Required for state management support (json queries & indexing)
25 |     docker stop dapr_redis
26 |     docker rm dapr_redis
27 |     docker run -d --name dapr_redis -p 6379:6379 redis/redis-stack-server:latest
28 | }
29 | 
30 | # Install tools
31 | set_tools
32 | set_ruby_for_docs_management
33 | 
34 | # Set dapr config
35 | set_dapr_config
36 | 
37 | # Prefetch dependencies
38 | pip install -r ./src/requests-api/requirements.txt
39 | pip install -r ./src/requests-processor/requirements.txt
40 | dotnet restore ./src/requests-frontend/Frontend.csproj
41 | (cd ./src/job/ && cargo build)
42 | 


--------------------------------------------------------------------------------
/infra/modules/infra/openai.bicep:
--------------------------------------------------------------------------------
 1 | param name string
 2 | param location string = resourceGroup().location
 3 | param tags object = {}
 4 | 
 5 | param customSubDomainName string = name
 6 | param deployments array = []
 7 | param kind string = 'OpenAI'
 8 | param publicNetworkAccess string = 'Enabled'
 9 | param sku object = {
10 |   name: 'S0'
11 | }
12 | 
13 | resource account 'Microsoft.CognitiveServices/accounts@2023-05-01' = {
14 |   name: name
15 |   location: location
16 |   tags: tags
17 |   kind: kind
18 |   properties: {
19 |     customSubDomainName: customSubDomainName
20 |     publicNetworkAccess: publicNetworkAccess
21 |   }
22 |   sku: sku
23 | }
24 | 
25 | @batchSize(1)
26 | resource openaiDeployment 'Microsoft.CognitiveServices/accounts/deployments@2023-05-01' = [for deployment in deployments: {
27 |   name: deployment.name
28 |   sku: {
29 |     capacity: deployment.sku.capacity
30 |     name: 'Standard'
31 |   }
32 |   parent: account
33 |   properties: {
34 |     model: {
35 |       format: 'OpenAI'
36 |       name: deployment.model.name
37 |       version: deployment.model.version
38 |     }
39 |     raiPolicyName: 'Microsoft.Default'
40 |     versionUpgradeOption: 'OnceCurrentVersionExpired'
41 |   }
42 | }]
43 | 
44 | output endpoint string = account.properties.endpoint
45 | output key string = account.listKeys().key1
46 | output id string = account.id
47 | output name string = account.name
48 | 


--------------------------------------------------------------------------------
/src/requests-api/request_entities.py:
--------------------------------------------------------------------------------
 1 | import json
 2 | import logging
 3 | from pydantic import BaseModel
 4 | 
 5 | class SearchSummarizeRequest(BaseModel):
 6 |     url : str
 7 | 
 8 | class NewSummarizeRequest(BaseModel):
 9 |     url : str
10 |     email : str
11 |     summary : str
12 | 
13 | class SummarizeRequest(dict):       
14 | 
15 |     def __init__(self, id : str, url : str, url_hashed : str, summary : str, email : str, timestamp : float):
16 |         dict.__init__(self, id=id, url=url, url_hashed=url_hashed, summary=summary, email=email, timestamp=timestamp)
17 | 
18 |     def get_id(self):
19 |         return self.get("id")
20 | 
21 |     def get_url(self):
22 |         return self.get("url")
23 |     
24 |     def get_url_hashed(self):
25 |         return self.get("url_hashed")
26 | 
27 |     def get_summary(self):
28 |         return self.get("summary")
29 | 
30 |     def get_email(self):
31 |         return self.get("email")
32 | 
33 |     def get_timestamp(self) -> float:
34 |         return self.get("timestamp")
35 |     
36 |     @staticmethod
37 |     def from_bytes(json_bytes : bytes):
38 |         request = json.loads(json_bytes.decode('utf-8'))
39 |         return SummarizeRequest(
40 |             request["id"],
41 |             request["url"],
42 |             request["url_hashed"],
43 |             request["summary"],
44 |             request["email"],
45 |             request["timestamp"]
46 |         )
47 | 


--------------------------------------------------------------------------------
/infra/modules/dapr/secretstore.bicep:
--------------------------------------------------------------------------------
 1 | targetScope = 'resourceGroup'
 2 | 
 3 | // ------------------
 4 | //    PARAMETERS
 5 | // ------------------
 6 | 
 7 | @description('The name of the container apps environment')
 8 | param containerAppsEnvironmentName string
 9 | 
10 | @description('Name of the Dapr Secret Store component')
11 | param daprComponentName string
12 | 
13 | @description('The name of the key vault')
14 | param vaultName string
15 | 
16 | @description('The client id of the managed identity')
17 | param managedIdentityClientId string
18 | 
19 | // ------------------
20 | //    RESOURCES
21 | // ------------------
22 | 
23 | resource containerAppsEnvironment 'Microsoft.App/managedEnvironments@2022-03-01' existing = {
24 |   name: containerAppsEnvironmentName
25 | 
26 |   resource daprComponent 'daprComponents@2022-03-01' = {
27 |     name: daprComponentName
28 |     properties: {
29 |       componentType: 'secretstores.azure.keyvault'
30 |       ignoreErrors: false
31 |       version: 'v1'
32 |       initTimeout: '5s'
33 |       metadata: [
34 |         {
35 |           name: 'vaultName'
36 |           value: vaultName
37 |         }
38 |         {
39 |           name: 'azureClientId'
40 |           value: managedIdentityClientId
41 |         }
42 |       ]
43 |       scopes:[
44 |         'summarizer-requests-processor'
45 |       ]
46 |     }
47 |   }
48 | }
49 | 
50 | output daprSecretStoreName string = containerAppsEnvironment::daprComponent.name
51 | 


--------------------------------------------------------------------------------
/src/requests-processor/app.py:
--------------------------------------------------------------------------------
 1 | import json, logging, os
 2 | 
 3 | from fastapi import Body, FastAPI, Response
 4 | from fastapi.responses import HTMLResponse
 5 | from dapr.clients import DaprClient
 6 | from dapr.ext.fastapi import DaprApp
 7 | 
 8 | from settings import Settings
 9 | from request_handler import SummarizeRequestHandler
10 | from request_entities import SummarizeRequestCloudEvent
11 | 
12 | logging.basicConfig(level=logging.INFO)
13 | 
14 | app = FastAPI()
15 | dapr_app = DaprApp(app)
16 | dapr_client = DaprClient()
17 | 
18 | @dapr_app.subscribe(pubsub='summarizer-pubsub', topic='link-to-summarize')
19 | async def link_to_summarize(event : SummarizeRequestCloudEvent):
20 |     try:
21 |         logging.info("New link to summarize event was triggered.")
22 |         logging.info(event)
23 | 
24 |         settings = Settings(dapr_client)
25 |         req_handle = SummarizeRequestHandler(dapr_client, settings, event)
26 |         await req_handle.run()
27 |     except Exception as e:
28 |         logging.error("Url Received to summarize but an issue occured.")
29 |         logging.error(e)
30 | 
31 | @app.get('/', response_class = HTMLResponse)
32 | async def read_items():
33 |     return """
34 |     <html>
35 |         <head>
36 |             <title>Requests Processor API</title>
37 |         </head>
38 |         <body>
39 |             <h1>Requests Processor API Ready !</h1>
40 |         </body>
41 |     </html>
42 |     """
43 | 


--------------------------------------------------------------------------------
/src/requests-processor/request_entities.py:
--------------------------------------------------------------------------------
 1 | import json
 2 | import logging
 3 | from pydantic import BaseModel
 4 |     
 5 | class SummarizeRequestEventData(BaseModel):
 6 |     url : str
 7 |     email : str
 8 | 
 9 | class SummarizeRequestCloudEvent(BaseModel):
10 |     data: SummarizeRequestEventData
11 |     datacontenttype: str
12 |     id: str
13 |     pubsubname: str
14 |     source: str
15 |     specversion: str
16 |     time: str
17 |     topic: str
18 |     traceid: str
19 |     traceparent: str
20 |     tracestate: str
21 |     type: str
22 | 
23 | class SummarizeRequest(dict):       
24 | 
25 |     def __init__(self, id, url, summary, email, timestamp : float):
26 |         dict.__init__(self, id=id, url=url, summary=summary, email=email, timestamp=timestamp)
27 | 
28 |     def get_id(self):
29 |         return self.get("id")
30 | 
31 |     def get_url(self):
32 |         return self.get("url")
33 | 
34 |     def get_summary(self):
35 |         return self.get("summary")
36 | 
37 |     def get_email(self):
38 |         return self.get("email")
39 | 
40 |     def get_timestamp(self) -> float:
41 |         return self.get("timestamp")
42 |     
43 |     @staticmethod
44 |     def from_bytes(json_bytes : bytes):
45 |         request = json.loads(json_bytes.decode('utf-8'))
46 |         return SummarizeRequest(
47 |             request["id"],
48 |             request["url"],
49 |             request["summary"],
50 |             request["email"],
51 |             request["timestamp"]
52 |         )
53 | 


--------------------------------------------------------------------------------
/docs/Gemfile:
--------------------------------------------------------------------------------
 1 | source "https://rubygems.org"
 2 | # Hello! This is where you manage which Jekyll version is used to run.
 3 | # When you want to use a different version, change it below, save the
 4 | # file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
 5 | #
 6 | #     bundle exec jekyll serve
 7 | #
 8 | # This will help ensure the proper Jekyll version is running.
 9 | # Happy Jekylling!
10 | # gem "jekyll", "~> 4.3.2"
11 | gem "github-pages", "~> 228", group: :jekyll_plugins
12 | 
13 | # This is the default theme for new Jekyll sites. You may change this to anything you like.
14 | gem "just-the-docs"
15 | 
16 | # If you want to use GitHub Pages, remove the "gem "jekyll"" above and
17 | # uncomment the line below. To upgrade, run `bundle update github-pages`.
18 | # gem "github-pages", group: :jekyll_plugins
19 | # If you have any plugins, put them here!
20 | # group :jekyll_plugins do
21 | #   gem "jekyll-feed", "~> 0.12"
22 | # end
23 | 
24 | # Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
25 | # and associated library.
26 | platforms :mingw, :x64_mingw, :mswin, :jruby do
27 |   gem "tzinfo", ">= 1", "< 3"
28 |   gem "tzinfo-data"
29 | end
30 | 
31 | # Performance-booster for watching directories on Windows
32 | gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin]
33 | 
34 | # Lock `http_parser.rb` gem to `v0.6.x` on JRuby builds since newer versions of the gem
35 | # do not have a Java counterpart.
36 | gem "http_parser.rb", "~> 0.6.0", :platforms => [:jruby]
37 | 


--------------------------------------------------------------------------------
/src/requests-frontend/Shared/NewSummaryRequest.razor:
--------------------------------------------------------------------------------
 1 | @using Frontend.Data
 2 | @using Microsoft.Extensions.Logging
 3 | @using Microsoft.AspNetCore.Components.Forms
 4 | 
 5 | @inject ILogger<NewSummaryRequest> Logger
 6 | @inject SummaryRequestService SummaryRequestService
 7 | 
 8 | <EditForm EditContext="@editContext" OnSubmit="@AddSummaryRequestAsync" class="summary-request-form">
 9 |     <DataAnnotationsValidator />
10 |     <label for="email">Email:</label>
11 |     <InputText id="email" @bind-Value="newSummaryRequestPayload.Email" placeholder="Enter your email" class="lbl" />
12 |     <label for="url">URL:</label>
13 |     <InputText id="url" @bind-Value="newSummaryRequestPayload.Url" placeholder="Enter the URL" class="lbl" />
14 |     <button type="submit">Queue</button>
15 |     <ValidationSummary />
16 | </EditForm>
17 | 
18 | @code {
19 |     private NewSummaryRequestPayload newSummaryRequestPayload = new NewSummaryRequestPayload();
20 |     private EditContext? editContext;
21 | 
22 |     protected override void OnInitialized()
23 |     {
24 |         newSummaryRequestPayload.Email = "me@bangaluru";
25 |         editContext = new(newSummaryRequestPayload);
26 |     }
27 | 
28 |     private async Task AddSummaryRequestAsync()
29 |     {
30 |         if (editContext != null && editContext.Validate())
31 |         {
32 |             Logger.LogInformation("AddSummaryRequestAsync called: Form  is valid");
33 |             await SummaryRequestService.AddSummaryRequestAsync(newSummaryRequestPayload);
34 |         }
35 |     }
36 | }


--------------------------------------------------------------------------------
/src/requests-frontend/Data/SummaryRequestService.cs:
--------------------------------------------------------------------------------
 1 | namespace Frontend.Data;
 2 | 
 3 | using System.Text.Json;
 4 | using Dapr.Client;
 5 | 
 6 | public class SummaryRequestService
 7 | {
 8 |     private readonly DaprClient _daprClient;
 9 |     private readonly AppSettings _settings;
10 | 
11 |     private readonly ILogger<SummaryRequestService> _logger;
12 | 
13 |     public SummaryRequestService(DaprClient daprClient, AppSettings settingsService, ILogger<SummaryRequestService> Logger)
14 |     {
15 |         this._daprClient = daprClient;
16 |         this._settings = settingsService;
17 |         this._logger = Logger;
18 |     }
19 | 
20 |     public async Task AddSummaryRequestAsync(NewSummaryRequestPayload newSummaryRequest)
21 |     {
22 |         CancellationTokenSource source = new CancellationTokenSource();
23 |         CancellationToken cancellationToken = source.Token;
24 | 
25 |         await this._daprClient.PublishEventAsync<NewSummaryRequestPayload>(
26 |             _settings.PubRequestName,
27 |             _settings.PubRequestTopic,
28 |             newSummaryRequest,
29 |             cancellationToken
30 |         );
31 |     }
32 | 
33 |     public async Task<SummaryRequest[]> GetSummaryRequestsAsync()
34 |     {
35 |         HttpRequestMessage? response = this._daprClient.CreateInvokeMethodRequest(
36 |             HttpMethod.Get,
37 |             _settings.requestsApiAppId,
38 |             _settings.requestsApiEndpoint
39 |         );
40 |         return await this._daprClient.InvokeMethodAsync<SummaryRequest[]>(response);
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/docs/_layouts/default.html:
--------------------------------------------------------------------------------
 1 | ---
 2 | layout: table_wrappers
 3 | ---
 4 | 
 5 | <!DOCTYPE html>
 6 | 
 7 | <html lang="{{ site.lang | default: 'en-US' }}">
 8 | {% include head.html %}
 9 | <body>
10 |   <a class="skip-to-main" href="#main-content">Skip to main content</a>
11 |   {% include icons/icons.html %}
12 |   {% include components/sidebar.html %}
13 |   <div class="main" id="top">
14 |     {% include components/header.html %}
15 |     <div id="main-content-wrap" class="main-content-wrap">
16 |       {% include components/breadcrumbs.html %}
17 |       <div id="main-content" class="main-content">
18 |         <main>
19 |           {% if site.heading_anchors != false %}
20 |             {% include vendor/anchor_headings.html html=content beforeHeading="true" anchorBody="<svg viewBox=\"0 0 16 16\" aria-hidden=\"true\"><use xlink:href=\"#svg-link\"></use></svg>" anchorClass="anchor-heading" anchorAttrs="aria-labelledby=\"%html_id%\"" %}
21 |           {% else %}
22 |             {{ content }}
23 |           {% endif %}
24 | 
25 |           {% if page.has_children == true and page.has_toc != false %}
26 |             {% include components/children_nav.html %}
27 |           {% endif %}
28 |         </main>
29 |         {% include components/footer.html %}
30 |       </div>
31 |     </div>
32 |     {% if site.search_enabled != false %}
33 |       {% include components/search_footer.html %}
34 |     {% endif %}
35 |   </div>
36 | 
37 |   {% if site.mermaid %}
38 |     {% include components/mermaid.html %}
39 |   {% endif %}
40 |   {% include text-expand.html %}
41 | </body>
42 | </html>


--------------------------------------------------------------------------------
/docs/lab/1-get-ready/1-2-codespaces.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: Setup Codespaces
 3 | parent: Get Ready
 4 | has_children: false
 5 | permalink: /lab1/codespaces
 6 | nav_order: 2
 7 | ---
 8 | 
 9 | # Setup Codespace
10 | 
11 | You can run this application in a [GitHub Codespace](https://docs.github.com/en/codespaces/developing-in-codespaces/creating-a-codespace). This is useful for development and testing.
12 | 
13 | 1. Open the [ACA Dapr Workshop GitHub](https://github.com/reidav/aca-dapr-openai-workshop)
14 | 
15 | 2. Click the `Open in Codespaces` button
16 | 
17 | ![Alt text](images/open-codespaces-1.png)
18 | 
19 | 3. Click the `Change options` button
20 | 
21 | ![Alt text](images/open-codespaces-2.png)
22 | 
23 | 4. Select the `lab` branch, the `aca-dapr-openai-workshop` dev container configuration and click `create codespace`.
24 | 
25 | ![Alt text](images/open-codespaces-3.png)
26 | 
27 | 5. Wait for the Codespace to be created
28 | 
29 | > As we've been using GitHub Codespaces prebuild feature, Codespace should be ready in a few seconds. Click here to learn more [about prebuilds](https://docs.github.com/en/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds).
30 | 
31 | ![Alt text](images/open-codespaces-5.png)
32 | 
33 | 6. Once the Codespace is ready, you can start working on the dev container through the browser or you can also connect to it using Visual Studio Code 
34 | 
35 | ![Alt text](images/open-codespaces-4.png)
36 | 
37 | > In case you're having the error message "Address already in use - bind", you can use the following command to free the address in use: `sudo lsof -i :8080` and then `sudo kill -9 <PID>`


--------------------------------------------------------------------------------
/.github/workflows/jekyll-gh-pages.yml:
--------------------------------------------------------------------------------
 1 | # Sample workflow for building and deploying a Jekyll site to GitHub Pages
 2 | name: Deploy GitHub Pages
 3 | 
 4 | on:
 5 |   # Runs on pushes targeting the default branch
 6 |   push:
 7 |     branches: ["main"]
 8 |     paths:
 9 |       - 'docs/**'
10 | 
11 |   # Allows you to run this workflow manually from the Actions tab
12 |   workflow_dispatch:
13 | 
14 | # Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
15 | permissions:
16 |   contents: read
17 |   pages: write
18 |   id-token: write
19 | 
20 | # Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
21 | # However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
22 | concurrency:
23 |   group: "pages"
24 |   cancel-in-progress: false
25 | 
26 | jobs:
27 |   # Build job
28 |   build:
29 |     runs-on: ubuntu-latest
30 |     steps:
31 |       - name: Checkout
32 |         uses: actions/checkout@v3
33 |       - name: Setup Pages
34 |         uses: actions/configure-pages@v3
35 |       - name: Build with Jekyll
36 |         uses: actions/jekyll-build-pages@v1
37 |         with:
38 |           source: ./docs
39 |           destination: ./_site
40 |       - name: Upload artifact
41 |         uses: actions/upload-pages-artifact@v1
42 | 
43 |   # Deployment job
44 |   deploy:
45 |     environment:
46 |       name: github-pages
47 |       url: ${{ steps.deployment.outputs.page_url }}
48 |     runs-on: ubuntu-latest
49 |     needs: build
50 |     steps:
51 |       - name: Deploy to GitHub Pages
52 |         id: deployment
53 |         uses: actions/deploy-pages@v2
54 | 


--------------------------------------------------------------------------------
/src/requests-frontend/Pages/Error.cshtml:
--------------------------------------------------------------------------------
 1 | @page
 2 | @model Frontend.Pages.ErrorModel
 3 | 
 4 | <!DOCTYPE html>
 5 | <html lang="en">
 6 | 
 7 | <head>
 8 |     <meta charset="utf-8" />
 9 |     <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" />
10 |     <title>Error</title>
11 |     <link href="~/css/site.css" rel="stylesheet" asp-append-version="true" />
12 | </head>
13 | 
14 | <body>
15 |     <div class="main">
16 |         <div class="content px-4">
17 |             <h1 class="text-danger">Error.</h1>
18 |             <h2 class="text-danger">An error occurred while processing your request.</h2>
19 | 
20 |             @if (Model.ShowRequestId)
21 |             {
22 |                 <p>
23 |                     <strong>Request ID:</strong> <code>@Model.RequestId</code>
24 |                 </p>
25 |             }
26 | 
27 |             <h3>Development Mode</h3>
28 |             <p>
29 |                 Swapping to the <strong>Development</strong> environment displays detailed information about the error that occurred.
30 |             </p>
31 |             <p>
32 |                 <strong>The Development environment shouldn't be enabled for deployed applications.</strong>
33 |                 It can result in displaying sensitive information from exceptions to end users.
34 |                 For local debugging, enable the <strong>Development</strong> environment by setting the <strong>ASPNETCORE_ENVIRONMENT</strong> environment variable to <strong>Development</strong>
35 |                 and restarting the app.
36 |             </p>
37 |         </div>
38 |     </div>
39 | </body>
40 | 
41 | </html>
42 | 


--------------------------------------------------------------------------------
/infra/modules/infra/webmail.bicep:
--------------------------------------------------------------------------------
 1 | targetScope = 'resourceGroup'
 2 | 
 3 | // ------------------
 4 | //    PARAMETERS
 5 | // ------------------
 6 | 
 7 | @description('Container apps environment id where the container app will be deployed')
 8 | param containerAppsEnvironmentId string
 9 | 
10 | @description('Container App Name being used for deployment')
11 | param containerAppName string
12 | 
13 | @description('Container app image being used for deployment')
14 | param containerAppImage string
15 | 
16 | param location string = resourceGroup().location
17 | 
18 | // ------------------
19 | //    RESOURCES
20 | // ------------------
21 | 
22 | resource containerApp 'Microsoft.App/containerApps@2023-11-02-preview' = {
23 |   name: containerAppName
24 |   location: location
25 |   properties: {
26 |     managedEnvironmentId: containerAppsEnvironmentId
27 |     template: {
28 |       containers: [
29 |         {
30 |           name: containerAppName
31 |           image: containerAppImage
32 |           resources: {
33 |             cpu: json('0.25')
34 |             memory: '0.5Gi'
35 |           }
36 |         }
37 |       ]
38 |       scale: {
39 |         minReplicas: 1
40 |         maxReplicas: 1
41 |       }
42 |     }
43 |     configuration: {
44 |       activeRevisionsMode: 'single'
45 | 
46 |       ingress: {
47 |         additionalPortMappings: [
48 |           {
49 |             exposedPort: 1025
50 |             external: true
51 |             targetPort: 1025
52 |           }
53 |         ]
54 |         external: true
55 |         targetPort: 8025
56 |       }
57 |     }
58 |   }
59 | }
60 | 
61 | output fqdn string = containerApp.properties.configuration.ingress.fqdn
62 | output smtpPort int = 1025
63 | 


--------------------------------------------------------------------------------
/infra/modules/infra/cosmos-db.bicep:
--------------------------------------------------------------------------------
 1 | // ------------------
 2 | //    PARAMETERS
 3 | // ------------------
 4 | 
 5 | @description('Cosmos DB account name')
 6 | param cosmosAccountName string
 7 | 
 8 | @description('Cosmos DB database name')
 9 | param cosmosDbName string
10 | 
11 | @description('Cosmos DB collection name')
12 | param location string
13 | 
14 | // ------------------
15 | //    RESOURCES
16 | // ------------------
17 | 
18 | resource cosmosAccount 'Microsoft.DocumentDB/databaseAccounts@2021-04-15' = {
19 |   name: cosmosAccountName
20 |   location: location
21 |   kind: 'GlobalDocumentDB'
22 |   properties: {
23 |     databaseAccountOfferType: 'Standard'
24 |     consistencyPolicy: {
25 |       defaultConsistencyLevel: 'Session'
26 |     }
27 |     locations: [
28 |       {
29 |         locationName: location
30 |       }
31 |     ]
32 |     capabilities: [
33 |       {
34 |         name: 'EnableServerless'
35 |       }
36 |     ]
37 |   }
38 | }
39 | 
40 | resource cosmosDb 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2021-04-15' = {
41 |   parent: cosmosAccount
42 |   name: cosmosDbName
43 |   properties: {
44 |     resource: {
45 |       id: cosmosDbName
46 |     }
47 |   }
48 | }
49 | 
50 | resource cosmosCollection 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2021-04-15' = {
51 |   parent: cosmosDb
52 |   name: 'state'
53 |   properties: {
54 |     resource: {
55 |       id: 'state'
56 |       partitionKey: {
57 |         paths: [
58 |           '/partitionKey'
59 |         ]
60 |         kind: 'Hash'
61 |       }
62 |     }
63 |   }
64 | }
65 | 
66 | output cosmosAccountName string = cosmosAccount.name
67 | output cosmosDbName string = cosmosDbName
68 | output cosmosUrl string = cosmosAccount.properties.documentEndpoint
69 | output cosmosKey string = cosmosAccount.listKeys().primaryMasterKey
70 | output cosmosCollectionName string = cosmosCollection.name
71 | 


--------------------------------------------------------------------------------
/dapr.yaml:
--------------------------------------------------------------------------------
 1 | version: 1
 2 | common:
 3 |   resourcesPath: dapr/local/components
 4 |   env:
 5 |     DEBUG: true
 6 | apps:
 7 |   - appID: summarizer-requests-api
 8 |     appDirPath: ./src/requests-api/
 9 |     appPort: 13000
10 |     command: ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "13000"]
11 |     env:
12 |       STATE_STORE_NAME: "summarizer-statestore"
13 |       STATE_STORE_QUERY_INDEX_NAME: "orgIndx"
14 |       BINDING_SMTP: "summarizer-smtp"
15 |       APP_PORT: 13000
16 |   - appID: summarizer-requests-processor
17 |     appDirPath: ./src/requests-processor/
18 |     appPort: 12000
19 |     command: ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "12000"]
20 |     env:
21 |       SECRET_STORE_NAME: "summarizer-secretstore"
22 |       PUBSUB_REQUESTS_NAME: "summarizer-pubsub"
23 |       PUBSUB_REQUESTS_TOPIC: "link-to-summarize"
24 |       REQUESTS_API_APP_ID: "summarizer-requests-api"
25 |       REQUESTS_API_SEARCH_ENDPOINT: "search-requests-by-url"
26 |       REQUESTS_API_CREATE_ENDPOINT: "requests"
27 |       OPENAI_API_VERSION: "2024-02-15-preview"
28 |       OPENAI_API_DEPLOYMENT_NAME: "gpt-4-32k"
29 |       APP_PORT: 12000
30 |   - appID: summarizer-frontend
31 |     appDirPath: ./src/requests-frontend/
32 |     appPort: 11000
33 |     command: ["dotnet", "run"]
34 |     env:
35 |       PUBSUB_REQUESTS_NAME: "summarizer-pubsub"
36 |       PUBSUB_REQUESTS_TOPIC: "link-to-summarize"
37 |       REQUESTS_API_APP_ID: "summarizer-requests-api"
38 |       REQUESTS_API_ENDPOINT: "requests"
39 |       DOTNET_URLS: "http://0.0.0.0:11000"
40 |   # - appID: job
41 |   #   appDirPath: ./src/job
42 |   #   env:
43 |   #     PUBSUB_REQUESTS_NAME: "summarizer-pubsub"
44 |   #     PUBSUB_REQUESTS_TOPIC: "link-to-summarize"
45 |   #     JOB_REQUESTED_URLS: "https://fr.wikipedia.org/wiki/Architecture_hexagonale"
46 |   #     JOB_REQUESTOR_EMAIL: me@contoso.com
47 |   #   command:  ["cargo", "run"]
48 | 


--------------------------------------------------------------------------------
/infra/modules/dapr/statestore.bicep:
--------------------------------------------------------------------------------
 1 | targetScope = 'resourceGroup'
 2 | 
 3 | // ------------------
 4 | //    PARAMETERS
 5 | // ------------------
 6 | @description('Name of the Container Apps environment')
 7 | param containerAppsEnvironmentName string
 8 | 
 9 | @description('Name of the Dapr PubSub component')
10 | param daprComponentName string
11 | 
12 | @description('Name of the Cosmos DB database')
13 | param cosmosDbName string
14 | 
15 | @description('Name of the Cosmos DB collection')
16 | param cosmosCollectionName string
17 | 
18 | @description('URL of the Cosmos DB instance')
19 | param cosmosUrl string
20 | 
21 | @secure()
22 | param cosmosKey string
23 | 
24 | // ------------------
25 | //    RESOURCES
26 | // ------------------
27 | 
28 | resource containerAppsEnvironment 'Microsoft.App/managedEnvironments@2022-03-01' existing = {
29 |   name: containerAppsEnvironmentName
30 | 
31 |   resource daprComponent 'daprComponents@2022-03-01' = {
32 |     name: daprComponentName
33 |     properties: {
34 |       componentType: 'state.azure.cosmosdb'
35 |       version: 'v1'
36 |       initTimeout: '5m'
37 |       secrets: [
38 |         {
39 |           name: 'cosmos-key'
40 |           value: cosmosKey
41 |         }
42 |       ]
43 |       metadata: [
44 |         {
45 |           name: 'url'
46 |           value: cosmosUrl
47 |         }
48 |         {
49 |           name: 'masterKey'
50 |           secretRef: 'cosmos-key'
51 |         }
52 |         {
53 |           name: 'database'
54 |           value: cosmosDbName
55 |         }
56 |         {
57 |           name: 'collection'
58 |           value: cosmosCollectionName
59 |         }
60 |         {
61 |           name: 'actorStateStore'
62 |           value: 'true'
63 |         }
64 |       ]
65 |       scopes:[
66 |         'summarizer-requests-api'
67 |       ]
68 |     }
69 |   }
70 | }
71 | 
72 | output daprStateStoreName string = containerAppsEnvironment::daprComponent.name
73 | 


--------------------------------------------------------------------------------
/infra/modules/infra/container-registry.bicep:
--------------------------------------------------------------------------------
 1 | // ------------------
 2 | //    PARAMETERS
 3 | // ------------------
 4 | 
 5 | @description('container registry name')
 6 | param containerRegistryName string
 7 | 
 8 | @description('The name of the user assigned identity to create.')
 9 | param containerRegistryUserAssignedIdentityName string
10 | 
11 | @description('The location of the container registry.')
12 | param location string
13 | 
14 | var containerRegistryPullRoleGuid = '7f951dda-4ed3-4680-a7ca-43fe172d538d'
15 | 
16 | // ------------------
17 | //    RESOURCES
18 | // ------------------
19 | 
20 | resource containerRegistry 'Microsoft.ContainerRegistry/registries@2022-12-01' = {
21 |   name: containerRegistryName
22 |   location: location
23 |   sku: {
24 |     name: 'Basic'
25 |   }
26 |   properties: {
27 |     adminUserEnabled: true
28 |   }
29 | }
30 | 
31 | resource containerRegistryUserAssignedIdentity 'Microsoft.ManagedIdentity/userAssignedIdentities@2018-11-30' = {
32 |   name: containerRegistryUserAssignedIdentityName
33 |   location: location
34 | }
35 | 
36 | resource containerRegistryRoleAssignment 'Microsoft.Authorization/roleAssignments@2020-04-01-preview' = {
37 |   name: guid(subscription().id, containerRegistryName, containerRegistryUserAssignedIdentityName) 
38 |   scope: containerRegistry
39 |   properties: {
40 |     principalId: containerRegistryUserAssignedIdentity.properties.principalId
41 |     roleDefinitionId: resourceId('Microsoft.Authorization/roleDefinitions', containerRegistryPullRoleGuid)
42 |     principalType: 'ServicePrincipal'
43 |   }
44 | }
45 | 
46 | output containerRegistryName string = containerRegistry.name
47 | output containerRegistryManagedIdentityId string = containerRegistryUserAssignedIdentity.id
48 | output containerRegistryManagedIdentityClientId string = containerRegistryUserAssignedIdentity.properties.clientId
49 | output containerRegistryManagedIdentityObjectId string = containerRegistryUserAssignedIdentity.properties.principalId
50 | 
51 | 


--------------------------------------------------------------------------------
/.devcontainer/devcontainer.json:
--------------------------------------------------------------------------------
 1 | // For format details, see https://aka.ms/devcontainer.json. For config options, see the
 2 | // README at: https://github.com/devcontainers/templates/tree/main/src/docker-in-docker
 3 | {
 4 |   "name": "aca-dapr-openai-workshop",
 5 |   "image": "mcr.microsoft.com/vscode/devcontainers/base:bullseye",
 6 |   "workspaceMount": "source=${localWorkspaceFolder},target=/workspace,type=bind",
 7 |   "workspaceFolder": "/workspace",
 8 |   "runArgs": ["--privileged", "--init"],
 9 |   "onCreateCommand": "bash ./.devcontainer/on-setup.sh",
10 | 
11 |   "features": {
12 |     "ghcr.io/devcontainers/features/github-cli:1": {},
13 |     "ghcr.io/devcontainers/features/azure-cli:1": {},
14 |     "ghcr.io/azure/azure-dev/azd:latest": {},
15 |     "ghcr.io/audacioustux/devcontainers/vegeta:1": {},
16 |     "ghcr.io/dapr/cli/dapr-cli:0": {},
17 |     "ghcr.io/devcontainers/features/docker-in-docker:2": {
18 |       "version": "latest",
19 |       "enableNonRootDocker": "true",
20 |       "moby": "true"
21 |     },
22 |     "ghcr.io/devcontainers/features/python:1": {},
23 |     "ghcr.io/devcontainers/features/node:1": {
24 |       "version": "lts"
25 |     },
26 |     "ghcr.io/devcontainers/features/dotnet:2.0.5": {
27 |       "version": "8.0"
28 |     },
29 |     "ghcr.io/devcontainers/features/rust:1": {}
30 |   },
31 | 
32 |   "customizations": {
33 |     // Configure properties specific to VS Code.
34 |     "vscode": {
35 |       "settings": {},
36 |       "extensions": [
37 |         "ms-azuretools.vscode-dapr",
38 |         "ms-azuretools.vscode-docker",
39 |         "ms-python.python",
40 |         "GitHub.copilot",
41 |         "GitHub.copilot-chat",
42 |         "esbenp.prettier-vscode",
43 |         "charliermarsh.ruff",
44 |         "ms-azuretools.vscode-bicep",
45 |         "ms-dotnettools.csdevkit"
46 |       ]
47 |     }
48 |   },
49 | 
50 |   // Use 'forwardPorts' to make a list of ports inside the container available locally.
51 |   // "forwardPorts": [],
52 | 
53 |   // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
54 |   "remoteUser": "vscode"
55 | }
56 | 


--------------------------------------------------------------------------------
/docs/lab/2-dapr-components/2-2-summarizer-overview.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: Summarizer Overview
 3 | parent: Implement Dapr Components
 4 | has_children: false
 5 | permalink: /lab2/summarizer-overview
 6 | nav_order: 2
 7 | ---
 8 | 
 9 | # Summarizer app using local components 
10 | 
11 | {: .no_toc }
12 | 
13 | <details open markdown="block">
14 |   <summary>
15 |     Table of contents
16 |   </summary>
17 |   {: .text-delta }
18 | - TOC
19 | {:toc}
20 | </details>
21 | 
22 | In the following sub-section of this chapter, we will be configuring the Summarizer application with Dapr components (mostly Redis as Pub/Sub & State Store provider, local secrets and SMTP connector).
23 | 
24 | Before we start, let's have a look at the application architecture.
25 | 
26 | ## Application architecture
27 | 
28 | ![Dapr overview](images/dapr-local.png)
29 | 
30 | ## Application behaviors
31 | 
32 | 1. User can requests summary of any links using the Blazor application (Single Page Application using the Dapr .NET SDK to interact with the Dapr Runtime).
33 |     * User can see the previous requests from the portal (using the Dapr Service Invocation to call the Requests API)
34 |     * User can request a new summary of a link (using the Pub/Sub building block to publish a new request to the Requests Processor)
35 | 
36 | 1. The requests processor retrieves the request from the queue.
37 | 
38 | 1. The requests processor is calling the requests API to evaluate if any requests already exists for this link.
39 | 
40 | 1. The requests API is checking within the state store
41 | 
42 | 1. If no results were provided by the request api, the request processor will resolve the summary using Azure Open AI endpoint. 
43 |     * If a summary was provided previously, the request processor will leverage it and will not call the Azure Open AI endpoint.
44 | 
45 | 1. After the request processing, a new record is created in the state store and an email is sent to the user using the SMTP connector.
46 | 
47 | 
48 | > Note: Bulk Summarization Request is a once time process aimed to generate requests automatically for debug purposes at the time being. It is also using the Pub/sub building block to publish a new request to the Requests Processor.
49 | 
50 | ## Source code
51 | 
52 | Spend some time to review the source code of the application located in the source code folder of the repository especially the `app.py` of backend application to understand their behaviours. 
53 | 
54 | 


--------------------------------------------------------------------------------
/infra/setup.sh:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env bash
 2 | set -e
 3 | 
 4 | export RESOURCE_GROUP=rg-dev-swn-linksummarizer
 5 | export WORKLOAD_NAME=summarizer
 6 | export ENVIRONMENT=dev
 7 | export UNIQUE_ID=01
 8 | 
 9 | # Create Resource Group
10 | # Check the availability of the OpenAI gpt-4, 0613 model in your region:
11 | # https://learn.microsoft.com/en-us/azure/ai-services/openai/concepts/models#standard-deployment-model-availability
12 | az group create --name $RESOURCE_GROUP --location australiaeast
13 | 
14 | # Deploy Container Apps Environment and its prerequisites
15 | echo "Deploying Container Apps Environment and its prerequisites to $RESOURCE_GROUP..."
16 | AZ_CAENV_DEPLOYMENT=$(az deployment group create \
17 |                         --resource-group $RESOURCE_GROUP \
18 |                         --template-file ./infra.bicep \
19 |                         --parameters workloadName=$WORKLOAD_NAME \
20 |                         --parameters environment=$ENVIRONMENT \
21 |                         --parameters uniqueId=$UNIQUE_ID)
22 | 
23 | # echo "Retrieving Container Registry..."
24 | REGISTRY=""
25 | REGISTRY=$(echo $AZ_CAENV_DEPLOYMENT | grep -oE -m 1 '/registries/([^/]+)' | tail -n +2 | cut -d'/' -f3).azurecr.io
26 | echo "Container Registry: $REGISTRY"
27 | 
28 | # Login to Azure
29 | echo "Logging in to Azure Container Registry..."
30 | az acr login --name $REGISTRY
31 | 
32 | # Build and push images
33 | echo "Building and pushing images..."
34 | export TIMESTAMP=$(date +%s)
35 | echo $TIMESTAMP
36 | 
37 | docker build -t $REGISTRY/summarizer/requests-api:$TIMESTAMP ../src/requests-api
38 | docker build -t $REGISTRY/summarizer/requests-processor:$TIMESTAMP ../src/requests-processor
39 | docker build -t $REGISTRY/summarizer/requests-frontend:$TIMESTAMP  ../src/requests-frontend
40 | docker push $REGISTRY/summarizer/requests-api:$TIMESTAMP
41 | docker push $REGISTRY/summarizer/requests-processor:$TIMESTAMP
42 | docker push $REGISTRY/summarizer/requests-frontend:$TIMESTAMP
43 | 
44 | # Deploy Container Apps
45 | echo "Deploying Container Apps..."
46 | AZ_CAENV_DEPLOYMENT=$( az deployment group create \
47 |                         --resource-group $RESOURCE_GROUP \
48 |                         --template-file ./apps.bicep \
49 |                         --parameters workloadName=$WORKLOAD_NAME \
50 |                         --parameters environment=$ENVIRONMENT \
51 |                         --parameters uniqueId=$UNIQUE_ID \
52 |                         --parameters imageTag=$TIMESTAMP)


--------------------------------------------------------------------------------
/docs/index.markdown:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: About this workshop
 3 | layout: default
 4 | permalink: /
 5 | nav_order: 1
 6 | ---
 7 | 
 8 | #  About this workshop
 9 | 
10 | Welcome to this **Dapr, Azure Container Apps Workshop**. You'll be experimenting with Azure Serverless services in multiple labs to achieve a real world scenario. Don't worry, even if the challenges will increase in difficulty, this is a step by step lab, you will be guided through the whole process.
11 | 
12 | During this workshop you will have the instructions to complete each steps. It is recommended to search for the answers in provided resources and links before looking at the solutions placed under the 'Toggle solution' panel.
13 | 
14 | ## Summarizer
15 | 
16 | **Summarizer** is an application designed to demonstrates how to build a, intelligent cloud native application using Dapr, Containers Apps and Open AI. It is composed of multiple microservices.
17 | 
18 | ![SummarizeArchitecture](assets/images/summarizer-dapr-aca.png)
19 | 
20 | **Summarizer Blazor App (Front-end)** : A Blazor WebAssembly application that allows to browse all summaries and eventually queue new links to be summarized.
21 | 
22 | **Requests API (Python)** : FastAPI leveraging Dapr state management to store / get all requests of summaries. It allows to track and reuse previous summaries eventually generated. When a new completed request is created following processing, it sends a email message to the requestor.
23 | 
24 | **Requests Processor (Python)** : A Python application that allows to process summary requests in queue. If no summary has already being provided, it will prompt Azure Open AI to get a new summary. In any case, requests will be tracked using the requests API at the end of the process.
25 | 
26 | 
27 | # Contributors
28 | 
29 | <ul class="list-style-none">
30 | {% for contributor in site.github.contributors %}
31 |   <li class="d-inline-block mr-1">
32 |      <a href="{{ contributor.html_url }}"><img src="{{ contributor.avatar_url }}" width="32" height="32" alt="{{ contributor.login }}"/></a>
33 |   </li>
34 | {% endfor %}
35 | </ul>
36 | 
37 | # Trademarks
38 | 
39 | This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft 
40 | trademarks or logos is subject to and must follow 
41 | [Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
42 | Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
43 | Any use of third-party trademarks or logos are subject to those third-party's policies.
44 | 


--------------------------------------------------------------------------------
/docs/_config.yml:
--------------------------------------------------------------------------------
 1 | # Welcome to Jekyll!
 2 | #
 3 | # This config file is meant for settings that affect your whole blog, values
 4 | # which you are expected to set up once and rarely edit after that. If you find
 5 | # yourself editing this file very often, consider using Jekyll's data files
 6 | # feature for the data you need to update frequently.
 7 | #
 8 | # For technical reasons, this file is *NOT* reloaded automatically when you use
 9 | # 'bundle exec jekyll serve'. If you change this file, please restart the server process.
10 | #
11 | # If you need help with YAML syntax, here are some quick references for you:
12 | # https://learn-the-web.algonquindesign.ca/topics/markdown-yaml-cheat-sheet/#yaml
13 | # https://learnxinyminutes.com/docs/yaml/
14 | #
15 | # Site settings
16 | # These are used to personalize your new site. If you look in the HTML files,
17 | # you will see them accessed via {{ site.title }}, {{ site.email }}, and so on.
18 | # You can create any custom variable you would like, and they will be accessible
19 | # in the templates via {{ site.myvariable }}.
20 | 
21 | title: "Dapr ACA Workshop"
22 | #email: your-email@example.com
23 | description: >- # this means to ignore newlines until "baseurl:"
24 |   This hands-on lab will guide you through the different concepts around Dapr, Container Apps & Open AI capabilities to build the next generation of Cloud Native Apps.
25 | baseurl: "/aca-dapr-openai-workshop" # the subpath of your site, e.g. /blog
26 | url: "" # the base hostname & protocol for your site, e.g. http://example.com
27 | 
28 | # Build settings
29 | remote_theme: "pmarsceill/just-the-docs"
30 | color_scheme: lab
31 | 
32 | gh_edit_link: true # show or hide edit this page link
33 | gh_edit_link_text: "Edit this page on GitHub."
34 | gh_edit_repository: "https://github.com/reidav/aca-dapr-openai-workshop" # the github URL for your repo
35 | gh_edit_branch: "main" # the branch that your docs is served from
36 | # gh_edit_source: docs # the source that your files originate from
37 | gh_edit_view_mode: "tree" # "tree" or "edit" if you want the user to jump into the editor immediately
38 | 
39 | # Exclude from processing.
40 | # The following items will not be processed, by default.
41 | # Any item listed under the `exclude:` key here will be automatically added to
42 | # the internal "default list".
43 | #
44 | # Excluded items can be processed by explicitly listing the directories or
45 | # their entries' file path in the `include:` list.
46 | #
47 | # exclude:
48 | #   - .sass-cache/
49 | #   - .jekyll-cache/
50 | #   - gemfiles/
51 | #   - Gemfile
52 | #   - Gemfile.lock
53 | #   - node_modules/
54 | #   - vendor/bundle/
55 | #   - vendor/cache/
56 | #   - vendor/gems/
57 | #   - vendor/ruby/
58 | 


--------------------------------------------------------------------------------
/docs/lab/2-dapr-components/2-1-dapr-overview.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: Dapr Overview
 3 | parent: Implement Dapr Components
 4 | has_children: false
 5 | permalink: /lab2/dapr-overview
 6 | nav_order: 1
 7 | ---
 8 | 
 9 | # Dapr Overview
10 | 
11 | Dapr is a portable, serverless, event-driven runtime that makes it easy for developers to build resilient, stateless and stateful microservices that run on the cloud and edge and embraces the diversity of languages and developer frameworks.
12 | 
13 | Dapr codifies the *best practices* for building microservice applications into open, independent, building blocks that enable you to build portable applications with the language and framework of your choice. Each building block is independent and you can use one, some, or all of them in your application.
14 | 
15 | ![Dapr overview](images/dapr-overview.png)
16 | 
17 | ## How it works
18 | 
19 | Dapr injects a side-car (container or process) to each compute unit. The side-car interacts with event triggers and communicates with the compute unit via standard HTTP or gRPC protocols. This enables Dapr to support all existing and future programming languages without requiring you to import frameworks or libraries.
20 | 
21 | Dapr offers built-in state management, reliable messaging (at least once delivery), triggers and bindings through standard HTTP verbs or gRPC interfaces. This allows you to write stateless, stateful and actor-like services following the same programming paradigm. You can freely choose consistency model, threading model and message delivery patterns.
22 | 
23 | Dapr runs natively on Kubernetes, as a self hosted binary on your machine, on an IoT device, or as a container that can be injected into any system, in the cloud or on-premises.
24 | 
25 | Dapr uses pluggable component state stores and message buses such as Redis as well as gRPC to offer a wide range of communication methods, including direct dapr-to-dapr using gRPC and async Pub-Sub with guaranteed delivery and at-least-once semantics.
26 | 
27 | ## Learn more
28 | 
29 | <b>Take some time to review following concepts as we will be using them in the next assigments.</b>
30 | 
31 | * [Dapr Building Blocks](https://docs.dapr.io/concepts/building-blocks-concept/) : Dapr capabilities that solve common development challenges for distributed applications
32 | * [Dapr SDKs](https://docs.dapr.io/developing-applications/sdks/) : The Dapr SDKs are the easiest way for you to get Dapr into your application. Choose your favorite language and get up and running with Dapr in minutes.
33 | * [Multi-App Run](https://docs.dapr.io/developing-applications/local-development/multi-app-dapr-run/) : Dapr can run multiple applications locally with a single command. This is useful for local development and testing.


--------------------------------------------------------------------------------
/src/job/src/main.rs:
--------------------------------------------------------------------------------
 1 | use std::{collections::HashMap, thread, time::Duration};
 2 | use chrono::Utc;
 3 | use serde_json::json;
 4 | use url::Url;
 5 | use uuid::Uuid;
 6 | 
 7 | fn get_requestor_urls() -> Result<Vec<Url>, Box<dyn std::error::Error>> {
 8 |     let mut urls: Vec<Url> = Vec::new();
 9 |     let job_urls: String = std::env::var("JOB_REQUESTED_URLS")?.parse()?;
10 |     let job_urls_parts = job_urls.split(",");
11 | 
12 |     for url in job_urls_parts {
13 |         urls.push(Url::parse(&url)?);
14 |         println!("[INFO] requested link '{}' provided", url);
15 |     }
16 | 
17 |     Ok(urls)
18 | }
19 | 
20 | #[tokio::main]
21 | async fn main() -> Result<(), Box<dyn std::error::Error>> {
22 |     
23 |     // Retrieve environment variables
24 |     let urls = get_requestor_urls().expect("Unable to get urls");
25 |     let requestor_email = std::env::var("JOB_REQUESTOR_EMAIL")?;
26 |     let pubsub_name = std::env::var("PUBSUB_REQUESTS_NAME")?;
27 |     let topic = std::env::var("PUBSUB_REQUESTS_TOPIC")?;
28 | 
29 |     // Introduce delay so that dapr grpc port is assigned before app tries to connect
30 |     thread::sleep(Duration::from_secs(2));
31 | 
32 |     // Get the Dapr port and create a connection
33 |     let port: u16 = std::env::var("DAPR_GRPC_PORT")?.parse()?;
34 |     let addr = format!("https://127.0.0.1:{}", port);
35 |     println!("[INFO] Using dapr grpc endpoint {}", addr);
36 | 
37 |     let mut client = dapr::Client::<dapr::client::TonicClient>::connect(addr).await?;
38 |     let data_content_type = "application/json".to_string();
39 | 
40 |     for url in urls {        
41 | 
42 |         // Message CloudEvent metadata
43 |         let mut metadata = HashMap::<String, String>::new();
44 |         metadata.insert("specversion".to_string(), "1.0".to_string());
45 |         metadata.insert("id".to_string(), Uuid::new_v4().to_string());
46 |         metadata.insert("time".to_string(), Utc::now().to_string());
47 |         metadata.insert("source".to_string(), "bulk-url-requestor".to_string());
48 |         
49 |         // Message CloudEvent data
50 |         let message = json!({
51 |             "url": "https://learn.microsoft.com/en-us/azure/container-apps/overview".to_string(),
52 |             "email": "me@loadtesting.io"
53 |         });
54 | 
55 |         println!("[INFO] Sending Url Summarization Request Event for {} owned by {}", &url, &requestor_email);
56 | 
57 |         client
58 |             .publish_event(
59 |                 &pubsub_name,
60 |                 &topic,
61 |                 &data_content_type,
62 |                 message.to_string().into_bytes(),
63 |                 Some(metadata),
64 |             )
65 |             .await?;
66 | 
67 |         // sleep for 2 secs to simulate delay b/w two events
68 |         tokio::time::sleep(Duration::from_secs(2)).await;
69 |     };
70 | 
71 |     Ok(())
72 | }


--------------------------------------------------------------------------------
/infra/naming-rules.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "resourceTypeAbbreviations": {
 3 |         "openai": "ai",
 4 |         "apiManagement": "apim",
 5 |         "applicationGateway": "agw",
 6 |         "applicationInsights": "appi",
 7 |         "appService": "app",
 8 |         "bastion": "bas",
 9 |         "containerAppsEnvironment": "cae",
10 |         "containerRegistry": "cr",
11 |         "cosmosDbNoSql": "cosno",
12 |         "frontDoor": "afd",
13 |         "frontDoorEndpoint": "fde",
14 |         "frontDoorWaf": "fdfp",
15 |         "keyVault": "kv",
16 |         "logAnalyticsWorkspace": "log",
17 |         "managedIdentity": "id",
18 |         "networkInterface": "nic",
19 |         "networkSecurityGroup": "nsg",
20 |         "privateEndpoint": "pep",
21 |         "privateLinkService": "pls",
22 |         "publicIpAddress": "pip",
23 |         "resourceGroup": "rg",
24 |         "serviceBus": "sb",
25 |         "serviceBusQueue": "sbq",
26 |         "serviceBusTopic": "sbt",
27 |         "storageAccount": "st",
28 |         "virtualMachine": "vm",
29 |         "virtualNetwork": "vnet"
30 |     },
31 |     "regionAbbreviations": {
32 |         "australiacentral": "auc",
33 |         "australiacentral2": "auc2",
34 |         "australiaeast": "aue",
35 |         "australiasoutheast": "ause",
36 |         "brazilsouth": "brs",
37 |         "brazilsoutheast": "brse",
38 |         "canadacentral": "canc",
39 |         "canadaeast": "cane",
40 |         "centralindia": "cin",
41 |         "centralus": "cus",
42 |         "centraluseuap": "cuseuap",
43 |         "eastasia": "ea",
44 |         "eastus": "eus",
45 |         "eastus2": "eus2",
46 |         "eastus2euap": "eus2euap",
47 |         "francecentral": "frc",
48 |         "francesouth": "frs",
49 |         "germanynorth": "gern",
50 |         "germanywestcentral": "gerwc",
51 |         "japaneast": "jae",
52 |         "japanwest": "jaw",
53 |         "jioindiacentral": "jioinc",
54 |         "jioindiawest": "jioinw",
55 |         "koreacentral": "koc",
56 |         "koreasouth": "kors",
57 |         "northcentralus": "ncus",
58 |         "northeurope": "neu",
59 |         "norwayeast": "nore",
60 |         "norwaywest": "norw",
61 |         "southafricanorth": "san",
62 |         "southafricawest": "saw",
63 |         "southcentralus": "scus",
64 |         "southeastasia": "sea",
65 |         "southindia": "sin",
66 |         "swedencentral": "swc",
67 |         "switzerlandnorth": "swn",
68 |         "switzerlandwest": "sww",
69 |         "uaecentral": "uaec",
70 |         "uaenorth": "uaen",
71 |         "uksouth": "uks",
72 |         "ukwest": "ukw",
73 |         "westcentralus": "wcus",
74 |         "westeurope": "weu",
75 |         "westindia": "win",
76 |         "westus": "wus",
77 |         "westus2": "wus2",
78 |         "westus3": "wus3"
79 |     }
80 | }


--------------------------------------------------------------------------------
/docs/lab/1-get-ready/1-3-connectivity.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: Setup Connectivity
 3 | parent: Get Ready
 4 | has_children: false
 5 | permalink: /lab1/set-secrets
 6 | nav_order: 3
 7 | ---
 8 | 
 9 | # Setup Connectivity
10 | 
11 | ## Connect using Azure CLI
12 | 
13 | 1. Open a terminal and connect to Azure CLI using the following command:
14 | 
15 | ```bash
16 | az login --use-device-code
17 | ```
18 | 
19 | 2. Open the page https://microsoft.com/devicelogin and enter the code displayed in the terminal.
20 | 
21 | 3. Login with your Azure credentials.
22 | 
23 | 4. Validate that you are connected to the right subscription using the following command:
24 | 
25 | ```bash
26 | az account show
27 | ```
28 | 
29 | ## Setup secrets
30 | 
31 | Actual repositery uses secrets files (ignored by gi)t to prevent secrets being pushed to the repository. We will need to reuse the sample secret files provided, duplicating and updating them with our own secrets.
32 | 
33 | 1. Create a new file `/dapr/summarizer-secrets.json` based on the content of the file  `/dapr/summarizer-secrets-sample.json`. This file will be used by Dapr to inject secrets into the application. Feel free to fill-in the values with your own secrets.
34 | 
35 | <details markdown="block">
36 |   <summary>
37 |     Toggle solution
38 |   </summary>
39 | 
40 | ```json
41 | {
42 |   "OPENAI-API-KEY": "",
43 |   "OPENAI-API-ENDPOINT": "",
44 |   "SMTP-HOST": "",
45 |   "SMTP-PORT": ""
46 | }
47 | ```
48 | </details>
49 | 
50 | 1. Create a new file `/deploy/containerapps/parameters.jsonc` based on the content of the file `/deploy/containerapps/parameters-sample.jsonc`. This file will be used by Bicep to schedule Azure deployment. Pick and choose any workload name, and fill-in the other values with your own secrets.
51 | 
52 | <details markdown="block">
53 |   <summary>
54 |     Toggle solution
55 |   </summary>
56 | 
57 | ```jsonc
58 | {
59 |     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
60 |     "contentVersion": "1.0.0.0",
61 |     "parameters": {
62 |       // The name of the workload that is being deployed. Up to 10 characters long. This wil be used as part of the naming convention (i.e. as defined here: https://learn.microsoft.com/azure/cloud-adoption-framework/ready/azure-best-practices/resource-naming) 
63 |       "workloadName": {
64 |         "value": "<Workload Name>"
65 |       },
66 |       //The name of the environment (e.g. "dev", "test", "prod", "preprod", "staging", "uat", "dr", "qa"). Up to 8 characters long.
67 |       "environment": {
68 |         "value": "dev"
69 |       },
70 |       "uniqueId": {
71 |           "value": "00"
72 |       },
73 |       "openAiApiKey": {
74 |         "value": "<Open AI Key>"
75 |       },
76 |       "openAiApiEndpoint": {
77 |         "value": "<Open API Endpoint>"
78 |       },
79 |       "smtpHost": {
80 |         "value": "<SMTP Host>"
81 |       },
82 |       "smtpPort": {
83 |         "value": 1025
84 |       }
85 |     }
86 |   }
87 | ```
88 | </details>


--------------------------------------------------------------------------------
/src/requests-processor/request_handler.py:
--------------------------------------------------------------------------------
 1 | import json
 2 | import logging
 3 | 
 4 | from openai import AzureOpenAI
 5 | from dapr.clients import DaprClient
 6 | from settings import Settings
 7 | from request_entities import SummarizeRequestCloudEvent
 8 | 
 9 | class SummarizeRequestHandler:
10 | 
11 |     def __init__(self, dapr_client: DaprClient, settings: Settings, event: SummarizeRequestCloudEvent):
12 |         self.dapr_client = dapr_client
13 |         self.settings = settings
14 |         self.event = event
15 | 
16 |     async def run(self):
17 |         logging.debug("Trying to find existing request in state")
18 |         request = await self.__try_find_by_url(self.event.data.url)
19 | 
20 |         if not (request):
21 |             logging.info(
22 |                 f"Azure Open AI requests for {self.event.data.url}")
23 |             summary = await self.__get_summary(self.event.data.url)
24 |         else:
25 |             logging.info(
26 |                 f"Get summary from state for {self.event.data.url}")
27 |             summary = request["summary"]
28 | 
29 |         resp = await self.dapr_client.invoke_method_async(
30 |             self.settings.requests_api_app_id,
31 |             self.settings.requests_api_create_endpoint,
32 |             json.dumps({'url': self.event.data.url, 'email': self.event.data.email, 'summary': summary}),
33 |             http_verb="POST")
34 | 
35 |     async def __try_find_by_url(self, url):
36 |         resp = await self.dapr_client.invoke_method_async(
37 |             self.settings.requests_api_app_id,
38 |             self.settings.requests_api_search_endpoint,
39 |             json.dumps({'url': self.event.data.url}),
40 |             http_verb="POST")
41 |         return json.loads(resp.data.decode('utf-8')) if resp.status_code == 200 else None
42 | 
43 |     async def __get_summary(self, url):
44 |         client = AzureOpenAI(
45 |             azure_endpoint = self.settings.openai_endpoint, 
46 |             api_key=self.settings.openai_apikey,
47 |             api_version=self.settings.openai_apiversion
48 |         )
49 | 
50 |         try:
51 |             response = client.chat.completions.create(
52 |                 model=self.settings.openai_deploymentname,
53 |                 messages=[
54 |                     {"role": "system", "content": "You are a helpful assistant helping people summarizing articles"},
55 |                     {"role": "user", "content": f"Summarize the article {url} in english in less than two paragraphs without adding new information. When the summary seems too short to make at least one paragraph, answer that you can't summarize a text that is too short"},
56 |                 ],
57 |                 temperature=0,
58 |                 max_tokens=1000
59 |             )
60 |             
61 |             content = response.choices[0].message.content
62 |             logging.info(content)
63 |             return content
64 | 
65 |         except Exception as e:
66 |             logging.error(e)
67 |             return "Unable to summarize this article."
68 | 


--------------------------------------------------------------------------------
/infra/modules/infra/container-apps-env.bicep:
--------------------------------------------------------------------------------
  1 | // ------------------
  2 | //    PARAMETERS
  3 | // ------------------
  4 | 
  5 | @description('The name of the container apps environment.')
  6 | param containerAppsEnvironmentName string
  7 | 
  8 | @description('The name of the Log Analytics workspace.')
  9 | param logAnalyticsWorkspaceName string
 10 | 
 11 | @description('The name of the Application Insights instance.')
 12 | param appInsightsName string
 13 | 
 14 | @description('The name of the virtual network')
 15 | param vnetName string
 16 | 
 17 | @description('The location of the container apps environment.')
 18 | param location string
 19 | 
 20 | // ------------------
 21 | //    RESOURCES
 22 | // ------------------
 23 | 
 24 | resource logAnalyticsWorkspace 'Microsoft.OperationalInsights/workspaces@2020-10-01' = {
 25 |   name: logAnalyticsWorkspaceName
 26 |   location: location
 27 |   properties: any({
 28 |     features: {
 29 |       searchVersion: 1
 30 |     }
 31 |     sku: {
 32 |       name: 'PerGB2018'
 33 |     }
 34 |     retentionInDays: 30
 35 |   })
 36 | }
 37 | 
 38 | resource appInsights 'Microsoft.Insights/components@2020-02-02-preview' = {
 39 |   name: appInsightsName
 40 |   location: location
 41 |   kind: 'web'
 42 |   properties: {
 43 |     Application_Type: 'web'
 44 |     WorkspaceResourceId: logAnalyticsWorkspace.id
 45 |   }
 46 | }
 47 | 
 48 | resource vnet 'Microsoft.Network/virtualNetworks@2022-07-01' = {
 49 |   name: vnetName
 50 |   location: location
 51 |   properties: {
 52 |     addressSpace: {
 53 |       addressPrefixes: [
 54 |         '10.1.0.0/22'
 55 |       ]
 56 |     }
 57 |     subnets: [
 58 |       {
 59 |         name: 'snet-infra'
 60 |         properties: {
 61 |           addressPrefix: '10.1.0.0/23'
 62 |           delegations: [
 63 |             {
 64 |               name: 'envdelegation'
 65 |               properties: {
 66 |                 serviceName: 'Microsoft.App/environments'
 67 |               }
 68 |             }
 69 |           ]
 70 |         }
 71 |       }]
 72 |   }
 73 | }
 74 | 
 75 | resource containerAppsEnvironment 'Microsoft.App/managedEnvironments@2023-05-01' = {
 76 |   name: containerAppsEnvironmentName
 77 |   location: location
 78 |   properties: {
 79 |     daprAIInstrumentationKey: appInsights.properties.InstrumentationKey
 80 |     appLogsConfiguration: {
 81 |       destination: 'log-analytics'
 82 |       logAnalyticsConfiguration: {
 83 |         customerId: logAnalyticsWorkspace.properties.customerId
 84 |         sharedKey: logAnalyticsWorkspace.listKeys().primarySharedKey
 85 |       }
 86 |     }
 87 |     vnetConfiguration: {
 88 |       internal: false
 89 |       infrastructureSubnetId: vnet.properties.subnets[0].id
 90 |     }
 91 |     workloadProfiles: [
 92 |       {
 93 |         workloadProfileType: 'Consumption'
 94 |         name: 'Consumption'
 95 |       }
 96 |     ]
 97 |     zoneRedundant: false
 98 |   }
 99 | }
100 | 
101 | output id string = containerAppsEnvironment.id
102 | output name string = containerAppsEnvironmentName
103 | output domain string = containerAppsEnvironment.properties.defaultDomain
104 | 


--------------------------------------------------------------------------------
/infra/modules/apps/requests-api.bicep:
--------------------------------------------------------------------------------
  1 | targetScope = 'resourceGroup'
  2 | 
  3 | // ------------------
  4 | //    PARAMETERS
  5 | // ------------------
  6 | 
  7 | @description('Container apps environment id where the container app will be deployed')
  8 | param containerAppsEnvironmentId string
  9 | 
 10 | @description('Assigned Identity Id for Container Registry, as container apps needs to access images')
 11 | param containerRegistryUserAssignedIdentityId string
 12 | 
 13 | @description('Assigned Identity Id for KeyVault, as container apps needs to access secret store')
 14 | param keyVaultUserAssignedIdentityId string
 15 | 
 16 | @description('Container Registry Login Server')
 17 | param containerRegistryLoginServer string
 18 | 
 19 | @description('Container App Name being used for deployment')
 20 | param containerAppName string
 21 | 
 22 | @description('Container app image being used for deployment')
 23 | param containerAppImage string
 24 | 
 25 | @description('Container app port being used')
 26 | param containerAppPort int
 27 | 
 28 | @description('State Dapr Component name being used')
 29 | param stateStoreName string
 30 | 
 31 | @description('Binding Dapr Component name being used')
 32 | param bindingSmtp string
 33 | 
 34 | param location string = resourceGroup().location
 35 | 
 36 | // ------------------
 37 | //    RESOURCES
 38 | // ------------------
 39 | 
 40 | resource containerApp 'Microsoft.App/containerApps@2023-11-02-preview' = {
 41 |   name: containerAppName
 42 |   location: location
 43 |   identity: {
 44 |     type: 'UserAssigned'
 45 |     userAssignedIdentities: {
 46 |       '${containerRegistryUserAssignedIdentityId}': {}
 47 |       '${keyVaultUserAssignedIdentityId}': {}
 48 |     }
 49 |   }
 50 |   properties: {
 51 |     managedEnvironmentId: containerAppsEnvironmentId
 52 |     template: {
 53 |       containers: [
 54 |         {
 55 |           name: containerAppName
 56 |           image: containerAppImage
 57 |           env: [
 58 |             {
 59 |               name: 'APP_PORT'
 60 |               value: string(containerAppPort)
 61 |             }
 62 |             {
 63 |               name: 'STATE_STORE_NAME'
 64 |               value: stateStoreName
 65 |             }
 66 |             {
 67 |               name: 'BINDING_SMTP'
 68 |               value: bindingSmtp
 69 |             }
 70 |           ]
 71 |           resources: {
 72 |             cpu: json('0.25')
 73 |             memory: '0.5Gi'
 74 |           }
 75 |         }
 76 |       ]
 77 |       scale: {
 78 |         minReplicas: 1
 79 |         maxReplicas: 1
 80 |       }
 81 |     }
 82 |     configuration: {
 83 |       registries: [ 
 84 |         { 
 85 |           server: containerRegistryLoginServer
 86 |           identity: containerRegistryUserAssignedIdentityId
 87 |         } 
 88 |       ]
 89 |       dapr: {
 90 |         enabled: true
 91 |         appId: containerAppName
 92 |         appPort: containerAppPort
 93 |         enableApiLogging: true
 94 |       }
 95 |       activeRevisionsMode: 'single'
 96 |       ingress: {
 97 |         external: true
 98 |         targetPort: containerAppPort
 99 |       }
100 |     }
101 |   }
102 | }
103 | 


--------------------------------------------------------------------------------
/src/requests-processor/settings.py:
--------------------------------------------------------------------------------
 1 | import logging
 2 | import os
 3 | from retry import retry
 4 | 
 5 | class Settings:
 6 |     def __init__(self, dapr_client):
 7 |         self.dapr_client = dapr_client
 8 | 
 9 |         # Dapr settings
10 |         self.secret_store_name = self.__get_environment_variable("SECRET_STORE_NAME")
11 |         self.pubsub_requests_name = self.__get_environment_variable("PUBSUB_REQUESTS_NAME")
12 |         self.pubsub_requests_topic = self.__get_environment_variable("PUBSUB_REQUESTS_TOPIC")
13 | 
14 |         # Requests API Backend settings
15 |         self.requests_api_app_id = self.__get_environment_variable("REQUESTS_API_APP_ID")
16 |         self.requests_api_search_endpoint = self.__get_environment_variable("REQUESTS_API_SEARCH_ENDPOINT")
17 |         self.requests_api_create_endpoint = self.__get_environment_variable("REQUESTS_API_CREATE_ENDPOINT")
18 | 
19 |         # INFO : ONLY FOR DEBUG PURPOSE
20 |         self.__show_secrets()
21 | 
22 |         # OpenAI settings
23 |         self.openai_apiversion = self.__get_environment_variable("OPENAI_API_VERSION")
24 |         self.openai_deploymentname = self.__get_environment_variable("OPENAI_API_DEPLOYMENT_NAME")
25 |         self.openai_apikey = self.__get_secret("OPENAI-API-KEY")
26 |         self.openai_endpoint = self.__get_secret("OPENAI-API-ENDPOINT")
27 | 
28 |         logging.info(f"""
29 | <environment-variables> 
30 |     secret_store_name:{self.secret_store_name}
31 |     pubsub_requests_name:{self.pubsub_requests_name}
32 |     pubsub_requests_topic:{self.pubsub_requests_topic}
33 |     requests_api_app_id:{self.requests_api_app_id}
34 |     requests_api_create_endpoint:{self.requests_api_create_endpoint}
35 |     requests_api_search_endpoint:{self.requests_api_search_endpoint}
36 |     open_api_version:{self.openai_apiversion}
37 |     open_api_deployment_name:{self.openai_deploymentname}
38 | </environment-variables>
39 | <secrets> 
40 |     ONLY FOR DEMO PURPOSE
41 |     open_api_key:{self.openai_apikey}
42 |     open_api_endpoint:{self.openai_endpoint}
43 | </secrets>
44 |     """)
45 | 
46 |     @retry(delay=1, backoff=2, max_delay=30)
47 |     def __show_secrets(self):
48 |         try:
49 |             secret = self.dapr_client.get_bulk_secret(store_name=self.secret_store_name)
50 |             logging.info('Result for bulk secret: ')
51 |             logging.info(sorted(secret.secrets.items()))
52 |         except Exception as e:
53 |             raise e
54 | 
55 |     @retry(delay=1, backoff=2, max_delay=30)
56 |     def __get_secret(self, secret_name):
57 |         try:
58 |             logging.log(logging.INFO, f"Getting secret {secret_name} from secret store {self.secret_store_name} ...")
59 |             secret = self.dapr_client.get_secret(
60 |                 store_name=self.secret_store_name,
61 |                 key=secret_name
62 |             )
63 |             return secret.secret[secret_name]
64 |         except Exception as e:
65 |             raise e
66 |     
67 |     def __get_environment_variable(self, variable_name, mandatory=True):
68 |         variable = os.environ.get(variable_name)
69 |         if not variable and mandatory:
70 |             raise Exception(f"Environment variable {variable_name} is not set")
71 |         return variable


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # Summarizer using Azure Open AI
 2 | 
 3 | [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/reidav/aca-dapr-openai-workshop?quickstart=1)
 4 | 
 5 | Hands-on-guide : [https://aka.ms/aca-dapr-workshop](https://aka.ms/aca-dapr-workshop)
 6 | 
 7 | Welcome to this **Dapr, Azure Container Apps Workshop**. You'll be experimenting with Azure Serverless services in multiple labs to achieve a real world scenario. Don't worry, even if the challenges will increase in difficulty, this is a step by step lab, you will be guided through the whole process.
 8 | 
 9 | During this workshop you will have the instructions to complete each steps. It is recommended to search for the answers in provided resources and links before looking at the solutions placed under the 'Toggle solution' panel.
10 | 
11 | ## Prerequisites
12 | 
13 | Before starting this workshop, be sure you have:
14 | 
15 | - An existing subscription with owner rights with rights to provision Azure Open AI resources.
16 |   - If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/en-us/free/) before you begin.
17 |   - You can request access to Azure Open AI [here](https://aka.ms/oai/access)
18 | - Azure providers should be registerd on your Azure Subscription if not done yet: `Microsoft.CognitiveServices`, `Microsoft.DocumentDB`, `Microsoft.ContainerRegistry`, `Microsoft.KeyVault`, `Microsoft.ServiceBus`,`Microsoft.Web`
19 | 
20 | ## Link Summarizer
21 | 
22 | **Link Summarizer** is an application designed to demonstrates how to build a, intelligent cloud native application using Dapr, Containers Apps and Open AI. It is composed of multiple microservices.
23 | 
24 | ![SummarizeArchitecture](docs/assets/images/summarizer-dapr-aca.png)
25 | 
26 | **Summarizer Blazor App (Front-end)** : A Blazor WebAssembly application that allows to browse all summaries and eventually queue new links to be summarized.
27 | 
28 | ![SummarizeWeb](docs/assets/images/summarizer-web.png)
29 | 
30 | **Requests API (Python)** : FastAPI leveraging Dapr state management to store / get all requests of summaries. It allows to track and reuse previous summaries eventually generated. When a new completed request is created following processing, it sends a email message to the requestor.
31 | 
32 | **Requests Processor (Python)** : A Python application that allows to process summary requests in queue. If no summary has already being provided, it will prompt Azure Open AI to get a new summary. In any case, requests will be tracked using the requests API at the end of the process.
33 | 
34 | ## How to install
35 | 
36 | ### 1. Open the solution using GitHub Codespaces
37 | 
38 | [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/reidav/aca-dapr-openai-workshop?quickstart=1)
39 | 
40 | ### 2. Review the file at ./infra/setup.sh and set the global variable
41 | 
42 | ```bash
43 | export RESOURCE_GROUP=rg-summarizer>
44 | export WORKLOAD_NAME=summarizer
45 | export ENVIRONMENT=dev
46 | export UNIQUE_ID=01
47 | ```
48 | 
49 | ### 2. Deploy the application
50 | 
51 | ```bash
52 | az login
53 | cd infra
54 | ./setup.sh
55 | ```
56 | 
57 | ### 3. Review resources
58 | 
59 | ![SummarizeArchitecture](docs/assets/images/summarizer-assets.png)
60 | 


--------------------------------------------------------------------------------
/infra/modules/infra/keyvault.bicep:
--------------------------------------------------------------------------------
  1 | // ------------------
  2 | //    PARAMETERS
  3 | // ------------------
  4 | 
  5 | @description('The name of the key vault to create.')
  6 | param keyVaultName string
  7 | 
  8 | @description('The name of the key vault user assigned identity to create.')
  9 | param keyVaultUserAssignedIdentityName string
 10 | 
 11 | @description('The location of the key vault to create.')
 12 | param location string
 13 | 
 14 | @description('Open AI API key')
 15 | @secure()
 16 | param openAiApiKey string
 17 | 
 18 | @description('Open AI Endpoint')
 19 | @secure()
 20 | param openAiApiEndpoint string
 21 | 
 22 | // var keyVaultAdminRoleGuid = '00482a5a-887f-4fb3-b363-3b7fe8e74483'
 23 | 
 24 | // ------------------
 25 | //    RESOURCES
 26 | // ------------------
 27 | 
 28 | resource keyVaultUserAssignedIdentity 'Microsoft.ManagedIdentity/userAssignedIdentities@2018-11-30' = {
 29 |   name: keyVaultUserAssignedIdentityName
 30 |   location: location
 31 | }
 32 | 
 33 | resource keyVault 'Microsoft.KeyVault/vaults@2022-07-01' = {
 34 |   name: keyVaultName
 35 |   location: location
 36 |   properties: {
 37 |     sku: {
 38 |       family: 'A'
 39 |       name: 'standard'
 40 |     }
 41 |     accessPolicies: [
 42 |       {
 43 |         objectId: keyVaultUserAssignedIdentity.properties.principalId
 44 |         tenantId: keyVaultUserAssignedIdentity.properties.tenantId
 45 |         permissions: {
 46 |           keys:  [
 47 |             'get'
 48 |             'list'
 49 |           ]
 50 |           secrets: [
 51 |             'get'
 52 |             'list'
 53 |           ]
 54 |         }
 55 |       }
 56 |     ]
 57 |     networkAcls: {
 58 |       defaultAction: 'Allow'
 59 |       bypass: 'AzureServices'
 60 |     }
 61 |     tenantId: subscription().tenantId
 62 |     enabledForTemplateDeployment: true
 63 |     enableSoftDelete: false
 64 |     softDeleteRetentionInDays: 7
 65 |     enablePurgeProtection: null  // It seems that you cannot set it to False even the first time. workaround is not to set it at all: https://github.com/Azure/bicep/issues/5223
 66 |   }
 67 | }
 68 | 
 69 | // ENABLE RBAC SUPPORT
 70 | // resource kevVaultRoleAssignment 'Microsoft.Authorization/roleAssignments@2020-04-01-preview' = {
 71 | //   name: guid(subscription().id, keyVaultName, keyVaultUserAssignedIdentityName) // This is a workaround for a bug in Bicep:
 72 | //   scope: keyVault
 73 | //   properties: {
 74 | //     roleDefinitionId: subscriptionResourceId('Microsoft.Authorization/roleDefinitions', keyVaultAdminRoleGuid)
 75 | //     principalId: keyVaultUserAssignedIdentity.properties.principalId
 76 | //     principalType: 'ServicePrincipal'
 77 | //   }
 78 | // }
 79 | 
 80 | resource openAiApiKeySecret 'Microsoft.KeyVault/vaults/secrets@2022-07-01' = {
 81 |   name: 'OPENAI-API-KEY'
 82 |   parent: keyVault
 83 |   properties: {
 84 |     value: openAiApiKey
 85 |   }
 86 | }
 87 | 
 88 | resource openAiApiEndpointSecret 'Microsoft.KeyVault/vaults/secrets@2022-07-01' = {
 89 |   name: 'OPENAI-API-ENDPOINT'
 90 |   parent: keyVault
 91 |   properties: {
 92 |     value: openAiApiEndpoint
 93 |   }
 94 | }
 95 | 
 96 | output vaultName string = keyVault.name
 97 | output vaultManagedIdentityId string = keyVaultUserAssignedIdentity.id
 98 | output vaultManagedIdentityClientId string = keyVaultUserAssignedIdentity.properties.clientId
 99 | output vaultManagedIdentityObjectId string = keyVaultUserAssignedIdentity.properties.principalId
100 | 
101 | 


--------------------------------------------------------------------------------
/src/requests-api/app.py:
--------------------------------------------------------------------------------
 1 | import hashlib
 2 | import uuid
 3 | import json
 4 | import logging
 5 | import time
 6 | 
 7 | from fastapi import FastAPI, Response, status
 8 | from fastapi.responses import HTMLResponse
 9 | from dapr.clients import DaprClient
10 | from dapr.ext.fastapi import DaprApp
11 | 
12 | from settings import Settings
13 | from request_state import SummarizeRequestState
14 | from request_entities import NewSummarizeRequest, SearchSummarizeRequest, SummarizeRequest
15 | 
16 | logging.basicConfig(level=logging.INFO)
17 | 
18 | app = FastAPI()
19 | dapr_app = DaprApp(app)
20 | dapr_client = DaprClient()
21 | 
22 | # Retrieve all requests
23 | @app.get('/requests')
24 | async def get_requests():
25 |     try:
26 |         settings = Settings(dapr_client)
27 |         requests = SummarizeRequestState(dapr_client, settings).find_all()
28 |         return Response(content=json.dumps(requests), media_type="application/json")
29 |     except Exception as e:
30 |         logging.error(f'Error: {e}')
31 |         return Response(content=json.dumps([]), media_type="application/json", status_code=status.HTTP_500_INTERNAL_SERVER_ERROR)
32 | 
33 | # Retrieve request by url
34 | @app.post('/search-requests-by-url')
35 | async def search_request_by_url(search: SearchSummarizeRequest):
36 |     try:
37 |         settings=Settings(dapr_client)
38 |         state_provider=SummarizeRequestState(dapr_client, settings)
39 |         
40 |         url_hashed = hashlib.sha256(search.url.encode()).hexdigest()
41 |         logging.info(f"Searching request for url: {search.url} hashed: {url_hashed}")
42 |         request=state_provider.try_find_by_url_hashed(url_hashed)
43 | 
44 |         if request is None:
45 |             logging.info(f"Request not found for url: {search.url}")
46 |             return Response(content = None, status_code = status.HTTP_204_NO_CONTENT)
47 |         else:
48 |             logging.info(f"Request found for url: {search.url}")
49 |             return Response(content = json.dumps(request), status_code= status.HTTP_200_OK, media_type = "application/json")
50 |     except Exception as e:
51 |         logging.error(f'Error: {e}')
52 |         return Response(content = None, status_code = status.HTTP_500_INTERNAL_SERVER_ERROR)
53 | 
54 | @app.post('/requests', status_code = status.HTTP_201_CREATED)
55 | async def create_request(new_request: NewSummarizeRequest):
56 |     try:
57 |         settings=Settings(dapr_client)
58 |         state_provider=SummarizeRequestState(dapr_client, settings)
59 | 
60 |         request=SummarizeRequest(
61 |             uuid.uuid4().hex,
62 |             new_request.url,
63 |             hashlib.sha256(new_request.url.encode()).hexdigest(),
64 |             new_request.summary,
65 |             new_request.email,
66 |             time.time()
67 |         )
68 | 
69 |         logging.info(
70 |             f"Saving new request in state and send email to requestor")
71 |         new_request=state_provider.upsert(request)
72 | 
73 |         return Response(content = json.dumps(new_request), media_type = "application/json")
74 |     except Exception as e:
75 |         logging.error(f'Error: {e}')
76 |         return Response(content = json.dumps([]), media_type = "application/json")
77 | 
78 | @app.get('/', response_class = HTMLResponse)
79 | async def read_items():
80 |     return """
81 |     <html>
82 |         <head>
83 |             <title>Requests API</title>
84 |         </head>
85 |         <body>
86 |             <h1>Requests API Ready !</h1>
87 |         </body>
88 |     </html>
89 |     """
90 | 


--------------------------------------------------------------------------------
/infra/modules/apps/requests-frontend.bicep:
--------------------------------------------------------------------------------
  1 | targetScope = 'resourceGroup'
  2 | 
  3 | // ------------------
  4 | //    PARAMETERS
  5 | // ------------------
  6 | 
  7 | @description('Container apps environment id where the container app will be deployed')
  8 | param containerAppsEnvironmentId string
  9 | 
 10 | @description('Assigned Identity Id for Container Registry, as container apps needs to access images')
 11 | param containerRegistryUserAssignedIdentityId string
 12 | 
 13 | @description('Assigned Identity Id for KeyVault, as container apps needs to access secret store')
 14 | param keyVaultUserAssignedIdentityId string
 15 | 
 16 | @description('Container Registry Login Server')
 17 | param containerRegistryLoginServer string
 18 | 
 19 | @description('Container App Name being used for deployment')
 20 | param containerAppName string
 21 | 
 22 | @description('Container app image being used for deployment')
 23 | param containerAppImage string
 24 | 
 25 | @description('Container app port being used')
 26 | param containerAppPort int
 27 | 
 28 | @description('PubSub Dapr Component Name being used')
 29 | param pubSubRequestsName string
 30 | 
 31 | @description('PubSub Dapr Component Topic being used')
 32 | param pubSubRequestsTopic string
 33 | 
 34 | @description('Requests API App Id being used')
 35 | param requestsApiAppId string
 36 | 
 37 | @description('Requests API Endpoint being used')
 38 | param requestsApiEndpoint string
 39 | 
 40 | param location string = resourceGroup().location
 41 | 
 42 | // ------------------
 43 | //    RESOURCES
 44 | // ------------------
 45 | 
 46 | resource containerApp 'Microsoft.App/containerApps@2023-11-02-preview' = {
 47 |   name: containerAppName
 48 |   location: location
 49 |   identity: {
 50 |     type: 'UserAssigned'
 51 |     userAssignedIdentities: {
 52 |       '${containerRegistryUserAssignedIdentityId}': {}
 53 |       '${keyVaultUserAssignedIdentityId}': {}
 54 |     }
 55 |   }
 56 |   properties: {
 57 |     managedEnvironmentId: containerAppsEnvironmentId
 58 |     template: {
 59 |       containers: [
 60 |         {
 61 |           name: containerAppName
 62 |           image: containerAppImage
 63 |           env: [
 64 |             {
 65 |               name: 'ASPNETCORE_ENVIRONMENT'
 66 |               value: 'Development'
 67 |             }
 68 |             {
 69 |               name: 'ASPNETCORE_URLS'
 70 |               value: 'http://0.0.0.0:${containerAppPort}'
 71 |             }
 72 |             {
 73 |               name: 'PUBSUB_REQUESTS_NAME'
 74 |               value: pubSubRequestsName
 75 |             }
 76 |             {
 77 |               name: 'PUBSUB_REQUESTS_TOPIC'
 78 |               value: pubSubRequestsTopic
 79 |             }
 80 |             {
 81 |               name: 'REQUESTS_API_APP_ID'
 82 |               value: requestsApiAppId
 83 |             }
 84 |             {
 85 |               name: 'REQUESTS_API_ENDPOINT'
 86 |               value: requestsApiEndpoint
 87 |             }
 88 |           ]
 89 |           resources: {
 90 |             cpu: json('0.25')
 91 |             memory: '0.5Gi'
 92 |           }
 93 |         }
 94 |       ]
 95 |       scale: {
 96 |         minReplicas: 1
 97 |         maxReplicas: 1
 98 |       }
 99 |     }
100 |     configuration: {
101 |       registries: [ 
102 |         { 
103 |           server: containerRegistryLoginServer
104 |           identity: containerRegistryUserAssignedIdentityId
105 |         } 
106 |       ]
107 |       dapr: {
108 |         enabled: true
109 |         appId: containerAppName
110 |         appPort: containerAppPort
111 |         enableApiLogging: true
112 |       }
113 |       activeRevisionsMode: 'single'
114 |       ingress: {
115 |         external: true
116 |         targetPort: containerAppPort
117 |       }
118 |     }
119 |   }
120 | }
121 | 


--------------------------------------------------------------------------------
/infra/modules/apps/requests-processor.bicep:
--------------------------------------------------------------------------------
  1 | targetScope = 'resourceGroup'
  2 | 
  3 | // ------------------
  4 | //    PARAMETERS
  5 | // ------------------
  6 | 
  7 | @description('Container apps environment id where the container app will be deployed')
  8 | param containerAppsEnvironmentId string
  9 | 
 10 | @description('Assigned Identity Id for Container Registry, as container apps needs to access images')
 11 | param containerRegistryUserAssignedIdentityId string
 12 | 
 13 | @description('Assigned Identity Id for KeyVault, as container apps needs to access secret store')
 14 | param keyVaultUserAssignedIdentityId string
 15 | 
 16 | @description('Container Registry Login Server')
 17 | param containerRegistryLoginServer string
 18 | 
 19 | @description('Container App Name being used for deployment')
 20 | param containerAppName string
 21 | 
 22 | @description('Container app image being used for deployment')
 23 | param containerAppImage string
 24 | 
 25 | @description('Container app port being used')
 26 | param containerAppPort int
 27 | 
 28 | @description('PubSub Dapr Component Name being used')
 29 | param pubSubRequestsName string
 30 | 
 31 | @description('PubSub Dapr Component Topic being used')
 32 | param pubSubRequestsTopic string
 33 | 
 34 | @description('Secret Dapr Component name being used')
 35 | // We disable lint of this line as it is not a secret but the name of the Dapr component
 36 | #disable-next-line secure-secrets-in-params
 37 | param secretStoreName string
 38 | 
 39 | @description('Requests API App Id being used')
 40 | param requestsApiAppId string
 41 | 
 42 | @description('Requests API Search Endpoint being used')
 43 | param requestsApiSearchEndpoint string
 44 | 
 45 | @description('Requests API Create Endpoint being used')
 46 | param requestsApiCreateEndpoint string
 47 | 
 48 | @description('OpenAI API Version being used')
 49 | param openAiApiVersion string
 50 | 
 51 | @description('OpenAI API Deployment Name being used')
 52 | param openAiApiDeploymentName string
 53 | 
 54 | param location string = resourceGroup().location
 55 | 
 56 | // ------------------
 57 | //    RESOURCES
 58 | // ------------------
 59 | 
 60 | resource containerApp 'Microsoft.App/containerApps@2023-11-02-preview' = {
 61 |   name: containerAppName
 62 |   location: location
 63 |   identity: {
 64 |     type: 'UserAssigned'
 65 |     userAssignedIdentities: {
 66 |       '${containerRegistryUserAssignedIdentityId}': {}
 67 |       '${keyVaultUserAssignedIdentityId}': {}
 68 |     }
 69 |   }
 70 |   properties: {
 71 |     managedEnvironmentId: containerAppsEnvironmentId
 72 |     template: {
 73 |       containers: [
 74 |         {
 75 |           name: containerAppName
 76 |           image: containerAppImage
 77 |           env: [
 78 |             {
 79 |               name: 'APP_PORT'
 80 |               value: string(containerAppPort)
 81 |             }
 82 |             {
 83 |               name: 'SECRET_STORE_NAME'
 84 |               value: secretStoreName
 85 |             }
 86 |             {
 87 |               name: 'REQUESTS_API_APP_ID'
 88 |               value: requestsApiAppId
 89 |             }
 90 |             {
 91 |               name: 'REQUESTS_API_SEARCH_ENDPOINT'
 92 |               value: requestsApiSearchEndpoint
 93 |             }
 94 |             {
 95 |               name: 'REQUESTS_API_CREATE_ENDPOINT'
 96 |               value: requestsApiCreateEndpoint
 97 |             }
 98 |             {
 99 |               name: 'PUBSUB_REQUESTS_NAME'
100 |               value: pubSubRequestsName
101 |             }
102 |             {
103 |               name: 'PUBSUB_REQUESTS_TOPIC'
104 |               value: pubSubRequestsTopic
105 |             }
106 |             {
107 |               name: 'OPENAI_API_VERSION'
108 |               value: openAiApiVersion
109 |             }
110 |             {
111 |               name: 'OPENAI_API_DEPLOYMENT_NAME'
112 |               value: openAiApiDeploymentName
113 |             }
114 |           ]
115 |           resources: {
116 |             cpu: json('0.25')
117 |             memory: '0.5Gi'
118 |           }
119 |         }
120 |       ]
121 |       scale: {
122 |         minReplicas: 1
123 |         maxReplicas: 1
124 |       }
125 |     }
126 |     configuration: {
127 |       registries: [ 
128 |         { 
129 |           server: containerRegistryLoginServer
130 |           identity: containerRegistryUserAssignedIdentityId
131 |         } 
132 |       ]
133 |       dapr: {
134 |         enabled: true
135 |         appId: containerAppName
136 |         appPort: containerAppPort
137 |         enableApiLogging: true
138 |       }
139 |       activeRevisionsMode: 'single'
140 |       ingress: {
141 |         external: true
142 |         targetPort: containerAppPort
143 |       }
144 |     }
145 |   }
146 | }
147 | 


--------------------------------------------------------------------------------
/src/requests-frontend/wwwroot/css/site.css:
--------------------------------------------------------------------------------
  1 | .content {
  2 |     padding-top: 1.1rem;
  3 | }
  4 | 
  5 | .valid.modified:not([type=checkbox]) {
  6 |     outline: 1px solid #26b050;
  7 | }
  8 | 
  9 | .invalid {
 10 |     outline: 1px solid red;
 11 | }
 12 | 
 13 | .validation-message {
 14 |     color: red;
 15 | }
 16 | 
 17 | #blazor-error-ui {
 18 |     background: lightyellow;
 19 |     bottom: 0;
 20 |     box-shadow: 0 -1px 2px rgba(0, 0, 0, 0.2);
 21 |     display: none;
 22 |     left: 0;
 23 |     padding: 0.6rem 1.25rem 0.7rem 1.25rem;
 24 |     position: fixed;
 25 |     width: 100%;
 26 |     z-index: 1000;
 27 | }
 28 | 
 29 |     #blazor-error-ui .dismiss {
 30 |         cursor: pointer;
 31 |         position: absolute;
 32 |         right: 0.75rem;
 33 |         top: 0.5rem;
 34 |     }
 35 | 
 36 | .blazor-error-boundary {
 37 |     background: url(data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNTYiIGhlaWdodD0iNDkiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiIG92ZXJmbG93PSJoaWRkZW4iPjxkZWZzPjxjbGlwUGF0aCBpZD0iY2xpcDAiPjxyZWN0IHg9IjIzNSIgeT0iNTEiIHdpZHRoPSI1NiIgaGVpZ2h0PSI0OSIvPjwvY2xpcFBhdGg+PC9kZWZzPjxnIGNsaXAtcGF0aD0idXJsKCNjbGlwMCkiIHRyYW5zZm9ybT0idHJhbnNsYXRlKC0yMzUgLTUxKSI+PHBhdGggZD0iTTI2My41MDYgNTFDMjY0LjcxNyA1MSAyNjUuODEzIDUxLjQ4MzcgMjY2LjYwNiA1Mi4yNjU4TDI2Ny4wNTIgNTIuNzk4NyAyNjcuNTM5IDUzLjYyODMgMjkwLjE4NSA5Mi4xODMxIDI5MC41NDUgOTIuNzk1IDI5MC42NTYgOTIuOTk2QzI5MC44NzcgOTMuNTEzIDI5MSA5NC4wODE1IDI5MSA5NC42NzgyIDI5MSA5Ny4wNjUxIDI4OS4wMzggOTkgMjg2LjYxNyA5OUwyNDAuMzgzIDk5QzIzNy45NjMgOTkgMjM2IDk3LjA2NTEgMjM2IDk0LjY3ODIgMjM2IDk0LjM3OTkgMjM2LjAzMSA5NC4wODg2IDIzNi4wODkgOTMuODA3MkwyMzYuMzM4IDkzLjAxNjIgMjM2Ljg1OCA5Mi4xMzE0IDI1OS40NzMgNTMuNjI5NCAyNTkuOTYxIDUyLjc5ODUgMjYwLjQwNyA1Mi4yNjU4QzI2MS4yIDUxLjQ4MzcgMjYyLjI5NiA1MSAyNjMuNTA2IDUxWk0yNjMuNTg2IDY2LjAxODNDMjYwLjczNyA2Ni4wMTgzIDI1OS4zMTMgNjcuMTI0NSAyNTkuMzEzIDY5LjMzNyAyNTkuMzEzIDY5LjYxMDIgMjU5LjMzMiA2OS44NjA4IDI1OS4zNzEgNzAuMDg4N0wyNjEuNzk1IDg0LjAxNjEgMjY1LjM4IDg0LjAxNjEgMjY3LjgyMSA2OS43NDc1QzI2Ny44NiA2OS43MzA5IDI2Ny44NzkgNjkuNTg3NyAyNjcuODc5IDY5LjMxNzkgMjY3Ljg3OSA2Ny4xMTgyIDI2Ni40NDggNjYuMDE4MyAyNjMuNTg2IDY2LjAxODNaTTI2My41NzYgODYuMDU0N0MyNjEuMDQ5IDg2LjA1NDcgMjU5Ljc4NiA4Ny4zMDA1IDI1OS43ODYgODkuNzkyMSAyNTkuNzg2IDkyLjI4MzcgMjYxLjA0OSA5My41Mjk1IDI2My41NzYgOTMuNTI5NSAyNjYuMTE2IDkzLjUyOTUgMjY3LjM4NyA5Mi4yODM3IDI2Ny4zODcgODkuNzkyMSAyNjcuMzg3IDg3LjMwMDUgMjY2LjExNiA4Ni4wNTQ3IDI2My41NzYgODYuMDU0N1oiIGZpbGw9IiNGRkU1MDAiIGZpbGwtcnVsZT0iZXZlbm9kZCIvPjwvZz48L3N2Zz4=) no-repeat 1rem/1.8rem, #b32121;
 38 |     padding: 1rem 1rem 1rem 3.7rem;
 39 |     color: white;
 40 | }
 41 | 
 42 |     .blazor-error-boundary::after {
 43 |         content: "An error has occurred."
 44 |     }
 45 | 
 46 |         body {
 47 |             font-family: Arial, sans-serif;
 48 |             margin: 0;
 49 |             padding: 20px;
 50 |             background-color: #f4f4f4;
 51 |         }
 52 |         .container {
 53 |             max-width: 800px;
 54 |             margin: 0 auto;
 55 |             background-color: #fff;
 56 |             padding: 20px;
 57 |             border-radius: 8px;
 58 |             box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
 59 |         }
 60 |         h1 {
 61 |             text-align: center;
 62 |         }
 63 |         form {
 64 |             margin-bottom: 20px;
 65 |         }
 66 |         label {
 67 |             display: block;
 68 |             margin-bottom: 5px;
 69 |         }
 70 |         .lbl {
 71 |             width: calc(100% - 12px);
 72 |             padding: 8px;
 73 |             margin-bottom: 10px;
 74 |             border: 1px solid #ccc;
 75 |             border-radius: 4px;
 76 |         }
 77 |         button[type="submit"] {
 78 |             width: 100%;
 79 |             background-color: #007bff;
 80 |             color: #fff;
 81 |             border: none;
 82 |             padding: 10px;
 83 |             cursor: pointer;
 84 |             border-radius: 4px;
 85 |             transition: background-color 0.3s ease;
 86 |         }
 87 |         button[type="submit"]:hover {
 88 |             background-color: #0056b3;
 89 |         }
 90 |         .summary-card {
 91 |             background-color: #fff;
 92 |             padding: 20px;
 93 |             margin-bottom: 20px;
 94 |             border-radius: 8px;
 95 |             box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
 96 |         }
 97 |         .summary-card h2 {
 98 |             margin-top: 0;
 99 |         }
100 |         .summary-card p {
101 |             margin-bottom: 0;
102 |         }
103 | 
104 |         .summary-card a, a:visited {
105 |           text-decoration: none;
106 |           color:#7ba1db
107 |       }
108 | 
109 | .validation-message {
110 |   color: red;
111 |   font-size: 14px;
112 | }
113 | 


--------------------------------------------------------------------------------
/infra/apps.bicep:
--------------------------------------------------------------------------------
  1 | targetScope = 'resourceGroup'
  2 | 
  3 | // ------------------
  4 | //    PARAMETERS
  5 | // ------------------
  6 | 
  7 | @minLength(2)
  8 | @maxLength(10)
  9 | @description('The name of the workloard that is being deployed. Up to 10 characters long.')
 10 | param workloadName string
 11 | 
 12 | @minLength(2)
 13 | @maxLength(8)
 14 | @description('The name of the environment (e.g. "dev", "test", "prod", "uat", "dr", "qa") Up to 8 characters long.')
 15 | param environment string
 16 | 
 17 | @description('The tag to use for the image.')
 18 | param imageTag string
 19 | 
 20 | @minLength(1)
 21 | param uniqueId string
 22 | 
 23 | param location string = resourceGroup().location
 24 | 
 25 | // ------------------
 26 | // VARIABLES
 27 | // ------------------
 28 | 
 29 | var naming = json(loadTextContent('./naming-rules.json'))
 30 | 
 31 | var resourceSuffix = format(
 32 |   '{0}-{1}-{2}-{3}',
 33 |   environment,
 34 |   naming.regionAbbreviations[location],
 35 |   workloadName,
 36 |   uniqueId
 37 | )
 38 | 
 39 | // ------------------
 40 | // CONTAINER APPS
 41 | // ------------------
 42 | 
 43 | resource containerAppsEnvironment 'Microsoft.App/managedEnvironments@2022-03-01' existing = {
 44 |   name: '${naming.resourceTypeAbbreviations.containerAppsEnvironment}-${resourceSuffix}'
 45 | }
 46 | 
 47 | resource containerRegistry 'Microsoft.ContainerRegistry/registries@2022-12-01' existing = {
 48 |   name: replace('${naming.resourceTypeAbbreviations.containerRegistry}-${resourceSuffix}', '-', '')
 49 | }
 50 | 
 51 | resource containerRegistryUserAssignedIdentity 'Microsoft.ManagedIdentity/userAssignedIdentities@2018-11-30' = {
 52 |   name: '${naming.resourceTypeAbbreviations.managedIdentity}-${naming.resourceTypeAbbreviations.containerRegistry}-${resourceSuffix}'
 53 |   location: location
 54 | }
 55 | 
 56 | resource keyVaultUserAssignedIdentity 'Microsoft.ManagedIdentity/userAssignedIdentities@2018-11-30' = {
 57 |   name: '${naming.resourceTypeAbbreviations.managedIdentity}-${naming.resourceTypeAbbreviations.keyVault}-${resourceSuffix}'
 58 |   location: location
 59 | }
 60 | 
 61 | module frontend 'modules/apps/requests-frontend.bicep' = {
 62 |   name: '${deployment().name}-summarizer-frontend'
 63 |   params: {
 64 |     location: location
 65 |     containerAppsEnvironmentId: containerAppsEnvironment.id
 66 |     containerRegistryUserAssignedIdentityId: containerRegistryUserAssignedIdentity.id
 67 |     keyVaultUserAssignedIdentityId: keyVaultUserAssignedIdentity.id
 68 | 
 69 |     containerRegistryLoginServer: containerRegistry.properties.loginServer
 70 |     containerAppName: 'summarizer-frontend'
 71 |     containerAppImage: '${containerRegistry.properties.loginServer}/summarizer/requests-frontend:${imageTag}'
 72 |     containerAppPort: 80
 73 | 
 74 |     pubSubRequestsName: 'summarizer-pubsub'
 75 |     pubSubRequestsTopic: 'link-to-summarize'
 76 |     requestsApiAppId: 'summarizer-requests-api'
 77 |     requestsApiEndpoint: 'requests'
 78 |   }
 79 | }
 80 | 
 81 | module requests_api 'modules/apps/requests-api.bicep' = {
 82 |   name: '${deployment().name}-summarizer-requests-api'
 83 |   params: {
 84 |     location: location
 85 |     containerAppsEnvironmentId: containerAppsEnvironment.id
 86 |     containerRegistryUserAssignedIdentityId: containerRegistryUserAssignedIdentity.id
 87 |     keyVaultUserAssignedIdentityId: keyVaultUserAssignedIdentity.id
 88 | 
 89 |     containerRegistryLoginServer: containerRegistry.properties.loginServer
 90 |     containerAppName: 'summarizer-requests-api'
 91 |     containerAppImage: '${containerRegistry.properties.loginServer}/summarizer/requests-api:${imageTag}'
 92 |     containerAppPort: 80
 93 |     stateStoreName: 'summarizer-statestore'
 94 |     bindingSmtp: 'summarizer-smtp'
 95 |   }
 96 | }
 97 | 
 98 | module requests_processor 'modules/apps/requests-processor.bicep' = {
 99 |   name: '${deployment().name}-summarizer-requests-processor'
100 |   params: {
101 |     location: location
102 |     containerAppsEnvironmentId: containerAppsEnvironment.id
103 |     containerRegistryUserAssignedIdentityId: containerRegistryUserAssignedIdentity.id
104 |     keyVaultUserAssignedIdentityId: keyVaultUserAssignedIdentity.id
105 | 
106 |     containerRegistryLoginServer: containerRegistry.properties.loginServer
107 |     containerAppName: 'summarizer-requests-processor'
108 |     containerAppImage: '${containerRegistry.properties.loginServer}/summarizer/requests-processor:${imageTag}'
109 |     containerAppPort: 80
110 |     pubSubRequestsName: 'summarizer-pubsub'
111 |     pubSubRequestsTopic: 'link-to-summarize'
112 |     openAiApiDeploymentName: 'gpt-4-32k'
113 |     openAiApiVersion: '2024-02-15-preview'
114 |     secretStoreName: 'summarizer-secretstore'
115 |     requestsApiAppId: 'summarizer-requests-api'
116 |     requestsApiCreateEndpoint: 'requests'
117 |     requestsApiSearchEndpoint: 'search-requests-by-url'
118 |   }
119 | }
120 | 


--------------------------------------------------------------------------------
/src/requests-api/request_state.py:
--------------------------------------------------------------------------------
  1 | import logging
  2 | import json
  3 | from dapr.clients import DaprClient
  4 | from settings import Settings
  5 | from request_entities import SummarizeRequest
  6 | 
  7 | 
  8 | class SummarizeRequestState:
  9 | 
 10 |     def __init__(self, dapr_client: DaprClient, settings: Settings):
 11 |         self.dapr_client = dapr_client
 12 |         self.settings = settings
 13 | 
 14 |     def find_all(self, token: str = None):
 15 |         try:
 16 |             # Paging are supported using token
 17 |             # see https://docs.dapr.io/developing-applications/building-blocks/state-management/howto-state-query-api/
 18 | 
 19 |             token = f", \"token\": \"{token}\"" if token is not None else ""
 20 |             query = '''
 21 |             {{
 22 |                 "page": {{
 23 |                     "limit": 100{0}
 24 |                 }}
 25 |             }}
 26 |             '''.format(token)
 27 | 
 28 |             return self.__query_state(query)
 29 |         except Exception as e:
 30 |             logging.error(
 31 |                 f"Error while trying to find all requests within the dapr state store")
 32 |             logging.error(e)
 33 |             return []
 34 | 
 35 |     def try_find_by_id(self, id : str):
 36 |         return self.__try_filter("id", id)
 37 |     
 38 |     def try_find_by_url_hashed(self, url_hashed : str):
 39 |         return self.__try_filter("url_hashed", url_hashed)
 40 |     
 41 |     def upsert(self, request: SummarizeRequest):
 42 |         try:
 43 |             self.dapr_client.save_state(
 44 |                 self.settings.state_store_name,
 45 |                 key=request.get_id(),
 46 |                 value=json.dumps(request),
 47 |                 state_metadata={"contentType": "application/json"}
 48 |             )
 49 |             self.__alert_owner(request)
 50 |             return self.try_find_by_id(request.get_id())
 51 |         except Exception as e:
 52 |             logging.error(
 53 |                 f"Error while trying to upsert {request.get_url()} within the dapr state store")
 54 |             logging.error(e)
 55 | 
 56 |         return None
 57 | 
 58 |     def delete(self, id : str):
 59 |         try:
 60 |             self.dapr_client.delete_state(
 61 |                 self.settings.state_store_name, key=id)
 62 |         except Exception as e:
 63 |             logging.error(
 64 |                 f"Error while deleting {id} within the dapr state store \n {e}")
 65 | 
 66 |     def __try_filter(self, property : str, value : str):
 67 |         try:
 68 |             query = '''
 69 |             {{
 70 |                 "filter": {{
 71 |                     "EQ": {{ "{0}": "{1}" }}
 72 |                 }}
 73 |             }}
 74 |             '''.format(property, value)
 75 | 
 76 |             results = self.__query_state(query)
 77 |             return results[0] if len(results) > 0 else None
 78 |         except Exception as e:
 79 |             logging.error(
 80 |                 f"Error while trying to find request using {property} and {value} within the dapr state store")
 81 |             logging.error(e)
 82 | 
 83 |         return None
 84 |     
 85 |     def __query_state(self, query : str):
 86 |         requests = []
 87 | 
 88 |         states_metadata = {"contentType": "application/json"}
 89 | 
 90 |         # Some components requires custom settings (Redis)
 91 |         if self.settings.state_store_query_index_name is not None:
 92 |             states_metadata["queryIndexName"] = self.settings.state_store_query_index_name
 93 | 
 94 |         logging.info(
 95 |             f"Querying state store : {self.settings.state_store_name} \
 96 |                 with query : {query} \
 97 |                 and metadata : {states_metadata}"
 98 |         )
 99 | 
100 |         resp = self.dapr_client.query_state(
101 |             store_name=self.settings.state_store_name,
102 |             query=query,
103 |             states_metadata=states_metadata
104 |         )
105 | 
106 |         for result in resp.results:
107 |             request = SummarizeRequest.from_bytes(result.value)
108 |             requests.append(request)
109 | 
110 |         return requests
111 |     
112 |     def __alert_owner(self, request: SummarizeRequest):
113 |         # Send email to requestor
114 |         email_contents = """
115 |         <html>
116 |             <body>
117 |                 <p>Hi,</p>
118 |                 <p>Here is the summary for the article you requested:</p>
119 |                 <p><a href="{url}">{url}</a></p>
120 |                 <p>{summary}</p>
121 |                 <p>Thanks for using our service!</p>
122 |             </body>
123 |         </html>        
124 |         """.format(url=request.get_url(), summary=request.get_summary())
125 | 
126 |         self.dapr_client.invoke_binding(
127 |             binding_name=self.settings.binding_smtp,
128 |             operation='create',
129 |             data=json.dumps(email_contents),
130 |             binding_metadata={
131 |                 "emailTo": request.get_email(),
132 |                 "subject": f"🎉 New Summary for {request.get_url()}!"
133 |             }
134 |         )


--------------------------------------------------------------------------------
/docs/lab/2-dapr-components/2-5-requests-processor.md:
--------------------------------------------------------------------------------
  1 | ---
  2 | title: Requests Processor
  3 | parent: Implement Dapr Components
  4 | has_children: false
  5 | permalink: /lab2/requests-processor
  6 | nav_order: 4
  7 | ---
  8 | 
  9 | # Requests Processor
 10 | 
 11 | {: .no_toc }
 12 | 
 13 | <details open markdown="block">
 14 |   <summary>
 15 |     Table of contents
 16 |   </summary>
 17 |   {: .text-delta }
 18 | - TOC
 19 | {:toc}
 20 | </details>
 21 | 
 22 | ## Add Request Processor to `dapr.yaml`
 23 | 
 24 | As we will be having many dapr applications, let's leverage the [multi-run](https://docs.dapr.io/developing-applications/local-development/multi-app-dapr-run/) feature of Dapr to run all the applications at once. So let's add Requests Processor App to the `dapr.yaml` file.
 25 | 
 26 | * Open the `dapr.yaml` file in the `/` folder and add a new node for the application including the environment variables.
 27 | 
 28 | <details markdown="block">
 29 |   <summary>
 30 |     Toggle solution
 31 |   </summary>
 32 | 
 33 | ```yaml
 34 | - appID: summarizer-requests-processor
 35 |   appDirPath: ./src/requests-processor/
 36 |   appPort: 12000
 37 |   command: ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "12000"]
 38 |   env:
 39 |     SECRET_STORE_NAME: "summarizer-secretstore"
 40 |     PUBSUB_REQUESTS_NAME: "summarizer-pubsub"
 41 |     PUBSUB_REQUESTS_TOPIC: "link-to-summarize"
 42 |     REQUESTS_API_APP_ID: "summarizer-requests-api"
 43 |     REQUESTS_API_SEARCH_ENDPOINT: "search-requests-by-url"
 44 |     REQUESTS_API_CREATE_ENDPOINT: "requests"
 45 |     OPENAI_API_VERSION: "2022-12-01"
 46 |     OPENAI_API_DEPLOYMENT_NAME: "aca-dapr-gpt-35-turbo-01"
 47 |     APP_PORT: 12000
 48 | ```
 49 | </details>
 50 | 
 51 | > Note: The `appID` is used to identify the application in the Dapr runtime. The `appDirPath` is the path to the application folder. The `appPort` is the port used by the application. The `command` is the command used to start the application. The `env` is the environment variables used by the application.
 52 | 
 53 | > Note: PubSub are already created, so we will be reusing the existing definition created before.
 54 | 
 55 | ## Request Processor Overview
 56 | 
 57 | 1. Open the `app.py` file in the `/src/request-processor` folder, and notice the subscribe method being used as en entry point
 58 | 
 59 | ```python	
 60 | # Subscribe to a new request from the pub/sub component
 61 | async def link_to_summarize(event : SummarizeRequestCloudEvent):
 62 | ```
 63 | 
 64 | 2. Open the `request_handler.py` file in the `/src/request-processor` folder, and notice how the request is being processed (eventually using Azure Open AI).
 65 | 
 66 | ## Implementing pub/sub and Http Invocation methods.
 67 | 
 68 | 1. Open the `request_handler.py` file in the `/src/requests-processor` folder.
 69 | 
 70 | 2.  Fill the `run` method so that it invokes the `requests-api` to search for a existing request. If the request is not found, it should invoke Open AI to get the summary. If the request is found, then it will reuse the summary from the request. In any case, it should invoke again the request api at the end to commit the new request.
 71 | 
 72 | <details markdown="block">
 73 |   <summary>
 74 |     Toggle solution
 75 |   </summary>
 76 | 
 77 | ```python	
 78 | async def run(self):
 79 |     logging.debug("Trying to find existing request in state")
 80 |     request = await self.__try_find_by_url(self.event.data.url)
 81 |     if not (request):
 82 |         logging.info(
 83 |             f"Azure Open AI requests for {self.event.data.url}")
 84 |         summary = await self.__get_summary(self.event.data.url)
 85 |     else:
 86 |         logging.info(
 87 |             f"Get summary from state for {self.event.data.url}")
 88 |         summary = request["summary"]
 89 |     resp = await self.dapr_client.invoke_method_async(
 90 |         self.settings.requests_api_app_id,
 91 |         self.settings.requests_api_create_endpoint,
 92 |         json.dumps({'url': self.event.data.url, 'email': self.event.data.email, 'summary': summary}),
 93 |         http_verb="POST")
 94 | ```
 95 | </details>
 96 | 
 97 | ## Validate the overall processes
 98 | 
 99 | 1. Execute dapr run multi run command to start the application
100 | 
101 |     ```bash
102 |     dapr run -f .
103 |     ``` 
104 | 2. Open the blazor application, create a new request using any email and link
105 | 
106 | ![Alt text](images/queue.png)
107 | 
108 | 3. Check that the request is stored in redis and refresh the blazor page to see the summary of the request.
109 | 
110 | ![Alt text](images/blazor-summary.png)
111 | 
112 | ![Alt text](images/redis-keys.png)
113 | 
114 | ## Bonus : Repeat the same dapr onboarding process with a new application (e.g, job-processor)
115 | 
116 | Job processor is sending new summary request in queue to be processed by the request processor. The request processor is then invoking the request api to store the new summary. It's a way to automate the process of sending new summary request to the request processor.
117 | 
118 | {: .no_toc }
119 | ## Congratulations !
120 | 
121 | You've been able to implement Dapr Components to an existing application to avoid strong coupling between application dependancies. In the next chapter, we will see how to use Dapr to deploy the application to Azure Container Apps.


--------------------------------------------------------------------------------
/docs/lab/2-dapr-components/2-4-blazor-app.md:
--------------------------------------------------------------------------------
  1 | ---
  2 | title: Blazor App
  3 | parent: Implement Dapr Components
  4 | has_children: false
  5 | permalink: /lab2/blazor-app
  6 | nav_order: 3
  7 | ---
  8 | 
  9 | # Blazor App
 10 | 
 11 | {: .no_toc }
 12 | 
 13 | <details open markdown="block">
 14 |   <summary>
 15 |     Table of contents
 16 |   </summary>
 17 |   {: .text-delta }
 18 | - TOC
 19 | {:toc}
 20 | </details>
 21 | 
 22 | ## Add Blazor App to `dapr.yaml`
 23 | 
 24 | As we will be having many dapr applications, let's leverage the [multi-run](https://docs.dapr.io/developing-applications/local-development/multi-app-dapr-run/) feature of Dapr to run all the applications at once. So let's add Blazor App to the `dapr.yaml` file.
 25 | 
 26 | * Open the `dapr.yaml` file in the `/` folder and add a new node for the application including the environment variables.
 27 | 
 28 | <details markdown="block">
 29 |   <summary>
 30 |     Toggle solution
 31 |   </summary>
 32 | 
 33 | ```yaml
 34 | - appID: summarizer-frontend
 35 |   appDirPath: ./src/frontend/
 36 |   appPort: 11000
 37 |   command: ["dotnet", "run"]
 38 |   env:
 39 |     PUBSUB_REQUESTS_NAME: "summarizer-pubsub"
 40 |     PUBSUB_REQUESTS_TOPIC: "link-to-summarize"
 41 |     REQUESTS_API_APP_ID: "summarizer-requests-api"
 42 |     REQUESTS_API_ENDPOINT: "requests"
 43 |     DOTNET_URLS: "http://*:11000"
 44 | ```
 45 | </details>
 46 | 
 47 | > Note: The `appID` is used to identify the application in the Dapr runtime. The `appDirPath` is the path to the application folder. The `appPort` is the port used by the application. The `command` is the command used to start the application. The `env` is the environment variables used by the application.
 48 | 
 49 | ## Create Pub / Sub yaml
 50 | 
 51 | From the previous definition of the environment variables of our application, we can see that we will be using a pub/sub dapr component. Let's create the yaml file for the pub/sub component.
 52 | 
 53 | * Create a new file named `summarizer-pubsub.yaml` in the `/dapr/local/components` folder using redis as the pub/sub component.
 54 | 
 55 | <details markdown="block">
 56 |   <summary>
 57 |     Toggle solution
 58 |   </summary>
 59 | 
 60 | ```yaml
 61 | apiVersion: dapr.io/v1alpha1
 62 | kind: Component
 63 | metadata:
 64 |   name: summarizer-pubsub
 65 | spec:
 66 |   type: pubsub.redis
 67 |   version: v1
 68 |   metadata:
 69 |   - name: redisHost
 70 |     value: localhost:6379
 71 |   - name: redisPassword
 72 |     value: ""
 73 | ```
 74 | </details>
 75 | 
 76 | > Note: The `name` is the name of the component. The `type` is the type of the component. The `version` is the version of the component. The `metadata` is the configuration of the component. We also added a query index to the state store to be able to query the state store by url. url_hashed is the hashed version of the url to ease the search query and avoid any special characters issues.
 77 | 
 78 | ## Blazor App Overview
 79 | 
 80 | 1. Open the `SummaryRequestService.cs` file in the `/src/Data/SummaryRequestService` folder, and notice the different methods being used as en entry point to manage external communication with both Request Api and Pub/Sub
 81 | 
 82 | ```csharp	
 83 | // Publish a new request to the pub/sub component
 84 | public async Task AddSummaryRequestAsync(NewSummaryRequestPayload newSummaryRequest) { }
 85 | 
 86 | // Get all the requests from the request api
 87 | public async Task<SummaryRequest[]> GetSummaryRequestsAsync() {}
 88 | ```
 89 |     
 90 | ## Implementing pub/sub and Http Invocation methods.
 91 | 
 92 | 1. Open the `SummaryRequestService.cs` file in the `/src/frontend` folder.
 93 | 
 94 | 2.  Fill the `GetSummaryRequestsAsync` method to get all the requests from the request api. The method should return a list of `Request` objects.
 95 | 
 96 | <details markdown="block">
 97 |   <summary>
 98 |     Toggle solution
 99 |   </summary>
100 | 
101 | ```csharp	
102 | public async Task<SummaryRequest[]> GetSummaryRequestsAsync()
103 | {
104 |     HttpRequestMessage? response = this._daprClient.CreateInvokeMethodRequest(
105 |         HttpMethod.Get,
106 |         _settings.requestsApiAppId,
107 |         _settings.requestsApiEndpoint
108 |     );
109 |     return await this._daprClient.InvokeMethodAsync<SummaryRequest[]>(response);
110 | }
111 | ```
112 | </details>
113 | 
114 | 3.   Fill the `AddSummaryRequestAsync` method to publish a new request to the pub/sub component.
115 | 
116 | <details markdown="block">
117 |   <summary>
118 |     Toggle solution
119 |   </summary>
120 | 
121 |   ```csharp	
122 |   public async Task AddSummaryRequestAsync(NewSummaryRequestPayload newSummaryRequest)
123 |   {
124 |     CancellationTokenSource source = new CancellationTokenSource();
125 |     CancellationToken cancellationToken = source.Token;
126 |     await this._daprClient.PublishEventAsync<NewSummaryRequestPayload>(
127 |         _settings.PubRequestName,
128 |         _settings.PubRequestTopic,
129 |         newSummaryRequest,
130 |         cancellationToken
131 |       );
132 |   }
133 |   ```
134 | </details>
135 | 
136 | ## Validate that the request is sent to Redis
137 | 
138 | 1. Execute dapr run multi run command to start the application
139 | 
140 | ```bash
141 |   dapr run -f .
142 | ``` 
143 | 2. Open a the blazor application, create a new request using any email and link
144 | 
145 | 3. Check that the request is stored in redis
146 | 
147 | ```bash	
148 | redis-cli
149 | > keys * # See all keys
150 | ```


--------------------------------------------------------------------------------
/docs/lab/3-container-apps/3-2-aca-deployment.md:
--------------------------------------------------------------------------------
  1 | ---
  2 | title: Infrastructure Deployment
  3 | parent: Container Apps
  4 | has_children: false
  5 | permalink: /lab3/aca-deployment
  6 | nav_order: 2
  7 | ---
  8 | 
  9 | # Container Apps Environment Deployment (including Dapr Components)
 10 | 
 11 | {: .no_toc }
 12 | 
 13 | <details open markdown="block">
 14 |   <summary>
 15 |     Table of contents
 16 |   </summary>
 17 |   {: .text-delta }
 18 | - TOC
 19 | {:toc}
 20 | </details>
 21 | 
 22 | ## General Information
 23 | 
 24 | In this section, we will deploy the infrastructure for the Container Apps environment. This includes the following resources:
 25 | *   Azure Container Apps Environment
 26 | *   Dapr components
 27 | *   Azure Container Registry
 28 | *   Azure Key Vault
 29 | *   Azure Service Bus
 30 | *   Managed Identities
 31 | 
 32 | Lucky for us, we already have bicep templates available to deploy all of these resources within the solution.
 33 | If you want to learn more about the bicep templates, you can find them in the [bicep](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/overview?tabs=bicep) but also in the [ACA Landing Zone Accelerator](https://github.com/Azure/aca-landing-zone-accelerator).
 34 | 
 35 | ## Deploying the infrastructure
 36 | 
 37 | Within the `/deploy/containerapps` folder, you will find the following files:
 38 | *  `infra.bicep` - This is the main bicep template that will deploy all of the infrastructure resources (except for the container apps)
 39 | *  `apps.bicep` - This is the bicep template that will deploy the container apps
 40 | *  `parameters.jsonc` - This is the parameters file that will be used to deploy the infrastructure resources
 41 |     > Make sure you have created this file before deploying the infrastructure if not, based on the sample provided
 42 | * `/dapr/*.bicep` - These are the bicep templates that will deploy the Dapr components
 43 | * `run-deploy.sh` - This is the script that will deploy both the infrastructure and the apps resources
 44 | 
 45 | ### Add dapr components to infra.bicep
 46 | 
 47 | * Open the `infra.bicep` file, scroll down to the dapr components section and add the following modules for each dapr components. Pay also attention to the underlying module to understand its behaviors.
 48 | 
 49 | * Output Binding (SMTP) : Dapr component that will send emails
 50 | 
 51 | <details markdown="block">
 52 |   <summary>
 53 |     Toggle solution
 54 |   </summary>
 55 | 
 56 | ```bicep
 57 | // ------------------
 58 | // DAPR COMPONENTS
 59 | // ------------------
 60 | 
 61 | module daprSmtp 'modules/dapr/smtp.bicep' = {
 62 |   name: '${deployment().name}-dapr-smtp'
 63 |   params: {
 64 |     daprComponentName: 'summarizer-smtp'
 65 |     containerAppsEnvironmentName: containerAppsEnvironment.outputs.name
 66 |     smtpHost: smtpHost
 67 |     smtpPort: smtpPort
 68 |   }
 69 | }
 70 | ```
 71 | </details>
 72 | 
 73 | * PubSub (Azure Service Bus) : Dapr component that will send messages to Azure Service Bus
 74 | 
 75 | <details markdown="block">
 76 |   <summary>
 77 |     Toggle solution
 78 |   </summary>
 79 | 
 80 | ```bicep
 81 | module daprPubSub 'modules/dapr/pubsub.bicep' = {
 82 |   name: '${deployment().name}-dapr-pubsub'
 83 |   params: {
 84 |     daprComponentName: 'summarizer-pubsub'
 85 |     containerAppsEnvironmentName: containerAppsEnvironment.outputs.name
 86 |     serviceBusConnectionString: serviceBus.outputs.connectionString
 87 |   }
 88 | }
 89 | ```
 90 | </details>
 91 | 
 92 | * State Store (Azure CosmosDb) : Dapr component that will store the state of the application 
 93 | 
 94 | <details markdown="block">
 95 |   <summary>
 96 |     Toggle solution
 97 |   </summary>
 98 | 
 99 | ```bicep
100 | module daprStateStore 'modules/dapr/statestore.bicep' = {
101 |   name: '${deployment().name}-dapr-statestore'
102 |   params: {
103 |     daprComponentName: 'summarizer-statestore'
104 |     containerAppsEnvironmentName: containerAppsEnvironment.outputs.name
105 |     cosmosDbName: cosmos.outputs.cosmosDbName
106 |     cosmosCollectionName: cosmos.outputs.cosmosCollectionName
107 |     cosmosUrl: cosmos.outputs.cosmosUrl
108 |     cosmosKey: cosmos.outputs.cosmosKey
109 |   }
110 | }
111 | ```
112 | </details>
113 | 
114 | * Secret Store (Azure KeyVault) : Dapr component that will store the secrets of the application
115 | 
116 | <details markdown="block">
117 |   <summary>
118 |     Toggle solution
119 |   </summary>
120 | 
121 | ```bicep
122 | module daprSecretStore 'modules/dapr/secretstore.bicep' = {
123 |   name: '${deployment().name}-dapr-secretstore'
124 |   params: {
125 |     daprComponentName: 'summarizer-secretstore'
126 |     containerAppsEnvironmentName: containerAppsEnvironment.outputs.name
127 |     vaultName: keyVault.outputs.vaultName
128 |     managedIdentityClientId: keyVault.outputs.vaultManagedIdentityClientId
129 |   }
130 | }
131 | ```
132 | </details>
133 | 
134 | ### Start the deployment
135 | 
136 | * Open a terminal and navigate to the `/deploy/containerapps` folder
137 | 
138 | * Make sure you are connected to the right subscription
139 | 
140 | ```bash
141 | az account show
142 | ```
143 | 
144 | * If you are not connected to the right subscription, run the following command
145 | 
146 | ```bash
147 | az account set --subscription <subscriptionId>
148 | ```
149 | 
150 | * Edit the deployment script './run-deploy.sh' to update the line below : 
151 |     * export RESOURCE_GROUP=<your-resource-group-name>
152 | 
153 | * Run the deployment script
154 |     * The overall process should take up to 4 minutes to complete
155 | 
156 | * Validate that the resources are created
157 | 
158 | ![Alt text](images/aca-provisioned.png)
159 | 
160 | * You can now move to the next section to deploy the container apps
161 | 


--------------------------------------------------------------------------------
/infra/infra.bicep:
--------------------------------------------------------------------------------
  1 | targetScope = 'resourceGroup'
  2 | 
  3 | // ------------------
  4 | //    PARAMETERS
  5 | // ------------------
  6 | 
  7 | @minLength(2)
  8 | @maxLength(10)
  9 | @description('The name of the workloard that is being deployed. Up to 10 characters long.')
 10 | param workloadName string
 11 | 
 12 | @minLength(2)
 13 | @maxLength(8)
 14 | @description('The name of the environment (e.g. "dev", "test", "prod", "uat", "dr", "qa") Up to 8 characters long.')
 15 | param environment string
 16 | 
 17 | @minLength(1)
 18 | param uniqueId string
 19 | 
 20 | param location string = resourceGroup().location
 21 | 
 22 | // ------------------
 23 | // VARIABLES
 24 | // ------------------
 25 | 
 26 | var naming = json(loadTextContent('./naming-rules.json'))
 27 | 
 28 | var resourceSuffix = format(
 29 |   '{0}-{1}-{2}-{3}',
 30 |   environment,
 31 |   naming.regionAbbreviations[location],
 32 |   workloadName,
 33 |   uniqueId
 34 | )
 35 | 
 36 | // ------------------
 37 | // INFRASTRUCTURE
 38 | // ------------------
 39 | 
 40 | module containerAppsEnvironment 'modules/infra/container-apps-env.bicep' = {
 41 |   name: '${deployment().name}-infra-container-app-env'
 42 |   params: {
 43 |     location: location
 44 |     appInsightsName: '${naming.resourceTypeAbbreviations.applicationInsights}-${resourceSuffix}'
 45 |     containerAppsEnvironmentName: '${naming.resourceTypeAbbreviations.containerAppsEnvironment}-${resourceSuffix}'
 46 |     logAnalyticsWorkspaceName: '${naming.resourceTypeAbbreviations.logAnalyticsWorkspace}-${resourceSuffix}'
 47 |     vnetName: '${naming.resourceTypeAbbreviations.virtualNetwork}-${resourceSuffix}'
 48 |   }
 49 | }
 50 | 
 51 | module containerRegistry 'modules/infra/container-registry.bicep' = {
 52 |   name: '${deployment().name}-infra-container-registry'
 53 |   params: {
 54 |     location: location
 55 |     containerRegistryName: replace('${naming.resourceTypeAbbreviations.containerRegistry}-${resourceSuffix}', '-', '')
 56 |     containerRegistryUserAssignedIdentityName: '${naming.resourceTypeAbbreviations.managedIdentity}-${naming.resourceTypeAbbreviations.containerRegistry}-${resourceSuffix}'
 57 |   }
 58 | }
 59 | 
 60 | module cosmos 'modules/infra/cosmos-db.bicep' = {
 61 |   name: '${deployment().name}-infra-cosmos-db'
 62 |   params: {
 63 |     location: location
 64 |     cosmosAccountName: '${naming.resourceTypeAbbreviations.cosmosDbNoSql}-${resourceSuffix}'
 65 |     cosmosDbName: 'summarizer'
 66 |   }
 67 | }
 68 | 
 69 | module serviceBus 'modules/infra/service-bus.bicep' = {
 70 |   name: '${deployment().name}-infra-service-bus'
 71 |   params: {
 72 |     serviceBusName: '${naming.resourceTypeAbbreviations.serviceBus}-${resourceSuffix}'
 73 |     location: location
 74 |   }
 75 | }
 76 | 
 77 | module openai 'modules/infra/openai.bicep' = {
 78 |   name: '${deployment().name}-infra-azure-ai-studio'
 79 |   params: {
 80 |     name: '${naming.resourceTypeAbbreviations.openai}-${resourceSuffix}'
 81 |     location: location
 82 |     deployments: [
 83 |       {
 84 |         name: 'gpt-4-32k'
 85 |         model: {
 86 |           name: 'gpt-4-32k'
 87 |           version: '0613'
 88 |         }
 89 |         sku: {
 90 |           capacity: 80
 91 |         }
 92 |       }
 93 |     ]
 94 |   }
 95 | }
 96 | 
 97 | module keyVault 'modules/infra/keyvault.bicep' = {
 98 |   name: '${deployment().name}-infra-keyvault'
 99 |   params: {
100 |     location: location
101 |     keyVaultName: '${naming.resourceTypeAbbreviations.keyVault}-${resourceSuffix}'
102 |     keyVaultUserAssignedIdentityName: '${naming.resourceTypeAbbreviations.managedIdentity}-${naming.resourceTypeAbbreviations.keyVault}-${resourceSuffix}'
103 |     openAiApiEndpoint: openai.outputs.endpoint
104 |     openAiApiKey: openai.outputs.key
105 |   }
106 | }
107 | 
108 | module webmail 'modules/infra/webmail.bicep' = {
109 |   name: '${deployment().name}-webmail'
110 |   params: {
111 |     location: location
112 |     containerAppsEnvironmentId: containerAppsEnvironment.outputs.id
113 |     containerAppName: 'webmail'
114 |     containerAppImage: 'mailhog/mailhog'
115 |   }
116 | }
117 | 
118 | // ------------------
119 | // DAPR COMPONENTS
120 | // ------------------
121 | 
122 | module daprSmtp 'modules/dapr/smtp.bicep' = {
123 |   name: '${deployment().name}-dapr-smtp'
124 |   params: {
125 |     daprComponentName: 'summarizer-smtp'
126 |     containerAppsEnvironmentName: containerAppsEnvironment.outputs.name
127 |     smtpHost: webmail.outputs.fqdn
128 |     smtpPort: webmail.outputs.smtpPort
129 |   }
130 | }
131 | 
132 | module daprPubSub 'modules/dapr/pubsub.bicep' = {
133 |   name: '${deployment().name}-dapr-pubsub'
134 |   params: {
135 |     daprComponentName: 'summarizer-pubsub'
136 |     containerAppsEnvironmentName: containerAppsEnvironment.outputs.name
137 |     serviceBusConnectionString: serviceBus.outputs.connectionString
138 |   }
139 | }
140 | 
141 | module daprStateStore 'modules/dapr/statestore.bicep' = {
142 |   name: '${deployment().name}-dapr-statestore'
143 |   params: {
144 |     daprComponentName: 'summarizer-statestore'
145 |     containerAppsEnvironmentName: containerAppsEnvironment.outputs.name
146 |     cosmosDbName: cosmos.outputs.cosmosDbName
147 |     cosmosCollectionName: cosmos.outputs.cosmosCollectionName
148 |     cosmosUrl: cosmos.outputs.cosmosUrl
149 |     cosmosKey: cosmos.outputs.cosmosKey
150 |   }
151 | }
152 | 
153 | module daprSecretStore 'modules/dapr/secretstore.bicep' = {
154 |   name: '${deployment().name}-dapr-secretstore'
155 |   params: {
156 |     daprComponentName: 'summarizer-secretstore'
157 |     containerAppsEnvironmentName: containerAppsEnvironment.outputs.name
158 |     vaultName: keyVault.outputs.vaultName
159 |     managedIdentityClientId: keyVault.outputs.vaultManagedIdentityClientId
160 |   }
161 | }
162 | 


--------------------------------------------------------------------------------
/docs/lab/3-container-apps/3-1-aca-overview.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | title: Container Apps Overview
 3 | parent: Container Apps
 4 | has_children: false
 5 | permalink: /lab3/aca-overview
 6 | nav_order: 1
 7 | ---
 8 | 
 9 | # Container Apps Overview
10 | 
11 | [Azure Container Apps](https://docs.microsoft.com/en-us/azure/container-apps)is a new serverless container platform for applications that need to scale on demand in response to HTTPS requests, events, or simply run as always-on services or background job processing without managing VMs, orchestrators, or other cloud infrastructure. Azure Container Apps makes it easy to manage your containerized applications with built-in autoscaling, traffic routing, application lifecycle management, and service-to-service communication in a fully managed environment.
12 | 
13 | While App Service, Functions, and Logic Apps provide application developers with fully-managed, high-productivity solutions for domain-specific problems, customers have to drop out of the fully-managed world and fall back to Kubernetes for full microservice applications or to run general purpose container applications. Azure container Apps fills this gap and rounds out the Azure application platform by providing high-level APIs for the most common container application scenarios, including auto-scaling, version management, application upgrades, and service-to-service communication in a fully managed environment.
14 | 
15 | Common uses for Azure Container Apps include:
16 | 
17 | - Deploying API endpoints
18 | - Hosting background processing applications
19 | - Handling event-driven processing
20 | - Running microservices
21 | 
22 | Applications built on Azure Container Apps can dynamically scale based on the following characteristics:
23 | 
24 | - HTTP traffic
25 | - Event-driven processing
26 | - CPU or memory load
27 | - Any [KEDA-supported scaler](https://keda.sh/docs/2.4/scalers/)
28 | 
29 | ![Example scenarios for Azure Container Apps](images/aca-example-scenarios.png)
30 | 
31 | Azure Container Apps enables executing application code packaged in any container and is unopinionated about runtime or programming model. With Container Apps, you enjoy the benefits of running containers while leaving behind the concerns of managing cloud infrastructure and complex container orchestrators.
32 | 
33 | With Azure Container Apps, you can:
34 | 
35 | - [**Run multiple container revisions**](https://docs.microsoft.com/en-us/azure/container-apps/application-lifecycle-management) and manage the container app's application lifecycle.
36 | 
37 | - [**Autoscale**](https://docs.microsoft.com/en-us/azure/container-apps/scale-app) your apps based on any KEDA-supported scale trigger. Most applications can scale to zero<sup>1</sup>.
38 | 
39 | - [**Enable HTTPS ingress**](https://docs.microsoft.com/en-us/azure/container-apps/ingress) without having to manage other Azure infrastructure.
40 | 
41 | - [**Split traffic**](https://docs.microsoft.com/en-us/azure/container-apps/revisions) across multiple versions of an application for Blue/Green deployments and A/B testing scenarios.
42 | 
43 | - [**Use internal ingress and service discovery**](https://docs.microsoft.com/en-us/azure/container-apps/connect-apps) for secure internal-only endpoints with built-in DNS-based service discovery.
44 | 
45 | - [**Build microservices with Dapr**](https://docs.microsoft.com/en-us/azure/container-apps/microservices) and access its rich set of APIs.
46 | 
47 | - [**Run containers from any registry**](https://docs.microsoft.com/en-us/azure/container-apps/containers), public or private, including Docker Hub and Azure Container Registry (ACR).
48 | 
49 | - [**Use the Azure CLI extension or ARM templates**](https://docs.microsoft.com/en-us/azure/container-apps/get-started) to manage your applications.
50 | 
51 | - [**Securely manage secrets**](https://docs.microsoft.com/en-us/azure/container-apps/secure-app) directly in your application.
52 | 
53 | - [**View application logs**](https://docs.microsoft.com/en-us/azure/container-apps/monitor) using Azure Log Analytics.
54 | 
55 | <sup>1</sup> Applications that [scale on CPU or memory load](https://docs.microsoft.com/en-us/azure/container-apps/scale-app) can't scale to zero.
56 | 
57 | ## Core Components
58 | 
59 | The main components of Azure Container Apps are:
60 | 
61 | ![Azure Container Apps main components](images/aca-components.jpg)
62 | 
63 | **1. Environments**
64 | The Environment is a secure boundary around several Container Apps. It contains one or more container apps. All container apps within an environment are deployed into a dedicated Azure Virtual Network, which makes it possible for these different container apps to communicate securely. In addition, all the logs produced from all container apps in the environment are sent to a dedicated Log Analytics workspace.
65 | 
66 | **2. Log Analytics Workspace**
67 | Used to provide monitoring and observability functionality. Each environment will have its own Log Analytic workspace and will be shared among all container apps within the environment.
68 | 
69 | **3. Container Apps**
70 | Each container App represents a single deployable unit that can contain one or more related containers. More than one container is an advanced use case. For this workshop we will deploy a single container in each container app. More about multiple containers in the same single Azure Container App can be found [here](https://docs.microsoft.com/en-us/azure/container-apps/containers#multiple-containers).
71 | 
72 | **4. Revisions**
73 | For each container app, you can create up to 100 revisions. Revisions are a way to deploy multiple versions of an app where you have the option to send the traffic to a certain revision. You can select if revision mode will support 1 active revision or multiple active revisions at the same time to support A/B testing scenarios or canary deployments. A container app running in single revision mode will have a single revision that is backed by zero-many Pods/replicas.
74 | 
75 | **5. Containers**
76 | Containers in the Azure Container Apps are grouped together in pods/replicas inside revision snapshots. A Pod/replica is composed of the application container and any required sidecar containers. Containers can be deployed from any public or private container registry, and they support any Linux-based x86-64 (linux/amd64) images. At the time of creating this workshop Windows based images are not supported.


--------------------------------------------------------------------------------
/docs/lab/3-container-apps/3-3-apps-deployment.md:
--------------------------------------------------------------------------------
  1 | ---
  2 | title: Apps Deployment
  3 | parent: Container Apps
  4 | has_children: false
  5 | permalink: /lab3/apps-deployment
  6 | nav_order: 3
  7 | ---
  8 | 
  9 | # Container Apps Deployment (Summarizer microservices)
 10 | 
 11 | {: .no_toc }
 12 | 
 13 | <details open markdown="block">
 14 |   <summary>
 15 |     Table of contents
 16 |   </summary>
 17 |   {: .text-delta }
 18 | - TOC
 19 | {:toc}
 20 | </details>
 21 | 
 22 | ## General Information
 23 | 
 24 | In this section, we will deploy the Summarizer apps within the Container Apps environment. This includes the following resources:
 25 | *  Frontend Blazor App
 26 | *  Backend Requests API
 27 | *  Backend Requests Processor
 28 | 
 29 | In order to do so, we'll need to follow below steps :
 30 | * Execute docker build and push of all images into the container registry
 31 | * Deploy the container apps
 32 | 
 33 | ## Adding the container app in the bicep template
 34 | 
 35 | * Open the `apps.bicep` file, scroll down to the container apps section and call the subsequent module defined or each container app. Pay also attention to the underlying module to understand its behaviors and map it accordingly.
 36 | 
 37 | * <b>Frontend Blazor App</b>
 38 | 
 39 | <details markdown="block">
 40 |   <summary>
 41 |     Toggle solution
 42 |   </summary>
 43 | 
 44 | ```bicep
 45 | module frontend 'modules/apps/frontend.bicep' = {
 46 |   name: '${deployment().name}-summarizer-frontend'
 47 |   params: {
 48 |     location: location
 49 |     containerAppsEnvironmentId: containerAppsEnvironment.id
 50 |     containerRegistryUserAssignedIdentityId: containerRegistryUserAssignedIdentity.id
 51 |     keyVaultUserAssignedIdentityId: keyVaultUserAssignedIdentity.id
 52 | 
 53 |     containerRegistryLoginServer: containerRegistry.properties.loginServer
 54 |     containerAppName: 'summarizer-frontend'
 55 |     containerAppImage: '${containerRegistry.properties.loginServer}/summarizer/frontend:latest'
 56 |     containerAppPort: 80
 57 | 
 58 |     pubSubRequestsName: 'summarizer-pubsub'
 59 |     pubSubRequestsTopic:'link-to-summarize'
 60 |     requestsApiAppId:'summarizer-requests-api'
 61 |     requestsApiEndpoint: 'requests'
 62 |   }
 63 | }
 64 | ```
 65 | </details>
 66 | 
 67 | * <b>Requests API</b>
 68 | 
 69 | <details markdown="block">
 70 |   <summary>
 71 |     Toggle solution
 72 |   </summary>
 73 | 
 74 | ```bicep
 75 | module requests_api 'modules/apps/requests-api.bicep' = {
 76 |   name: '${deployment().name}-summarizer-requests-api'
 77 |   params: {
 78 |     location: location
 79 |     containerAppsEnvironmentId: containerAppsEnvironment.id
 80 |     containerRegistryUserAssignedIdentityId: containerRegistryUserAssignedIdentity.id
 81 |     keyVaultUserAssignedIdentityId: keyVaultUserAssignedIdentity.id
 82 | 
 83 |     containerRegistryLoginServer: containerRegistry.properties.loginServer
 84 |     containerAppName: 'summarizer-requests-api'
 85 |     containerAppImage: '${containerRegistry.properties.loginServer}/summarizer/requests-api:latest'
 86 |     containerAppPort: 80
 87 |     stateStoreName:'summarizer-statestore'
 88 |     bindingSmtp: 'summarizer-smtp'
 89 |   }
 90 | }
 91 | ```
 92 | </details>
 93 | 
 94 | * <b>Requests Processor</b>
 95 | 
 96 | <details markdown="block">
 97 |   <summary>
 98 |     Toggle solution
 99 |   </summary>
100 | 
101 | ```bicep
102 | module requests_processor 'modules/apps/requests-processor.bicep' = {
103 |   name: '${deployment().name}-summarizer-requests-processor'
104 |   params: {
105 |     location: location
106 |     containerAppsEnvironmentId: containerAppsEnvironment.id
107 |     containerRegistryUserAssignedIdentityId: containerRegistryUserAssignedIdentity.id
108 |     keyVaultUserAssignedIdentityId: keyVaultUserAssignedIdentity.id
109 | 
110 |     containerRegistryLoginServer: containerRegistry.properties.loginServer
111 |     containerAppName: 'summarizer-requests-processor'
112 |     containerAppImage: '${containerRegistry.properties.loginServer}/summarizer/requests-processor:latest'
113 |     containerAppPort: 80
114 |     pubSubRequestsName: 'summarizer-pubsub'
115 |     pubSubRequestsTopic:'link-to-summarize'
116 |     openAiApiDeploymentName:'aca-dapr-gpt-35-turbo-01'
117 |     openAiApiVersion:'2022-12-01'
118 |     secretStoreName:'summarizer-secretstore'
119 |     requestsApiAppId: 'summarizer-requests-api'
120 |     requestsApiCreateEndpoint: 'requests'
121 |     requestsApiSearchEndpoint: 'search-requests-by-url'
122 |   }
123 | }
124 | ```
125 | </details>
126 | 
127 | ## Deployment script
128 | 
129 | ### Building / pushing the images
130 | 
131 | * Open the `run-deploy.sh` file and add docker build and docker push to the container registry for each image. :
132 | 
133 | <details markdown="block">
134 |   <summary>
135 |     Toggle solution
136 |   </summary>
137 | 
138 | ```bash
139 | # echo "Retrieving Container Registry... from previous deployment"
140 | REGISTRY=$(echo $AZ_CAENV_DEPLOYMENT | grep -oE -m 1 '/registries/([^/]+)' | tail -n +2 | cut -d'/' -f3).azurecr.io
141 | echo "Container Registry: $REGISTRY"
142 | 
143 | # Login to Azure
144 | echo "Logging in to Azure Container Registry..."
145 | az acr login --name $REGISTRY
146 | 
147 | # Build and push images
148 | echo "Building and pushing images..."
149 | docker build -t $REGISTRY/summarizer/requests-api:latest ../../src/requests-api
150 | docker build -t $REGISTRY/summarizer/requests-processor:latest ../../src/requests-processor
151 | docker build -t $REGISTRY/summarizer/frontend:latest  ../../src/frontend
152 | docker push $REGISTRY/summarizer/requests-api:latest
153 | docker push $REGISTRY/summarizer/requests-processor:latest
154 | docker push $REGISTRY/summarizer/frontend:latest
155 | ```
156 | </details>
157 | 
158 | ### Adding the container apps
159 | 
160 | * Right next to it, trigger the az deployment of the `apps.bicep` using the az cli command :
161 | 
162 | <details markdown="block">
163 |   <summary>
164 |     Toggle solution
165 |   </summary>
166 | 
167 | ```bash
168 | # Deploy Container Apps
169 | echo "Deploying Container Apps..."
170 | AZ_CAENV_DEPLOYMENT=$(az deployment group create \
171 |                         --resource-group $RESOURCE_GROUP \
172 |                         --template-file ./apps.bicep \
173 |                         --parameters ./parameters.jsonc)
174 | ```
175 | </details>
176 | 
177 | * Run the script again `run-deploy.sh`, you should now be having three container apps deployed within the Container Apps environment.
178 | 
179 | ![Alt text](images/container-apps.png)
180 | 
181 | ## Test the application
182 | 
183 | * Open the `frontend` app in your browser, and test the application by adding a new URL to summarize. 
184 | > You can get the FQDN of the frontend app by running the following command : `az containerapp show -n summarizer-frontend -g <resource-group-name> --query frontendEndpoint -o tsv` or using the Azure Portal in the overview section of the container app.
185 | 
186 | * Open the other containers apps logs stream to see the logs of the requests-api and requests-processor apps.
187 | 
188 | ![Alt text](images/request-processor-logs.png)
189 | 
190 | ## Bonus : Make some changes to the frontend app, set revision strategy to multiple and do traffic splitting
191 | 
192 | * [Traffic splitting](https://learn.microsoft.com/en-us/azure/container-apps/traffic-splitting?pivots=azure-portal)
193 | 


--------------------------------------------------------------------------------
/docs/lab/2-dapr-components/2-3-requests-api.md:
--------------------------------------------------------------------------------
  1 | ---
  2 | title: Requests API
  3 | parent: Implement Dapr Components
  4 | has_children: false
  5 | permalink: /lab2/requests-api
  6 | nav_order: 2
  7 | ---
  8 | 
  9 | # Requests API
 10 | 
 11 | {: .no_toc }
 12 | 
 13 | <details open markdown="block">
 14 |   <summary>
 15 |     Table of contents
 16 |   </summary>
 17 |   {: .text-delta }
 18 | - TOC
 19 | {:toc}
 20 | </details>
 21 | 
 22 | ## Add Request API to `dapr.yaml`
 23 | 
 24 | As we will be having many dapr applications, let's leverage the [multi-run](https://docs.dapr.io/developing-applications/local-development/multi-app-dapr-run/) feature of Dapr to run all the applications at once. For now, let's add the request api only to the `dapr.yaml` file.
 25 | 
 26 | * Open the `dapr.yaml` file in the `/` folder and add a new node for the application including the environment variables.
 27 | 
 28 | <details markdown="block">
 29 |   <summary>
 30 |     Toggle solution
 31 |   </summary>
 32 | 
 33 | ```yaml
 34 | - appID: summarizer-requests-api
 35 |   appDirPath: ./src/requests-api/
 36 |   appPort: 13000
 37 |   command: ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "13000"]
 38 |   env:
 39 |     STATE_STORE_NAME: "summarizer-statestore"
 40 |     STATE_STORE_QUERY_INDEX_NAME: "orgIndx"
 41 |     BINDING_SMTP: "summarizer-smtp"
 42 |     APP_PORT: 13000
 43 | ```
 44 | </details>
 45 | 
 46 | > Note: The `appID` is used to identify the application in the Dapr runtime. The `appDirPath` is the path to the application folder. The `appPort` is the port used by the application. The `command` is the command used to start the application. The `env` is the environment variables used by the application.
 47 | 
 48 | ## Create State Store yaml
 49 | 
 50 | From the previous definition of the environment variables of our application, we can see that we will be using a state store. Let's create the yaml file for the state store.
 51 | 
 52 | * Create a new file named `summarizer-statestore.yaml` in the `/dapr/local/components` folder, add a state store component called 'summarizer-statestore' and configure it to use Redis. Query indexes should also be configured to allow for fast retrieval of data (url, url_hashed and id).
 53 | 
 54 | <details markdown="block">
 55 |   <summary>
 56 |     Toggle solution
 57 |   </summary>
 58 | 
 59 | ```yaml
 60 | apiVersion: dapr.io/v1alpha1
 61 | kind: Component
 62 | metadata:
 63 |   name: summarizer-statestore
 64 | spec:
 65 |   type: state.redis
 66 |   version: v1
 67 |   metadata:
 68 |   - name: redisHost
 69 |     value: localhost:6379
 70 |   - name: redisPassword
 71 |     value: ""
 72 |   - name: queryIndexes
 73 |     value: |
 74 |       [
 75 |         {
 76 |           "name": "orgIndx",
 77 |           "indexes": [
 78 |             {
 79 |               "key": "id",
 80 |               "type": "TEXT"
 81 |             },
 82 |             {
 83 |               "key": "url",
 84 |               "type": "TEXT"
 85 |             },
 86 |             {
 87 |               "key": "url_hashed",
 88 |               "type": "TEXT"
 89 |             }
 90 |           ]
 91 |         }
 92 |       ] 
 93 | ```
 94 | </details>
 95 | 
 96 | > Note: The `name` is the name of the component. The `type` is the type of the component. The `version` is the version of the component. The `metadata` is the configuration of the component. We also added a query index to the state store to be able to query the state store by url. url_hashed is the hashed version of the url to ease the search query and avoid any special characters issues.
 97 | 
 98 | ## Request API Overview
 99 | 
100 | 1. Open the `app.py` file in the `/src/requests-api` folder, and notice the DaprClient object that is used to interact with the Dapr runtime.
101 |     
102 | ```python
103 | dapr_client = DaprClient()
104 | ```
105 | 2. We also have several endpoints defined to manage the requests lifecycle :
106 |     * `@app.get('/requests')` : Get all the requests
107 |     * `@app.post('/search-requests-by-url')` : Search a request with specific link
108 |     * `@app.post('/requests', status_code = status.HTTP_201_CREATED)` : Create a request
109 | 
110 | ## Implementing state and SMTP binding methods
111 | 
112 | Let's implement the state methods and the SMTP output binding.
113 | 
114 | 1. Open the `request_state.py` file in the `/src/requests-api` folder, managing the state store.
115 | 
116 | > `def __query_state(self, query : str)` is using the DaprClient object to execute the query to the state store.
117 | 
118 | 2.  Fill the `find_all` method to get all the requests from the state store. The method should return a list of `Request` objects.
119 | 
120 | <details markdown="block">
121 |   <summary>
122 |     Toggle solution
123 |   </summary>
124 | 
125 | {% raw %}
126 | ```python
127 | def find_all(self, token: str = None):
128 | try:
129 |      # Paging are supported using token
130 |      # see https://docs.dapr.io/developing-applications/building-blocks/state-management/howto-state-query-api/
131 | 
132 |      token = f", \"token\": \"{token}\"" if token is not None else ""
133 |      query = '''
134 |      {{
135 |          "page": {{
136 |              "limit": 100{0}
137 |          }}
138 |      }}
139 |      '''.format(token)
140 | 
141 |      return self.__query_state(query)
142 | except Exception as e:
143 |     logging.error(
144 |         f"Error while trying to find all requests within the dapr state store")
145 |     logging.error(e)
146 |     return []
147 | ```
148 | {% endraw %}
149 | </details>
150 | 
151 | 3.   Fill the `__try_filter` method to get a request from the state store using a specific property and value. The method should return a `Request` object or None.
152 | 
153 | <details markdown="block">
154 |   <summary>
155 |     Toggle solution
156 |   </summary>
157 | 
158 | {% raw %}
159 | ```python
160 | def __try_filter(self, property : str, value : str):
161 |     try:
162 |         query = '''
163 |         {{
164 |             "filter": {{
165 |                 "EQ": {{ "{0}": "{1}" }}
166 |             }}
167 |         }}
168 |         '''.format(property, value)        
169 |         results = self.__query_state(query)
170 |         return results[0] if len(results) > 0 else None
171 |     except Exception as e:
172 |         logging.error(
173 |             f"Error while trying to find request using {property} and {value} within the dapr state store")
174 |         logging.error(e)    
175 |         return None
176 | ```
177 | {% endraw %}
178 | </details>
179 | 
180 | 4.   Fill the `__alert_owner` method to invoke the smtp binding, providing an email contents as a data.None.
181 | 
182 | <details markdown="block">
183 |   <summary>
184 |     Toggle solution
185 |   </summary>
186 | 
187 | {% raw %}
188 | ```python
189 | def __alert_owner(self, request: SummarizeRequest):
190 |     # Send email to requestor
191 |     email_contents = """
192 |     <html>
193 |         <body>
194 |             <p>Hi,</p>
195 |             <p>Here is the summary for the article you requested:</p>
196 |             <p><a href="{url}">{url}</a></p>
197 |             <p>{summary}</p>
198 |             <p>Thanks for using our service!</p>
199 |         </body>
200 |     </html>        
201 |     """.format(url=request.get_url(), summary=request.get_summary())
202 |     self.dapr_client.invoke_binding(
203 |         binding_name=self.settings.binding_smtp,
204 |         operation='create',
205 |         data=json.dumps(email_contents),
206 |         binding_metadata={
207 |             "emailTo": request.get_email(),
208 |             "subject": f"🎉 New Summary for {request.get_url()}!"
209 |         }
210 |     )
211 | ```
212 | {% endraw %}
213 | </details>
214 | 
215 | ## Validate that the request is stored in the state store and email received
216 | 
217 | 1. Execute dapr run multi run command to start the application
218 | 
219 |     ```bash
220 |     dapr run -f .
221 |     ``` 
222 | 2. Open a new terminal and use curl to validate new request creation
223 | 
224 | 3. Check that the request is stored in the state store and email received


--------------------------------------------------------------------------------
/docs/Gemfile.lock:
--------------------------------------------------------------------------------
  1 | GEM
  2 |   remote: https://rubygems.org/
  3 |   specs:
  4 |     activesupport (7.0.5)
  5 |       concurrent-ruby (~> 1.0, >= 1.0.2)
  6 |       i18n (>= 1.6, < 2)
  7 |       minitest (>= 5.1)
  8 |       tzinfo (~> 2.0)
  9 |     addressable (2.8.4)
 10 |       public_suffix (>= 2.0.2, < 6.0)
 11 |     coffee-script (2.4.1)
 12 |       coffee-script-source
 13 |       execjs
 14 |     coffee-script-source (1.11.1)
 15 |     colorator (1.1.0)
 16 |     commonmarker (0.23.9)
 17 |     concurrent-ruby (1.2.2)
 18 |     dnsruby (1.70.0)
 19 |       simpleidn (~> 0.2.1)
 20 |     em-websocket (0.5.3)
 21 |       eventmachine (>= 0.12.9)
 22 |       http_parser.rb (~> 0)
 23 |     ethon (0.16.0)
 24 |       ffi (>= 1.15.0)
 25 |     eventmachine (1.2.7)
 26 |     execjs (2.8.1)
 27 |     faraday (2.7.6)
 28 |       faraday-net_http (>= 2.0, < 3.1)
 29 |       ruby2_keywords (>= 0.0.4)
 30 |     faraday-net_http (3.0.2)
 31 |     ffi (1.15.5)
 32 |     forwardable-extended (2.6.0)
 33 |     gemoji (3.0.1)
 34 |     github-pages (228)
 35 |       github-pages-health-check (= 1.17.9)
 36 |       jekyll (= 3.9.3)
 37 |       jekyll-avatar (= 0.7.0)
 38 |       jekyll-coffeescript (= 1.1.1)
 39 |       jekyll-commonmark-ghpages (= 0.4.0)
 40 |       jekyll-default-layout (= 0.1.4)
 41 |       jekyll-feed (= 0.15.1)
 42 |       jekyll-gist (= 1.5.0)
 43 |       jekyll-github-metadata (= 2.13.0)
 44 |       jekyll-include-cache (= 0.2.1)
 45 |       jekyll-mentions (= 1.6.0)
 46 |       jekyll-optional-front-matter (= 0.3.2)
 47 |       jekyll-paginate (= 1.1.0)
 48 |       jekyll-readme-index (= 0.3.0)
 49 |       jekyll-redirect-from (= 0.16.0)
 50 |       jekyll-relative-links (= 0.6.1)
 51 |       jekyll-remote-theme (= 0.4.3)
 52 |       jekyll-sass-converter (= 1.5.2)
 53 |       jekyll-seo-tag (= 2.8.0)
 54 |       jekyll-sitemap (= 1.4.0)
 55 |       jekyll-swiss (= 1.0.0)
 56 |       jekyll-theme-architect (= 0.2.0)
 57 |       jekyll-theme-cayman (= 0.2.0)
 58 |       jekyll-theme-dinky (= 0.2.0)
 59 |       jekyll-theme-hacker (= 0.2.0)
 60 |       jekyll-theme-leap-day (= 0.2.0)
 61 |       jekyll-theme-merlot (= 0.2.0)
 62 |       jekyll-theme-midnight (= 0.2.0)
 63 |       jekyll-theme-minimal (= 0.2.0)
 64 |       jekyll-theme-modernist (= 0.2.0)
 65 |       jekyll-theme-primer (= 0.6.0)
 66 |       jekyll-theme-slate (= 0.2.0)
 67 |       jekyll-theme-tactile (= 0.2.0)
 68 |       jekyll-theme-time-machine (= 0.2.0)
 69 |       jekyll-titles-from-headings (= 0.5.3)
 70 |       jemoji (= 0.12.0)
 71 |       kramdown (= 2.3.2)
 72 |       kramdown-parser-gfm (= 1.1.0)
 73 |       liquid (= 4.0.4)
 74 |       mercenary (~> 0.3)
 75 |       minima (= 2.5.1)
 76 |       nokogiri (>= 1.13.6, < 2.0)
 77 |       rouge (= 3.26.0)
 78 |       terminal-table (~> 1.4)
 79 |     github-pages-health-check (1.17.9)
 80 |       addressable (~> 2.3)
 81 |       dnsruby (~> 1.60)
 82 |       octokit (~> 4.0)
 83 |       public_suffix (>= 3.0, < 5.0)
 84 |       typhoeus (~> 1.3)
 85 |     html-pipeline (2.14.3)
 86 |       activesupport (>= 2)
 87 |       nokogiri (>= 1.4)
 88 |     http_parser.rb (0.8.0)
 89 |     i18n (1.14.1)
 90 |       concurrent-ruby (~> 1.0)
 91 |     jekyll (3.9.3)
 92 |       addressable (~> 2.4)
 93 |       colorator (~> 1.0)
 94 |       em-websocket (~> 0.5)
 95 |       i18n (>= 0.7, < 2)
 96 |       jekyll-sass-converter (~> 1.0)
 97 |       jekyll-watch (~> 2.0)
 98 |       kramdown (>= 1.17, < 3)
 99 |       liquid (~> 4.0)
100 |       mercenary (~> 0.3.3)
101 |       pathutil (~> 0.9)
102 |       rouge (>= 1.7, < 4)
103 |       safe_yaml (~> 1.0)
104 |     jekyll-avatar (0.7.0)
105 |       jekyll (>= 3.0, < 5.0)
106 |     jekyll-coffeescript (1.1.1)
107 |       coffee-script (~> 2.2)
108 |       coffee-script-source (~> 1.11.1)
109 |     jekyll-commonmark (1.4.0)
110 |       commonmarker (~> 0.22)
111 |     jekyll-commonmark-ghpages (0.4.0)
112 |       commonmarker (~> 0.23.7)
113 |       jekyll (~> 3.9.0)
114 |       jekyll-commonmark (~> 1.4.0)
115 |       rouge (>= 2.0, < 5.0)
116 |     jekyll-default-layout (0.1.4)
117 |       jekyll (~> 3.0)
118 |     jekyll-feed (0.15.1)
119 |       jekyll (>= 3.7, < 5.0)
120 |     jekyll-gist (1.5.0)
121 |       octokit (~> 4.2)
122 |     jekyll-github-metadata (2.13.0)
123 |       jekyll (>= 3.4, < 5.0)
124 |       octokit (~> 4.0, != 4.4.0)
125 |     jekyll-include-cache (0.2.1)
126 |       jekyll (>= 3.7, < 5.0)
127 |     jekyll-mentions (1.6.0)
128 |       html-pipeline (~> 2.3)
129 |       jekyll (>= 3.7, < 5.0)
130 |     jekyll-optional-front-matter (0.3.2)
131 |       jekyll (>= 3.0, < 5.0)
132 |     jekyll-paginate (1.1.0)
133 |     jekyll-readme-index (0.3.0)
134 |       jekyll (>= 3.0, < 5.0)
135 |     jekyll-redirect-from (0.16.0)
136 |       jekyll (>= 3.3, < 5.0)
137 |     jekyll-relative-links (0.6.1)
138 |       jekyll (>= 3.3, < 5.0)
139 |     jekyll-remote-theme (0.4.3)
140 |       addressable (~> 2.0)
141 |       jekyll (>= 3.5, < 5.0)
142 |       jekyll-sass-converter (>= 1.0, <= 3.0.0, != 2.0.0)
143 |       rubyzip (>= 1.3.0, < 3.0)
144 |     jekyll-sass-converter (1.5.2)
145 |       sass (~> 3.4)
146 |     jekyll-seo-tag (2.8.0)
147 |       jekyll (>= 3.8, < 5.0)
148 |     jekyll-sitemap (1.4.0)
149 |       jekyll (>= 3.7, < 5.0)
150 |     jekyll-swiss (1.0.0)
151 |     jekyll-theme-architect (0.2.0)
152 |       jekyll (> 3.5, < 5.0)
153 |       jekyll-seo-tag (~> 2.0)
154 |     jekyll-theme-cayman (0.2.0)
155 |       jekyll (> 3.5, < 5.0)
156 |       jekyll-seo-tag (~> 2.0)
157 |     jekyll-theme-dinky (0.2.0)
158 |       jekyll (> 3.5, < 5.0)
159 |       jekyll-seo-tag (~> 2.0)
160 |     jekyll-theme-hacker (0.2.0)
161 |       jekyll (> 3.5, < 5.0)
162 |       jekyll-seo-tag (~> 2.0)
163 |     jekyll-theme-leap-day (0.2.0)
164 |       jekyll (> 3.5, < 5.0)
165 |       jekyll-seo-tag (~> 2.0)
166 |     jekyll-theme-merlot (0.2.0)
167 |       jekyll (> 3.5, < 5.0)
168 |       jekyll-seo-tag (~> 2.0)
169 |     jekyll-theme-midnight (0.2.0)
170 |       jekyll (> 3.5, < 5.0)
171 |       jekyll-seo-tag (~> 2.0)
172 |     jekyll-theme-minimal (0.2.0)
173 |       jekyll (> 3.5, < 5.0)
174 |       jekyll-seo-tag (~> 2.0)
175 |     jekyll-theme-modernist (0.2.0)
176 |       jekyll (> 3.5, < 5.0)
177 |       jekyll-seo-tag (~> 2.0)
178 |     jekyll-theme-primer (0.6.0)
179 |       jekyll (> 3.5, < 5.0)
180 |       jekyll-github-metadata (~> 2.9)
181 |       jekyll-seo-tag (~> 2.0)
182 |     jekyll-theme-slate (0.2.0)
183 |       jekyll (> 3.5, < 5.0)
184 |       jekyll-seo-tag (~> 2.0)
185 |     jekyll-theme-tactile (0.2.0)
186 |       jekyll (> 3.5, < 5.0)
187 |       jekyll-seo-tag (~> 2.0)
188 |     jekyll-theme-time-machine (0.2.0)
189 |       jekyll (> 3.5, < 5.0)
190 |       jekyll-seo-tag (~> 2.0)
191 |     jekyll-titles-from-headings (0.5.3)
192 |       jekyll (>= 3.3, < 5.0)
193 |     jekyll-watch (2.2.1)
194 |       listen (~> 3.0)
195 |     jemoji (0.12.0)
196 |       gemoji (~> 3.0)
197 |       html-pipeline (~> 2.2)
198 |       jekyll (>= 3.0, < 5.0)
199 |     just-the-docs (0.5.3)
200 |       jekyll (>= 3.8.5)
201 |       jekyll-seo-tag (>= 2.0)
202 |       rake (>= 12.3.1)
203 |     kramdown (2.3.2)
204 |       rexml
205 |     kramdown-parser-gfm (1.1.0)
206 |       kramdown (~> 2.0)
207 |     liquid (4.0.4)
208 |     listen (3.8.0)
209 |       rb-fsevent (~> 0.10, >= 0.10.3)
210 |       rb-inotify (~> 0.9, >= 0.9.10)
211 |     mercenary (0.3.6)
212 |     minima (2.5.1)
213 |       jekyll (>= 3.5, < 5.0)
214 |       jekyll-feed (~> 0.9)
215 |       jekyll-seo-tag (~> 2.1)
216 |     minitest (5.18.1)
217 |     nokogiri (1.15.2-x86_64-linux)
218 |       racc (~> 1.4)
219 |     octokit (4.25.1)
220 |       faraday (>= 1, < 3)
221 |       sawyer (~> 0.9)
222 |     pathutil (0.16.2)
223 |       forwardable-extended (~> 2.6)
224 |     public_suffix (4.0.7)
225 |     racc (1.7.1)
226 |     rake (13.0.6)
227 |     rb-fsevent (0.11.2)
228 |     rb-inotify (0.10.1)
229 |       ffi (~> 1.0)
230 |     rexml (3.2.5)
231 |     rouge (3.26.0)
232 |     ruby2_keywords (0.0.5)
233 |     rubyzip (2.3.2)
234 |     safe_yaml (1.0.5)
235 |     sass (3.7.4)
236 |       sass-listen (~> 4.0.0)
237 |     sass-listen (4.0.0)
238 |       rb-fsevent (~> 0.9, >= 0.9.4)
239 |       rb-inotify (~> 0.9, >= 0.9.7)
240 |     sawyer (0.9.2)
241 |       addressable (>= 2.3.5)
242 |       faraday (>= 0.17.3, < 3)
243 |     simpleidn (0.2.1)
244 |       unf (~> 0.1.4)
245 |     terminal-table (1.8.0)
246 |       unicode-display_width (~> 1.1, >= 1.1.1)
247 |     typhoeus (1.4.0)
248 |       ethon (>= 0.9.0)
249 |     tzinfo (2.0.6)
250 |       concurrent-ruby (~> 1.0)
251 |     unf (0.1.4)
252 |       unf_ext
253 |     unf_ext (0.0.8.2)
254 |     unicode-display_width (1.8.0)
255 | 
256 | PLATFORMS
257 |   x86_64-linux
258 | 
259 | DEPENDENCIES
260 |   github-pages (~> 228)
261 |   http_parser.rb (~> 0.6.0)
262 |   just-the-docs
263 |   tzinfo (>= 1, < 3)
264 |   tzinfo-data
265 |   wdm (~> 0.1.1)
266 | 
267 | BUNDLED WITH
268 |    2.4.14
269 | 


--------------------------------------------------------------------------------