Update output and changelog

Author: claudiospizzi

AnsibleCtl/Functions/Start-AnsibleCtl.ps1

@@ -96,6 +96,11 @@ function Start-AnsibleCtl
 
         Write-Verbose "[ansiblectl] Version $Script:PSModuleVersion"
 
+        if (-not $Silent.IsPresent -and $VerbosePreference -eq 'SilentlyContinue')
+        {
+            Write-Host "> Verify input and prepare .ansiblectl cache folder...      `r" -NoNewline
+        }
+
         # Ensure we are on a Windows system by using the legacy Windows
         # PowerShell or the modern cross-platform PowerShell on the Windows OS.
         if ($PSVersionTable.PSVersion.Major -gt 5 -and -not $IsWindows)
@@ -193,6 +198,11 @@ function Start-AnsibleCtl
         ## Container Image
         ##
 
+        if (-not $Silent.IsPresent -and $VerbosePreference -eq 'SilentlyContinue')
+        {
+            Write-Host "> Define container image for the ansiblectl container...    `r" -NoNewline
+        }
+
         if ($PSCmdlet.ParameterSetName -like 'ContainerImage_*')
         {
             # Nothing to do, the container image is already specified.
@@ -231,6 +241,11 @@ function Start-AnsibleCtl
         ## SSH Keys
         ##
 
+        if (-not $Silent.IsPresent -and $VerbosePreference -eq 'SilentlyContinue')
+        {
+            Write-Host "> Prepare SSH Keys for the ansiblectl container...          `r" -NoNewline
+        }
+
         $sshKeysCleanupFiles = @()
 
         if ($PSCmdlet.ParameterSetName -like '*_KeyFiles')
@@ -340,18 +355,6 @@ function Start-AnsibleCtl
         ## Run Ansible Control Node
         ##
 
-        if (-not $Silent.IsPresent)
-        {
-            Write-Host ''
-            Write-Host 'ANSIBLE CONTROL NODE' -ForegroundColor 'Magenta'
-            Write-Host '********************' -ForegroundColor 'Magenta'
-            Write-Host ''
-            Write-Host "Ansible Repo    : $repositoryFullPath"
-            Write-Host "Container Image : $ContainerImage"
-            Write-Host "SSH Key Mode    : $sshKeyMode"
-            Write-Host ''
-        }
-
         $normalizedRepositoryPath = '/{0}' -f $repositoryFullPath.Replace(':', '').Replace('\', '/').Trim('/')
 
         $dockerSshKeysVolumeMount        = '{0}/.ansiblectl/.ssh:/tmp/.ssh' -f $normalizedRepositoryPath
@@ -360,17 +363,17 @@ function Start-AnsibleCtl
 
         if ($PSCmdlet.ParameterSetName -like 'Dockerfile_*')
         {
-            if (-not $Silent.IsPresent)
+            if (-not $Silent.IsPresent -and $VerbosePreference -eq 'SilentlyContinue')
             {
-                Write-Host '> Building container image from specified Dockerfile...'
+                Write-Host "> Building container image from specified Dockerfile...     `r" -NoNewline
             }
             Invoke-DockerProcess -Command 'build' -ArgumentList '-t', $ContainerImage, '-f', $Dockerfile, $dockerfilePath -ErrorMessage "The Docker build of the Dockerfile '$Dockerfile' failed."
         }
         else
         {
-            if (-not $Silent.IsPresent)
+            if (-not $Silent.IsPresent -and $VerbosePreference -eq 'SilentlyContinue')
             {
-                Write-Host '> Pulling container image from remote registry...'
+                Write-Host "> Pulling container image from remote registry...           `r" -NoNewline
             }
             Invoke-DockerProcess -Command 'pull' -ArgumentList $ContainerImage -ErrorMessage "The Docker pull of the container image '$ContainerImage' failed."
         }
@@ -380,11 +383,17 @@ function Start-AnsibleCtl
 
         if (-not $Silent.IsPresent)
         {
-            Write-Host '> Start ansiblectl container with mounted volumes...'
+            Write-Host '                                                            '
+            Write-Host 'ANSIBLE CONTROL NODE' -ForegroundColor 'Magenta'
+            Write-Host '********************' -ForegroundColor 'Magenta'
+            Write-Host ''
+            Write-Host "Ansible Repo    : $repositoryFullPath"
+            Write-Host "Container Image : $ContainerImage"
+            Write-Host "SSH Key Mode    : $sshKeyMode"
             Write-Host ''
         }
 
-        Invoke-DockerProcess -Command 'run' -ArgumentList '-it', '--rm', '-h', 'ansiblectl', '-v', $dockerSshKeysVolumeMount, '-v', $dockerRepositoryPathVolumeMount, '-v', $dockerBashHistoryVolumeMount, $ContainerImage
+        Invoke-DockerProcess -Command 'run' -ArgumentList '-it', '--rm', '-h', 'ansiblectl', '-v', $dockerSshKeysVolumeMount, '-v', $dockerRepositoryPathVolumeMount, '-v', $dockerBashHistoryVolumeMount, $ContainerImage -ShowOutput
     }
     catch
     {
@@ -408,17 +417,23 @@ Register-ArgumentCompleter -CommandName 'Start-AnsibleCtl' -ParameterName 'Ansib
     param ($CommandName, $ParameterName, $WordToComplete, $CommandAst, $FakeBoundParameters)
 
     # Hardcode the 'latest' tag as it's always available
-    [System.Management.Automation.CompletionResult]::new('latest', 'latest', 'ParameterValue', 'latest')
+    $results = @('latest')
 
     # Query the config.json from the GitHub repository to get the available
     # Ansible versions which will be builded and published to the container.
     # This is not perfect, but the image registry has non anonymous API to get
     # all containers tags.
     $config = Invoke-RestMethod -uri 'https://raw.githubusercontent.com/claudiospizzi/ansiblectl/refs/heads/main/docker/config.json'
     foreach ($ansibleVersion in $config.ansible.versions) {
-        if ($ansibleVersion -like "$WordToComplete*") {
-            [System.Management.Automation.CompletionResult]::new($ansibleVersion, $ansibleVersion, 'ParameterValue', $ansibleVersion)
-            [System.Management.Automation.CompletionResult]::new("$ansibleVersion-ci", "$ansibleVersion-ci", 'ParameterValue', "$ansibleVersion-ci")
+        $results += $ansibleVersion
+        $results += "$ansibleVersion-ci"
+    }
+
+    foreach ($result in $results)
+    {
+        if ($result -like "$WordToComplete*")
+        {
+            [System.Management.Automation.CompletionResult]::new($result, $result, 'ParameterValue', $result)
         }
     }
 }

AnsibleCtl/Helpers/Invoke-DockerProcess.ps1

@@ -21,6 +21,11 @@ function Invoke-DockerProcess
         [System.String[]]
         $ArgumentList,
 
+        # If specified, show the output of the docker command in the console.
+        [Parameter(Mandatory = $false)]
+        [Switch]
+        $ShowOutput,
+
         # The error message to display if the command fails.
         [Parameter(Mandatory = $false)]
         [System.String]
@@ -41,7 +46,7 @@ function Invoke-DockerProcess
 
         # If -Verbose was specified, don't redirect the output and show it in
         # the console output.
-        if ($VerbosePreference -eq 'SilentlyContinue')
+        if ($VerbosePreference -eq 'SilentlyContinue' -and -not $ShowOutput.IsPresent)
         {
             $dockerCommandSplat['RedirectStandardOutput'] = [System.IO.Path]::GetTempFileName()
             $dockerCommandSplat['RedirectStandardError']  = [System.IO.Path]::GetTempFileName()

CHANGELOG.md

@@ -5,6 +5,6 @@ All notable changes to this project will be documented in this file.
 The format is mainly based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
-## 0.1.0 - 2025-09-17
+## Unreleased
 
-- Added: Initial development release of AnsibleCtl with the Start-AnsibleCtl cmdlet
+- Added: Initial development release of AnsibleCtl container image with the Start-AnsibleCtl cmdlet