DockerPester

Run Pester Tests in containers locally and get PassThru Object back.

Install the Module

Use the following code to install the Module:

Find-Module DockerPester -AllowPrerelease | Install-Module -Force

Azure Pipelines

Module Functionality

Base functionality	Pipeline
DockerPester

Tested Docker Images

Up until now I tested it with the following Docker Images:

OS	Pull	Pipeline
Windows servercore	docker pull mcr.microsoft.com/powershell:7.0.0-rc.3-windowsservercore-1803-kb4537762-amd64
Alpine 3.8	docker pull mcr.microsoft.com/powershell:7.0.0-rc.2-alpine-3.8
Alpine 3.9	docker pull mcr.microsoft.com/powershell:7.0.0-rc.2-alpine-3.9
Alpine 3.10	docker pull mcr.microsoft.com/powershell:7.0.0-rc.2-alpine-3.10
Ubuntu 16.04	docker pull mcr.microsoft.com/powershell:6.2.3-ubuntu-16.04
Ubuntu 18.04	docker pull mcr.microsoft.com/powershell:6.2.3-ubuntu-18.04
Ubuntu Bionic	docker pull mcr.microsoft.com/powershell:7.0.0-rc.2-arm32v7-ubuntu-bionic
Ubuntu Bionic	docker pull mcr.microsoft.com/powershell:7.0.0-rc.2-arm32v7-ubuntu-18.04
Centos 7	docker pull mcr.microsoft.com/powershell:7.0.0-rc.2-centos-7
Centos 8	docker pull mcr.microsoft.com/powershell:7.0.0-rc.2-centos-8
debian buster slim	docker pull mcr.microsoft.com/powershell:7.0.0-rc.2-debian-buster-slim
debian 9	docker pull mcr.microsoft.com/powershell:7.0.0-rc.2-debian-9
debian 10	docker pull mcr.microsoft.com/powershell:7.0.0-rc.2-debian-10
debian 11	docker pull mcr.microsoft.com/powershell:7.0.0-rc.2-debian-11
Fedora 28	docker pull mcr.microsoft.com/powershell:7.0.0-rc.2-fedora-28
Fedora 29	docker pull mcr.microsoft.com/powershell:7.0.0-rc.2-fedora-29
Fedora 30	docker pull mcr.microsoft.com/powershell:7.0.0-rc.2-fedora-30
OpenSuse 42.3	docker pull mcr.microsoft.com/powershell:7.0.0-rc.2-opensuse-42.3

How to use it

Prereq

Install Docker

Install Docker on your System from here:

Install Docker

You can install it using Chocolatey with this Script:

Install Docker with Chocolatey

! Installs Chocolatey and Docker. If you already have Chocolatey installed just run the second line.

Blog Post on how to set up and use:

DockerPester on BatesBase

Run a Test - TLDR

$Param = @{
  ContainerName = "DockerPester" #Name of the Container used to Test.
  Image = "mcr.microsoft.com/powershell:7.0.0-rc.2-alpine-3.8" #Image used for the Container
  InputFolder = "/Users/kevin/code/PSHarmonize"#Module or Folder you pass with your Tests in them
  PathOnContainer = "/var" #Path you want to copy to in your container
  PathToTests = "Tests" #Path in 'InputFolder' where your Tests are located
  PrerequisiteModule = "PSHTML" #Pass Modules that are prerequisites to your tests to download from gallery in container.
}

Invoke-DockerPester @Param

Parameters are described in Detail here: Parameters

Set DockerPester up for your Module to use locally

Find the Documentation to set up DockerPester for your module here - NOT FINISHED

To check out how to set up DockerPester for a Project check out This BlogPost.

This is how you would add a job for your project:

And this is how you would run DockerPester against your Project: