bateskevin / DockerPester

Run Pester Tests in containers locally and get PassThru Object

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: