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 -r, --ready
60 mark change as ready (clears work-in-progress setting)
61 -o PUSH_OPTIONS, --push-option=PUSH_OPTIONS
63 additional push options to transmit
64 -D BRANCH, --destination=BRANCH, --dest=BRANCH
66 submit for review on this target branch
67 -n, --dry-run
69 do everything except actually upload the CL
70 -y, --yes
72 answer yes to all safe prompts
73 --ignore-untracked-files
75 ignore untracked files in the working copy
76 --no-ignore-untracked-files
78 always ask about untracked files in the working copy
79 --no-cert-checks
81 disable verifying ssl certs (unsafe)
82 Logging options:
84 -v, --verbose
85 show all output
86 -q, --quiet
88 only show errors
89 Multi-manifest options:
91 --outer-manifest
92 operate starting at the outermost manifest
93 --no-outer-manifest
95 do not operate on outer manifests
96 --this-manifest-only
98 only operate on this (sub)manifest
99 --no-this-manifest-only, --all-manifests
101 operate on this manifest and its submanifests
102 pre-upload hooks:
104 --no-verify
105 Do not run the pre-upload hook.
106 --verify
108 Run the pre-upload hook without prompting.
109 --ignore-hooks
111 Do not abort if pre-upload hooks fail.
112 Run `repo help upload` to view the detailed manual.
114
116 The 'repo upload' command is used to send changes to the Gerrit Code
117 Review system. It searches for topic branches in local projects that
118 have not yet been published for review. If multiple topic branches are
119 found, 'repo upload' opens an editor to allow the user to select which
120 branches to upload.
121 'repo upload' searches for uploadable changes in all projects listed at
123 the command line. Projects can be specified either by name, or by a
124 relative or absolute path to the project's local directory. If no
125 projects are specified, 'repo upload' will search for uploadable
126 changes in all projects listed in the manifest.
127 If the --reviewers or --cc options are passed, those emails are added
129 to the respective list of users, and emails are sent to any new users.
130 Users passed as --reviewers must already be registered with the code
131 review system, or the upload will fail.
132 While most normal Gerrit options have dedicated command line options,
134 direct access to the Gerit options is available via --push-options.
135 This is useful when Gerrit has newer functionality that repo upload
136 doesn't yet support, or doesn't have plans to support. See the Push Op‐
137 tions documentation for more details: https://gerrit-review.google‐
138 source.com/Documentation/user-upload.html#push_options
139 Configuration
141 review.URL.autoupload:
143 To disable the "Upload ... (y/N)?" prompt, you can set a per-project or
145 global Git configuration option. If review.URL.autoupload is set to
146 "true" then repo will assume you always answer "y" at the prompt, and
147 will not prompt you further. If it is set to "false" then repo will as‐
148 sume you always answer "n", and will abort.
149 review.URL.autoreviewer:
151 To automatically append a user or mailing list to reviews, you can set
153 a per-project or global Git option to do so.
154 review.URL.autocopy:
156 To automatically copy a user or mailing list to all uploaded reviews,
158 you can set a per-project or global Git option to do so. Specifically,
159 review.URL.autocopy can be set to a comma separated list of reviewers
160 who you always want copied on all uploads with a non-empty --re argu‐
161 ment.
162 review.URL.username:
164 Override the username used to connect to Gerrit Code Review. By default
166 the local part of the email address is used.
167 The URL must match the review URL listed in the manifest XML file, or
169 in the .git/config within the project. For example:
170 [remote "origin"]
172 url = git://git.example.com/project.git review = http://re‐
174 view.example.com/
175 [review "http://review.example.com/"]
177 autoupload = true autocopy = johndoe@com‐
179 pany.com,my-team-alias@company.com
180 review.URL.uploadtopic:
182 To add a topic branch whenever uploading a commit, you can set a
184 per-project or global Git option to do so. If review.URL.uploadtopic is
185 set to "true" then repo will assume you always want the equivalent of
186 the -t option to the repo command. If unset or set to "false" then
187 repo will make use of only the command line option.
188 review.URL.uploadhashtags:
190 To add hashtags whenever uploading a commit, you can set a per-project
192 or global Git option to do so. The value of review.URL.uploadhashtags
193 will be used as comma delimited hashtags like the --hashtag option.
194 review.URL.uploadlabels:
196 To add labels whenever uploading a commit, you can set a per-project or
198 global Git option to do so. The value of review.URL.uploadlabels will
199 be used as comma delimited labels like the --label option.
200 review.URL.uploadnotify:
202 Control e-mail notifications when uploading. https://gerrit-re‐
204 view.googlesource.com/Documentation/user-upload.html#notify
205 References
207 Gerrit Code Review: https://www.gerritcodereview.com/
209repo upload August 2022 REPO(1)