microsoft / microsoft/aspire.dev

Getting Started - Tutorial Content

Open
#53 4 comments 0 reactions 1 assignee View on GitHub

@IEvangelist is already working on this.

Since Jun 2, 2026.

Dominant language
MDX
Stars
193
Forks
87
Avg merge
1d 22h
Merged PRs (30d)
73

Description

I am trying to train many people in my group to adopt Aspire, and have the pay-for-play experience:

  1. Adding Aspire to an existing Application
  2. Create custom resource
  3. Publishing
  4. E2E tests

I want them to learn these skills one at a time, and only when they need to. To do so, I would love to just share a link to the website for each topic during training.

Adding Aspire to an existing Application

I think that migration guides from docker-compose.yaml, helm charts, etc. are in place.

Custom Resource

Currently, the docs do not contain easy to follow Custom Resource creation, with a "real" resource.

The only doc showing what a custom resource looks like is: Resource Examples.

This doc isn't a step by step guide on how to create a resource.

There should be a Create Your First Custom Resource [Tutorial] right next to Create Your First App.

Publishing

I am interested in k8s helm charts, docker build && push to registry in CI.

I know that k8s is going to be rewritten.

The docker build && push in CI is a really cool use case for Aspire as it makes it so there is only one place in the code that knows where all the docker files (or dynamically created docker files) exist, and how to build them.

But I have no idea how to do this.

E2E testing

There are currently no docs for how to use Aspire for E2E testing using the testing package, including how to wire this up in CI.

Thanks! Love the Website :)

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.