├── .devcontainer
    └── devcontainer.json
├── .vscode
    └── settings.json
├── Containers
    └── Distroless
    │   ├── Containerfile
    │   └── README.MD
├── Examples
    ├── Script
    │   ├── Dockerfile
    │   ├── README.MD
    │   └── main.ps1
    └── ScriptWithModules
    │   ├── Dockerfile
    │   ├── README.MD
    │   └── main.ps1
├── LICENSE.MD
├── README.MD
├── build.ps1
└── images
    └── README
        └── image.png


/.devcontainer/devcontainer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "PowerShell Runtime Containers",
 3 |   "image": "mcr.microsoft.com/devcontainers/dotnet:1-10.0-preview-trixie-slim", //Trixie needed for podman/buildah updates
 4 |   "privileged": true,
 5 |   "hostRequirements": {
 6 |     "cpus": 4 // To build containers in parallel and match the GitHub Actions environment
 7 |   },
 8 |   "initializeCommand": "docker images -a", //To see what images are cached on the devcontainer or host
 9 |   "postCreateCommand": "sudo apt-get update && sudo apt-get install -y podman skopeo && sudo mount --make-rshared / && sudo ln -s /usr/bin/podman /usr/bin/docker",
10 |   "containerEnv": {
11 |     "PODMAN_IGNORE_CGROUPSV1_WARNING": "true"
12 |   },
13 |   "customizations": {
14 |     "vscode": {
15 |       "extensions": [
16 |         "ms-vscode.powershell",
17 |         "ms-azuretools.vscode-containers",
18 |         "GitHub.vscode-pull-request-github"
19 |       ]
20 |     }
21 |   }
22 | }
23 | 


--------------------------------------------------------------------------------
/.vscode/settings.json:
--------------------------------------------------------------------------------
1 | {}


--------------------------------------------------------------------------------
/Containers/Distroless/Containerfile:
--------------------------------------------------------------------------------
 1 | #These args will vary based on the build. This is a multi-arch build
 2 | ARG DIST=noble-chiseled
 3 | ARG PS_VERSION=7.5.1
 4 | 
 5 | #This needs to match the pwsh build version. The build script does this detectin work via global.json of the commit of the release
 6 | ARG DOTNET_VERSION=9.0
 7 | 
 8 | 
 9 | #Autogenerated args based on the build
10 | ARG BUILDPLATFORM TARGETOS TARGETARCH
11 | 
12 | #You wont typically need to vary these args
13 | ARG PS_PACKAGE_BASE=powershell-${PS_VERSION}-${TARGETOS}
14 | ARG PS_PACKAGE_BASE_URL=https://github.com/PowerShell/PowerShell/releases/download/v${PS_VERSION}/${PS_PACKAGE_BASE}
15 | ARG PS_INSTALL_FOLDER=/opt/microsoft/powershell/7
16 | ARG LANG=en_US.UTF-8
17 | ARG IMAGE=mcr.microsoft.com/dotnet/runtime-deps:$DOTNET_VERSION-$DIST
18 | ARG TAG=$PS_VERSION-$DIST-$TARGETARCH
19 | 
20 | #STAGE: Install PowerShell
21 | FROM --platform=$BUILDPLATFORM alpine AS install-powershell
22 | ARG PS_INSTALL_FOLDER PS_VERSION PS_PACKAGE_BASE_URL TARGETARCH TARGETPLATFORM
23 | #Passed thru so it can reach the configure stage
24 | RUN <<SCRIPT
25 | if [ "${TARGETARCH}" = "amd64" ]; then
26 | 	PSARCH="x64"
27 | elif [ "${TARGETARCH}" = "arm64" ]; then
28 | 	PSARCH="arm64"
29 | else
30 | 	echo "Unsupported architecture: $TARGETARCH"
31 | 	exit 1
32 | fi
33 | 
34 | #Fetch and extract the appropriate zip
35 | wget -O /tmp/linux.tar.gz $PS_PACKAGE_BASE_URL-$PSARCH.tar.gz
36 | mkdir -p $PS_INSTALL_FOLDER
37 | echo "Extracting to $PS_INSTALL_FOLDER"
38 | tar zxf /tmp/linux.tar.gz -C $PS_INSTALL_FOLDER
39 | chmod a+x,o-w ${PS_INSTALL_FOLDER}/pwsh
40 | chmod a+x,o-w ${PS_INSTALL_FOLDER}/pwsh.dll
41 | SCRIPT
42 | 
43 | 
44 | #Cleanup unnecessary items
45 | WORKDIR $PS_INSTALL_FOLDER
46 | RUN <<SCRIPT
47 | # Unnecessary Modules for runtime
48 | rm -rf Schemas Modules/PowerShellGet Modules/Microsoft.PowerShell.PSResourceGet Modules/PackageManagement Modules/PSReadLine
49 | #Unnecessary localization
50 | rm -rf zh-Hans zh-Hant cs de es fr it ja ko pl pt-BR tr ru _manifest ref
51 | 
52 | # Additional Unnecessary Extras
53 | rm Microsoft.PowerShell.*.xml
54 | rm ThirdPartyNotices.txt
55 | rm System.Directory*.dll System.Data.SqlClient.dll System.Data.Odbc.dll
56 | rm System.Drawing.Common.dll System.Speech.dll
57 | SCRIPT
58 | 
59 | #STAGE: Configure PowerShell
60 | FROM --platform=$TARGETPLATFORM $IMAGE
61 | ARG PS_INSTALL_FOLDER
62 | ARG TAG
63 | COPY --from=install-powershell /opt/microsoft/powershell /opt/microsoft/powershell
64 | 
65 | # Define ENVs for Localization/Globalization
66 | ENV DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=true
67 | ENV LC_ALL=en_US.UTF-8
68 | ENV LANG=en_US.UTF-8
69 | 
70 | #PowerShell Specific: https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_environment_variables?view=powershell-7.4
71 | ENV POWERSHELL_DISTRIBUTION_CHANNEL=JustinGrote-PowerShell-Containers-$TAG
72 | ENV POWERSHELL_UPDATECHECK=Off
73 | 
74 | ENTRYPOINT [ "/opt/microsoft/powershell/7/pwsh", "-noni", "-c" ]
75 | 
76 | #Prepare the Module Analysis Cache
77 | #TODO: Figure out how to run this on arm64
78 | # RUN ["/opt/microsoft/powershell/7/pwsh","-noni", "-c","'Waiting for ModuleAnalysisCache Creation (usually 12-15 seconds)';do {start-sleep 2} until (Test-Path ~/.cache/powershell/ModuleAnalysisCache*)"]
79 | 


--------------------------------------------------------------------------------
/Containers/Distroless/README.MD:
--------------------------------------------------------------------------------
1 | This containerfile is used to build distroless images. Currently it is commonly used for both supported .NET distroless images:
2 | 
3 | - Azure Linux 3.0
4 | - .NET Chiseled (Debian)


--------------------------------------------------------------------------------
/Examples/Script/Dockerfile:
--------------------------------------------------------------------------------
1 | FROM ghcr.io/justingrote/powershell
2 | ADD main.ps1 /
3 | CMD ["/main.ps1"]
4 | 


--------------------------------------------------------------------------------
/Examples/Script/README.MD:
--------------------------------------------------------------------------------
 1 | # Run from Script
 2 | In this folder is a script and a Dockerfile that instructs it to include the container at the root level.
 3 | 
 4 | 1. Build the container (make sure you are in this same directory, or otherwise specify the path rather than `.`)
 5 | 
 6 | 	`docker build -t pshello .` (you can replace `pshello` tag with whatever you want)
 7 | 
 8 | 1. Run the container. The entrypoint is already specified in the container via the `CMD` operator in the dockerfile.
 9 | 
10 | 	`docker run pshello`
11 | 	
12 | 	*Output:* ```Hello world at 03/29/2025 21:08:05!```
13 | 	
14 | 1. Now try running the container with an argument. You must respecify the `CMD` part as the first argument when doing this
15 | 
16 | 	`docker run pshello "/main.ps1" "Friend"`
17 | 	
18 | 	*Output:* ```Hello Friend at 03/29/2025 21:08:05!```


--------------------------------------------------------------------------------
/Examples/Script/main.ps1:
--------------------------------------------------------------------------------
1 | [CmdletBinding()]
2 | param(
3 | 	$Name = "World"
4 | )
5 | "Hello $Name at $(Get-Date)!"


--------------------------------------------------------------------------------
/Examples/ScriptWithModules/Dockerfile:
--------------------------------------------------------------------------------
 1 | FROM ghcr.io/justingrote/powershell
 2 | ADD main.ps1 /
 3 | 
 4 | # Need this to make RUN work correctly
 5 | SHELL [ "/opt/microsoft/powershell/7/pwsh", "-c" ]
 6 | # Bootstraps ModuleFast and tells it to install the dependencies present in main.ps1 #requires header
 7 | # Default installation is to the /home/app folder which is writable by the user
 8 | # If you want modules in a read-only location, use -Destination /usr/local/share/powershell/Modules
 9 | RUN <<SCRIPT
10 | iwr bit.ly/modulefast | iex
11 | Install-ModuleFast -Path main.ps1 -Verbose
12 | SCRIPT
13 | 
14 | CMD ["/main.ps1"]
15 | 


--------------------------------------------------------------------------------
/Examples/ScriptWithModules/README.MD:
--------------------------------------------------------------------------------
 1 | # Script with Modules
 2 | 
 3 | It is a best practice to bundle all your dependencies for speed and security within the module, rather than install them at runtime. As such, you should bundle your modules and any other related dependencies in your Docker container.
 4 | 
 5 | There are many ways to accomplish this, but I recommend doing it as part of a build step of your container.
 6 | 
 7 | This example uses [ModuleFast](https://github.com/JustinGrote/ModuleFast) to quickly install and embed dependencies into the module. The modules will go into the `/home/app` folder, and are specified by the `#requires` line of the script which ModuleFast can autodetect.
 8 | 
 9 | ## Example 1: Build and Run Default Example
10 | `docker build -t ps-network-finder .`
11 | 
12 | `docker run ps-network-finder`
13 | 
14 | *Output*: `The Network ID of 199.255.26.15/21 is 199.255.24.0`
15 | 
16 | ## Example 2: Run with an Argument
17 | `docker run ps-network-finder "/main.ps1" "10.2.1.0/8"`
18 | 
19 | *Output*: `The Network ID of 10.2.1.0/8 is 10.0.0.0`


--------------------------------------------------------------------------------
/Examples/ScriptWithModules/main.ps1:
--------------------------------------------------------------------------------
 1 | #requires -Module IPNetwork
 2 | 
 3 | [CmdletBinding()]
 4 | param(
 5 | 	#The IP prefixed address to get the subnet for. Example: 10.2.1.5/24
 6 | 	[string]$IP = '199.255.26.15/21'
 7 | )
 8 | 
 9 | $IPInfo = Get-IPNetwork $IP
10 | 
11 | return "The Network ID of $IP is $($IPInfo.Network)"


--------------------------------------------------------------------------------
/LICENSE.MD:
--------------------------------------------------------------------------------
 1 | # License
 2 | 
 3 | Copyright 2024 Justin Grote @JustinWGrote github.com/JustinGrote
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 6 | 
 7 | The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
 8 | 
 9 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
10 | 


--------------------------------------------------------------------------------
/README.MD:
--------------------------------------------------------------------------------
 1 | # [PowerShell Runtime Containers](https://ghcr.io/justingrote/powershell)
 2 | 
 3 | ![PowerShell Runtime Containers](images/README/image.png)
 4 | 
 5 | This repository provides modern container builds for running PowerShell Scripts.
 6 | 
 7 | Found at: [ghcr.io/justingrote/powershell](https://ghcr.io/justingrote/powershell)
 8 | 
 9 | Optimized for:
10 | 
11 | 🤏 Small Footprint (~140Mb)
12 | 
13 | ⏱️ High Performance
14 | 
15 | 👮 Minimal Security Surface Area
16 | 
17 | ---
18 | 
19 | https://github.com/user-attachments/assets/c3fb3fd7-cc5d-4146-a7d9-ef823d6d99ed
20 | 
21 | ## ⚡ Quick Start
22 | > [!NOTE]
23 | By default the container will run any powershell script passed to it as an argument, either directly or via stdin.
24 | 
25 | `docker run ghcr.io/justingrote/powershell '"Welcome to PowerShell $($PSVersionTable.PSVersion)"'`
26 | 
27 | > Welcome to PowerShell 7.5.0
28 | 
29 | ## 🏷️ Tags
30 | > [!NOTE]
31 | Unless otherwise specified, the base distro is [Azure Linux 3.0 distroless](https://github.com/dotnet/dotnet-docker/blob/main/documentation/azurelinux.md)
32 | 
33 | * `latest` - latest stable version
34 | * `lts` - latest lts version
35 | * `X` - latest specified major version. For example: `7` is the latest 7.x.x version
36 | * `X-lts` - latest specified major lts version (e.g. `7-lts` is 7.4.Z but not 7.5.Z)
37 | * `X.Y` - latest feature version. For example: `7.4` is latest 7.4.Z version.
38 | * `7.X.Y` - "pinned" version to the version you specify. For example: `7.4.2` will always be `7.4.2`
39 | * `azurelinux3.0-distroless` - latest stable version using [.NET Azure Linux 3.0 distroless](https://github.com/dotnet/dotnet-docker/blob/main/documentation/azurelinux.md)
40 | * `noble-chiseled` - latest stable version using [.NET Chiseled](https://github.com/dotnet/dotnet-docker/blob/main/documentation/ubuntu-chiseled.md)
41 | 
42 | > [!TIP]
43 | There are direct tags you can pin to a specific version and architecture. These tags should be considered relatively stable but not immutable, as changes to the image build process or bugfixes may be required, but the PowerShell version specified will remain the same.
44 | 
45 | ## 📦 Bundling
46 | To create new container applications, define a new dockerfile that bundles your script.
47 | 
48 | * [Standalone Script Example](Examples/Script/README.MD)
49 | * [Script with Modules Example](Examples/ScriptWithModules/README.MD)
50 | 
51 | 
52 | ## About These Containers
53 | 
54 | These images run the self-contained version of PowerShell on top of the dotnet/runtime-deps container, with some additional features removed to reduce size:
55 | 1. PowerShellGet/PSResourceGet/PackageManagement removed (you should bundle modules into your container directly)
56 | 1. Help Removed
57 | 1. PSReadline Removed (this is not meant for interactive use)
58 | 1. Some unnecessary assemblies for most workloads removed (SQLClient, ODBC, etc.). You should bundle in modern equivalents with your docker image if you need these.
59 | 1. Localization Support removed. If there is sufficient demand for a localization-enabled container, I will build a version based on AzureLinux-extra which includes the required localization parts.
60 | 
61 | The images are multi-arch, supporting x64 and arm64-v8.
62 | 
63 | The image also runs under a local non-root user by default. 
64 | 
65 | By default, there is no writable filesystem access besides /tmp and /home/app for security. You can layer in writable filesystems if needed, but it is recommended to mount volumes instead.
66 | 
67 | Alpine builds have been deprecated for now in favor of distroless builds. Interactive users should use the official .NET SDK or Devcontainer images.
68 | 
69 | While fxdependent is smaller, the self-contained images contain precompliation that result in a huge (50%+) startup CPU and time cost, so the minor extra 30MB or so is considered worth the size increase, especially since the size is a one-time hit.
70 | 
71 | ## Updates
72 | 
73 | There are plans to auto-generate new images upon new PowerShell release within 24 hours, potentially as soon as a release is posted.
74 | 


--------------------------------------------------------------------------------
/build.ps1:
--------------------------------------------------------------------------------
  1 | using namespace System.Management.Automation
  2 | 
  3 | [CmdletBinding()]
  4 | param(
  5 | 	#The minimum version to build for. This should be increased when EOL dates are reached.
  6 | 	[SemanticVersion]$minimumPSVersion = '7.4',
  7 | 	#For now, our build process is the same for both. This may change in the future
  8 | 	$Distributions = @(
  9 | 		'noble-chiseled'
 10 | 		'azurelinux3.0-distroless'
 11 | 	),
 12 | 	#Map the architectures to the release nomenclature we use.
 13 | 	[string[]]$Architectures = @('amd64', 'arm64'),
 14 | 	$LocalImageName = 'powershell',
 15 | 	$remoteImageName = 'ghcr.io/justingrote/powershell',
 16 | 	#Push to remote repo
 17 | 	[switch]$Push,
 18 | 	#By default, does not rebuild images that already exist. Use -Force to override.
 19 | 	[switch]$Force
 20 | )
 21 | 
 22 | $irmParams = @{
 23 | 	Headers = @{
 24 | 		Accept                 = 'application/vnd.github+json'
 25 | 		'X-Github-Api-Version' = '2022-11-28'
 26 | 	}
 27 | 	Uri     = 'https://api.github.com/repos/PowerShell/PowerShell/releases?per_page=100'
 28 | }
 29 | Write-Verbose 'Fetching Latest PowerShell Releases'
 30 | $releases = Invoke-RestMethod @irmParams -Verbose:$false
 31 | 
 32 | # Gather releases newer than specified minimumPSVersion
 33 | $pwshReleases = $releases
 34 | | Select-Object id,
 35 | tag_name,
 36 | @{
 37 | 	N = 'Version';
 38 | 	E = { [SemanticVersion]($_.tag_name -replace '^v') }
 39 | },
 40 | name,
 41 | assets
 42 | | Where-Object Version -GT $minimumPSVersion
 43 | | Sort-Object Version -Descending
 44 | 
 45 | #A hash mapping used to easily map and store the state of the latest tags
 46 | [System.Collections.Generic.HashSet[string]]$latestTag = @()
 47 | 
 48 | #Generate the Azure Linux Distroless Images
 49 | foreach ($release in $pwshReleases) {
 50 | 	foreach ($distribution in $Distributions) {
 51 | 		[SemanticVersion]$version = $release.Version
 52 | 		[string]$releaseMajorMinorVersion = $version.Major, $version.Minor -join '.'
 53 | 
 54 | 		$powershellTag = "$version-$distribution"
 55 | 		$powershellImageTag = "$LocalImageName`:$powershellTag"
 56 | 
 57 | 		Write-Verbose "🟢: Building PowerShell $powershellTag"
 58 | 
 59 | 		# Fetch the global.json from the commit to determine the .NET version
 60 | 		$dotnetVersion = (Invoke-RestMethod "https://raw.githubusercontent.com/PowerShell/PowerShell/refs/tags/$($release.tag_name)/global.json" -Verbose:$false).sdk.version
 61 | 
 62 | 		#Do some massaging to get the correct tag. For example convert 10.0.100-preview.2.25164.34 to 10.0-preview
 63 | 		$currentDotnetVersion = $dotnetVersion
 64 | 		$dotnetVersion = $dotnetVersion -replace '^(\d+\.\d+)(\.\d+)-(\w+)\.(\d+)?.+$', '$1.0-$3.$4'
 65 | 		if ($dotnetVersion -ne $currentDotnetVersion) {
 66 | 			Write-Debug "Dotnet Preview Version Detected. New Tag: $dotnetVersion"
 67 | 		} else {
 68 | 			[Version]$releaseVer = $dotnetVersion
 69 | 			$dotnetVersion = $releaseVer.Major, $releaseVer.Minor -join '.'
 70 | 			Write-Debug "Dotnet Version Detected. New Tag: $dotnetVersion"
 71 | 		}
 72 | 
 73 | 		if (-not $dotnetVersion) {
 74 | 			Write-Error "Unable to fetch .NET version for PowerShell version $releaseMajorMinorVersion"
 75 | 			continue
 76 | 		}
 77 | 
 78 | 		if (-not $dotnetVersion) {
 79 | 			Write-Error "No matching distro Image for PowerShell version $releaseMajorMinorVersion"
 80 | 			continue
 81 | 		}
 82 | 
 83 | 
 84 | 		Push-Location $PSScriptRoot/Containers/Distroless
 85 | 		try {
 86 | 			$platforms = $Architectures | ForEach-Object {
 87 | 				"linux/$_"
 88 | 			}
 89 | 
 90 | 			$podmanBuildArgs = @(
 91 | 				# Pass the version and distribution to the podmanfile
 92 | 				'--build-arg', "DIST=$distribution",
 93 | 				'--build-arg', "PS_VERSION=$version",
 94 | 				'--build-arg', "DOTNET_VERSION=$dotnetVersion"
 95 | 				'--platform', ($platforms -join ','),
 96 | 				'--manifest', $powershellImageTag
 97 | 			)
 98 | 
 99 | 			Write-Debug "podman Build Args: $($podmanBuildArgs -join ' ')"
100 | 
101 | 			& podman build @podmanBuildArgs . *>&1
102 | 			| ForEach-Object {
103 | 				$podmanLogs += $_
104 | 				Write-Debug "${powershellTag}: $_"
105 | 			}
106 | 
107 | 			if ($LASTEXITCODE -ne 0) {
108 | 				Write-Error "podman Build Failed: `n $($podmanLogs -join '`n')"
109 | 				continue
110 | 			}
111 | 
112 | 			#Basic Sanity Check
113 | 			# TODO: Test in amd64 devcontainer
114 | 			$testValue = 'ValidContainer'
115 | 			$testResult = & podman run --rm $powershellImageTag "'$testValue'"
116 | 			if ($testResult -ne $testValue) {
117 | 				Write-Error "PowerShell Image $powershellImageTag failed basic PowerShell script test"
118 | 				continue
119 | 			}
120 | 
121 | 			#Add annotations
122 | 			$annotations = @{
123 | 				'org.opencontainers.image.source'      = 'https://github.com/JustinGrote/PowerShell-Containers'
124 | 				'org.opencontainers.image.title'       = "PowerShell Runtime Container $($version.ToString()) for $distribution"
125 | 				'org.opencontainers.image.description' = 'Run PowerShell in a low footprint, high performance, and secure environment'
126 | 				'org.opencontainers.image.licenses'    = 'MIT'
127 | 				'org.opencontainers.image.authors'     = 'Justin Grote'
128 | 				'org.opencontainers.image.version'     = $version.ToString()
129 | 				'org.opencontainers.image.revision'    = $release.tag_name
130 | 				'org.opencontainers.image.created'     = (Get-Date -Format 'o')
131 | 			}
132 | 
133 | 			foreach ($annotation in $annotations.GetEnumerator()) {
134 | 				Write-Verbose "🏷️ $($annotation.Key)=$($annotation.Value)"
135 | 				$annotateArgs = @(
136 | 					'--index'
137 | 					'--annotation'
138 | 					"$($annotation.Key)=$($annotation.Value)"
139 | 				)
140 | 				$annotatedDigest = & podman manifest annotate @annotateArgs $powershellImageTag
141 | 				if ($LASTEXITCODE -ne 0) {
142 | 					continue
143 | 				}
144 | 			}
145 | 
146 | 			#Check for rollup tag candidates. Since we start with Azure Linux, it will always default to those distro images first.
147 | 			[string[]]$additionalTags = @()
148 | 			if (-not $version.PreReleaseLabel -and -not $version.BuildLabel) {
149 | 				if ($latestTag.Add('latest')) {
150 | 					Write-Verbose "🎯 $powerShellImageTag will be additionally tagged as latest"
151 | 					$additionalTags += 'latest'
152 | 				}
153 | 				if ($latestTag.Add($Version.Major)) {
154 | 					Write-Verbose "🎯 $powerShellImageTag will be additionally tagged as $($Version.Major)"
155 | 					$additionalTags += $Version.Major
156 | 				}
157 | 				if ($latestTag.Add($releaseMajorMinorVersion)) {
158 | 					Write-Verbose "🎯 $powerShellImageTag will be additionally tagged as $releaseMajorMinorVersion"
159 | 					$additionalTags += $releaseMajorMinorVersion
160 | 				}
161 | 				if ($latestTag.Add($version)) {
162 | 					Write-Verbose "🎯 $powerShellImageTag will be additionally tagged as $version"
163 | 					$additionalTags += $version
164 | 				}
165 | 
166 | 				#LTS tag processing
167 | 				if ($Version.Minor % 2 -eq 0) {
168 | 					$majorLtsTag = "$($Version.Major)-lts"
169 | 					if ($latestTag.Add($majorLtsTag)) {
170 | 						Write-Verbose "🎯 $powerShellImageTag will be additionally tagged as $majorLtsTag"
171 | 						$additionalTags += $majorLtsTag
172 | 						if ($latestTag.Add('lts')) {
173 | 							Write-Verbose "🎯 $powerShellImageTag will be additionally tagged as lts"
174 | 							$additionalTags += 'lts'
175 | 						}
176 | 					}
177 | 				}
178 | 
179 | 				#Distro tag processing
180 | 				if ($latestTag.Add($distribution)) {
181 | 					Write-Verbose "🎯 $powerShellImageTag will be additionally tagged as $distribution"
182 | 					$additionalTags += $distribution
183 | 				}
184 | 			}
185 | 
186 | 			if ($version.PrereleaseLabel) {
187 | 				if ($latestTag.Add('preview')) {
188 | 					Write-Verbose "🎯 $powerShellImageTag will be additionally tagged as preview"
189 | 					$additionalTags += 'preview'
190 | 				}
191 | 			}
192 | 
193 | 			if ($additionalTags) {
194 | 				[string[]]$psExtraTags = $additionalTags | ForEach-Object {
195 | 					"${LocalImageName}:$_"
196 | 				}
197 | 				Write-Verbose "🏷️ Adding Tags: $psExtraTags"
198 | 				podman tag $powershellImageTag @psExtraTags
199 | 			}
200 | 
201 | 			if ($Push) {
202 | 				[string[]]$pushTags = $powershellTag
203 | 				if ($additionalTags) {
204 | 					$pushTags += $additionalTags
205 | 				}
206 | 				$pushArgs = @(
207 | 					'--compression-format', 'gzip'
208 | 					'--add-compression', 'zstd:chunked'
209 | 				)
210 | 
211 | 				foreach ($tag in $pushTags) {
212 | 					$remoteTag = "${remoteImageName}:$tag"
213 | 					Write-Verbose "📤 Pushing $powershellImageTag to $remoteTag"
214 | 					[string[]]$podmanLogs = @()
215 | 					podman manifest push @pushArgs $powershellImageTag $remoteTag *>&1
216 | 					| ForEach-Object {
217 | 						$podmanLogs += $_
218 | 						Write-Debug "${remoteTag}: $_"
219 | 					}
220 | 					if ($LASTEXITCODE -ne 0) {
221 | 						Write-Error "podman Push Failed for tag ${tag}: `n $($podmanLogs -join '`n')"
222 | 						continue
223 | 					}
224 | 				}
225 | 			}
226 | 		} catch {
227 | 			Write-Host -Fore Magenta $podmanLogs
228 | 			throw
229 | 		} finally {
230 | 			Write-Verbose "🤚: Building PowerShell $powershellTag"
231 | 			Pop-Location
232 | 		}
233 | 	}
234 | }


--------------------------------------------------------------------------------
/images/README/image.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/JustinGrote/PowerShell-Containers/debd37c9aeffbc063b0dc7a6bc8d958f4476e720/images/README/image.png


--------------------------------------------------------------------------------