docs: fix --deploy-git-folder description + document buildFromGit constraints and startWithoutCode#350
Merged
krls2020 merged 2 commits intoJun 19, 2026
Conversation
…straints and startWithoutCode - pipeline.mdx: the --deploy-git-folder flag description was a copy of --zerops-yaml-path's text. Corrected to what the flag does per 'zcli service deploy --help': uploads the .git folder with the deploy (ignored by default). - import.mdx buildFromGit: document two constraints verified against the live platform: the repository must be publicly accessible (a private repo fails at clone time with a FAILED build and no build log), and the URL must not carry a trailing .git suffix (fails the same way). - import.mdx: add the startWithoutCode service key (present in the live import JSON schema, previously undocumented): starts a runtime service's containers without waiting for a first deploy.
tikinang
previously approved these changes
Jun 18, 2026
Comment on lines
+414
to
+416
| Set `true` to start a runtime service's containers without waiting for a first | ||
| deploy. Useful for provisioning a service whose code arrives later (e.g. via | ||
| SSH or a later pipeline run). |
Contributor
There was a problem hiding this comment.
Jeste bych pridal "Useful for ... and "playing around" / test commands to be later versioned into zerops.yaml run.prepareCommands". Nebo neco na ten zpusob.
…→ run.prepareCommands workflow Per review on PR #350: startWithoutCode is also the on-ramp for getting a bare runtime container to SSH into and experiment in, then versioning the setup steps into run.prepareCommands so they persist across container replacements (SSH changes alone are non-persistent). Cross-links the SSH reference and the zerops.yaml run.prepareCommands spec anchor.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Three small reference fixes, each verified against the live platform / live
zcli:pipeline.mdx—--deploy-git-folderflag description was wrong. Thezcli service deployflag list described it as "Sets a custom path to the zerops.yaml file" — a copy of--zerops-yaml-path's text two rows below. Perzcli service deploy --help, the flag actually uploads the.gitfolder with the deploy (ignored by default). Description corrected.import.mdx—buildFromGitconstraints documented. Two failure modes verified against the live platform, both ending in a terminal FAILED build with no build log (hard to diagnose without knowing them):.gitsuffix on the URL (the conventional clone-URL form) fails the same way.import.mdx—startWithoutCodeservice key added. Present in the live import JSON schema (Set true, if you want to start service without code.) but previously undocumented. Added a table row: starts a runtime service's containers without waiting for a first deploy.🤖 Generated with Claude Code