Skip to content

Commit 210c295

Browse files
RolandGuijtRoland Guijtmaartenba
authored
Explain how Aspire and package management is used with samples (#1139)
* Explain how Aspire and package management is used with samples * Update astro/src/content/docs/identityserver/samples/index.mdx Co-authored-by: Maarten Balliauw <maarten.balliauw@duendesoftware.com> --------- Co-authored-by: Roland Guijt <roland.guijt@gmail.com> Co-authored-by: Maarten Balliauw <maarten.balliauw@duendesoftware.com>
1 parent 3e00b07 commit 210c295

1 file changed

Lines changed: 19 additions & 0 deletions

File tree

  • astro/src/content/docs/identityserver/samples

astro/src/content/docs/identityserver/samples/index.mdx

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,25 @@ Most of the samples include both their own IdentityServer implementation and the
2727
The [_Basics_](/identityserver/samples/basics.mdx) samples use a [shared IdentityServer implementation](https://github.com/DuendeSoftware/Samples/tree/main/IdentityServer/v8/IdentityServerHost).
2828
Some samples use our public [demo instance of IdentityServer](https://demo.duendesoftware.com/).
2929

30+
### Aspire
31+
32+
To simplify local development, many samples include an *Aspire host* project. This eliminates the need to run or debug individual projects manually, and provides a better experience running the samples.
33+
34+
* Launching the `AppHost` project makes sure all projects are started in the correct order
35+
* Relevant projects reference the `Aspire.ServiceDefaults` project, which automatically configures health endpoints and telemetry for the Aspire dashboard.
36+
* If a sample includes a database, you can use the database icon directly inside the Aspire dashboard to create the database and run migrations.
37+
38+
### Package Management
39+
40+
These samples use **Central Package Management**. While individual project files still reference NuGet packages, they do not contain version numbers. Instead, dependency versions are managed in two places:
41+
42+
* **NuGet Packages:** Managed via the `Directory.Packages.props` file located in each IdentityServer and BFF version directory.
43+
* **Aspire SDK:** Centrally defined in the `global.json` file at the repository root.
44+
45+
:::note[Always clone the full samples repository]
46+
Because of this centralized structure, samples will only compile and run correctly if the entire repository is cloned. Downloading individual project folders will result in build errors.
47+
:::
48+
3049
## Feedback
3150

3251
You can [join the Duende developer community](https://github.com/DuendeSoftware/community/discussions) if you are looking for a particular sample and can't find it here.

0 commit comments

Comments
 (0)