Fix markdown syntax violations (#5768)
This commit is contained in:
Michael Simons
GitHub
Родитель
b3777fd51e
Коммит
4fe4aeb2b5
|
|
@ -5,12 +5,4 @@
|
|||
"siblings_only": true
|
||||
},
|
||||
"MD033": false, // no inline HTML
|
||||
|
||||
// The following rules are disabled to allow the linter to be enabled.
|
||||
// Follow-up work will be done to enable these rules and clean up the violations.
|
||||
"MD001": false, // heading-increment Heading levels should only increment by one level at a time
|
||||
"MD022": false, // blanks-around-headings Headings should be surrounded by blank lines
|
||||
"MD025": false, // single-title/single-h1 Multiple top-level headings in the same document
|
||||
"MD034": false, // no-bare-urls Bare URL used
|
||||
"MD041": false, // first-line-heading/first-line-h1 First line in a file should be a top-level heading
|
||||
}
|
||||
|
|
|
|||
|
|
@ -1,15 +1,17 @@
|
|||
# Featured Tags
|
||||
# .NET Aspire Dashboard
|
||||
|
||||
## Featured Tags
|
||||
|
||||
* `8.1`
|
||||
* `docker pull mcr.microsoft.com/dotnet/aspire-dashboard:8.1`
|
||||
|
||||
# About
|
||||
## About
|
||||
|
||||
This image contains the .NET Aspire Dashboard.
|
||||
|
||||
Watch [discussions](https://github.com/dotnet/dotnet-docker/discussions/categories/announcements) for Docker-related .NET announcements.
|
||||
|
||||
# Usage
|
||||
## Usage
|
||||
|
||||
The .NET Aspire Dashboard is a browser-based app to view run-time information about your distributed application.
|
||||
|
||||
|
|
@ -19,7 +21,7 @@ The dashboard shows:
|
|||
* Live console logs of resources.
|
||||
* Live telemetry, such as structured logs, traces and metrics.
|
||||
|
||||
## Configuration
|
||||
### Configuration
|
||||
|
||||
The dashboard must be configured when it is started. The configuration is done via environment variables. The following environment variables are supported:
|
||||
|
||||
|
|
@ -29,7 +31,7 @@ The dashboard must be configured when it is started. The configuration is done v
|
|||
* `DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS` specifies the dashboard doesn't use authentication and accepts anonymous access. This setting is a shortcut to configuring `Dashboard:Frontend:AuthMode` and `Dashboard:Otlp:AuthMode` to `Unsecured`.
|
||||
* `DOTNET_DASHBOARD_CONFIG_FILE_PATH` specifies the path for an optional JSON configuration file.
|
||||
|
||||
### Frontend authentication
|
||||
#### Frontend authentication
|
||||
|
||||
The dashboard's frontend supports OpenID Connect (OIDC). Set `Dashboard__Frontend__AuthMode` to `OpenIdConnect`, then add the following configuration:
|
||||
|
||||
|
|
@ -40,7 +42,7 @@ The dashboard's frontend supports OpenID Connect (OIDC). Set `Dashboard__Fronten
|
|||
|
||||
It may also be run unsecured. Set `Dashboard__Frontend__AuthMode` to `Unsecured`. The frontend endpoint will allow anonymous access. This setting is used during local development, but is not recommended if you attempt to host the dashboard in other settings.
|
||||
|
||||
## OTLP authentication
|
||||
### OTLP authentication
|
||||
|
||||
The OTLP endpoint can be secured with [client certificate](https://learn.microsoft.com/aspnet/core/security/authentication/certauth) or API key authentication.
|
||||
|
||||
|
|
@ -53,7 +55,7 @@ For API key authentication, set `Dashboard__Otlp__AuthMode` to `ApiKey`, then ad
|
|||
|
||||
It may also be run unsecured. Set `Dashboard__Otlp__AuthMode` to `Unsecured`. The OTLP endpoint will allow anonymous access. This setting is used during local development, but is not recommended if you attempt to host the dashboard in other settings.
|
||||
|
||||
## Resources
|
||||
### Resources
|
||||
|
||||
* `Dashboard__ResourceServiceClient__Url` specifies the gRPC endpoint to which the dashboard connects for its data. There's no default. If this variable is unspecified, the dashboard shows OTEL data but no resource list or console logs.
|
||||
|
||||
|
|
@ -70,7 +72,7 @@ The resource service client supports certificates. Set `Dashboard__ResourceServi
|
|||
|
||||
To opt-out of authentication, set `Dashboard__ResourceServiceClient__AuthMode` to `Unsecured`. This completely disables all security for the resource service client. This setting is used during local development, but is not recommended if you attempt to host the dashboard in other settings.
|
||||
|
||||
### Telemetry Limits
|
||||
#### Telemetry Limits
|
||||
|
||||
Telemetry is stored in-memory. To avoid excessive memory usage, the dashboard has limits on the count and size of stored telemetry. When a count limit is reached, new telemetry is added, and the oldest telemetry is removed. When a size limit is reached, data is truncated to the limit.
|
||||
|
||||
|
|
@ -83,11 +85,11 @@ Telemetry is stored in-memory. To avoid excessive memory usage, the dashboard ha
|
|||
|
||||
Limits are per-resource. For example, a `MaxLogCount` value of 10,000 configures the dashboard to store up to 10,000 log entries per-resource.
|
||||
|
||||
## Other
|
||||
### Other
|
||||
|
||||
* `Dashboard__ApplicationName` specifies the application name to be displayed in the UI. This applies only when no resource service URL is specified. When a resource service exists, the service specifies the application name.
|
||||
|
||||
# Related Repositories
|
||||
## Related Repositories
|
||||
|
||||
.NET:
|
||||
|
||||
|
|
@ -105,7 +107,7 @@ Limits are per-resource. For example, a `MaxLogCount` value of 10,000 configures
|
|||
* [dotnet/framework](https://hub.docker.com/r/microsoft/dotnet-framework/): .NET Framework, ASP.NET and WCF
|
||||
* [dotnet/framework/samples](https://hub.docker.com/r/microsoft/dotnet-framework-samples/): .NET Framework, ASP.NET and WCF Samples
|
||||
|
||||
# Full Tag Listing
|
||||
## Full Tag Listing
|
||||
|
||||
### Linux amd64 Tags
|
||||
|
||||
|
|
@ -120,23 +122,23 @@ Tags | Dockerfile | OS Version
|
|||
8.1.0-arm64v8, 8.1-arm64v8, 8-arm64v8, 8.1.0, 8.1, 8, latest | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/aspire-dashboard/8.1/cbl-mariner-distroless/arm64v8/Dockerfile) | CBL-Mariner 2.0
|
||||
<!--End of generated tags-->
|
||||
|
||||
*Tags not listed in the table above are not supported. See the [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md)*
|
||||
*Tags not listed in the table above are not supported. See the [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md). See the [full list of tags](https://mcr.microsoft.com/v2/dotnet/aspire-dashboard/tags/list) for all supported and unsupported tags.*
|
||||
|
||||
# Support
|
||||
## Support
|
||||
|
||||
## Lifecycle
|
||||
### Lifecycle
|
||||
|
||||
* [Microsoft Support for .NET](https://github.com/dotnet/core/blob/main/support.md)
|
||||
* [Supported Container Platforms Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md)
|
||||
* [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md)
|
||||
|
||||
## Image Update Policy
|
||||
### Image Update Policy
|
||||
|
||||
* We update supported .NET images within 12 hours of any updates to their base images (e.g. debian:bookworm-slim, windows/nanoserver:ltsc2022, etc.).
|
||||
* We re-build all .NET images as part of releasing new versions of .NET including new major/minor versions and servicing.
|
||||
* Distroless images such as Ubuntu Chiseled have no base image, and as such will only be updated with .NET releases and CVE fixes as described below.
|
||||
|
||||
### CVE Update Policy
|
||||
#### CVE Update Policy
|
||||
|
||||
.NET container images are regularly monitored for the presence of CVEs. A given image will be rebuilt to pick up fixes for a CVE when:
|
||||
|
||||
|
|
@ -146,12 +148,12 @@ Tags | Dockerfile | OS Version
|
|||
|
||||
Please refer to the [Security Policy](https://github.com/dotnet/dotnet-docker/blob/main/SECURITY.md) and [Container Vulnerability Workflow](https://github.com/dotnet/dotnet-docker/blob/main/documentation/vulnerability-reporting.md) for more detail about what to do when a CVE is encountered in a .NET image.
|
||||
|
||||
## Feedback
|
||||
### Feedback
|
||||
|
||||
* [File an issue](https://github.com/dotnet/dotnet-docker/issues/new/choose)
|
||||
* [Contact Microsoft Support](https://support.microsoft.com/contactus/)
|
||||
|
||||
# License
|
||||
## License
|
||||
|
||||
* Legal Notice: [Container License Information](https://aka.ms/mcr/osslegalnotice)
|
||||
* [.NET license](https://github.com/dotnet/dotnet-docker/blob/main/LICENSE)
|
||||
|
|
|
|||
|
|
@ -1,33 +1,35 @@
|
|||
# Featured Tags
|
||||
# ASP.NET Core Runtime
|
||||
|
||||
## Featured Tags
|
||||
|
||||
* `8.0` (Long-Term Support)
|
||||
* `docker pull mcr.microsoft.com/dotnet/aspnet:8.0`
|
||||
* `6.0` (Long-Term Support)
|
||||
* `docker pull mcr.microsoft.com/dotnet/aspnet:6.0`
|
||||
|
||||
# About
|
||||
## About
|
||||
|
||||
This image contains the ASP.NET Core and .NET runtimes and libraries and is optimized for running ASP.NET Core apps in production.
|
||||
|
||||
Watch [discussions](https://github.com/dotnet/dotnet-docker/discussions/categories/announcements) for Docker-related .NET announcements.
|
||||
|
||||
## New: Ubuntu Chiseled Images
|
||||
### New: Ubuntu Chiseled Images
|
||||
|
||||
Ubuntu Chiseled .NET images are a type of "distroless" container image that contain only the minimal set of packages .NET needs, with everything else removed.
|
||||
These images offer dramatically smaller deployment sizes and attack surface by including only the minimal set of packages required to run .NET applications.
|
||||
|
||||
Please see the [Ubuntu Chiseled + .NET](https://github.com/dotnet/dotnet-docker/blob/main/documentation/ubuntu-chiseled.md) documentation page for more info.
|
||||
|
||||
## ASP.NET Core Composite Images
|
||||
### ASP.NET Core Composite Images
|
||||
|
||||
Starting from .NET 8, ASP.NET Core Composite images are optimized for performance using [ReadyToRun (R2R) compilation](https://learn.microsoft.com/dotnet/core/deploying/ready-to-run).
|
||||
For more information, see the [composite images section in the Image Variants documentation](https://github.com/dotnet/dotnet-docker/blob/main/documentation/image-variants.md#composite-net-80).
|
||||
|
||||
# Usage
|
||||
## Usage
|
||||
|
||||
The [.NET Docker samples](https://github.com/dotnet/dotnet-docker/blob/main/samples/README.md) show various ways to use .NET and Docker together. See [Building Docker Images for .NET Applications](https://docs.microsoft.com/dotnet/core/docker/building-net-docker-images) to learn more.
|
||||
|
||||
## Container sample: Run a web application
|
||||
### Container sample: Run a web application
|
||||
|
||||
You can quickly run a container with a pre-built [.NET Docker image](https://hub.docker.com/r/microsoft/dotnet-samples/), based on the [ASP.NET Core sample](https://github.com/dotnet/dotnet-docker/blob/main/samples/aspnetapp/README.md).
|
||||
|
||||
|
|
@ -43,12 +45,12 @@ After the application starts, navigate to `http://localhost:8000` in your web br
|
|||
|
||||
See [Hosting ASP.NET Core Images with Docker over HTTPS](https://github.com/dotnet/dotnet-docker/blob/main/samples/host-aspnetcore-https.md) to use HTTPS with this image.
|
||||
|
||||
# Image Variants
|
||||
## Image Variants
|
||||
|
||||
.NET container images have several variants that offer different combinations of flexibility and deployment size.
|
||||
The [Image Variants documentation](https://github.com/dotnet/dotnet-docker/blob/main/documentation/image-variants.md) contains a summary of the image variants and their use-cases.
|
||||
|
||||
# Related Repositories
|
||||
## Related Repositories
|
||||
|
||||
.NET:
|
||||
|
||||
|
|
@ -66,7 +68,7 @@ The [Image Variants documentation](https://github.com/dotnet/dotnet-docker/blob/
|
|||
* [dotnet/framework](https://hub.docker.com/r/microsoft/dotnet-framework/): .NET Framework, ASP.NET and WCF
|
||||
* [dotnet/framework/samples](https://hub.docker.com/r/microsoft/dotnet-framework-samples/): .NET Framework, ASP.NET and WCF Samples
|
||||
|
||||
# Full Tag Listing
|
||||
## Full Tag Listing
|
||||
|
||||
### Linux amd64 Tags
|
||||
|
||||
|
|
@ -273,23 +275,23 @@ Tag | Dockerfile
|
|||
9.0.0-preview.7-windowsservercore-ltsc2019, 9.0-preview-windowsservercore-ltsc2019 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/aspnet/9.0/windowsservercore-ltsc2019/amd64/Dockerfile)
|
||||
<!--End of generated tags-->
|
||||
|
||||
*Tags not listed in the table above are not supported. See the [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md)*
|
||||
*Tags not listed in the table above are not supported. See the [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md). See the [full list of tags](https://mcr.microsoft.com/v2/dotnet/aspnet/tags/list) for all supported and unsupported tags.*
|
||||
|
||||
# Support
|
||||
## Support
|
||||
|
||||
## Lifecycle
|
||||
### Lifecycle
|
||||
|
||||
* [Microsoft Support for .NET](https://github.com/dotnet/core/blob/main/support.md)
|
||||
* [Supported Container Platforms Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md)
|
||||
* [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md)
|
||||
|
||||
## Image Update Policy
|
||||
### Image Update Policy
|
||||
|
||||
* We update supported .NET images within 12 hours of any updates to their base images (e.g. debian:bookworm-slim, windows/nanoserver:ltsc2022, etc.).
|
||||
* We re-build all .NET images as part of releasing new versions of .NET including new major/minor versions and servicing.
|
||||
* Distroless images such as Ubuntu Chiseled have no base image, and as such will only be updated with .NET releases and CVE fixes as described below.
|
||||
|
||||
### CVE Update Policy
|
||||
#### CVE Update Policy
|
||||
|
||||
.NET container images are regularly monitored for the presence of CVEs. A given image will be rebuilt to pick up fixes for a CVE when:
|
||||
|
||||
|
|
@ -299,12 +301,12 @@ Tag | Dockerfile
|
|||
|
||||
Please refer to the [Security Policy](https://github.com/dotnet/dotnet-docker/blob/main/SECURITY.md) and [Container Vulnerability Workflow](https://github.com/dotnet/dotnet-docker/blob/main/documentation/vulnerability-reporting.md) for more detail about what to do when a CVE is encountered in a .NET image.
|
||||
|
||||
## Feedback
|
||||
### Feedback
|
||||
|
||||
* [File an issue](https://github.com/dotnet/dotnet-docker/issues/new/choose)
|
||||
* [Contact Microsoft Support](https://support.microsoft.com/contactus/)
|
||||
|
||||
# License
|
||||
## License
|
||||
|
||||
* Legal Notice: [Container License Information](https://aka.ms/mcr/osslegalnotice)
|
||||
* [.NET license](https://github.com/dotnet/dotnet-docker/blob/main/LICENSE)
|
||||
|
|
|
|||
30
README.md
30
README.md
|
|
@ -1,4 +1,6 @@
|
|||
# Featured Repos
|
||||
# .NET
|
||||
|
||||
## Featured Repos
|
||||
|
||||
* [dotnet/sdk](https://hub.docker.com/r/microsoft/dotnet-sdk/): .NET SDK
|
||||
* [dotnet/aspnet](https://hub.docker.com/r/microsoft/dotnet-aspnet/): ASP.NET Core Runtime
|
||||
|
|
@ -8,7 +10,7 @@
|
|||
* [dotnet/aspire-dashboard](https://hub.docker.com/r/microsoft/dotnet-aspire-dashboard/): .NET Aspire Dashboard
|
||||
* [dotnet/samples](https://hub.docker.com/r/microsoft/dotnet-samples/): .NET Samples
|
||||
|
||||
# About
|
||||
## About
|
||||
|
||||
[.NET](https://docs.microsoft.com/dotnet/core/) is a general purpose development platform maintained by Microsoft and the .NET community on [GitHub](https://github.com/dotnet/core). It is cross-platform, supports Windows, macOS, and Linux, and can be used in device, cloud, and embedded/IoT scenarios.
|
||||
|
||||
|
|
@ -27,18 +29,18 @@ You are invited to [contribute new features](https://github.com/dotnet/core/blob
|
|||
|
||||
Watch [discussions](https://github.com/dotnet/dotnet-docker/discussions/categories/announcements) for Docker-related .NET announcements.
|
||||
|
||||
## New: Ubuntu Chiseled Images
|
||||
### New: Ubuntu Chiseled Images
|
||||
|
||||
Ubuntu Chiseled .NET images are a type of "distroless" container image that contain only the minimal set of packages .NET needs, with everything else removed.
|
||||
These images offer dramatically smaller deployment sizes and attack surface by including only the minimal set of packages required to run .NET applications.
|
||||
|
||||
Please see the [Ubuntu Chiseled + .NET](https://github.com/dotnet/dotnet-docker/blob/main/documentation/ubuntu-chiseled.md) documentation page for more info.
|
||||
|
||||
# Usage
|
||||
## Usage
|
||||
|
||||
The [.NET Docker samples](https://github.com/dotnet/dotnet-docker/blob/main/samples/README.md) show various ways to use .NET and Docker together. See [Building Docker Images for .NET Applications](https://docs.microsoft.com/dotnet/core/docker/building-net-docker-images) to learn more.
|
||||
|
||||
## Container sample: Run a simple application
|
||||
### Container sample: Run a simple application
|
||||
|
||||
You can quickly run a container with a pre-built [.NET Docker image](https://hub.docker.com/r/microsoft/dotnet-samples/), based on the [.NET console sample](https://github.com/dotnet/dotnet-docker/blob/main/samples/dotnetapp/README.md).
|
||||
|
||||
|
|
@ -48,7 +50,7 @@ Type the following command to run a sample console application:
|
|||
docker run --rm mcr.microsoft.com/dotnet/samples
|
||||
```
|
||||
|
||||
## Container sample: Run a web application
|
||||
### Container sample: Run a web application
|
||||
|
||||
You can quickly run a container with a pre-built [.NET Docker image](https://hub.docker.com/r/microsoft/dotnet-samples/), based on the [ASP.NET Core sample](https://github.com/dotnet/dotnet-docker/blob/main/samples/aspnetapp/README.md).
|
||||
|
||||
|
|
@ -64,12 +66,12 @@ After the application starts, navigate to `http://localhost:8000` in your web br
|
|||
|
||||
See [Hosting ASP.NET Core Images with Docker over HTTPS](https://github.com/dotnet/dotnet-docker/blob/main/samples/host-aspnetcore-https.md) to use HTTPS with this image.
|
||||
|
||||
# Image Variants
|
||||
## Image Variants
|
||||
|
||||
.NET container images have several variants that offer different combinations of flexibility and deployment size.
|
||||
The [Image Variants documentation](https://github.com/dotnet/dotnet-docker/blob/main/documentation/image-variants.md) contains a summary of the image variants and their use-cases.
|
||||
|
||||
# Related Repositories
|
||||
## Related Repositories
|
||||
|
||||
.NET:
|
||||
|
||||
|
|
@ -85,21 +87,21 @@ The [Image Variants documentation](https://github.com/dotnet/dotnet-docker/blob/
|
|||
* [dotnet/framework](https://hub.docker.com/r/microsoft/dotnet-framework/): .NET Framework, ASP.NET and WCF
|
||||
* [dotnet/framework/samples](https://hub.docker.com/r/microsoft/dotnet-framework-samples/): .NET Framework, ASP.NET and WCF Samples
|
||||
|
||||
# Support
|
||||
## Support
|
||||
|
||||
## Lifecycle
|
||||
### Lifecycle
|
||||
|
||||
* [Microsoft Support for .NET](https://github.com/dotnet/core/blob/main/support.md)
|
||||
* [Supported Container Platforms Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md)
|
||||
* [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md)
|
||||
|
||||
## Image Update Policy
|
||||
### Image Update Policy
|
||||
|
||||
* We update supported .NET images within 12 hours of any updates to their base images (e.g. debian:bookworm-slim, windows/nanoserver:ltsc2022, etc.).
|
||||
* We re-build all .NET images as part of releasing new versions of .NET including new major/minor versions and servicing.
|
||||
* Distroless images such as Ubuntu Chiseled have no base image, and as such will only be updated with .NET releases and CVE fixes as described below.
|
||||
|
||||
### CVE Update Policy
|
||||
#### CVE Update Policy
|
||||
|
||||
.NET container images are regularly monitored for the presence of CVEs. A given image will be rebuilt to pick up fixes for a CVE when:
|
||||
|
||||
|
|
@ -109,12 +111,12 @@ The [Image Variants documentation](https://github.com/dotnet/dotnet-docker/blob/
|
|||
|
||||
Please refer to the [Security Policy](https://github.com/dotnet/dotnet-docker/blob/main/SECURITY.md) and [Container Vulnerability Workflow](https://github.com/dotnet/dotnet-docker/blob/main/documentation/vulnerability-reporting.md) for more detail about what to do when a CVE is encountered in a .NET image.
|
||||
|
||||
## Feedback
|
||||
### Feedback
|
||||
|
||||
* [File an issue](https://github.com/dotnet/dotnet-docker/issues/new/choose)
|
||||
* [Contact Microsoft Support](https://support.microsoft.com/contactus/)
|
||||
|
||||
# License
|
||||
## License
|
||||
|
||||
* Legal Notice: [Container License Information](https://aka.ms/mcr/osslegalnotice)
|
||||
* [.NET license](https://github.com/dotnet/dotnet-docker/blob/main/LICENSE)
|
||||
|
|
|
|||
|
|
@ -1,9 +1,11 @@
|
|||
# Featured Tags
|
||||
# .NET Monitor Base
|
||||
|
||||
## Featured Tags
|
||||
|
||||
* `8` (Long-Term Support)
|
||||
* `docker pull mcr.microsoft.com/dotnet/monitor/base:8`
|
||||
|
||||
# About
|
||||
## About
|
||||
|
||||
This image contains the .NET Monitor Base installation.
|
||||
|
||||
|
|
@ -11,25 +13,25 @@ Use this image as a base image for building a .NET Monitor image with extensions
|
|||
|
||||
Watch [discussions](https://github.com/dotnet/dotnet-docker/discussions/categories/announcements) for Docker-related .NET announcements.
|
||||
|
||||
## New: Ubuntu Chiseled Images
|
||||
### New: Ubuntu Chiseled Images
|
||||
|
||||
Ubuntu Chiseled .NET images are a type of "distroless" container image that contain only the minimal set of packages .NET needs, with everything else removed.
|
||||
These images offer dramatically smaller deployment sizes and attack surface by including only the minimal set of packages required to run .NET applications.
|
||||
|
||||
Please see the [Ubuntu Chiseled + .NET](https://github.com/dotnet/dotnet-docker/blob/main/documentation/ubuntu-chiseled.md) documentation page for more info.
|
||||
|
||||
# Usage
|
||||
## Usage
|
||||
|
||||
The [.NET Docker samples](https://github.com/dotnet/dotnet-docker/blob/main/samples/README.md) show various ways to use .NET and Docker together. See [Building Docker Images for .NET Applications](https://docs.microsoft.com/dotnet/core/docker/building-net-docker-images) to learn more.
|
||||
|
||||
## Building a Custom .NET Monitor Image
|
||||
### Building a Custom .NET Monitor Image
|
||||
|
||||
The following Dockerfiles demonstrate how you can use this base image to build a .NET Monitor image with a custom set of extensions.
|
||||
|
||||
* [Ubuntu Chiseled - amd64](https://github.com/dotnet/dotnet-docker/blob/main/src/monitor/8.0/ubuntu-chiseled/amd64/Dockerfile)
|
||||
* [Ubuntu Chiseled - arm64v8](https://github.com/dotnet/dotnet-docker/blob/main/src/monitor/8.0/ubuntu-chiseled/arm64v8/Dockerfile)
|
||||
|
||||
# Related Repositories
|
||||
## Related Repositories
|
||||
|
||||
.NET:
|
||||
|
||||
|
|
@ -48,7 +50,7 @@ The following Dockerfiles demonstrate how you can use this base image to build a
|
|||
* [dotnet/framework](https://hub.docker.com/r/microsoft/dotnet-framework/): .NET Framework, ASP.NET and WCF
|
||||
* [dotnet/framework/samples](https://hub.docker.com/r/microsoft/dotnet-framework-samples/): .NET Framework, ASP.NET and WCF Samples
|
||||
|
||||
# Full Tag Listing
|
||||
## Full Tag Listing
|
||||
|
||||
### Linux amd64 Tags
|
||||
|
||||
|
|
@ -77,23 +79,23 @@ Tags | Dockerfile | OS Version
|
|||
9.0.0-preview.7-arm64v8, 9.0-preview-arm64v8, 9.0.0-preview.7, 9.0-preview, 9-preview | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/monitor-base/9.0/azurelinux-distroless/arm64v8/Dockerfile) | Azure Linux 3.0
|
||||
<!--End of generated tags-->
|
||||
|
||||
*Tags not listed in the table above are not supported. See the [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md)*
|
||||
*Tags not listed in the table above are not supported. See the [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md). See the [full list of tags](https://mcr.microsoft.com/v2/dotnet/monitor/base/tags/list) for all supported and unsupported tags.*
|
||||
|
||||
# Support
|
||||
## Support
|
||||
|
||||
## Lifecycle
|
||||
### Lifecycle
|
||||
|
||||
* [Microsoft Support for .NET](https://github.com/dotnet/core/blob/main/support.md)
|
||||
* [Supported Container Platforms Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md)
|
||||
* [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md)
|
||||
|
||||
## Image Update Policy
|
||||
### Image Update Policy
|
||||
|
||||
* We update supported .NET images within 12 hours of any updates to their base images (e.g. debian:bookworm-slim, windows/nanoserver:ltsc2022, etc.).
|
||||
* We re-build all .NET images as part of releasing new versions of .NET including new major/minor versions and servicing.
|
||||
* Distroless images such as Ubuntu Chiseled have no base image, and as such will only be updated with .NET releases and CVE fixes as described below.
|
||||
|
||||
### CVE Update Policy
|
||||
#### CVE Update Policy
|
||||
|
||||
.NET container images are regularly monitored for the presence of CVEs. A given image will be rebuilt to pick up fixes for a CVE when:
|
||||
|
||||
|
|
@ -103,12 +105,12 @@ Tags | Dockerfile | OS Version
|
|||
|
||||
Please refer to the [Security Policy](https://github.com/dotnet/dotnet-docker/blob/main/SECURITY.md) and [Container Vulnerability Workflow](https://github.com/dotnet/dotnet-docker/blob/main/documentation/vulnerability-reporting.md) for more detail about what to do when a CVE is encountered in a .NET image.
|
||||
|
||||
## Feedback
|
||||
### Feedback
|
||||
|
||||
* [File an issue](https://github.com/dotnet/dotnet-docker/issues/new/choose)
|
||||
* [Contact Microsoft Support](https://support.microsoft.com/contactus/)
|
||||
|
||||
# License
|
||||
## License
|
||||
|
||||
* Legal Notice: [Container License Information](https://aka.ms/mcr/osslegalnotice)
|
||||
* [.NET license](https://github.com/dotnet/dotnet-docker/blob/main/LICENSE)
|
||||
|
|
|
|||
|
|
@ -1,11 +1,13 @@
|
|||
# Featured Tags
|
||||
# .NET Monitor Tool
|
||||
|
||||
## Featured Tags
|
||||
|
||||
* `8` (Long-Term Support)
|
||||
* `docker pull mcr.microsoft.com/dotnet/monitor:8`
|
||||
* `6` (Long-Term Support)
|
||||
* `docker pull mcr.microsoft.com/dotnet/monitor:6`
|
||||
|
||||
# About
|
||||
## About
|
||||
|
||||
This image contains the .NET Monitor tool.
|
||||
|
||||
|
|
@ -13,24 +15,24 @@ Use this image as a sidecar container to collect diagnostic information from oth
|
|||
|
||||
Watch [discussions](https://github.com/dotnet/dotnet-docker/discussions/categories/announcements) for Docker-related .NET announcements.
|
||||
|
||||
## New: Ubuntu Chiseled Images
|
||||
### New: Ubuntu Chiseled Images
|
||||
|
||||
Ubuntu Chiseled .NET images are a type of "distroless" container image that contain only the minimal set of packages .NET needs, with everything else removed.
|
||||
These images offer dramatically smaller deployment sizes and attack surface by including only the minimal set of packages required to run .NET applications.
|
||||
|
||||
Please see the [Ubuntu Chiseled + .NET](https://github.com/dotnet/dotnet-docker/blob/main/documentation/ubuntu-chiseled.md) documentation page for more info.
|
||||
|
||||
# Usage
|
||||
## Usage
|
||||
|
||||
The [.NET Docker samples](https://github.com/dotnet/dotnet-docker/blob/main/samples/README.md) show various ways to use .NET and Docker together. See [Building Docker Images for .NET Applications](https://docs.microsoft.com/dotnet/core/docker/building-net-docker-images) to learn more.
|
||||
|
||||
## Container sample: Run the tool
|
||||
### Container sample: Run the tool
|
||||
|
||||
You can run a container with a pre-built [.NET Docker Image](https://hub.docker.com/r/microsoft/dotnet-monitor/), based on the dotnet-monitor global tool.
|
||||
|
||||
See the [documentation](https://go.microsoft.com/fwlink/?linkid=2158052) for how to configure the image to be run in a Docker or Kubernetes environment, including how to configure authentication and certificates for https bindings.
|
||||
|
||||
# Related Repositories
|
||||
## Related Repositories
|
||||
|
||||
.NET:
|
||||
|
||||
|
|
@ -49,7 +51,7 @@ See the [documentation](https://go.microsoft.com/fwlink/?linkid=2158052) for how
|
|||
* [dotnet/framework](https://hub.docker.com/r/microsoft/dotnet-framework/): .NET Framework, ASP.NET and WCF
|
||||
* [dotnet/framework/samples](https://hub.docker.com/r/microsoft/dotnet-framework-samples/): .NET Framework, ASP.NET and WCF Samples
|
||||
|
||||
# Full Tag Listing
|
||||
## Full Tag Listing
|
||||
|
||||
### Linux amd64 Tags
|
||||
|
||||
|
|
@ -86,23 +88,23 @@ Tags | Dockerfile | OS Version
|
|||
9.0.0-preview.7-arm64v8, 9.0-preview-arm64v8, 9.0.0-preview.7, 9.0-preview, 9-preview | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/monitor/9.0/azurelinux-distroless/arm64v8/Dockerfile) | Azure Linux 3.0
|
||||
<!--End of generated tags-->
|
||||
|
||||
*Tags not listed in the table above are not supported. See the [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md)*
|
||||
*Tags not listed in the table above are not supported. See the [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md). See the [full list of tags](https://mcr.microsoft.com/v2/dotnet/monitor/tags/list) for all supported and unsupported tags.*
|
||||
|
||||
# Support
|
||||
## Support
|
||||
|
||||
## Lifecycle
|
||||
### Lifecycle
|
||||
|
||||
* [Microsoft Support for .NET](https://github.com/dotnet/core/blob/main/support.md)
|
||||
* [Supported Container Platforms Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md)
|
||||
* [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md)
|
||||
|
||||
## Image Update Policy
|
||||
### Image Update Policy
|
||||
|
||||
* We update supported .NET images within 12 hours of any updates to their base images (e.g. debian:bookworm-slim, windows/nanoserver:ltsc2022, etc.).
|
||||
* We re-build all .NET images as part of releasing new versions of .NET including new major/minor versions and servicing.
|
||||
* Distroless images such as Ubuntu Chiseled have no base image, and as such will only be updated with .NET releases and CVE fixes as described below.
|
||||
|
||||
### CVE Update Policy
|
||||
#### CVE Update Policy
|
||||
|
||||
.NET container images are regularly monitored for the presence of CVEs. A given image will be rebuilt to pick up fixes for a CVE when:
|
||||
|
||||
|
|
@ -112,12 +114,12 @@ Tags | Dockerfile | OS Version
|
|||
|
||||
Please refer to the [Security Policy](https://github.com/dotnet/dotnet-docker/blob/main/SECURITY.md) and [Container Vulnerability Workflow](https://github.com/dotnet/dotnet-docker/blob/main/documentation/vulnerability-reporting.md) for more detail about what to do when a CVE is encountered in a .NET image.
|
||||
|
||||
## Feedback
|
||||
### Feedback
|
||||
|
||||
* [File an issue](https://github.com/dotnet/dotnet-docker/issues/new/choose)
|
||||
* [Contact Microsoft Support](https://support.microsoft.com/contactus/)
|
||||
|
||||
# License
|
||||
## License
|
||||
|
||||
* Legal Notice: [Container License Information](https://aka.ms/mcr/osslegalnotice)
|
||||
* [.NET license](https://github.com/dotnet/dotnet-docker/blob/main/LICENSE)
|
||||
|
|
|
|||
|
|
@ -1,35 +1,37 @@
|
|||
# Featured Tags
|
||||
# .NET Runtime Dependencies
|
||||
|
||||
## Featured Tags
|
||||
|
||||
* `8.0` (Long-Term Support)
|
||||
* `docker pull mcr.microsoft.com/dotnet/runtime-deps:8.0`
|
||||
* `6.0` (Long-Term Support)
|
||||
* `docker pull mcr.microsoft.com/dotnet/runtime-deps:6.0`
|
||||
|
||||
# About
|
||||
## About
|
||||
|
||||
This image contains the native dependencies needed by .NET. It does not include .NET. It is for [self-contained](https://docs.microsoft.com/dotnet/articles/core/deploying/index) applications.
|
||||
|
||||
Watch [discussions](https://github.com/dotnet/dotnet-docker/discussions/categories/announcements) for Docker-related .NET announcements.
|
||||
|
||||
## New: Ubuntu Chiseled Images
|
||||
### New: Ubuntu Chiseled Images
|
||||
|
||||
Ubuntu Chiseled .NET images are a type of "distroless" container image that contain only the minimal set of packages .NET needs, with everything else removed.
|
||||
These images offer dramatically smaller deployment sizes and attack surface by including only the minimal set of packages required to run .NET applications.
|
||||
|
||||
Please see the [Ubuntu Chiseled + .NET](https://github.com/dotnet/dotnet-docker/blob/main/documentation/ubuntu-chiseled.md) documentation page for more info.
|
||||
|
||||
# Usage
|
||||
## Usage
|
||||
|
||||
The [.NET Docker samples](https://github.com/dotnet/dotnet-docker/blob/main/samples/README.md) show various ways to use .NET and Docker together. See [Building Docker Images for .NET Applications](https://docs.microsoft.com/dotnet/core/docker/building-net-docker-images) to learn more.
|
||||
|
||||
* [.NET self-contained Sample](https://github.com/dotnet/dotnet-docker/blob/main/samples/dotnetapp/README.md) - This [sample](https://github.com/dotnet/dotnet-docker/blob/main/samples/dotnetapp/Dockerfile.debian-x64-slim) builds and runs an application as a self-contained application.
|
||||
|
||||
# Image Variants
|
||||
## Image Variants
|
||||
|
||||
.NET container images have several variants that offer different combinations of flexibility and deployment size.
|
||||
The [Image Variants documentation](https://github.com/dotnet/dotnet-docker/blob/main/documentation/image-variants.md) contains a summary of the image variants and their use-cases.
|
||||
|
||||
# Related Repositories
|
||||
## Related Repositories
|
||||
|
||||
.NET:
|
||||
|
||||
|
|
@ -47,7 +49,7 @@ The [Image Variants documentation](https://github.com/dotnet/dotnet-docker/blob/
|
|||
* [dotnet/framework](https://hub.docker.com/r/microsoft/dotnet-framework/): .NET Framework, ASP.NET and WCF
|
||||
* [dotnet/framework/samples](https://hub.docker.com/r/microsoft/dotnet-framework-samples/): .NET Framework, ASP.NET and WCF Samples
|
||||
|
||||
# Full Tag Listing
|
||||
## Full Tag Listing
|
||||
|
||||
### Linux amd64 Tags
|
||||
|
||||
|
|
@ -174,23 +176,23 @@ Tags | Dockerfile | OS Version
|
|||
9.0.0-preview.7-noble-chiseled-extra-arm32v7, 9.0-preview-noble-chiseled-extra-arm32v7, 9.0.0-preview.7-noble-chiseled-extra, 9.0-preview-noble-chiseled-extra | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/runtime-deps/9.0/noble-chiseled-extra/arm32v7/Dockerfile) | Ubuntu 24.04
|
||||
<!--End of generated tags-->
|
||||
|
||||
*Tags not listed in the table above are not supported. See the [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md)*
|
||||
*Tags not listed in the table above are not supported. See the [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md). See the [full list of tags](https://mcr.microsoft.com/v2/dotnet/runtime-deps/tags/list) for all supported and unsupported tags.*
|
||||
|
||||
# Support
|
||||
## Support
|
||||
|
||||
## Lifecycle
|
||||
### Lifecycle
|
||||
|
||||
* [Microsoft Support for .NET](https://github.com/dotnet/core/blob/main/support.md)
|
||||
* [Supported Container Platforms Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md)
|
||||
* [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md)
|
||||
|
||||
## Image Update Policy
|
||||
### Image Update Policy
|
||||
|
||||
* We update supported .NET images within 12 hours of any updates to their base images (e.g. debian:bookworm-slim, windows/nanoserver:ltsc2022, etc.).
|
||||
* We re-build all .NET images as part of releasing new versions of .NET including new major/minor versions and servicing.
|
||||
* Distroless images such as Ubuntu Chiseled have no base image, and as such will only be updated with .NET releases and CVE fixes as described below.
|
||||
|
||||
### CVE Update Policy
|
||||
#### CVE Update Policy
|
||||
|
||||
.NET container images are regularly monitored for the presence of CVEs. A given image will be rebuilt to pick up fixes for a CVE when:
|
||||
|
||||
|
|
@ -200,12 +202,12 @@ Tags | Dockerfile | OS Version
|
|||
|
||||
Please refer to the [Security Policy](https://github.com/dotnet/dotnet-docker/blob/main/SECURITY.md) and [Container Vulnerability Workflow](https://github.com/dotnet/dotnet-docker/blob/main/documentation/vulnerability-reporting.md) for more detail about what to do when a CVE is encountered in a .NET image.
|
||||
|
||||
## Feedback
|
||||
### Feedback
|
||||
|
||||
* [File an issue](https://github.com/dotnet/dotnet-docker/issues/new/choose)
|
||||
* [Contact Microsoft Support](https://support.microsoft.com/contactus/)
|
||||
|
||||
# License
|
||||
## License
|
||||
|
||||
* Legal Notice: [Container License Information](https://aka.ms/mcr/osslegalnotice)
|
||||
* [.NET license](https://github.com/dotnet/dotnet-docker/blob/main/LICENSE)
|
||||
|
|
|
|||
|
|
@ -1,28 +1,30 @@
|
|||
# Featured Tags
|
||||
# .NET Runtime
|
||||
|
||||
## Featured Tags
|
||||
|
||||
* `8.0` (Long-Term Support)
|
||||
* `docker pull mcr.microsoft.com/dotnet/runtime:8.0`
|
||||
* `6.0` (Long-Term Support)
|
||||
* `docker pull mcr.microsoft.com/dotnet/runtime:6.0`
|
||||
|
||||
# About
|
||||
## About
|
||||
|
||||
This image contains the .NET runtimes and libraries and is optimized for running .NET apps in production.
|
||||
|
||||
Watch [discussions](https://github.com/dotnet/dotnet-docker/discussions/categories/announcements) for Docker-related .NET announcements.
|
||||
|
||||
## New: Ubuntu Chiseled Images
|
||||
### New: Ubuntu Chiseled Images
|
||||
|
||||
Ubuntu Chiseled .NET images are a type of "distroless" container image that contain only the minimal set of packages .NET needs, with everything else removed.
|
||||
These images offer dramatically smaller deployment sizes and attack surface by including only the minimal set of packages required to run .NET applications.
|
||||
|
||||
Please see the [Ubuntu Chiseled + .NET](https://github.com/dotnet/dotnet-docker/blob/main/documentation/ubuntu-chiseled.md) documentation page for more info.
|
||||
|
||||
# Usage
|
||||
## Usage
|
||||
|
||||
The [.NET Docker samples](https://github.com/dotnet/dotnet-docker/blob/main/samples/README.md) show various ways to use .NET and Docker together. See [Building Docker Images for .NET Applications](https://docs.microsoft.com/dotnet/core/docker/building-net-docker-images) to learn more.
|
||||
|
||||
## Container sample: Run a simple application
|
||||
### Container sample: Run a simple application
|
||||
|
||||
You can quickly run a container with a pre-built [.NET Docker image](https://hub.docker.com/r/microsoft/dotnet-samples/), based on the [.NET console sample](https://github.com/dotnet/dotnet-docker/blob/main/samples/dotnetapp/README.md).
|
||||
|
||||
|
|
@ -32,12 +34,12 @@ Type the following command to run a sample console application:
|
|||
docker run --rm mcr.microsoft.com/dotnet/samples
|
||||
```
|
||||
|
||||
# Image Variants
|
||||
## Image Variants
|
||||
|
||||
.NET container images have several variants that offer different combinations of flexibility and deployment size.
|
||||
The [Image Variants documentation](https://github.com/dotnet/dotnet-docker/blob/main/documentation/image-variants.md) contains a summary of the image variants and their use-cases.
|
||||
|
||||
# Related Repositories
|
||||
## Related Repositories
|
||||
|
||||
.NET:
|
||||
|
||||
|
|
@ -55,7 +57,7 @@ The [Image Variants documentation](https://github.com/dotnet/dotnet-docker/blob/
|
|||
* [dotnet/framework](https://hub.docker.com/r/microsoft/dotnet-framework/): .NET Framework, ASP.NET and WCF
|
||||
* [dotnet/framework/samples](https://hub.docker.com/r/microsoft/dotnet-framework-samples/): .NET Framework, ASP.NET and WCF Samples
|
||||
|
||||
# Full Tag Listing
|
||||
## Full Tag Listing
|
||||
|
||||
### Linux amd64 Tags
|
||||
|
||||
|
|
@ -225,23 +227,23 @@ Tag | Dockerfile
|
|||
9.0.0-preview.7-windowsservercore-ltsc2019, 9.0-preview-windowsservercore-ltsc2019 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/runtime/9.0/windowsservercore-ltsc2019/amd64/Dockerfile)
|
||||
<!--End of generated tags-->
|
||||
|
||||
*Tags not listed in the table above are not supported. See the [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md)*
|
||||
*Tags not listed in the table above are not supported. See the [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md). See the [full list of tags](https://mcr.microsoft.com/v2/dotnet/runtime/tags/list) for all supported and unsupported tags.*
|
||||
|
||||
# Support
|
||||
## Support
|
||||
|
||||
## Lifecycle
|
||||
### Lifecycle
|
||||
|
||||
* [Microsoft Support for .NET](https://github.com/dotnet/core/blob/main/support.md)
|
||||
* [Supported Container Platforms Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md)
|
||||
* [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md)
|
||||
|
||||
## Image Update Policy
|
||||
### Image Update Policy
|
||||
|
||||
* We update supported .NET images within 12 hours of any updates to their base images (e.g. debian:bookworm-slim, windows/nanoserver:ltsc2022, etc.).
|
||||
* We re-build all .NET images as part of releasing new versions of .NET including new major/minor versions and servicing.
|
||||
* Distroless images such as Ubuntu Chiseled have no base image, and as such will only be updated with .NET releases and CVE fixes as described below.
|
||||
|
||||
### CVE Update Policy
|
||||
#### CVE Update Policy
|
||||
|
||||
.NET container images are regularly monitored for the presence of CVEs. A given image will be rebuilt to pick up fixes for a CVE when:
|
||||
|
||||
|
|
@ -251,12 +253,12 @@ Tag | Dockerfile
|
|||
|
||||
Please refer to the [Security Policy](https://github.com/dotnet/dotnet-docker/blob/main/SECURITY.md) and [Container Vulnerability Workflow](https://github.com/dotnet/dotnet-docker/blob/main/documentation/vulnerability-reporting.md) for more detail about what to do when a CVE is encountered in a .NET image.
|
||||
|
||||
## Feedback
|
||||
### Feedback
|
||||
|
||||
* [File an issue](https://github.com/dotnet/dotnet-docker/issues/new/choose)
|
||||
* [Contact Microsoft Support](https://support.microsoft.com/contactus/)
|
||||
|
||||
# License
|
||||
## License
|
||||
|
||||
* Legal Notice: [Container License Information](https://aka.ms/mcr/osslegalnotice)
|
||||
* [.NET license](https://github.com/dotnet/dotnet-docker/blob/main/LICENSE)
|
||||
|
|
|
|||
|
|
@ -1,4 +1,6 @@
|
|||
# Featured Tags
|
||||
# .NET Samples
|
||||
|
||||
## Featured Tags
|
||||
|
||||
* `dotnetapp` [(*Dockerfile*)](https://github.com/dotnet/dotnet-docker/blob/main/samples/dotnetapp/Dockerfile)
|
||||
* `docker pull mcr.microsoft.com/dotnet/samples:dotnetapp`
|
||||
|
|
@ -7,24 +9,24 @@
|
|||
* `docker pull mcr.microsoft.com/dotnet/samples:aspnetapp`
|
||||
* `docker pull mcr.microsoft.com/dotnet/samples:aspnetapp-chiseled`
|
||||
|
||||
# About
|
||||
## About
|
||||
|
||||
These images contain sample .NET and ASP.NET Core applications.
|
||||
|
||||
Watch [discussions](https://github.com/dotnet/dotnet-docker/discussions/categories/announcements) for Docker-related .NET announcements.
|
||||
|
||||
## New: Ubuntu Chiseled Images
|
||||
### New: Ubuntu Chiseled Images
|
||||
|
||||
Ubuntu Chiseled .NET images are a type of "distroless" container image that contain only the minimal set of packages .NET needs, with everything else removed.
|
||||
These images offer dramatically smaller deployment sizes and attack surface by including only the minimal set of packages required to run .NET applications.
|
||||
|
||||
Please see the [Ubuntu Chiseled + .NET](https://github.com/dotnet/dotnet-docker/blob/main/documentation/ubuntu-chiseled.md) documentation page for more info.
|
||||
|
||||
# Usage
|
||||
## Usage
|
||||
|
||||
The [.NET Docker samples](https://github.com/dotnet/dotnet-docker/blob/main/samples/README.md) show various ways to use .NET and Docker together. See [Building Docker Images for .NET Applications](https://docs.microsoft.com/dotnet/core/docker/building-net-docker-images) to learn more.
|
||||
|
||||
## Container sample: Run a simple application
|
||||
### Container sample: Run a simple application
|
||||
|
||||
You can quickly run a container with a pre-built [.NET Docker image](https://hub.docker.com/r/microsoft/dotnet-samples/), based on the [.NET console sample](https://github.com/dotnet/dotnet-docker/blob/main/samples/dotnetapp/README.md).
|
||||
|
||||
|
|
@ -34,7 +36,7 @@ Type the following command to run a sample console application:
|
|||
docker run --rm mcr.microsoft.com/dotnet/samples
|
||||
```
|
||||
|
||||
## Container sample: Run a web application
|
||||
### Container sample: Run a web application
|
||||
|
||||
You can quickly run a container with a pre-built [.NET Docker image](https://hub.docker.com/r/microsoft/dotnet-samples/), based on the [ASP.NET Core sample](https://github.com/dotnet/dotnet-docker/blob/main/samples/aspnetapp/README.md).
|
||||
|
||||
|
|
@ -50,12 +52,12 @@ After the application starts, navigate to `http://localhost:8000` in your web br
|
|||
|
||||
See [Hosting ASP.NET Core Images with Docker over HTTPS](https://github.com/dotnet/dotnet-docker/blob/main/samples/host-aspnetcore-https.md) to use HTTPS with this image.
|
||||
|
||||
# Image Variants
|
||||
## Image Variants
|
||||
|
||||
.NET container images have several variants that offer different combinations of flexibility and deployment size.
|
||||
The [Image Variants documentation](https://github.com/dotnet/dotnet-docker/blob/main/documentation/image-variants.md) contains a summary of the image variants and their use-cases.
|
||||
|
||||
# Related Repositories
|
||||
## Related Repositories
|
||||
|
||||
.NET:
|
||||
|
||||
|
|
@ -72,7 +74,7 @@ The [Image Variants documentation](https://github.com/dotnet/dotnet-docker/blob/
|
|||
* [dotnet/framework](https://hub.docker.com/r/microsoft/dotnet-framework/): .NET Framework, ASP.NET and WCF
|
||||
* [dotnet/framework/samples](https://hub.docker.com/r/microsoft/dotnet-framework-samples/): .NET Framework, ASP.NET and WCF Samples
|
||||
|
||||
# Full Tag Listing
|
||||
## Full Tag Listing
|
||||
|
||||
### Linux amd64 Tags
|
||||
|
||||
|
|
@ -116,25 +118,25 @@ dotnetapp-8.0-nanoserver-1809, dotnetapp-nanoserver-1809, dotnetapp-8.0, dotneta
|
|||
aspnetapp-8.0-nanoserver-1809, aspnetapp-nanoserver-1809, aspnetapp-8.0, aspnetapp | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/samples/aspnetapp/Dockerfile.nanoserver)
|
||||
<!--End of generated tags-->
|
||||
|
||||
*Tags not listed in the table above are not supported. See the [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md)*
|
||||
*Tags not listed in the table above are not supported. See the [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md). See the [full list of tags](https://mcr.microsoft.com/v2/dotnet/samples/tags/list) for all supported and unsupported tags.*
|
||||
|
||||
# Support
|
||||
## Support
|
||||
|
||||
These sample images are not intended for production use and may be subject to breaking changes or removal at any time. They are provided as a starting point for developers to experiment with and learn about .NET in a containerized environment.
|
||||
|
||||
## Lifecycle
|
||||
### Lifecycle
|
||||
|
||||
* [Microsoft Support for .NET](https://github.com/dotnet/core/blob/main/support.md)
|
||||
* [Supported Container Platforms Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md)
|
||||
* [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md)
|
||||
|
||||
## Image Update Policy
|
||||
### Image Update Policy
|
||||
|
||||
* We update supported .NET images within 12 hours of any updates to their base images (e.g. debian:bookworm-slim, windows/nanoserver:ltsc2022, etc.).
|
||||
* We re-build all .NET images as part of releasing new versions of .NET including new major/minor versions and servicing.
|
||||
* Distroless images such as Ubuntu Chiseled have no base image, and as such will only be updated with .NET releases and CVE fixes as described below.
|
||||
|
||||
### CVE Update Policy
|
||||
#### CVE Update Policy
|
||||
|
||||
.NET container images are regularly monitored for the presence of CVEs. A given image will be rebuilt to pick up fixes for a CVE when:
|
||||
|
||||
|
|
@ -144,12 +146,12 @@ These sample images are not intended for production use and may be subject to br
|
|||
|
||||
Please refer to the [Security Policy](https://github.com/dotnet/dotnet-docker/blob/main/SECURITY.md) and [Container Vulnerability Workflow](https://github.com/dotnet/dotnet-docker/blob/main/documentation/vulnerability-reporting.md) for more detail about what to do when a CVE is encountered in a .NET image.
|
||||
|
||||
## Feedback
|
||||
### Feedback
|
||||
|
||||
* [File an issue](https://github.com/dotnet/dotnet-docker/issues/new/choose)
|
||||
* [Contact Microsoft Support](https://support.microsoft.com/contactus/)
|
||||
|
||||
# License
|
||||
## License
|
||||
|
||||
* Legal Notice: [Container License Information](https://aka.ms/mcr/osslegalnotice)
|
||||
* [.NET license](https://github.com/dotnet/dotnet-docker/blob/main/LICENSE)
|
||||
|
|
|
|||
|
|
@ -1,11 +1,13 @@
|
|||
# Featured Tags
|
||||
# .NET SDK
|
||||
|
||||
## Featured Tags
|
||||
|
||||
* `8.0` (Long-Term Support)
|
||||
* `docker pull mcr.microsoft.com/dotnet/sdk:8.0`
|
||||
* `6.0` (Long-Term Support)
|
||||
* `docker pull mcr.microsoft.com/dotnet/sdk:6.0`
|
||||
|
||||
# About
|
||||
## About
|
||||
|
||||
This image contains the .NET SDK which is comprised of three parts:
|
||||
|
||||
|
|
@ -17,16 +19,16 @@ Use this image for your development process (developing, building and testing ap
|
|||
|
||||
Watch [discussions](https://github.com/dotnet/dotnet-docker/discussions/categories/announcements) for Docker-related .NET announcements.
|
||||
|
||||
# Usage
|
||||
## Usage
|
||||
|
||||
The [.NET Docker samples](https://github.com/dotnet/dotnet-docker/blob/main/samples/README.md) show various ways to use .NET and Docker together. See [Building Docker Images for .NET Applications](https://docs.microsoft.com/dotnet/core/docker/building-net-docker-images) to learn more.
|
||||
|
||||
## Building .NET Apps with Docker
|
||||
### Building .NET Apps with Docker
|
||||
|
||||
* [.NET Docker Sample](https://github.com/dotnet/dotnet-docker/blob/main/samples/dotnetapp/README.md) - This [sample](https://github.com/dotnet/dotnet-docker/blob/main/samples/dotnetapp/Dockerfile) builds, tests, and runs the sample. It includes and builds multiple projects.
|
||||
* [ASP.NET Core Docker Sample](https://github.com/dotnet/dotnet-docker/blob/main/samples/aspnetapp/README.md) - This [sample](https://github.com/dotnet/dotnet-docker/blob/main/samples/aspnetapp/Dockerfile) demonstrates using Docker with an ASP.NET Core Web App.
|
||||
|
||||
## Develop .NET Apps in a Container
|
||||
### Develop .NET Apps in a Container
|
||||
|
||||
The following samples show how to develop, build and test .NET applications with Docker without the need to install the .NET SDK.
|
||||
|
||||
|
|
@ -34,12 +36,12 @@ The following samples show how to develop, build and test .NET applications with
|
|||
* [Test .NET Applications with SDK Container](https://github.com/dotnet/dotnet-docker/blob/main/samples/run-tests-in-sdk-container.md)
|
||||
* [Run .NET Applications with SDK Container](https://github.com/dotnet/dotnet-docker/blob/main/samples/run-in-sdk-container.md)
|
||||
|
||||
# Image Variants
|
||||
## Image Variants
|
||||
|
||||
.NET container images have several variants that offer different combinations of flexibility and deployment size.
|
||||
The [Image Variants documentation](https://github.com/dotnet/dotnet-docker/blob/main/documentation/image-variants.md) contains a summary of the image variants and their use-cases.
|
||||
|
||||
# Related Repositories
|
||||
## Related Repositories
|
||||
|
||||
.NET:
|
||||
|
||||
|
|
@ -57,7 +59,7 @@ The [Image Variants documentation](https://github.com/dotnet/dotnet-docker/blob/
|
|||
* [dotnet/framework](https://hub.docker.com/r/microsoft/dotnet-framework/): .NET Framework, ASP.NET and WCF
|
||||
* [dotnet/framework/samples](https://hub.docker.com/r/microsoft/dotnet-framework-samples/): .NET Framework, ASP.NET and WCF Samples
|
||||
|
||||
# Full Tag Listing
|
||||
## Full Tag Listing
|
||||
|
||||
### Linux amd64 Tags
|
||||
|
||||
|
|
@ -191,23 +193,23 @@ Tag | Dockerfile
|
|||
9.0.100-preview.7-windowsservercore-ltsc2019, 9.0-preview-windowsservercore-ltsc2019 | [Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/src/sdk/9.0/windowsservercore-ltsc2019/amd64/Dockerfile)
|
||||
<!--End of generated tags-->
|
||||
|
||||
*Tags not listed in the table above are not supported. See the [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md)*
|
||||
*Tags not listed in the table above are not supported. See the [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md). See the [full list of tags](https://mcr.microsoft.com/v2/dotnet/sdk/tags/list) for all supported and unsupported tags.*
|
||||
|
||||
# Support
|
||||
## Support
|
||||
|
||||
## Lifecycle
|
||||
### Lifecycle
|
||||
|
||||
* [Microsoft Support for .NET](https://github.com/dotnet/core/blob/main/support.md)
|
||||
* [Supported Container Platforms Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md)
|
||||
* [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md)
|
||||
|
||||
## Image Update Policy
|
||||
### Image Update Policy
|
||||
|
||||
* We update supported .NET images within 12 hours of any updates to their base images (e.g. debian:bookworm-slim, windows/nanoserver:ltsc2022, etc.).
|
||||
* We re-build all .NET images as part of releasing new versions of .NET including new major/minor versions and servicing.
|
||||
* Distroless images such as Ubuntu Chiseled have no base image, and as such will only be updated with .NET releases and CVE fixes as described below.
|
||||
|
||||
### CVE Update Policy
|
||||
#### CVE Update Policy
|
||||
|
||||
.NET container images are regularly monitored for the presence of CVEs. A given image will be rebuilt to pick up fixes for a CVE when:
|
||||
|
||||
|
|
@ -217,12 +219,12 @@ Tag | Dockerfile
|
|||
|
||||
Please refer to the [Security Policy](https://github.com/dotnet/dotnet-docker/blob/main/SECURITY.md) and [Container Vulnerability Workflow](https://github.com/dotnet/dotnet-docker/blob/main/documentation/vulnerability-reporting.md) for more detail about what to do when a CVE is encountered in a .NET image.
|
||||
|
||||
## Feedback
|
||||
### Feedback
|
||||
|
||||
* [File an issue](https://github.com/dotnet/dotnet-docker/issues/new/choose)
|
||||
* [Contact Microsoft Support](https://support.microsoft.com/contactus/)
|
||||
|
||||
# License
|
||||
## License
|
||||
|
||||
* Legal Notice: [Container License Information](https://aka.ms/mcr/osslegalnotice)
|
||||
* [.NET license](https://github.com/dotnet/dotnet-docker/blob/main/LICENSE)
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
{{
|
||||
set commonArgs to [
|
||||
"top-header": "#"
|
||||
"top-header": ARGS["top-header"]
|
||||
"readme-host": ARGS["readme-host"]
|
||||
] ^
|
||||
|
||||
|
|
@ -25,9 +25,9 @@ if !IS_PRODUCT_FAMILY:{{InsertTemplate("FeaturedTags.md", commonArgs)}}
|
|||
|
||||
{{insertReposListTemplate("RelatedRepos.md")}}
|
||||
{{if !IS_PRODUCT_FAMILY:
|
||||
# Full Tag Listing
|
||||
{{ARGS["top-header"]}} Full Tag Listing
|
||||
{{if ARGS["readme-host"] = "github":<!--End of generated tags-->
|
||||
*Tags not listed in the table above are not supported. See the [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md)*
|
||||
*Tags not listed in the table above are not supported. See the [Supported Tags Policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md). See the [full list of tags](https://mcr.microsoft.com/v2/{{REPO}}/tags/list) for all supported and unsupported tags.*
|
||||
^elif ARGS["readme-host"] = "dockerhub":
|
||||
View the current tags at the [Microsoft Artifact Registry portal](https://mcr.microsoft.com/product/{{REPO}}/tags) or on [GitHub](https://github.com/dotnet/dotnet-docker/blob/{{if isNightlyRepo:nightly^else:main}}/README.{{SHORT_REPO}}.md#full-tag-listing).
|
||||
}}}}
|
||||
|
|
|
|||
|
|
@ -0,0 +1,17 @@
|
|||
{{
|
||||
_ ARGS:
|
||||
product-repos: List of .NET product repos
|
||||
product-family-repos: List of .NET product family repos
|
||||
samples-repos: List of .NET samples repos ^
|
||||
|
||||
set repos to cat(ARGS["product-repos"], ARGS["samples-repos"]) ^
|
||||
|
||||
set isCurrentRepo(repo) to:{{
|
||||
set repoNameParts to split(repo[0], "/") ^
|
||||
set shortRepo to repoNameParts[len(repoNameParts) - 1] ^
|
||||
return shortRepo = SHORT_REPO
|
||||
}} ^
|
||||
|
||||
set currentRepo to when(IS_PRODUCT_FAMILY, ARGS["product-family-repos"], cat(filter(repos, isCurrentRepo)))
|
||||
|
||||
}}# {{currentRepo[0][1]}}
|
||||
|
|
@ -1 +1 @@
|
|||
{{InsertTemplate("DefaultLayout.md", ["readme-host": "dockerhub"])}}
|
||||
{{InsertTemplate("DefaultLayout.md", ["top-header": "#", "readme-host": "dockerhub"])}}
|
||||
|
|
|
|||
|
|
@ -1 +1,3 @@
|
|||
{{InsertTemplate("DefaultLayout.md", ["readme-host": "github"])}}
|
||||
{{InsertTemplate("ReposProvider.md", ["template": "GitHub.header.md"])}}
|
||||
|
||||
{{InsertTemplate("DefaultLayout.md", ["top-header": "##", "readme-host": "github"])}}
|
||||
|
|
|
|||
Загрузка…
Ссылка в новой задаче