Update comments and PnP.PowerShell version in Dockerfile

Author: KoenZomers

docker/linux-arm32.dockerfile

@@ -1,14 +1,14 @@
 FROM arm32v7/debian:bookworm-slim
 
-# Base deps + ICU (needed for .NET/PowerShell on Linux)
+# ---- Base deps + ICU (needed for .NET/PowerShell on Linux) ----
 RUN set -eux; \
     apt-get update; \
     DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends \
         ca-certificates curl tar libicu-dev \
     && update-ca-certificates \
     && rm -rf /var/lib/apt/lists/*
 
-# Install PowerShell 7.4.2 (ARM32)
+# ---- Install PowerShell 7.4.2 (ARM32) ----
 ARG PWSH_VERSION=7.4.2
 RUN set -eux; \
     curl -sSL -o /tmp/pwsh.tar.gz \
@@ -18,33 +18,33 @@ RUN set -eux; \
     ln -s /opt/microsoft/powershell/7/pwsh /usr/bin/pwsh; \
     rm -f /tmp/pwsh.tar.gz
 
-# PnP version to install at first container start (on real ARM32, not QEMU)
-ARG PNP_VERSION=3.0.0
+# ---- PnP.PowerShell version to install at first run ----
+ARG PNP_VERSION=3.1.306-nightly
 ENV PNP_VERSION=${PNP_VERSION} TZ=Etc/UTC
 
-# Create a robust entrypoint script
-# - Installs PnP.PowerShell once on first run (real ARM32 hardware)
-# - Then execs pwsh, forwarding any arguments
+# ---- Write entrypoint script via heredoc (no semicolon/backslash after <<'SH') ----
 RUN set -eux; \
-  install -d -m 0755 /usr/local/bin; \
-  cat > /usr/local/bin/docker-entrypoint.sh <<'SH'; \
+    install -d -m 0755 /usr/local/bin; \
+    cat > /usr/local/bin/docker-entrypoint.sh <<'SH'
 #!/bin/sh
 set -eu
 
-# First-run install on real ARM CPU only; avoid QEMU-build crashes
+# First-run install on real ARM32 (avoid QEMU build-time crashes)
 pwsh -NoLogo -NoProfile -Command "
-  \$m = Get-Module -ListAvailable PnP.PowerShell -ErrorAction SilentlyContinue;
-  if (-not \$m) {
-    Install-Module PnP.PowerShell -Scope AllUsers -Force -AllowPrerelease -SkipPublisherCheck -RequiredVersion \$env:PNP_VERSION;
+  $m = Get-Module -ListAvailable PnP.PowerShell -ErrorAction SilentlyContinue;
+  if (-not $m) {
+    Install-Module PnP.PowerShell -Scope AllUsers -Force -AllowPrerelease -SkipPublisherCheck -RequiredVersion $env:PNP_VERSION;
     Write-Host 'PnP.PowerShell installed.';
   } else {
     Write-Host 'PnP.PowerShell already present.';
   }"
-# Hand off to PowerShell; forward all args
+# Hand off to PowerShell; forward all container args
 exec pwsh -NoLogo "$@"
 SH
-  chmod +x /usr/local/bin/docker-entrypoint.sh
 
-# Use exec-form ENTRYPOINT; CMD can supply default args if you like
+# mark executable in a separate RUN (simplest, avoids heredoc chaining quirks)
+RUN chmod +x /usr/local/bin/docker-entrypoint.sh
+
+# Use exec-form ENTRYPOINT so signals are delivered to pwsh
 ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"]
 CMD []