fargo
1a822493ba
963 markdown files reformatted with the repository's pinned prettier so pnpm format:check covers the folded tree like every other repo file. The formatter's embedded-language pass also normalized code fences (TS semicolons, closed HTML tags in examples, lowercased CSS hex colors, one renumbered list that skipped an index). Alphanumeric token deltas vs the fold commit were audited file-by-file; all are formatter-equivalent markup normalizations plus the four sanitized skills.
83 lines
2.5 KiB
Markdown
83 lines
2.5 KiB
Markdown
---
|
|
name: mosaic-deploy
|
|
description: 'Full end-to-end deploy flow for Mosaic Stack projects: push branch → open PR → wait for CI → merge → redeploy Portainer stack. Use when deploying a feature branch to production or staging, or when asked to ship a completed feature. Orchestrates mosaic-gitea, mosaic-woodpecker, and mosaic-portainer skills.'
|
|
---
|
|
|
|
# mosaic-deploy
|
|
|
|
End-to-end deployment flow for Mosaic Stack projects.
|
|
|
|
## Full Deploy Sequence
|
|
|
|
```
|
|
push branch → open PR → CI passes → merge → portainer redeploy
|
|
```
|
|
|
|
### Step 1: Push branch and open PR
|
|
|
|
```bash
|
|
cd ~/src/<repo>-worktrees/<task-slug>
|
|
git push -u origin <branch>
|
|
~/.config/mosaic/tools/git/pr-create.sh -t "feat: ..." -b "..." -i <issue#>
|
|
# Note the PR number from output
|
|
```
|
|
|
|
### Step 2: Wait for CI
|
|
|
|
```bash
|
|
~/.config/mosaic/tools/git/pr-ci-wait.sh -n <pr#>
|
|
```
|
|
|
|
If CI fails, check:
|
|
|
|
```bash
|
|
source ~/.config/mosaic/tools/_lib/credentials.sh && load_credentials woodpecker
|
|
~/.config/mosaic/tools/woodpecker/pipeline-status.sh -r <org>/<repo>
|
|
```
|
|
|
|
### Step 3: Merge
|
|
|
|
```bash
|
|
cd ~/src/<repo>
|
|
~/.config/mosaic/tools/git/pr-merge.sh -n <pr#> -d
|
|
```
|
|
|
|
For branch-protected repos (force merge):
|
|
|
|
```bash
|
|
GITEA_TOKEN=$(cat ~/.config/mosaic/credentials/gitea.env | grep TOKEN | cut -d= -f2)
|
|
curl -X POST "https://git.mosaicstack.dev/api/v1/repos/<org>/<repo>/pulls/<pr#>/merge" \
|
|
-H "Authorization: token $GITEA_TOKEN" -H "Content-Type: application/json" \
|
|
-d '{"Do":"squash","force_merge":true}'
|
|
```
|
|
|
|
### Step 4: Redeploy Portainer stack
|
|
|
|
```bash
|
|
source ~/.config/mosaic/tools/_lib/credentials.sh && load_credentials portainer
|
|
~/.config/mosaic/tools/portainer/stack-redeploy.sh -n <stack-name> -p
|
|
```
|
|
|
|
Check deployment:
|
|
|
|
```bash
|
|
~/.config/mosaic/tools/portainer/stack-status.sh -n <stack-name>
|
|
~/.config/mosaic/tools/portainer/stack-logs.sh -n <stack-name> -l 50
|
|
```
|
|
|
|
## Stack Name Map
|
|
|
|
| Project | Stack Name |
|
|
| ------------ | -------------- |
|
|
| mosaic-stack | `mosaic-stack` |
|
|
| sage-phr | `sage-phr` |
|
|
| openbrain | `openbrain` |
|
|
| firefly | `firefly` |
|
|
|
|
## Notes
|
|
|
|
- Workers open PRs but **never merge** — orchestrator or Merge Guard handles step 3+
|
|
- Docker Swarm image pinning: if `-p` doesn't pull a new image, SSH to `w-docker0` (10.1.1.45) and run `docker pull <image>` manually, then redeploy
|
|
- Worktrees: all coding work in `~/src/<repo>-worktrees/<task-slug>`, never in main checkout
|
|
- Always clean up worktree after push: `git worktree remove ~/src/<repo>-worktrees/<task-slug>`
|