Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
Léo-Paul Géneau
gitlab-ce
Commits
dd7f0fb6
Commit
dd7f0fb6
authored
Dec 01, 2016
by
Achilleas Pipinellis
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Clarify that a commit SHA doesn't work for CI triggers
[ci skip]
parent
2adc6568
Changes
1
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
7 additions
and
3 deletions
+7
-3
doc/ci/triggers/README.md
doc/ci/triggers/README.md
+7
-3
No files found.
doc/ci/triggers/README.md
View file @
dd7f0fb6
...
@@ -6,7 +6,7 @@
...
@@ -6,7 +6,7 @@
GitLab 8.12 has a completely redesigned build permissions system.
GitLab 8.12 has a completely redesigned build permissions system.
Read all about the
[
new model and its implications
](
../../user/project/new_ci_build_permissions_model.md#build-triggers
)
.
Read all about the
[
new model and its implications
](
../../user/project/new_ci_build_permissions_model.md#build-triggers
)
.
Triggers can be used to force a rebuild of a specific
branch, tag or commit,
Triggers can be used to force a rebuild of a specific
`ref`
(branch or tag)
with an API call.
with an API call.
## Add a trigger
## Add a trigger
...
@@ -29,6 +29,10 @@ irreversible.
...
@@ -29,6 +29,10 @@ irreversible.
## Trigger a build
## Trigger a build
> **Note**:
Valid refs are only the branches and tags. If you pass a commit SHA as a ref,
it will not trigger a build.
To trigger a build you need to send a
`POST`
request to GitLab's API endpoint:
To trigger a build you need to send a
`POST`
request to GitLab's API endpoint:
```
```
...
@@ -36,8 +40,8 @@ POST /projects/:id/trigger/builds
...
@@ -36,8 +40,8 @@ POST /projects/:id/trigger/builds
```
```
The required parameters are the trigger's
`token`
and the Git
`ref`
on which
The required parameters are the trigger's
`token`
and the Git
`ref`
on which
the trigger will be performed. Valid refs are the branch
, the tag or the commit
the trigger will be performed. Valid refs are the branch
and the tag. The
`:id`
SHA. The
`:id`
of a project can be found by
[
querying the API
](
../../api/projects.md
)
of a project can be found by
[
querying the API
](
../../api/projects.md
)
or by visiting the
**Triggers**
page which provides self-explanatory examples.
or by visiting the
**Triggers**
page which provides self-explanatory examples.
When a rebuild is triggered, the information is exposed in GitLab's UI under
When a rebuild is triggered, the information is exposed in GitLab's UI under
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment