FAQ
Frequently Asked Questions
Find answers about destination precedence, tags, backup remotes, Run equivalence, and dry-run behavior.
custy pushCategory
Quick Command
custy push [OPTIONS]Overview
These answers clarify which references the profile synchronizes and how destination precedence affects the effective remote set.
What Does Custy Push by Default?
The workflow pushes the current HEAD to resolved main remotes. It pushes a tag
only when a tag is present in workflow state and tag pushing is not skipped.
Does `custy push` Create a Commit or Tag?
No. The push profile validates and synchronizes existing references. Create and review commits or tags first.
Can It Push to a Backup Remote?
Yes, when backup synchronization is enabled, an eligible backup remote resolves, and the current branch is not excluded by safety rules.
What Does `--remote` Override?
It selects exactly one destination and overrides --all-remote,
tool.custy.git.push_to, and the configured remote groups.
How Does `custy run push` Differ?
Both forms select the registered push profile and propagate the same push
options. Run profiles such as Dev, Release, and Full inherit the same selection
precedence whenever their pipeline reaches the push step. The direct form
disables hidden Rich rendering completely, while custy run push suspends its
visible progress display during interactive authentication. Both forms give
Git stable terminal ownership for username, PAT, and SSH prompts.
Does Dry-Run Contact the Remote?
Validation and remote resolution can still inspect repository and remote state. Its primary guarantee is that normal push mutations are replaced with reported intent; read the actual output for the current version.
Why Does Docker Ask for Credentials Again?
The container does not inherit the host credential-manager session. Use native
SSH, answer an approved interactive prompt, or configure Custy's optional
protected external fallback with custy configure credentials.
Why Does an Interactive Push Look Frozen?
Git is normally waiting for username and PAT input. Current Custy releases give
manual Git authentication direct terminal ownership and print guidance before
the prompt. Direct commands disable their otherwise hidden Rich renderer, and
Run pipelines suspend visible progress until authentication finishes. If only
custy push loses the prompt while custy run push works, rebuild or pull the
current image. Do not submit two empty lines: GitHub can report Repository not found together with Authentication failed for missing access to a private
repository.
What Is the Manual Docker Authentication Flow?
Run with -it and omit the managed credential mount or variable. Enter the
provider username, then enter a PAT when Git asks for Password. The password
field normally hides input. A disposable container does not retain these values
and separate GitHub and GitLab remotes may prompt independently.
Does Custy Store My Token?
Never in project configuration. File mode stores it in an explicitly selected external protected file; environment mode reads the named runtime variable. Normal Git credentials and SSH remain owned by their native tools.
Can a Non-Interactive Push Wait for Input?
With the recommended fail_non_interactive = true, no. Git prompting is
disabled when it cannot be answered, so the job fails with an actionable
authentication error instead of hanging.