Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
In Aspire 9.1, the default container image name and tag assigned to the container resource when using AddDockerfile or WithDockerfile changed. This change affects how container images are named and tagged by default, improving consistency and safety.
Version introduced
Aspire 9.1
Previous behavior
In Aspire 9.0:
- The default container image name used was based on this format:
{ResourceName}-image-{HashOfAppHostDirectory} - The default container tag used was simply
latest
New behavior
In Aspire 9.1:
- The default container image name used is now simply the resource name lowercased.
- The default container tag used is now a hash derived from the AppHost directory combined with a timestamp of when the method was called.
Type of breaking change
This change is a behavioral change.
Reason for change
The previous behavior led to a bug. The resource name wasn't properly sanitized, resulting in unsafe, and unfriendly container image names. Additionally, tagging all images as latest made it difficult to manage and roll back deployments.
Recommended action
Users should update any deployment tools, scripts, and processes to accommodate the new image names and tags.
Note
The default image name and tag can be overridden by calling WithImage and WithImageTag on the IResourceBuilder<ContainerResource> respectively.
Affected APIs
Collaborate with us on GitHub
The source for this content can be found on GitHub, where you can also create and review issues and pull requests. For more information, see our contributor guide.
