Functions/Public/ConvertTo-Dockerfile.ps1
|
function ConvertTo-Dockerfile { <# .SYNOPSIS Scans and converts a valid WIM or VHDX file into a Dockerfile. .DESCRIPTION This command is the main entrypoint into this PowerShell module. .PARAMETER ImagePath The filesystem path to the valid WIM or VHDX file that will be inspected for artifacts. NOTE: You will need administrative permissions in order to mount and inspect image files. .PARAMETER OutputPath An optional parameter that specifies the filesystem path where artifacts and the resulting Dockerfile will be stored. If you do not specify a path, a temporary directory will be created for you. .PARAMETER Artifact Specify the discovery artifacts that will be scanned during the ConvertTo-Dockerfile command. You can obtain the supported list of artifacts by running the Get-WindowsArtifacts command in the same module. .PARAMETER MountPath The filesystem path to the directory where the image will be mounted to for discovery. The folder will be created if it does not exist. #> [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [ValidateScript({ if (!(Test-Path -Path $PSItem)) { return $false } else { return $true } })] [string] $ImagePath, [Parameter(Mandatory = $false)] [string] $OutputPath, [Parameter(Mandatory = $false)] [string] $MountPath, [Parameter(Mandatory = $false)] [string[]] $Artifact ) ### If the user doesn't specify an output path, then generate one if (!$PSBoundParameters.Keys.Contains('OutputPath')) { $OutputPath = GenerateOutputFolder } else { $OutputPath = GenerateOutputFolder -Path $OutputPath } Write-Verbose -Message ('Starting conversion process') ### Verify the image type before proceeding $ImageType = GetImageType -Path $ImagePath Write-Verbose -Message ('Image type is: {0}' -f $ImageType) try { ### Mount the image to a directory $Mount = MountImage -ImagePath $ImagePath -MountPath $MountPath Write-Verbose -Message ('Finished mounting image to: {0}' -f $Mount.Path) } catch { throw 'Fatal error: couldn''t mount image file: {0}' -f $PSItem } ### Perform artifact discovery if (!$PSBoundParameters.Keys.Contains('Artifact')) { $Artifact = Get-WindowsArtifacts } DiscoverArtifacts -Artifact $Artifact -OutputPath $OutputPath ### Generate Dockerfile GenerateDockerfile -ArtifactPath $OutputPath -Artifact $Artifact Write-Verbose -Message 'Finished generating the Dockerfile' ### Dismount the image when inspection is completed $null = Dismount-WindowsImage -Path $Mount.Path -Discard Write-Verbose -Message ('Finished dismounting the Windows image from {0}' -f $Mount.Path) } |