Skip to content

Add zero-build path, deploy versioning/rollback, source-of-truth notes#3

Merged
schlunsen merged 1 commit into
mainfrom
skill-current-practices
Jul 3, 2026
Merged

Add zero-build path, deploy versioning/rollback, source-of-truth notes#3
schlunsen merged 1 commit into
mainfrom
skill-current-practices

Conversation

@schlunsen

Copy link
Copy Markdown
Collaborator

Summary

  • New Path C: Zero-build (config_files) app strategy — stock image + source embedded in config_files, no Dockerfile/CI/registry; includes manifest-regeneration recipe and 1 MiB ConfigMap limit guidance
  • Deploy Versioning & Rollback section: every deploy gets a unique version tag (definition commit short-sha or timestamp), manifest snapshot per deploy record, rollback via {"record_id": ...} on the redeploy endpoint
  • Redeploy flow for zero-build apps: re-import definition before redeploy
  • API notes: {"success": true, "data": ...} response envelope, iframe-token CLI verification for SSO-gated apps
  • Declared this repo the single source of truth (README + SKILL.md header comment)

🤖 Generated with Claude Code

…, API envelope + verification notes; declare repo as single source of truth
Copilot AI review requested due to automatic review settings July 3, 2026 22:26

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the n0-app skill documentation to add a “zero-build” deployment path (embedding source into config_files) and to document deploy versioning/rollback behavior, while also declaring this repo as the canonical source for the skill.

Changes:

  • Add Path C (zero-build config_files) guidance, including a manifest-regeneration workflow and ConfigMap size-limit notes.
  • Document deploy versioning & rollback semantics and update the redeploy flow for zero-build apps (re-import definition first).
  • Add source-of-truth notes and additional API usage notes (response envelope, iframe-token CLI verification).

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
SKILL.md Adds Path C documentation, deploy versioning/rollback guidance, and a source-of-truth header note.
README.md Declares this repo as source-of-truth and updates the “What it does” list to mention the zero-build config_files option.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread SKILL.md
Comment on lines 111 to 115
### Step 2: Decide the Image Strategy

**Choose ONE of these two paths:**
**Choose ONE of these three paths:**

#### Path A: Use Upstream Pre-built Images (preferred when available)
Comment thread README.md
Comment on lines 11 to 15
1. **Analyzes** a repository to detect the tech stack, framework, ports, databases, and dependencies
2. **Decides the image strategy**: use upstream pre-built images OR generate a custom `Dockerfile`
2. **Decides the image strategy**: upstream pre-built images, a custom `Dockerfile`, OR a zero-build `config_files` app (no CI needed)
3. **Generates** an `n0-app.json` manifest describing all services
4. **Generates** a `.gitea/workflows/build-and-push.yml` CI workflow for building and pushing Docker images
5. **Validates** the output against N0's manifest schema
@schlunsen
schlunsen merged commit e23a4ed into main Jul 3, 2026
2 checks passed
@schlunsen
schlunsen deleted the skill-current-practices branch July 3, 2026 22:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants