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
1
Merge Requests
1
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
nexedi
gitlab-ce
Commits
af503c8d
Commit
af503c8d
authored
May 08, 2018
by
Dylan Griffith
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Add simple docs for group runners
parent
e4a04996
Changes
1
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
12 additions
and
1 deletion
+12
-1
doc/ci/runners/README.md
doc/ci/runners/README.md
+12
-1
No files found.
doc/ci/runners/README.md
View file @
af503c8d
...
@@ -11,7 +11,7 @@ Ideally, the GitLab Runner should not be installed on the same machine as GitLab
...
@@ -11,7 +11,7 @@ Ideally, the GitLab Runner should not be installed on the same machine as GitLab
Read the
[
requirements documentation
](
../../install/requirements.md#gitlab-runner
)
Read the
[
requirements documentation
](
../../install/requirements.md#gitlab-runner
)
for more information.
for more information.
## Shared
vs specific
Runners
## Shared
, specific and group
Runners
After
[
installing the Runner
][
install
]
, you can either register it as shared or
After
[
installing the Runner
][
install
]
, you can either register it as shared or
specific. You can only register a shared Runner if you have admin access to
specific. You can only register a shared Runner if you have admin access to
...
@@ -32,6 +32,9 @@ are:
...
@@ -32,6 +32,9 @@ are:
Runners. For example, if you want to deploy a certain project, you can setup
Runners. For example, if you want to deploy a certain project, you can setup
a specific Runner to have the right credentials for this. The
[
usage of tags
](
#using-tags
)
a specific Runner to have the right credentials for this. The
[
usage of tags
](
#using-tags
)
may be useful in this case. Specific Runners process jobs using a [FIFO] queue.
may be useful in this case. Specific Runners process jobs using a [FIFO] queue.
-
**Group Runners**
are useful when you have multiple projects under one group
and would like all projects to have access to a set of runners. Group Runners
process jobs using a [FIFO] queue.
A Runner that is specific only runs for the specified project(s). A shared Runner
A Runner that is specific only runs for the specified project(s). A shared Runner
can run jobs for every project that has enabled the option
**Allow shared Runners**
can run jobs for every project that has enabled the option
**Allow shared Runners**
...
@@ -79,6 +82,14 @@ visit the project you want to make the Runner work for in GitLab:
...
@@ -79,6 +82,14 @@ visit the project you want to make the Runner work for in GitLab:
1.
Go to
**Settings > CI/CD**
to obtain the token
1.
Go to
**Settings > CI/CD**
to obtain the token
1.
[
Register the Runner
][
register
]
1.
[
Register the Runner
][
register
]
## Registering a group Runner
Creating a group Runner requires Master permissions for the group. To create a
group Runner visit the group you want to make the Runner work for in GitLab:
1.
Go to
**Settings > CI/CD**
to obtain the token
1.
[
Register the Runner
][
register
]
### Making an existing shared Runner specific
### Making an existing shared Runner specific
If you are an admin on your GitLab instance, you can turn any shared Runner into
If you are an admin on your GitLab instance, you can turn any shared Runner into
...
...
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