mirror of
https://github.com/kellymichels/zscripts-token-savers
synced 2026-10-07 07:18:18 +00:00
502c0e8b29
Implements the versioning rule (SmartPlant's 5-segment scheme, now the global
standard; currently only sp and zscripts are on it at v1.x):
v{major}.{rc}.{beta}.{alpha}.{build}
zversion: get / bump / bump-stage / set. A stage bump zeroes every lower
segment including build. 'bump' is one per PR and one per defect fix, not per
file. Any write rewrites three things together, because they are only useful
when they agree: build-version.json (source of truth), a '# Version:' line in
all 42 script headers (a lone copied script still says which release it came
from), and CHECKSUMS.txt (stamping changes every file).
zrelease: packages the current version as releases/zscripts-<version>.zip with
a sibling .sha256, for people who want the toolkit without cloning. One hash
verifies the download; the bundled CHECKSUMS.txt verifies the extracted
contents. Refuses to overwrite an existing version's zip (released = immutable;
bump instead), and refuses to package when zchecksums fails. tests/ excluded
from the zip; releases/ never packages itself.
First release included: releases/zscripts-v1.0.0.0.0.zip (42 scripts + 7
support files) and its .sha256.
.gitattributes: releases/*.sha256 pinned LF (sha256sum treats a trailing CR as
part of the filename), releases/*.zip marked binary.
Verified end-to-end as a downloader would experience it, in WSL: sha256sum -c
on the zip passes, unzip, sha256sum -c CHECKSUMS.txt inside gives 42 OK / 0
FAILED, and the extracted zdeploy.ps1 header and build-version.json both read
v1.0.0.0.0. Double-release guard and -Verify mode exercised. Full Pester suite
219/219 (the checksum tests absorb the new files automatically).
80 lines
2.8 KiB
PowerShell
80 lines
2.8 KiB
PowerShell
# Evomedia.net Token Savers — https://github.com/kellymichels/zscripts-token-savers
|
|
# Created by Kelly Michels · dev@evomedia.net
|
|
# Licensed under the MIT License. See LICENSE.
|
|
# Version: v1.0.0.0.0
|
|
|
|
# zstart_docker.ps1 — bring up a local docker compose stack from <scriptsRoot>\docker\.
|
|
#
|
|
# Usage:
|
|
# zstart_docker [-Build] [-Attached] [-Solo]
|
|
#
|
|
# -Build rebuild images before starting
|
|
# -Attached stream logs in the foreground (default is detached)
|
|
# -Solo use docker-compose.solo.yml (app only, no proxy)
|
|
#
|
|
param(
|
|
[switch]$Build,
|
|
[switch]$Attached,
|
|
[switch]$Solo
|
|
)
|
|
|
|
$ErrorActionPreference = "Stop"
|
|
Set-Location -Path $PSScriptRoot
|
|
. (Join-Path $PSScriptRoot "ZHelpers.ps1")
|
|
Start-ZTracking
|
|
|
|
Write-Host "=== zstart_docker ===" -ForegroundColor Cyan
|
|
|
|
$composeFileName = if ($Solo) { "docker-compose.solo.yml" } else { "docker-compose.yml" }
|
|
|
|
$dockerPing = Start-Process -FilePath "docker" -ArgumentList "info" -Wait -NoNewWindow -PassThru
|
|
if ($dockerPing.ExitCode -ne 0) {
|
|
Write-Host ""
|
|
Write-Host "ERROR: Docker Engine is not running or this shell cannot reach it." -ForegroundColor Red
|
|
Write-Host " (npipe dockerDesktopLinuxEngine missing usually means Docker Desktop is stopped or still starting.)" -ForegroundColor DarkYellow
|
|
Write-Host ""
|
|
Write-Host "Try:" -ForegroundColor Cyan
|
|
Write-Host " 1. Start Docker Desktop from the Start menu; wait until it shows Running." -ForegroundColor Gray
|
|
Write-Host " 2. If it hangs: open PowerShell as Administrator, run: wsl --shutdown" -ForegroundColor Gray
|
|
Write-Host " then start Docker Desktop again." -ForegroundColor Gray
|
|
Write-Host ""
|
|
Stop-ZTracking; exit 1
|
|
}
|
|
|
|
$composeFile = Join-Path $PSScriptRoot "docker\$composeFileName"
|
|
if (-not (Test-Path $composeFile)) {
|
|
Write-Host "ERROR: Missing $composeFile" -ForegroundColor Red
|
|
Stop-ZTracking; exit 1
|
|
}
|
|
|
|
$envFile = Join-Path $PSScriptRoot ".env"
|
|
if (-not (Test-Path $envFile)) {
|
|
Write-Host "WARNING: .env not found at $envFile - compose may still start if env vars are set elsewhere." -ForegroundColor DarkYellow
|
|
}
|
|
|
|
Push-Location -Path (Join-Path $PSScriptRoot "docker")
|
|
try {
|
|
$dcArgs = @("compose", "-f", $composeFileName, "up")
|
|
if (-not $Attached) {
|
|
$dcArgs += "-d"
|
|
}
|
|
if ($Build) {
|
|
$dcArgs += "--build"
|
|
}
|
|
Write-Host "Running: docker $($dcArgs -join ' ')" -ForegroundColor DarkGray
|
|
& docker @dcArgs
|
|
if ($LASTEXITCODE -ne 0) {
|
|
Stop-ZTracking; exit $LASTEXITCODE
|
|
}
|
|
} finally {
|
|
Pop-Location
|
|
}
|
|
|
|
Write-Host ""
|
|
Write-Host "Stack: http://localhost/" -ForegroundColor Green
|
|
if (-not $Attached) {
|
|
Write-Host 'Logs: docker compose -f docker/docker-compose.yml logs -f' -ForegroundColor DarkGray
|
|
Write-Host 'Stop: docker compose -f docker/docker-compose.yml down' -ForegroundColor DarkGray
|
|
}
|
|
Stop-ZTracking
|