Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
380988c194 |
No files matched your search
@@ -115,7 +115,7 @@ live) are kept and never logged; only `vars` are overwritten. Images are
|
|||||||
re-pulled (`pullImage`).
|
re-pulled (`pullImage`).
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
- uses: https://git.rfa.cz/tth-pub/ci-actions/portainer-deploy@v4
|
- uses: https://git.rfa.cz/tth-pub/ci-actions/portainer-deploy@v5
|
||||||
with:
|
with:
|
||||||
url: ${{ secrets.PORTAINER_URL }}
|
url: ${{ secrets.PORTAINER_URL }}
|
||||||
token: ${{ secrets.PORTAINER_TOKEN }}
|
token: ${{ secrets.PORTAINER_TOKEN }}
|
||||||
@@ -128,6 +128,23 @@ re-pulled (`pullImage`).
|
|||||||
smoke-timeout: "180"
|
smoke-timeout: "180"
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Config files from the repo can ride along as Swarm configs. Each becomes a
|
||||||
|
config named after its content hash, created when missing; the stack
|
||||||
|
variable points at it, so a changed file rolls the services that mount it,
|
||||||
|
and superseded versions are removed once nothing uses them:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
configs: |
|
||||||
|
CFG_NGINX=deploy/nginx.conf
|
||||||
|
config-prefix: myapp_
|
||||||
|
```
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# compose
|
||||||
|
configs:
|
||||||
|
nginx_conf: {external: true, name: "${CFG_NGINX}"}
|
||||||
|
```
|
||||||
|
|
||||||
Pin images in the compose file to the variable (`image: …:${IMAGE_TAG}`), so
|
Pin images in the compose file to the variable (`image: …:${IMAGE_TAG}`), so
|
||||||
the deployed version is the commit that passed the gate, not whatever
|
the deployed version is the commit that passed the gate, not whatever
|
||||||
`latest` points at when Swarm pulls.
|
`latest` points at when Swarm pulls.
|
||||||
|
|||||||
+126
-68
@@ -4,7 +4,8 @@ description: >
|
|||||||
compose file is the single source of truth: Portainer's stored compose is
|
compose file is the single source of truth: Portainer's stored compose is
|
||||||
replaced on every deploy, the stack's env vars (where the secrets live) are
|
replaced on every deploy, the stack's env vars (where the secrets live) are
|
||||||
kept and only the given variables are overwritten. Images are re-pulled.
|
kept and only the given variables are overwritten. Images are re-pulled.
|
||||||
Optionally waits until a URL answers with the expected status.
|
Config files from the repo can be shipped as content-addressed Swarm
|
||||||
|
configs. Optionally waits until a URL answers with the expected status.
|
||||||
|
|
||||||
inputs:
|
inputs:
|
||||||
url:
|
url:
|
||||||
@@ -29,6 +30,19 @@ inputs:
|
|||||||
Stack variables to set, one NAME=value per line (e.g. IMAGE_TAG=sha-1234abcd).
|
Stack variables to set, one NAME=value per line (e.g. IMAGE_TAG=sha-1234abcd).
|
||||||
Every other stack variable is kept as it is.
|
Every other stack variable is kept as it is.
|
||||||
default: ""
|
default: ""
|
||||||
|
configs:
|
||||||
|
description: >
|
||||||
|
Files shipped as Swarm configs, one VAR=path per line. Each file becomes
|
||||||
|
a config named <config-prefix><var>-<sha256[:12] of the content>
|
||||||
|
(created when missing) and the stack variable VAR is set to that name,
|
||||||
|
so the compose file references it as
|
||||||
|
`{external: true, name: "${VAR}"}`. A changed file = a new config =
|
||||||
|
the service is updated; older versions of the same VAR are removed once
|
||||||
|
no service uses them.
|
||||||
|
default: ""
|
||||||
|
config-prefix:
|
||||||
|
description: Prefix of the config names (e.g. the stack name and an underscore).
|
||||||
|
default: ""
|
||||||
prune:
|
prune:
|
||||||
description: Remove services that are no longer in the compose file.
|
description: Remove services that are no longer in the compose file.
|
||||||
default: "false"
|
default: "false"
|
||||||
@@ -53,6 +67,8 @@ runs:
|
|||||||
COMPOSE_FILE: ${{ inputs.compose-file }}
|
COMPOSE_FILE: ${{ inputs.compose-file }}
|
||||||
ENDPOINT_ID: ${{ inputs.endpoint-id }}
|
ENDPOINT_ID: ${{ inputs.endpoint-id }}
|
||||||
SET_VARS: ${{ inputs.vars }}
|
SET_VARS: ${{ inputs.vars }}
|
||||||
|
CONFIGS: ${{ inputs.configs }}
|
||||||
|
CONFIG_PREFIX: ${{ inputs.config-prefix }}
|
||||||
PRUNE: ${{ inputs.prune }}
|
PRUNE: ${{ inputs.prune }}
|
||||||
SMOKE_URL: ${{ inputs.smoke-url }}
|
SMOKE_URL: ${{ inputs.smoke-url }}
|
||||||
SMOKE_STATUS: ${{ inputs.smoke-status }}
|
SMOKE_STATUS: ${{ inputs.smoke-status }}
|
||||||
@@ -63,73 +79,115 @@ runs:
|
|||||||
echo "::notice::portainer-deploy: no stack id, deploy skipped"
|
echo "::notice::portainer-deploy: no stack id, deploy skipped"
|
||||||
exit 0
|
exit 0
|
||||||
fi
|
fi
|
||||||
: "${PORTAINER_URL:?url input is empty}" "${PORTAINER_TOKEN:?token input is empty}"
|
# The stack env carries the secrets: it only ever lives in this
|
||||||
[ -f "$COMPOSE_FILE" ] || { echo "::error::compose file $COMPOSE_FILE not found"; exit 1; }
|
# process's memory, between the GET and the PUT, never in the log.
|
||||||
work="${RUNNER_TEMP:-/tmp}/portainer-deploy"; mkdir -p "$work"; chmod 700 "$work"
|
python3 - <<'PY'
|
||||||
trap 'rm -rf "$work"' EXIT
|
import base64, hashlib, json, os, ssl, sys, time, urllib.error, urllib.parse, urllib.request
|
||||||
base="${PORTAINER_URL%/}"
|
|
||||||
|
|
||||||
# The stack body carries the env (secrets): it goes from this GET into
|
E = os.environ
|
||||||
# the PUT body through a private temp file and never to the log.
|
base = E["PORTAINER_URL"].rstrip("/")
|
||||||
code=$(curl -sS -o "$work/stack.json" -w '%{http_code}' \
|
token = E["PORTAINER_TOKEN"]
|
||||||
-H "X-API-Key: $PORTAINER_TOKEN" "$base/api/stacks/$STACK_ID") || code=000
|
stack_id, endpoint = E["STACK_ID"], E.get("ENDPOINT_ID") or "1"
|
||||||
if [ "$code" != 200 ]; then
|
if not base or not token:
|
||||||
echo "::error::Portainer GET /api/stacks/$STACK_ID returned HTTP $code"
|
sys.exit("::error::portainer-deploy: url and token are required")
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
python3 - "$work/stack.json" "$COMPOSE_FILE" "$work/body.json" <<'PY'
|
def api(method, path, body=None, ok=(200,)):
|
||||||
import json, os, sys
|
req = urllib.request.Request(base + path, method=method,
|
||||||
stack_path, compose_path, out_path = sys.argv[1:]
|
headers={"X-API-Key": token, "Content-Type": "application/json"},
|
||||||
with open(stack_path) as f:
|
data=None if body is None else json.dumps(body).encode())
|
||||||
stack = json.load(f)
|
try:
|
||||||
sets = {}
|
with urllib.request.urlopen(req, timeout=120) as r:
|
||||||
for line in os.environ.get("SET_VARS", "").splitlines():
|
status, raw = r.status, r.read()
|
||||||
line = line.strip()
|
except urllib.error.HTTPError as e:
|
||||||
if not line:
|
status, raw = e.code, e.read()
|
||||||
continue
|
if status not in ok:
|
||||||
name, sep, value = line.partition("=")
|
raise RuntimeError(f"{method} {path.split('?')[0]} -> HTTP {status}: {raw[:300].decode(errors='replace')}")
|
||||||
if not sep or not name:
|
return status, (json.loads(raw) if raw.strip() else None)
|
||||||
sys.exit(f"portainer-deploy: bad vars line (want NAME=value): {name!r}")
|
|
||||||
sets[name.strip()] = value
|
def lines(name):
|
||||||
env = [e for e in (stack.get("Env") or []) if e.get("name") not in sets]
|
out = {}
|
||||||
env += [{"name": k, "value": v} for k, v in sets.items()]
|
for line in E.get(name, "").splitlines():
|
||||||
with open(compose_path) as f:
|
line = line.strip()
|
||||||
compose = f.read()
|
if not line:
|
||||||
body = {
|
continue
|
||||||
"stackFileContent": compose,
|
key, sep, value = line.partition("=")
|
||||||
"env": env,
|
if not sep or not key.strip():
|
||||||
"prune": os.environ.get("PRUNE", "false").lower() == "true",
|
sys.exit(f"::error::portainer-deploy: bad {name.lower()} line (want NAME=value): {key!r}")
|
||||||
"pullImage": True,
|
out[key.strip()] = value.strip() if name == "CONFIGS" else value
|
||||||
}
|
return out
|
||||||
fd = os.open(out_path, os.O_WRONLY | os.O_CREAT | os.O_TRUNC, 0o600)
|
|
||||||
with os.fdopen(fd, "w") as f:
|
try:
|
||||||
json.dump(body, f)
|
sets = lines("SET_VARS")
|
||||||
kept = len(env) - len(sets)
|
docker = f"/api/endpoints/{endpoint}/docker"
|
||||||
print(f"stack {stack.get('Name', '?')}: setting {', '.join(f'{k}={v}' for k, v in sets.items()) or 'nothing'}; {kept} other variable(s) kept")
|
|
||||||
|
# Content-addressed configs: the name changes with the content, so
|
||||||
|
# a changed file rolls the services that mount it.
|
||||||
|
prefix = E.get("CONFIG_PREFIX", "")
|
||||||
|
stale = []
|
||||||
|
for var, path in lines("CONFIGS").items():
|
||||||
|
with open(path, "rb") as f:
|
||||||
|
data = f.read()
|
||||||
|
stem = f"{prefix}{var.lower()}"
|
||||||
|
name = f"{stem}-{hashlib.sha256(data).hexdigest()[:12]}"
|
||||||
|
flt = urllib.parse.quote(json.dumps({"label": [f"portainer-deploy.config={stem}"]}))
|
||||||
|
_, existing = api("GET", f"{docker}/configs?filters={flt}")
|
||||||
|
names = {c["Spec"]["Name"]: c["ID"] for c in existing or []}
|
||||||
|
if name in names:
|
||||||
|
print(f"config {name} ({path}) unchanged")
|
||||||
|
else:
|
||||||
|
api("POST", f"{docker}/configs/create", {
|
||||||
|
"Name": name,
|
||||||
|
"Data": base64.b64encode(data).decode(),
|
||||||
|
"Labels": {"portainer-deploy.config": stem},
|
||||||
|
}, ok=(200, 201))
|
||||||
|
print(f"config {name} created from {path}")
|
||||||
|
stale += [(n, i) for n, i in names.items() if n != name]
|
||||||
|
sets[var] = name
|
||||||
|
|
||||||
|
_, stack = api("GET", f"/api/stacks/{stack_id}")
|
||||||
|
env = [e for e in (stack.get("Env") or []) if e.get("name") not in sets]
|
||||||
|
kept = len(env)
|
||||||
|
env += [{"name": k, "value": v} for k, v in sets.items()]
|
||||||
|
with open(E["COMPOSE_FILE"]) as f:
|
||||||
|
compose = f.read()
|
||||||
|
api("PUT", f"/api/stacks/{stack_id}?endpointId={endpoint}", {
|
||||||
|
"stackFileContent": compose,
|
||||||
|
"env": env,
|
||||||
|
"prune": E.get("PRUNE", "false").lower() == "true",
|
||||||
|
"pullImage": True,
|
||||||
|
})
|
||||||
|
shown = ", ".join(f"{k}={v}" for k, v in sets.items()) or "nothing"
|
||||||
|
print(f"stack {stack.get('Name', stack_id)} updated from {E['COMPOSE_FILE']}: {shown}; {kept} other variable(s) kept")
|
||||||
|
|
||||||
|
# Older versions go once nothing mounts them; Docker refuses to
|
||||||
|
# delete a config in use (the previous task may still be draining),
|
||||||
|
# the next deploy retries.
|
||||||
|
for name, cid in stale:
|
||||||
|
try:
|
||||||
|
api("DELETE", f"{docker}/configs/{cid}", ok=(200, 204))
|
||||||
|
print(f"config {name} removed (superseded)")
|
||||||
|
except RuntimeError:
|
||||||
|
print(f"config {name} still in use, kept for the next deploy")
|
||||||
|
except (RuntimeError, OSError) as exc:
|
||||||
|
sys.exit(f"::error::portainer-deploy: {exc}")
|
||||||
|
|
||||||
|
url = E.get("SMOKE_URL", "")
|
||||||
|
if url:
|
||||||
|
want, deadline = E.get("SMOKE_STATUS", "200"), time.time() + float(E.get("SMOKE_TIMEOUT") or 180)
|
||||||
|
ctx = ssl.create_default_context()
|
||||||
|
ctx.check_hostname, ctx.verify_mode = False, ssl.CERT_NONE
|
||||||
|
while True:
|
||||||
|
try:
|
||||||
|
with urllib.request.urlopen(url, timeout=10, context=ctx) as r:
|
||||||
|
got = str(r.status)
|
||||||
|
except urllib.error.HTTPError as e:
|
||||||
|
got = str(e.code)
|
||||||
|
except (urllib.error.URLError, OSError):
|
||||||
|
got = "000"
|
||||||
|
if got == want:
|
||||||
|
print(f"smoke: {url} answered {got}")
|
||||||
|
break
|
||||||
|
if time.time() >= deadline:
|
||||||
|
sys.exit(f"::error::smoke: {url} answered {got}, expected {want}")
|
||||||
|
time.sleep(10)
|
||||||
PY
|
PY
|
||||||
|
|
||||||
code=$(curl -sS -o "$work/resp.json" -w '%{http_code}' -X PUT \
|
|
||||||
"$base/api/stacks/$STACK_ID?endpointId=$ENDPOINT_ID" \
|
|
||||||
-H "X-API-Key: $PORTAINER_TOKEN" -H "Content-Type: application/json" \
|
|
||||||
--data-binary "@$work/body.json") || code=000
|
|
||||||
if [ "$code" != 200 ]; then
|
|
||||||
echo "::error::Portainer stack PUT returned HTTP $code: $(head -c 300 "$work/resp.json" 2>/dev/null)"
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
echo "stack $STACK_ID updated from $COMPOSE_FILE"
|
|
||||||
|
|
||||||
[ -n "$SMOKE_URL" ] || exit 0
|
|
||||||
deadline=$(( $(date +%s) + SMOKE_TIMEOUT ))
|
|
||||||
while :; do
|
|
||||||
got=$(curl -sk -o /dev/null -w '%{http_code}' --max-time 10 "$SMOKE_URL" 2>/dev/null) || got=000
|
|
||||||
if [ "$got" = "$SMOKE_STATUS" ]; then
|
|
||||||
echo "smoke: $SMOKE_URL answered $got"
|
|
||||||
break
|
|
||||||
fi
|
|
||||||
if [ "$(date +%s)" -ge "$deadline" ]; then
|
|
||||||
echo "::error::smoke: $SMOKE_URL answered $got, expected $SMOKE_STATUS (waited ${SMOKE_TIMEOUT}s)"
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
sleep 10
|
|
||||||
done
|
|
||||||
Reference in new issue
Block a user