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
iv
gitlab-ce
Commits
a1c2b168
Commit
a1c2b168
authored
Jun 14, 2016
by
Mark Pundsack
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Add pipeline image
parent
a0fefc2a
Changes
2
Hide whitespace changes
Inline
Side-by-side
Showing
2 changed files
with
23 additions
and
19 deletions
+23
-19
doc/ci/quick_start/README.md
doc/ci/quick_start/README.md
+23
-19
doc/ci/quick_start/img/pipelines_status.png
doc/ci/quick_start/img/pipelines_status.png
+0
-0
No files found.
doc/ci/quick_start/README.md
View file @
a1c2b168
...
...
@@ -9,8 +9,9 @@ GitLab offers a [continuous integration][ci] service. If you
and configure your GitLab project to use a [Runner], then each merge request or
push triggers your CI [pipeline].
The
`.gitlab-ci.yml`
file tells the GitLab runner what to do. By default it
runs a pipeline with three [stages]:
`build`
,
`test`
, and
`deploy`
.
The
`.gitlab-ci.yml`
file tells the GitLab runner what to do. By default it runs
a pipeline with three [stages]:
`build`
,
`test`
, and
`deploy`
. You don't need to
use all three stages; stages with no jobs are simply ignored.
If everything runs OK (no non-zero return values), you'll get a nice green
checkmark associated with the pushed commit or merge request. This makes it
...
...
@@ -56,15 +57,14 @@ On any push to your repository, GitLab will look for the `.gitlab-ci.yml`
file and start builds on _Runners_ according to the contents of the file,
for that commit.
Because
`.gitlab-ci.yml`
is in the repository
, it is version controlled,
old versions still build successfully, forks can easily make use of CI,
branches can have separate builds
and you have a single source of truth for CI.
You can read more about the reasons why we are using
`.gitlab-ci.yml`
[
in our
blog about it
][
blog-ci
]
.
Because
`.gitlab-ci.yml`
is in the repository
and is version controlled, old
versions still build successfully, forks can easily make use of CI, branches can
have different pipelines and jobs,
and you have a single source of truth for CI.
You can read more about the reasons why we are using
`.gitlab-ci.yml`
[
in our
blog about it
][
blog-ci
]
.
**Note:**
`.gitlab-ci.yml`
is a
[
YAML
](
https://en.wikipedia.org/wiki/YAML
)
file
so you have to pay extra attention to the indentation. Always use spaces, not
tabs.
so you have to pay extra attention to indentation. Always use spaces, not tabs.
### Creating a simple `.gitlab-ci.yml` file
...
...
@@ -107,7 +107,7 @@ If you want to check whether your `.gitlab-ci.yml` file is valid, there is a
Lint tool under the page
`/ci/lint`
of your GitLab instance. You can also find
the link under
**Settings > CI settings**
in your project.
For more information and a complete
`.gitlab-ci.yml`
syntax, please
check
For more information and a complete
`.gitlab-ci.yml`
syntax, please
read
[
the documentation on .gitlab-ci.yml
](
../yaml/README.md
)
.
### Push `.gitlab-ci.yml` to GitLab
...
...
@@ -121,7 +121,8 @@ git commit -m "Add .gitlab-ci.yml"
git push origin master
```
Now if you go to the
**Builds**
page you will see that the builds are pending.
Now if you go to the
**Pipelines**
page you will see that the pipeline is
pending.
You can also go to the
**Commits**
page and notice the little clock icon next
to the commit SHA.
...
...
@@ -137,15 +138,14 @@ Notice that there are two jobs pending which are named after what we wrote in
`.gitlab-ci.yml`
. The red triangle indicates that there is no Runner configured
yet for these builds.
The next step is to configure a Runner so that it picks the pending
job
s.
The next step is to configure a Runner so that it picks the pending
build
s.
## Configuring a Runner
In GitLab, Runners run the builds that you define in
`.gitlab-ci.yml`
.
A Runner can be a virtual machine, a VPS, a bare-metal machine, a docker
container or even a cluster of containers. GitLab and the Runners communicate
through an API, so the only needed requirement is that the machine on which the
Runner is configured to have Internet access.
In GitLab, Runners run the builds that you define in
`.gitlab-ci.yml`
. A Runner
can be a virtual machine, a VPS, a bare-metal machine, a docker container or
even a cluster of containers. GitLab and the Runners communicate through an API,
so the only requirement is that the Runner's machine has Internet access.
A Runner can be specific to a certain project or serve multiple projects in
GitLab. If it serves all projects it's called a _Shared Runner_.
...
...
@@ -187,12 +187,16 @@ To enable **Shared Runners** you have to go to your project's
[
Read more on Shared Runners
](
../runners/README.md
)
.
## Seeing the status of your
build
## Seeing the status of your
pipeline and builds
After configuring the Runner successfully, you should see the status of your
last commit change from _pending_ to either _running_, _success_ or _failed_.
You can view all builds, by going to the
**Builds**
page in your project.
You can view all pipelines by going to the
**Pipelines**
page in your project.
![
Commit status
](
img/pipelines_status.png
)
Or you can view all builds, by going to the
**Pipelines > Builds**
page.
![
Commit status
](
img/builds_status.png
)
...
...
doc/ci/quick_start/img/pipelines_status.png
0 → 100644
View file @
a1c2b168
87.3 KB
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