4.6 KiB
Docker
These Dockerfiles enable building and running PowerShell in a container for each Linux distribution we support. There are two sets: stable and unstable.
This requires an up-to-date version of Docker, such as 1.12.
It also expects you to be able to run Docker without sudo
.
Please follow Docker's official instructions to install docker
correctly.
Note: we intend to publish automatically built containers on the Docker Hub, but this work is still pending.
Stable
The stable containers derive from the official distribution image,
such as centos:7
, then install dependencies,
and finally install the PowerShell package.
At about 440 megabytes, they are decently minimal, with their size being the sum of the base image (200 megabytes) plus the uncompressed package (120 megabytes), and about 120 megabytes of .NET Core and bootstrapping dependencies.
Unstable
The unstable containers derive from their respective stable images,
such as powershell/powershell:stable-centos7
,
then run the bootstrap.ps1
script which clones the repository,
runs Start-PSBootstrap -Package
to install building and packaging tools,
runs Start-PSBuild -Crossgen
to build PowerShell with native-image DLLs,
runs Start-PSPackage
to generate the platform's package,
and finally installs the generated package.
At about 4 gigabytes, these images are much larger due to having all the tools installed. This is intended so that the containers are useful for reproducing packages.
Automation
A script, launch.sh
, exists to automatically build all the respective images.
It has a few configuration options,
passed in as environment variables:
-
FORK
: the fork to clone in unstable builds (default:PowerShell
)- Set
FORK=andschwa
to clone https://github.com/andschwa/PowerShell
- Set
-
BRANCH
: the branch to checkout in unstable builds (default:master
)- Set
BRANCH=feature-A
to checkout thefeature-A
branch
- Set
-
BUILDS
: the type of builds to run (default:stable unstable
)- This is order dependent! Stable images must exist for unstable images to be built
- Set
BUILDS=stable
to run the script for just the stable images
-
DISTROS
: the distributions of Linux to run (default:ubuntu14.04 ubuntu16.04 centos7
)- Set
DISTROS=centos7
to build just CentOS 7 images - Combine with
BUILDS
to filter
- Set
-
TEST
: set to 1 todocker run Start-PSPester
inside the containers- The containers must first exist; this skips the build step
-
BUILDARGS
: additional arguments to be passed todocker build
during building- Set
BUILDARGS="--no-cache"
to rebuild and ignore cached layers
- Set
-
RUNARGS
: additional arguments to be passed todocker run
during testing- Set
RUNARGS="--rm"
to automatically delete the test container when finished
- Set
For each build type (stable and unstable),
the selected distributions will run in parallel.
The output is sent to log files in docker/logs
.
For unstable builds, the generated packages are copied to docker/packages
.
This script is very new, and there may be bugs.
Use set -x
to see exactly what commands it is running.
Examples
To build a CentOS container with the latest released package:
$ BUILDS=stable DISTROS=centos7 ./launch.sh
Logging to docker/logs/stable-centos7.log
Waiting for stable containers to finish; tail the logs for more information.
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
powershell/powershell stable-centos7 f0a11a8009b7 20 minutes ago 438.3 MB
...
To generate an Ubuntu 16.04 package from andschwa's docker
branch:
$ DISTROS=ubuntu16.04 FORK=andschwa BRANCH=docker ./launch.sh
Logging to docker/logs/stable-ubuntu16.04.log
Waiting for stable containers to finish; tail the logs for more information.
Logging to docker/logs/unstable-ubuntu16.04.log
Waiting for unstable containers to finish; tail the logs for more information.
$ ls packages
powershell_6.0.0-alpha.9-310-g5ded651-1ubuntu1.16.04.1_amd64.deb
$ tail logs/unstable-ubuntu16.04.log
Step 5 : COPY bootstrap.ps1 /
---> Using cache
---> d18a28ff1e3d
Step 6 : RUN powershell -f bootstrap.ps1 && dpkg -i PowerShell/powershell*.deb
---> Using cache
---> 9cd8b1ef79b3
Successfully built 9cd8b1ef79b3
LOG: Saving package to docker/packages
~/src/PowerShell/docker ~/src/PowerShell/docker
'/PowerShell/powershell_6.0.0-alpha.9-310-g5ded651-1ubuntu1.16.04.1_amd64.deb' -> '/mnt/powershell_6.0.0-alpha.9-310-g5ded651-1ubuntu1.16.04.1_amd64.deb'