git 在命令行提交merge request

Note: Git push options are only available with Git 2.10 or newer.

For Git versions 2.10 to 2.17 use --push-option:

git push --push-option=<push_option>

For version 2.18 and later, you can use the above format, or the shorter -o:

git push -o <push_option>

Push options for GitLab CI/CD

You can use push options to skip a CI/CD pipeline, or pass environment variables.

Push option	Description	Introduced in version
ci.skip	Do not create a CI pipeline for the latest push.	11.7
ci.variable="<name>=<value>"	Provide environment variables to be used in a CI pipeline, if one is created due to the push.	12.6

An example of using ci.skip:

git push -o ci.skip

An example of passing some environment variables for a pipeline:

git push -o ci.variable="MAX_RETRIES=10" -o ci.variable="MAX_TIME=600"

Push options for merge requests

You can use Git push options to perform certain actions for merge requests at the same time as pushing changes:

Push option	Description	Introduced in version
merge_request.create	Create a new merge request for the pushed branch.	11.10
merge_request.target=<branch_name>	Set the target of the merge request to a particular branch.	11.10
merge_request.merge_when_pipeline_succeeds	Set the merge request to merge when its pipeline succeeds.	11.10
merge_request.remove_source_branch	Set the merge request to remove the source branch when it’s merged.	12.2
merge_request.title="<title>"	Set the title of the merge request. Ex: git push -o merge_request.title="The title I want".	12.2
merge_request.description="<description>"	Set the description of the merge request. Ex: git push -o merge_request.description="The description I want".	12.2
merge_request.label="<label>"	Add labels to the merge request. If the label does not exist, it will be created. For example, for two labels: git push -o merge_request.label="label1" -o merge_request.label="label2".	12.3
merge_request.unlabel="<label>"	Remove labels from the merge request. For example, for two labels: git push -o merge_request.unlabel="label1" -o merge_request.unlabel="label2".	12.3

If you use a push option that requires text with spaces in it, you need to enclose it in quotes ("). You can omit the quotes if there are no spaces. Some examples:

git push -o merge_request.label="Label with spaces"
git push -o merge_request.label=Label-with-no-spaces

You can combine push options to accomplish multiple tasks at once, by using multiple -o (or --push-option) flags. For example, if you want to create a new merge request, and target a branch named my-target-branch:

git push -o merge_request.create -o merge_request.target=my-target-branch

Additionally if you want the merge request to merge as soon as the pipeline succeeds you can do:

git push -o merge_request.create -o merge_request.target=my-target-branch -o merge_request.merge_when_pipeline_succeeds