CLI Reference

CLI Reference

Copybara command-line interface.

Basic Usage

java -jar copybara_deploy.jar <command> <config_file> [workflow] [flags]

Commands

migrate

Run a synchronization workflow:

java -jar copybara.jar migrate copy.bara.sky workflow_name [flags]

validate

Validate configuration without running:

java -jar copybara.jar validate copy.bara.sky [workflow_name]

info

Show information about a workflow:

java -jar copybara.jar info copy.bara.sky workflow_name

feedback

Run a feedback workflow:

java -jar copybara.jar feedback copy.bara.sky feedback_workflow_name

Common Flags

—init-history

Process all history (first-time sync):

java -jar copybara.jar migrate copy.bara.sky export --init-history

—last-rev

Start from a specific commit:

java -jar copybara.jar migrate copy.bara.sky export --last-rev abc123

—force

Force sync (ignore state, overwrite destination):

java -jar copybara.jar migrate copy.bara.sky export --force

—ignore-noop

Don’t fail if there are no changes:

java -jar copybara.jar migrate copy.bara.sky export --ignore-noop

—dry-run

Show what would happen without making changes:

java -jar copybara.jar migrate copy.bara.sky export --dry-run

—folder-origin

Use local folder as origin:

java -jar copybara.jar migrate copy.bara.sky test \
  --folder-origin /path/to/source

—folder-destination

Write to local folder:

java -jar copybara.jar migrate copy.bara.sky test \
  --folder-destination /path/to/output

—git-destination-url

Override destination URL:

java -jar copybara.jar migrate copy.bara.sky export \
  --git-destination-url https://github.com/other/repo

—read-config-from-change

Read config from the migrated change:

java -jar copybara.jar migrate copy.bara.sky export \
  --read-config-from-change

Output Control

—console-file-path

Write console output to file:

java -jar copybara.jar migrate copy.bara.sky export \
  --console-file-path output.log

-v (verbose)

Increase verbosity:

java -jar copybara.jar migrate copy.bara.sky export -v
java -jar copybara.jar migrate copy.bara.sky export -vv  # More verbose

Examples

Initial Sync

java -jar copybara.jar migrate copy.bara.sky export --init-history

Incremental Sync

java -jar copybara.jar migrate copy.bara.sky export --ignore-noop

Preview Changes

java -jar copybara.jar migrate copy.bara.sky export \
  --folder-destination /tmp/preview

Validate Config

java -jar copybara.jar validate copy.bara.sky

Force Re-sync

java -jar copybara.jar migrate copy.bara.sky export \
  --last-rev abc123 --force

Exit Codes

Code	Meaning
0	Success
1	Error
2	No changes (without —ignore-noop)

Environment Variables

Variable	Description
COPYBARA_CONFIG	Default config file
GIT_AUTHOR_NAME	Git author name
GIT_AUTHOR_EMAIL	Git author email
GIT_COMMITTER_NAME	Git committer name
GIT_COMMITTER_EMAIL	Git committer email

Next Steps

• Core module reference
• Git module reference