Execute-in-windows-docker-container
Actions
Composite action for running commands in windows docker containers.
Very simple hello world example:
steps:
- name: Checkout
uses: actions/checkout@v3
with:
fetch-depth: 0
- name: Test_Run
uses: philips-software/run-windows-docker-container-action@<version>
with:
image: mcr.microsoft.com/windows/servercore:20H2
entrypoint: powershell.exe
run: >-
echo "Hello world";
./run-test-script.ps1;
This action tries to stay close to GitHub's Action environment, and as such all GitHub defined default environment variables are passed to the container by default.
By default, the github workspace directory is mapped to the docker volume path and work path.
| parameter | description | required | default |
|---|---|---|---|
| image | Docker image. | true |
|
| run | Command to execute. | true |
|
| workspace_path | Workspace path. Default is root workspace path. | false |
|
| mapping_path | Mapping path, i.e. path to where the workspace path is mapped in the docker container. Defaults to workspace_path. | false |
|
| work_path | Work path, i.e. path where the command in the docker container is executed. Defaults to workspace_path. | false |
|
| memory | Memory limit. See docker documentation on --memory. | false |
4GB |
| entrypoint | Overrides the default ENTRYPOINT in docker image. | false |
|
| env_names | Environment variable names passed to docker image as comma separated list, for example: NAME1, NAME2, NAME3 | false |
|
| extra_args | Extra arguments for docker run command. | false |
|
| pre-warm | Run a warming-up container (which might crash due to first time use failure) | false |
true |
| pre-warm-cmd | Pre warm command to run inside the container | false |
echo "warming up!" |
| registry_authentication | Authenticate against registry server | false |
false |
| registry_username | Docker registry username. | false |
|
| registry_token | Docker registry token | false |
|
| registry_repository | Docker registry repository | false |
This action is a composite action.
Please refer to our Contributing guide when you want to contribute to this project.
Run-Windows-Docker-Container is licenced under the MIT license. See LICENSE file.
Execute-in-windows-docker-container is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.
Execute-in-windows-docker-container is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.