From 6c0f05a650310692491718e0bdcddc90f89bfe80 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 2 Dec 2025 16:31:56 +0000 Subject: [PATCH 1/4] Initial plan From fa8ff58abe630c313a2dba0e281cc42d5a840c6b Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 2 Dec 2025 16:44:34 +0000 Subject: [PATCH 2/4] Add WithImageTag example to SQL Server integration documentation Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com> --- .../integrations/databases/sql-server.mdx | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/src/frontend/src/content/docs/integrations/databases/sql-server.mdx b/src/frontend/src/content/docs/integrations/databases/sql-server.mdx index 319a8a598..9b9b3ff2a 100644 --- a/src/frontend/src/content/docs/integrations/databases/sql-server.mdx +++ b/src/frontend/src/content/docs/integrations/databases/sql-server.mdx @@ -214,6 +214,29 @@ builder.Build().Run(); For more information on providing parameters, see [External parameters](/get-started/resources/). +### Use a specific SQL Server container image tag + +If you want to use a specific tag for the SQL Server container image, you can call the `WithImageTag` method to override the default tag. This is useful when you need to test against a specific version of SQL Server: + +```csharp title="C# — AppHost.cs" +var builder = DistributedApplication.CreateBuilder(args); + +var sql = builder.AddSqlServer("sql") + .WithImageTag("2019-latest"); + +var db = sql.AddDatabase("database"); + +builder.AddProject("exampleproject") + .WithReference(db) + .WaitFor(db); + +// After adding all resources, run the app... + +builder.Build().Run(); +``` + +The preceding code uses the `2019-latest` tag for the SQL Server container image. For a list of available tags, see [SQL Server container image tags](https://mcr.microsoft.com/en-us/artifact/mar/mssql/server/tags). + ### Connect to database resources When the Aspire AppHost runs, the server's database resources can be accessed from external tools, such as [SQL Server Management Studio (SSMS)](https://learn.microsoft.com/sql/ssms/download-sql-server-management-studio-ssms) or [MSSQL for Visual Studio Code](https://learn.microsoft.com/sql/tools/visual-studio-code-extensions/mssql/mssql-extension-visual-studio-code). The connection string for the database resource is available in the dependent resources environment variables and is accessed using the [Aspire dashboard: Resource details](/dashboard/explore/#resource-details) pane. The environment variable is named `ConnectionStrings__{name}` where `{name}` is the name of the database resource, in this example it's `database`. Use the connection string to connect to the database resource from external tools. Imagine that you have a database named `todos` with a single `dbo.Todos` table. From a9d92f9ff507e922bb5a9ba79375c2019ff63230 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 3 Dec 2025 00:38:03 +0000 Subject: [PATCH 3/4] Update SQL Server image tag to 2025-RTM-ubuntu-24.04-preview Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com> --- .../src/content/docs/integrations/databases/sql-server.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/frontend/src/content/docs/integrations/databases/sql-server.mdx b/src/frontend/src/content/docs/integrations/databases/sql-server.mdx index 9b9b3ff2a..049548b86 100644 --- a/src/frontend/src/content/docs/integrations/databases/sql-server.mdx +++ b/src/frontend/src/content/docs/integrations/databases/sql-server.mdx @@ -222,7 +222,7 @@ If you want to use a specific tag for the SQL Server container image, you can ca var builder = DistributedApplication.CreateBuilder(args); var sql = builder.AddSqlServer("sql") - .WithImageTag("2019-latest"); + .WithImageTag("2025-RTM-ubuntu-24.04-preview"); var db = sql.AddDatabase("database"); @@ -235,7 +235,7 @@ builder.AddProject("exampleproject") builder.Build().Run(); ``` -The preceding code uses the `2019-latest` tag for the SQL Server container image. For a list of available tags, see [SQL Server container image tags](https://mcr.microsoft.com/en-us/artifact/mar/mssql/server/tags). +The preceding code uses the `2025-RTM-ubuntu-24.04-preview` tag for the SQL Server container image. For a list of available tags, see [SQL Server container image tags](https://mcr.microsoft.com/en-us/artifact/mar/mssql/server/tags). ### Connect to database resources From 8b55aca58d34354c3196a6beaac1eafd2731469d Mon Sep 17 00:00:00 2001 From: David Pine Date: Thu, 4 Dec 2025 06:47:08 -0600 Subject: [PATCH 4/4] Update src/frontend/src/content/docs/integrations/databases/sql-server.mdx Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- .../src/content/docs/integrations/databases/sql-server.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/frontend/src/content/docs/integrations/databases/sql-server.mdx b/src/frontend/src/content/docs/integrations/databases/sql-server.mdx index 049548b86..1e3f6126b 100644 --- a/src/frontend/src/content/docs/integrations/databases/sql-server.mdx +++ b/src/frontend/src/content/docs/integrations/databases/sql-server.mdx @@ -226,7 +226,7 @@ var sql = builder.AddSqlServer("sql") var db = sql.AddDatabase("database"); -builder.AddProject("exampleproject") +builder.AddProject("exampleproject") .WithReference(db) .WaitFor(db);