From 8201138038a846c9c8b9c7aa110b760387fce6d8 Mon Sep 17 00:00:00 2001 From: Jesse Date: Thu, 6 Aug 2026 08:41:30 +0000 Subject: [PATCH] Update deployment preflight guidance --- deploy-company-linux/SKILL.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/deploy-company-linux/SKILL.md b/deploy-company-linux/SKILL.md index c262227..75da13f 100644 --- a/deploy-company-linux/SKILL.md +++ b/deploy-company-linux/SKILL.md @@ -14,15 +14,16 @@ Deploy applications to the company Linux host through SSH with release directori 3. Prefer an existing `compose.yaml`, `compose.yml`, `docker-compose.yaml`, or `docker-compose.yml`. Use Dockerfile mode only when no Compose configuration exists. 4. Derive a lowercase app name that starts with a letter or digit and contains only letters, digits, underscores, and hyphens. Do not reuse an existing application name unless the user is updating that application. 5. Detect port collisions against the server profile and a live preflight. Ask only when the intended application name, public port, or health endpoint cannot be inferred safely. -6. Authenticate with an SSH key. If key authentication is unavailable, use `COMPANY_LINUX_PASSWORD` only for the current process. Never write a password into the skill, repository, deployment archive, command output, or shell history. -7. Run preflight before deployment: +6. Check whether every Docker base image is cached before deploying. The server may be unable to reach Docker Hub; for Node.js projects, prefer the server's cached `local/node:24.16.0-bookworm` image when appropriate. +7. Authenticate with an SSH key. If key authentication is unavailable, use `COMPANY_LINUX_PASSWORD` only for the current process. Never write a password into the skill, repository, deployment archive, command output, or shell history. +8. Run preflight before deployment: ```powershell powershell -ExecutionPolicy Bypass -File scripts/deploy.ps1 ` -Action preflight -AppName ``` -8. Deploy from the project root: +9. Deploy from the project root: ```powershell powershell -ExecutionPolicy Bypass -File scripts/deploy.ps1 ` @@ -31,7 +32,7 @@ Deploy applications to the company Linux host through SSH with release directori -HealthUrl ``` -9. Report the release path, containers, exposed endpoint, and health result. If the command fails, report whether automatic rollback succeeded and include the smallest relevant log excerpt. +10. Report the release path, containers, exposed endpoint, and health result. If the command fails, report whether automatic rollback succeeded and include the smallest relevant log excerpt. ## Authentication Setup