Add Azure provisioning and deployment capabilities

Introduced Azure-specific startup mode and added support for provisioning Azure resources such as Container Apps, Event Hubs, Cosmos DB, Application Insights, and more. Updated projects to publish as Azure Container Apps with scaling configurations. Improved resource dependency handling with `.WaitFor()` calls. Added `PublishAsAzureContainerAppJob` for BotQ with event-triggered scaling. Updated SQL Server configuration for `OnPremises` mode. Enhanced `Codebreaker.AppHost.csproj` with new Azure-related NuGet dependencies. Included code cleanup, comments, and TODOs for future improvements.

Author: christiannagel

src/services/host/Codebreaker.AppHost/AppHost.cs

@@ -1,3 +1,7 @@
+using Azure.Provisioning.AppContainers;
+using Azure.Provisioning.EventHubs;
+using Azure.Provisioning.Sql;
+
 var builder = DistributedApplication.CreateBuilder(args);
 
 string dataStore = builder.Configuration["DataStore"] ?? "InMemory";
@@ -17,7 +21,7 @@
     var sqlServer = builder.AddSqlServer("sql")
         .WithDataVolume()
         .PublishAsContainer()
-        .AddDatabase("CodebreakerSql");        
+        .AddDatabase("CodebreakerSql");
 
     var cosmos = builder.AddAzureCosmosDB("codebreakercosmos")
         .AddCosmosDatabase("codebreaker");
@@ -53,6 +57,8 @@
 }
 else
 {
+    builder.AddAzureContainerAppEnvironment("codebreaker-environment");
+
     var logs = builder.AddAzureLogAnalyticsWorkspace("logs");
     var insights = builder.AddAzureApplicationInsights("insights", logs);
     var signalR = builder.AddAzureSignalR("signalr");
@@ -61,7 +67,16 @@
     var botQueue = storage.AddQueues("botqueue");
     var blob = storage.AddBlobs("checkpoints");
 
-    var eventHub = builder.AddAzureEventHubs("codebreakerevents");
+    var eventHub = builder.AddAzureEventHubs("codebreakerevents")
+        .ConfigureInfrastructure(infrastructure =>
+        {
+            var eventHubsNamespace = infrastructure.GetProvisionableResources().OfType<EventHubsNamespace>().Single();
+            eventHubsNamespace.Sku = new EventHubsSku()
+            {
+                Name = EventHubsSkuName.Basic,
+                Tier = EventHubsSkuTier.Basic
+            };
+        });
 
     eventHub.AddHub("games");
 
@@ -75,73 +90,113 @@
 
     // TODO: fix new eventhub namings
     var gameAPIs = builder.AddProject<Projects.Codebreaker_GameAPIs>("gameapis")
-        .WithReference(cosmos)
-        .WithReference(redis)
-        .WithReference(insights)
-        .WithReference(eventHub)
+        .WithReference(cosmos).WaitFor(cosmos)
+        .WithReference(redis).WaitFor(redis)
+        .WithReference(insights).WaitFor(insights)
+        .WithReference(eventHub).WaitFor(eventHub)
         .WithEnvironment("DataStore", dataStore)
-        .WithEnvironment("StartupMode", startupMode);
+        .WithEnvironment("StartupMode", startupMode)
+        .PublishAsAzureContainerApp((module, app) =>
+        {
+            app.Template.Scale.MinReplicas = 0;
+            app.Template.Scale.MaxReplicas = 2;
+        });
 
     var bot = builder.AddProject<Projects.CodeBreaker_Bot>("bot")
-        .WithReference(insights)
-        .WithReference(botQueue)
-        .WithReference(gameAPIs)
+        .WithReference(insights).WaitFor(insights)
+        .WithReference(botQueue).WaitFor(botQueue)
+        .WithReference(gameAPIs).WaitFor(gameAPIs)
         .WithEnvironment("Bot__Loop", botLoop)
         .WithEnvironment("Bot__Delay", botDelay)
-        .WaitFor(gameAPIs);
+        .PublishAsAzureContainerApp((module, app) =>
+        {
+            app.Template.Scale.MinReplicas = 0;
+            app.Template.Scale.MaxReplicas = 1;
+        });
 
     // TODO: change to use BotQ with Container App Jobs
+#pragma warning disable ASPIREAZURE002 // PublishAsAzureContainerAppJob is for evaluation purposes
     var botq = builder.AddProject<Projects.Codebreaker_BotQ>("botq")
-        .WithReference(insights)
-        .WithReference(botQueue)
-        .WithReference(gameAPIs)
+        .WithReference(insights).WaitFor(insights)
+        .WithReference(botQueue).WaitFor(botQueue)
+        .WithReference(gameAPIs).WaitFor(gameAPIs)
         .WithEnvironment("Bot__Loop", botLoop)
         .WithEnvironment("Bot__Delay", botDelay)
-        .WaitFor(gameAPIs);
+        .PublishAsAzureContainerAppJob((_, job) =>
+        {
+            job.Configuration.TriggerType = ContainerAppJobTriggerType.Event;
+            job.Configuration.EventTriggerConfig.Scale.MinExecutions = 1;
+            job.Configuration.EventTriggerConfig.Scale.MaxExecutions = 10;
+            job.Configuration.EventTriggerConfig.Parallelism = 1;
+            job.Configuration.EventTriggerConfig.ReplicaCompletionCount = 1;
+            // TODO: specify scale rule on queue trigger
+            //job.Configuration.EventTriggerConfig.Scale.Rules.Add(new ContainerAppJobScaleRule()
+            //{
+            //    QueueName = botQueue.Resource.Name,
+            //    MessageCount = 1
+            //});
+        });
+#pragma warning restore ASPIREAZURE002
 
     var live = builder.AddProject<Projects.Codebreaker_Live>("live")
         .WithReference(insights)
         .WithReference(eventHub)
         .WithReference(signalR)
         .WaitFor(eventHub)
-        .WaitFor(gameAPIs);
+        .WaitFor(gameAPIs)
+        .PublishAsAzureContainerApp((module, app) =>
+        {
+            app.Template.Scale.MinReplicas = 0;
+            app.Template.Scale.MaxReplicas = 1;
+        });
 
     var ranking = builder.AddProject<Projects.Codebreaker_Ranking>("ranking")
         .WithReference(cosmos)
         .WithReference(insights)
-        .WithReference(eventHub)
+        .WithReference(eventHub).WaitFor(eventHub)
         .WithReference(blob)
-        .WaitFor(eventHub)
         .WaitFor(insights)
-        .WaitFor(gameAPIs);
+        .WaitFor(gameAPIs)
+        .PublishAsAzureContainerApp((module, app) =>
+        {
+            app.Template.Scale.MinReplicas = 0;
+            app.Template.Scale.MaxReplicas = 1;
+        });
 
     var users = builder.AddProject<Projects.CodeBreaker_UserService>("users")
         .WithReference(insights)
         .WithReference(userServiceKeyvault)
         .WaitFor(insights)
-        .WaitFor(userServiceKeyvault);
+        .WaitFor(userServiceKeyvault)
+        .PublishAsAzureContainerApp((module, app) =>
+        {
+            app.Template.Scale.MinReplicas = 0;
+            app.Template.Scale.MaxReplicas = 1;
+        });
 
     var gateway = builder.AddProject<Projects.Codebreaker_ApiGateway>("gateway")
         .WithExternalHttpEndpoints()
-        .WithReference(gameAPIs)
-        .WithReference(live)
-        .WithReference(ranking)
-        .WithReference(users)
-        .WithReference(gatewayKeyvault)
-        .WithReference(insights)
-        .WaitFor(gameAPIs)
-        .WaitFor(live)
-        .WaitFor(ranking)
-        .WaitFor(users)
-        .WaitFor(gatewayKeyvault)
-        .WaitFor(insights);
+        .WithReference(gameAPIs).WaitFor(gameAPIs)
+        .WithReference(live).WaitFor(live)
+        .WithReference(ranking).WaitFor(ranking)
+        .WithReference(users).WaitFor(users)
+        .WithReference(gatewayKeyvault).WaitFor(gatewayKeyvault)
+        .WithReference(insights).WaitFor(insights)
+        .PublishAsAzureContainerApp((module, app) =>
+        {
+            app.Template.Scale.MinReplicas = 0;
+            app.Template.Scale.MaxReplicas = 2;
+        });
 
     builder.AddProject<Projects.CodeBreaker_Blazor>("blazor")
         .WithExternalHttpEndpoints()
-        .WithReference(gateway)
-        .WithReference(insights)
-        .WaitFor(gateway)
-        .WaitFor(insights);
+        .WithReference(gateway).WaitFor(gateway)
+        .WithReference(insights).WaitFor(insights)
+        .PublishAsAzureContainerApp((module, app) =>
+        {
+            app.Template.Scale.MinReplicas = 0;
+            app.Template.Scale.MaxReplicas = 1;
+        });
 }
 
 builder.Build().Run();

src/services/host/Codebreaker.AppHost/Codebreaker.AppHost.csproj

@@ -14,6 +14,7 @@
     <PackageReference Include="Aspire.Hosting.AppHost" />
     <PackageReference Include="Aspire.Hosting.Azure" />
     <PackageReference Include="Aspire.Hosting.Azure.AppConfiguration" />
+    <PackageReference Include="Aspire.Hosting.Azure.AppContainers" />
     <PackageReference Include="Aspire.Hosting.Azure.ApplicationInsights" />
     <PackageReference Include="Aspire.Hosting.Azure.CosmosDB" />
     <PackageReference Include="Aspire.Hosting.Azure.EventHubs" />