Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 2 additions & 0 deletions .portal-docs/docker-hub/README.aspnet.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@

# Featured Tags

* `11.0-preview` (Preview)
* `docker pull mcr.microsoft.com/dotnet/nightly/aspnet:11.0-preview`
* `10.0` (Long-Term Support)
* `docker pull mcr.microsoft.com/dotnet/nightly/aspnet:10.0`
* `9.0` (Standard Support)
Expand Down
2 changes: 2 additions & 0 deletions .portal-docs/docker-hub/README.runtime-deps.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@

# Featured Tags

* `11.0-preview` (Preview)
* `docker pull mcr.microsoft.com/dotnet/nightly/runtime-deps:11.0-preview`
* `10.0` (Long-Term Support)
* `docker pull mcr.microsoft.com/dotnet/nightly/runtime-deps:10.0`
* `9.0` (Standard Support)
Expand Down
2 changes: 2 additions & 0 deletions .portal-docs/docker-hub/README.runtime.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@

# Featured Tags

* `11.0-preview` (Preview)
* `docker pull mcr.microsoft.com/dotnet/nightly/runtime:11.0-preview`
* `10.0` (Long-Term Support)
* `docker pull mcr.microsoft.com/dotnet/nightly/runtime:10.0`
* `9.0` (Standard Support)
Expand Down
2 changes: 2 additions & 0 deletions .portal-docs/docker-hub/README.sdk.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@

# Featured Tags

* `11.0-preview` (Preview)
* `docker pull mcr.microsoft.com/dotnet/nightly/sdk:11.0-preview`
* `10.0` (Long-Term Support)
* `docker pull mcr.microsoft.com/dotnet/nightly/sdk:10.0`
* `9.0` (Standard Support)
Expand Down
2 changes: 2 additions & 0 deletions .portal-docs/mar/README.aspnet.portal.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ Watch [discussions](https://github.com/dotnet/dotnet-docker/discussions/categori

## Featured Tags

* `11.0-preview` (Preview)
* `docker pull mcr.microsoft.com/dotnet/nightly/aspnet:11.0-preview`
* `10.0` (Long-Term Support)
* `docker pull mcr.microsoft.com/dotnet/nightly/aspnet:10.0`
* `9.0` (Standard Support)
Expand Down
2 changes: 2 additions & 0 deletions .portal-docs/mar/README.runtime-deps.portal.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ Watch [discussions](https://github.com/dotnet/dotnet-docker/discussions/categori

## Featured Tags

* `11.0-preview` (Preview)
* `docker pull mcr.microsoft.com/dotnet/nightly/runtime-deps:11.0-preview`
* `10.0` (Long-Term Support)
* `docker pull mcr.microsoft.com/dotnet/nightly/runtime-deps:10.0`
* `9.0` (Standard Support)
Expand Down
2 changes: 2 additions & 0 deletions .portal-docs/mar/README.runtime.portal.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ Watch [discussions](https://github.com/dotnet/dotnet-docker/discussions/categori

## Featured Tags

* `11.0-preview` (Preview)
* `docker pull mcr.microsoft.com/dotnet/nightly/runtime:11.0-preview`
* `10.0` (Long-Term Support)
* `docker pull mcr.microsoft.com/dotnet/nightly/runtime:10.0`
* `9.0` (Standard Support)
Expand Down
2 changes: 2 additions & 0 deletions .portal-docs/mar/README.sdk.portal.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,8 @@ Watch [discussions](https://github.com/dotnet/dotnet-docker/discussions/categori

## Featured Tags

* `11.0-preview` (Preview)
* `docker pull mcr.microsoft.com/dotnet/nightly/sdk:11.0-preview`
* `10.0` (Long-Term Support)
* `docker pull mcr.microsoft.com/dotnet/nightly/sdk:10.0`
* `9.0` (Standard Support)
Expand Down
32 changes: 32 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,12 @@ The [`build-and-test.ps1`](https://github.com/dotnet/dotnet-docker/blob/main/bui
> ./build-and-test.ps1 -Version 9.0 -OS nanoserver-1809 -Mode Test
```

- Build and test images on an arm64 device (e.g. Apple Silicon Mac or Linux ARM64 machine). Note: The architecture argument must be `arm64`, not `arm64v8`.

``` console
> ./build-and-test.ps1 -Paths '*9.0*noble*' -Architecture arm64
```

### Editing Dockerfiles

The [Dockerfiles](https://github.com/search?q=repo%3Adotnet%2Fdotnet-docker+path%3Asrc%2F**%2FDockerfile&type=code&ref=advsearch) contained in this repo are generated from a set of [Cottle](https://cottle.readthedocs.io/en/stable/page/01-overview.html) based [templates](https://github.com/dotnet/dotnet-docker/tree/main/eng/dockerfile-templates). A single template generates the set of Dockerfiles that are similar (e.g. all Windows sdk Dockerfiles for a particular .NET version). This ensures consistency across the various Dockerfiles and eases the burden of making changes to the Dockerfiles. Instead of editing the Dockerfiles directly, the templates should be updated and then the Dockerfiles should get regenerated by running the [generate Dockerfiles script](https://github.com/dotnet/dotnet-docker/blob/main/eng/dockerfile-templates/Get-GeneratedDockerfiles.ps1).
Expand Down Expand Up @@ -105,6 +111,32 @@ There are several types of [tests](https://github.com/dotnet/dotnet-docker/tree/

When editing Dockerfiles, please ensure the appropriate test changes are also made.

#### Running Tests Without Building Images

If you want to test images that have already been built and published to a registry (e.g. official images from `mcr.microsoft.com`), you can run tests without building first by using the `-PullImages` argument with the `run-tests.ps1` script:

- Run tests against published images without building locally:

``` console
> ./tests/run-tests.ps1 -PullImages -Paths '*9.0*noble*'
```

#### Running Specific Tests

To run specific tests, use the `-CustomTestFilter` argument with either `run-tests.ps1` or `build-and-test.ps1`. This argument accepts [Xunit test filtering](https://learn.microsoft.com/dotnet/core/testing/selective-unit-tests?pivots=xunit) expressions:

- Run a specific test by name:

``` console
> ./tests/run-tests.ps1 -Paths '*9.0*noble*' -CustomTestFilter "FullyQualifiedName~VerifyEnvironmentVariables"
```

- Run tests using `build-and-test.ps1` with a custom filter:

``` console
> ./build-and-test.ps1 -Paths '*9.0*noble*' -Mode Test -CustomTestFilter "FullyQualifiedName~VerifyPackageInstallation"
```

#### Debugging Tests Using VS Code

This repo comes with VS Code Task and Launch Profiles to help you debug tests.
Expand Down
Loading