Skip to content

Add WithImageTag example to SQL Server integration documentation #109

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
David Pine (IEvangelist) merged 4 commits into from
Dec 5, 2025
Merged

Add WithImageTag example to SQL Server integration documentation #109

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
6c0f05a
Initial plan
Copilot Dec 2, 2025
fa8ff58
Add WithImageTag example to SQL Server integration documentation
Copilot Dec 2, 2025
a9d92f9
Update SQL Server image tag to 2025-RTM-ubuntu-24.04-preview
Copilot Dec 3, 2025
8b55aca
Update src/frontend/src/content/docs/integrations/databases/sql-serve…
IEvangelist Dec 4, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 23 additions & 0 deletions src/frontend/src/content/docs/integrations/databases/sql-server.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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("2025-RTM-ubuntu-24.04-preview");

var db = sql.AddDatabase("database");

builder.AddProject<Projects.AspireApp_ExampleProject>("exampleproject")
.WithReference(db)
.WaitFor(db);

// After adding all resources, run the app...

builder.Build().Run();
```

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).
Comment thread
IEvangelist marked this conversation as resolved.

### 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.
Expand Down
Loading