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
b8a1f1c4
Commit
b8a1f1c4
authored
Mar 06, 2016
by
Achilleas Pipinellis
Browse files
Options
Browse Files
Download
Plain Diff
Merge branch 'ci_quickstart' into 'master'
Add a TL;DR version in quickstart guide See merge request !3026
parents
9bbf873e
d5f634b3
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
38 additions
and
11 deletions
+38
-11
doc/ci/quick_start/README.md
doc/ci/quick_start/README.md
+38
-11
No files found.
doc/ci/quick_start/README.md
View file @
b8a1f1c4
# Quick Start
# Quick Start
Starting from version 8.0, GitLab Continuous Integration (CI) is fully
>**Note:** Starting from version 8.0, GitLab [Continuous Integration][ci] (CI)
integrated into GitLab itself and is enabled by default on all projects.
is fully integrated into GitLab itself and is [enabled] by default on all
projects.
Th
is guide assumes that you:
Th
e TL;DR version of how GitLab CI works is the following.
-
have a working GitLab instance of version 8.0 or higher or are using
---
[
GitLab.com
](
https://gitlab.com/users/sign_in
)
-
have a project in GitLab that you would like to use CI for
GitLab offers a
[
continuous integration
][
ci
]
service. If you
[
add a `.gitlab-ci.yml` file
][
yaml
]
to the root directory of your repository,
and configure your GitLab project to use a [Runner], then each merge request or
push triggers a build.
The
`.gitlab-ci.yml`
file tells the GitLab runner what do to. By default it
runs three [stages]:
`build`
,
`test`
, and
`deploy`
.
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
easy to see whether a merge request will cause any of the tests to fail before
you even look at the code.
Most projects only use GitLab's CI service to run the test suite so that
developers get immediate feedback if they broke something.
I
n brief, the steps needed to have a working CI can be summed up to:
So i
n brief, the steps needed to have a working CI can be summed up to:
1.
Create a new project
1.
Add
`.gitlab-ci.yml`
to the root directory of your repository
1.
Add
`.gitlab-ci.yml`
to the git repository and push to GitLab
1.
Configure a Runner
1.
Configure a Runner
From there on, on every push to your
git repository
the build will be
From there on, on every push to your
Git repository,
the build will be
automagically started by the Runner and will appear under the project's
automagically started by the Runner and will appear under the project's
`/builds`
page.
`/builds`
page.
Now, let's break it down to pieces and work on solving the GitLab CI puzzle.
---
This guide assumes that you:
-
have a working GitLab instance of version 8.0 or higher or are using
[
GitLab.com
](
https://gitlab.com/users/sign_in
)
-
have a project in GitLab that you would like to use CI for
Let's break it down to pieces and work on solving the GitLab CI puzzle.
## Creating a `.gitlab-ci.yml` file
## Creating a `.gitlab-ci.yml` file
...
@@ -218,3 +240,8 @@ Visit our various languages examples at <https://gitlab.com/groups/gitlab-exampl
...
@@ -218,3 +240,8 @@ Visit our various languages examples at <https://gitlab.com/groups/gitlab-exampl
[
runner-install
]:
https://gitlab.com/gitlab-org/gitlab-ci-multi-runner/tree/master#installation
[
runner-install
]:
https://gitlab.com/gitlab-org/gitlab-ci-multi-runner/tree/master#installation
[
blog-ci
]:
https://about.gitlab.com/2015/05/06/why-were-replacing-gitlab-ci-jobs-with-gitlab-ci-dot-yml/
[
blog-ci
]:
https://about.gitlab.com/2015/05/06/why-were-replacing-gitlab-ci-jobs-with-gitlab-ci-dot-yml/
[
examples
]:
../examples/README.md
[
examples
]:
../examples/README.md
[
ci
]:
https://about.gitlab.com/gitlab-ci/
[
yaml
]:
../yaml/README.md
[
runner
]:
../runners/README.md
[
enabled
]:
../enable_or_disable_ci.md
[
stages
]:
../yaml/README.md#stages
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