You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+32Lines changed: 32 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -73,6 +73,12 @@ The [`build-and-test.ps1`](https://github.com/dotnet/dotnet-docker/blob/main/bui
73
73
> ./build-and-test.ps1 -Version 9.0 -OS nanoserver-1809 -Mode Test
74
74
```
75
75
76
+
- 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`.
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).
@@ -105,6 +111,32 @@ There are several types of [tests](https://github.com/dotnet/dotnet-docker/tree/
105
111
106
112
When editing Dockerfiles, please ensure the appropriate test changes are also made.
107
113
114
+
#### Running Tests Without Building Images
115
+
116
+
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:
117
+
118
+
- Run tests against published images without building locally:
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:
0 commit comments