1REPO(1) Repo Manual REPO(1)
2
6 repo - repo upload - manual page for repo upload
7
9 repo upload [--re --cc] [<project>]...
10
12 Summary
13 Upload changes for code review
15
17 -h, --help
18 show this help message and exit
19 -j JOBS, --jobs=JOBS
21 number of jobs to run in parallel (default: based on number of
22 CPU cores)
23 -t send local branch name to Gerrit Code Review
25 --hashtag=HASHTAGS, --ht=HASHTAGS
27 add hashtags (comma delimited) to the review
28 --hashtag-branch, --htb
30 add local branch name as a hashtag
31 -l LABELS, --label=LABELS
33 add a label when uploading
34 --re=REVIEWERS, --reviewers=REVIEWERS
36 request reviews from these people
37 --cc=CC
39 also send email to these email addresses
40 --br=BRANCH, --branch=BRANCH
42 (local) branch to upload
43 -c, --current-branch
45 upload current git branch
46 --no-current-branch
48 upload all git branches
49 --ne, --no-emails
51 do not send e-mails on upload
52 -p, --private
54 upload as a private change (deprecated; use --wip)
55 -w, --wip
57 upload as a work-in-progress change
58 -o PUSH_OPTIONS, --push-option=PUSH_OPTIONS
60 additional push options to transmit
61 -D BRANCH, --destination=BRANCH, --dest=BRANCH
63 submit for review on this target branch
64 -n, --dry-run
66 do everything except actually upload the CL
67 -y, --yes
69 answer yes to all safe prompts
70 --no-cert-checks
72 disable verifying ssl certs (unsafe)
73 Logging options:
75 -v, --verbose
76 show all output
77 -q, --quiet
79 only show errors
80 pre-upload hooks:
82 --no-verify
83 Do not run the pre-upload hook.
84 --verify
86 Run the pre-upload hook without prompting.
87 --ignore-hooks
89 Do not abort if pre-upload hooks fail.
90 Run `repo help upload` to view the detailed manual.
92
94 The 'repo upload' command is used to send changes to the Gerrit Code
95 Review system. It searches for topic branches in local projects that
96 have not yet been published for review. If multiple topic branches are
97 found, 'repo upload' opens an editor to allow the user to select which
98 branches to upload.
99 'repo upload' searches for uploadable changes in all projects listed at
101 the command line. Projects can be specified either by name, or by a
102 relative or absolute path to the project's local directory. If no
103 projects are specified, 'repo upload' will search for uploadable
104 changes in all projects listed in the manifest.
105 If the --reviewers or --cc options are passed, those emails are added
107 to the respective list of users, and emails are sent to any new users.
108 Users passed as --reviewers must already be registered with the code
109 review system, or the upload will fail.
110 Configuration
112 review.URL.autoupload:
114 To disable the "Upload ... (y/N)?" prompt, you can set a per-project or
116 global Git configuration option. If review.URL.autoupload is set to
117 "true" then repo will assume you always answer "y" at the prompt, and
118 will not prompt you further. If it is set to "false" then repo will as‐
119 sume you always answer "n", and will abort.
120 review.URL.autoreviewer:
122 To automatically append a user or mailing list to reviews, you can set
124 a per-project or global Git option to do so.
125 review.URL.autocopy:
127 To automatically copy a user or mailing list to all uploaded reviews,
129 you can set a per-project or global Git option to do so. Specifically,
130 review.URL.autocopy can be set to a comma separated list of reviewers
131 who you always want copied on all uploads with a non-empty --re argu‐
132 ment.
133 review.URL.username:
135 Override the username used to connect to Gerrit Code Review. By default
137 the local part of the email address is used.
138 The URL must match the review URL listed in the manifest XML file, or
140 in the .git/config within the project. For example:
141 [remote "origin"]
143 url = git://git.example.com/project.git review = http://re‐
145 view.example.com/
146 [review "http://review.example.com/"]
148 autoupload = true autocopy = johndoe@com‐
150 pany.com,my-team-alias@company.com
151 review.URL.uploadtopic:
153 To add a topic branch whenever uploading a commit, you can set a
155 per-project or global Git option to do so. If review.URL.uploadtopic is
156 set to "true" then repo will assume you always want the equivalent of
157 the -t option to the repo command. If unset or set to "false" then
158 repo will make use of only the command line option.
159 review.URL.uploadhashtags:
161 To add hashtags whenever uploading a commit, you can set a per-project
163 or global Git option to do so. The value of review.URL.uploadhashtags
164 will be used as comma delimited hashtags like the --hashtag option.
165 review.URL.uploadlabels:
167 To add labels whenever uploading a commit, you can set a per-project or
169 global Git option to do so. The value of review.URL.uploadlabels will
170 be used as comma delimited labels like the --label option.
171 review.URL.uploadnotify:
173 Control e-mail notifications when uploading. https://gerrit-re‐
175 view.googlesource.com/Documentation/user-upload.html#notify
176 References
178 Gerrit Code Review: https://www.gerritcodereview.com/
180repo upload July 2021 REPO(1)