Commit 0b8b631a authored by 🚄 Job van der Voort 🚀's avatar 🚄 Job van der Voort 🚀

Merge branch 'docs/no-comments' into 'master'

Exclude comments from specific docs

Closes #39678

See merge request gitlab-org/gitlab-ce!15122
parents 5c1459ef 69b4c5c0
--- ---
toc: false toc: false
comments: false
--- ---
# GitLab Documentation # GitLab Documentation
......
---
comments: false
---
# Authentication and Authorization # Authentication and Authorization
GitLab integrates with the following external authentication and authorization GitLab integrates with the following external authentication and authorization
......
---
comments: false
---
# GitLab Continuous Integration (GitLab CI) # GitLab Continuous Integration (GitLab CI)
![Pipeline graph](img/cicd_pipeline_infograph.png) ![Pipeline graph](img/cicd_pipeline_infograph.png)
......
---
comments: false
---
# Docker integration # Docker integration
- [Using Docker Images](using_docker_images.md) - [Using Docker Images](using_docker_images.md)
......
## Enable or disable GitLab CI/CD # How to enable or disable GitLab CI/CD
To effectively use GitLab CI/CD, you need a valid [`.gitlab-ci.yml`](yaml/README.md) To effectively use GitLab CI/CD, you need a valid [`.gitlab-ci.yml`](yaml/README.md)
file present at the root directory of your project and a file present at the root directory of your project and a
...@@ -21,7 +21,7 @@ individually under each project's settings, or site-wide by modifying the ...@@ -21,7 +21,7 @@ individually under each project's settings, or site-wide by modifying the
settings in `gitlab.yml` and `gitlab.rb` for source and Omnibus installations settings in `gitlab.yml` and `gitlab.rb` for source and Omnibus installations
respectively. respectively.
### Per-project user setting ## Per-project user setting
The setting to enable or disable GitLab CI/CD can be found under your project's The setting to enable or disable GitLab CI/CD can be found under your project's
**Settings > General > Permissions**. Choose one of "Disabled", "Only team members" **Settings > General > Permissions**. Choose one of "Disabled", "Only team members"
...@@ -29,7 +29,7 @@ or "Everyone with access" and hit **Save changes** for the settings to take effe ...@@ -29,7 +29,7 @@ or "Everyone with access" and hit **Save changes** for the settings to take effe
![Sharing & Permissions settings](../user/project/settings/img/sharing_and_permissions_settings.png) ![Sharing & Permissions settings](../user/project/settings/img/sharing_and_permissions_settings.png)
### Site-wide admin setting ## Site-wide admin setting
You can disable GitLab CI/CD site-wide, by modifying the settings in `gitlab.yml` You can disable GitLab CI/CD site-wide, by modifying the settings in `gitlab.yml`
and `gitlab.rb` for source and Omnibus installations respectively. and `gitlab.rb` for source and Omnibus installations respectively.
......
---
comments: false
---
# GitLab CI Examples # GitLab CI Examples
A collection of `.gitlab-ci.yml` files is maintained at the [GitLab CI Yml project][gitlab-ci-templates]. A collection of `.gitlab-ci.yml` files is maintained at the [GitLab CI Yml project][gitlab-ci-templates].
......
## Running Composer and NPM scripts with deployment via SCP # Running Composer and NPM scripts with deployment via SCP in GitLab CI/CD
This guide covers the building dependencies of a PHP project while compiling assets via an NPM script. This guide covers the building dependencies of a PHP project while compiling assets via an NPM script.
...@@ -39,13 +39,13 @@ In this particular case, the `npm deploy` script is a Gulp script that does the ...@@ -39,13 +39,13 @@ In this particular case, the `npm deploy` script is a Gulp script that does the
All these operations will put all files into a `build` folder, which is ready to be deployed to a live server. All these operations will put all files into a `build` folder, which is ready to be deployed to a live server.
### How to transfer files to a live server? ## How to transfer files to a live server
You have multiple options: rsync, scp, sftp and so on. For now, we will use scp. You have multiple options: rsync, scp, sftp and so on. For now, we will use scp.
To make this work, you need to add a GitLab Secret Variable (accessible on _gitlab.example/your-project-name/variables_). That variable will be called `STAGING_PRIVATE_KEY` and it's the **private** ssh key of your server. To make this work, you need to add a GitLab Secret Variable (accessible on _gitlab.example/your-project-name/variables_). That variable will be called `STAGING_PRIVATE_KEY` and it's the **private** ssh key of your server.
#### Security tip ### Security tip
Create a user that has access **only** to the folder that needs to be updated! Create a user that has access **only** to the folder that needs to be updated!
...@@ -69,7 +69,7 @@ In order, this means that: ...@@ -69,7 +69,7 @@ In order, this means that:
And this is basically all you need in the `before_script` section. And this is basically all you need in the `before_script` section.
## How to deploy things? ## How to deploy things
As we stated above, we need to deploy the `build` folder from the docker image to our server. To do so, we create a new job: As we stated above, we need to deploy the `build` folder from the docker image to our server. To do so, we create a new job:
...@@ -88,7 +88,7 @@ stage_deploy: ...@@ -88,7 +88,7 @@ stage_deploy:
- ssh -p22 server_user@server_host "rm -rf htdocs/wp-content/themes/_old" - ssh -p22 server_user@server_host "rm -rf htdocs/wp-content/themes/_old"
``` ```
### What's going on here? Here's the breakdown:
1. `only:dev` means that this build will run only when something is pushed to the `dev` branch. You can remove this block completely and have everything be ran on every push (but probably this is something you don't want) 1. `only:dev` means that this build will run only when something is pushed to the `dev` branch. You can remove this block completely and have everything be ran on every push (but probably this is something you don't want)
2. `ssh-add ...` we will add that private key you added on the web UI to the docker container 2. `ssh-add ...` we will add that private key you added on the web UI to the docker container
...@@ -99,7 +99,7 @@ stage_deploy: ...@@ -99,7 +99,7 @@ stage_deploy:
What's the deal with the artifacts? We just tell GitLab CI to keep the `build` directory (later on, you can download that as needed). What's the deal with the artifacts? We just tell GitLab CI to keep the `build` directory (later on, you can download that as needed).
#### Why we do it this way? ### Why we do it this way
If you're using this only for stage server, you could do this in two steps: If you're using this only for stage server, you could do this in two steps:
...@@ -112,7 +112,7 @@ The problem is that there will be a small period of time when you won't have the ...@@ -112,7 +112,7 @@ The problem is that there will be a small period of time when you won't have the
So we use so many steps because we want to make sure that at any given time we have a functional app in place. So we use so many steps because we want to make sure that at any given time we have a functional app in place.
## Where to go next? ## Where to go next
Since this was a WordPress project, I gave real life code snippets. Some ideas you can pursuit: Since this was a WordPress project, I gave real life code snippets. Some ideas you can pursuit:
......
## Test and Deploy a python application # Test and Deploy a python application with GitLab CI/CD
This example will guide you how to run tests in your Python application and deploy it automatically as Heroku application. This example will guide you how to run tests in your Python application and deploy it automatically as Heroku application.
You can checkout the example [source](https://gitlab.com/ayufan/python-getting-started) and check [CI status](https://gitlab.com/ayufan/python-getting-started/builds?scope=all). You can checkout the [example source](https://gitlab.com/ayufan/python-getting-started).
## Configure project
### Configure project
This is what the `.gitlab-ci.yml` file looks like for this project: This is what the `.gitlab-ci.yml` file looks like for this project:
```yaml ```yaml
test: test:
script: script:
...@@ -41,21 +44,25 @@ This project has three jobs: ...@@ -41,21 +44,25 @@ This project has three jobs:
2. `staging` - used to automatically deploy staging environment every push to `master` branch 2. `staging` - used to automatically deploy staging environment every push to `master` branch
3. `production` - used to automatically deploy production environmnet for every created tag 3. `production` - used to automatically deploy production environmnet for every created tag
### Store API keys ## Store API keys
You'll need to create two variables in `Project > Variables`: You'll need to create two variables in `Project > Variables`:
1. `HEROKU_STAGING_API_KEY` - Heroku API key used to deploy staging app, 1. `HEROKU_STAGING_API_KEY` - Heroku API key used to deploy staging app,
2. `HEROKU_PRODUCTION_API_KEY` - Heroku API key used to deploy production app. 2. `HEROKU_PRODUCTION_API_KEY` - Heroku API key used to deploy production app.
Find your Heroku API key in [Manage Account](https://dashboard.heroku.com/account). Find your Heroku API key in [Manage Account](https://dashboard.heroku.com/account).
### Create Heroku application ## Create Heroku application
For each of your environments, you'll need to create a new Heroku application. For each of your environments, you'll need to create a new Heroku application.
You can do this through the [Dashboard](https://dashboard.heroku.com/). You can do this through the [Dashboard](https://dashboard.heroku.com/).
### Create runner ## Create Runner
First install [Docker Engine](https://docs.docker.com/installation/). First install [Docker Engine](https://docs.docker.com/installation/).
To build this project you also need to have [GitLab Runner](https://about.gitlab.com/gitlab-ci/#gitlab-runner). To build this project you also need to have [GitLab Runner](https://docs.gitlab.com/runner).
You can use public runners available on `gitlab.com`, but you can register your own: You can use public runners available on `gitlab.com`, but you can register your own:
``` ```
gitlab-ci-multi-runner register \ gitlab-ci-multi-runner register \
--non-interactive \ --non-interactive \
......
## Test and Deploy a ruby application # Test and Deploy a ruby application with GitLab CI/CD
This example will guide you how to run tests in your Ruby on Rails application and deploy it automatically as Heroku application. This example will guide you how to run tests in your Ruby on Rails application and deploy it automatically as Heroku application.
You can checkout the example [source](https://gitlab.com/ayufan/ruby-getting-started) and check [CI status](https://gitlab.com/ayufan/ruby-getting-started/builds?scope=all). You can checkout the example [source](https://gitlab.com/ayufan/ruby-getting-started) and check [CI status](https://gitlab.com/ayufan/ruby-getting-started/builds?scope=all).
### Configure project ## Configure the project
This is what the `.gitlab-ci.yml` file looks like for this project: This is what the `.gitlab-ci.yml` file looks like for this project:
```yaml ```yaml
test: test:
script: script:
...@@ -36,23 +39,28 @@ This project has three jobs: ...@@ -36,23 +39,28 @@ This project has three jobs:
2. `staging` - used to automatically deploy staging environment every push to `master` branch 2. `staging` - used to automatically deploy staging environment every push to `master` branch
3. `production` - used to automatically deploy production environment for every created tag 3. `production` - used to automatically deploy production environment for every created tag
### Store API keys ## Store API keys
You'll need to create two variables in `Project > Variables`:
You'll need to create two variables in your project's **Settings > CI/CD > Variables**:
1. `HEROKU_STAGING_API_KEY` - Heroku API key used to deploy staging app, 1. `HEROKU_STAGING_API_KEY` - Heroku API key used to deploy staging app,
2. `HEROKU_PRODUCTION_API_KEY` - Heroku API key used to deploy production app. 2. `HEROKU_PRODUCTION_API_KEY` - Heroku API key used to deploy production app.
Find your Heroku API key in [Manage Account](https://dashboard.heroku.com/account). Find your Heroku API key in [Manage Account](https://dashboard.heroku.com/account).
### Create Heroku application ## Create Heroku application
For each of your environments, you'll need to create a new Heroku application. For each of your environments, you'll need to create a new Heroku application.
You can do this through the [Dashboard](https://dashboard.heroku.com/). You can do this through the [Dashboard](https://dashboard.heroku.com/).
### Create runner ## Create Runner
First install [Docker Engine](https://docs.docker.com/installation/). First install [Docker Engine](https://docs.docker.com/installation/).
To build this project you also need to have [GitLab Runner](https://about.gitlab.com/gitlab-ci/#gitlab-runner). To build this project you also need to have [GitLab Runner](https://about.gitlab.com/gitlab-ci/#gitlab-runner).
You can use public runners available on `gitlab.com`, but you can register your own: You can use public runners available on `gitlab.com`, but you can register your own:
``` ```
gitlab-ci-multi-runner register \ gitlab-runner register \
--non-interactive \ --non-interactive \
--url "https://gitlab.com/" \ --url "https://gitlab.com/" \
--registration-token "PROJECT_REGISTRATION_TOKEN" \ --registration-token "PROJECT_REGISTRATION_TOKEN" \
...@@ -62,6 +70,6 @@ gitlab-ci-multi-runner register \ ...@@ -62,6 +70,6 @@ gitlab-ci-multi-runner register \
--docker-postgres latest --docker-postgres latest
``` ```
With the command above, you create a runner that uses [ruby:2.2](https://hub.docker.com/r/_/ruby/) image and uses [postgres](https://hub.docker.com/r/_/postgres/) database. With the command above, you create a Runner that uses [ruby:2.2](https://hub.docker.com/r/_/ruby/) image and uses [postgres](https://hub.docker.com/r/_/postgres/) database.
To access PostgreSQL database you need to connect to `host: postgres` as user `postgres` without password. To access PostgreSQL database you need to connect to `host: postgres` as user `postgres` without password.
## Test a Clojure application # Test a Clojure application with GitLab CI/CD
This example will guide you how to run tests in your Clojure application. This example will guide you how to run tests in your Clojure application.
You can checkout the example [source](https://gitlab.com/dzaporozhets/clojure-web-application) and check [CI status](https://gitlab.com/dzaporozhets/clojure-web-application/builds?scope=all). You can checkout the example [source](https://gitlab.com/dzaporozhets/clojure-web-application) and check [CI status](https://gitlab.com/dzaporozhets/clojure-web-application/builds?scope=all).
### Configure project ## Configure the project
This is what the `.gitlab-ci.yml` file looks like for this project: This is what the `.gitlab-ci.yml` file looks like for this project:
...@@ -23,13 +23,13 @@ before_script: ...@@ -23,13 +23,13 @@ before_script:
- lein deps - lein deps
- lein migratus migrate - lein migratus migrate
test: test:
script: script:
- lein test - lein test
``` ```
In before script we install JRE and [Leiningen](http://leiningen.org/). In before script we install JRE and [Leiningen](http://leiningen.org/).
Sample project uses [migratus](https://github.com/yogthos/migratus) library to manage database migrations. Sample project uses [migratus](https://github.com/yogthos/migratus) library to manage database migrations.
So we added database migration as last step of `before_script` section So we added database migration as last step of `before_script` section
You can use public runners available on `gitlab.com` for testing your application with such configuration. You can use public runners available on `gitlab.com` for testing your application with such configuration.
## Test a Phoenix application # Test a Phoenix application with GitLab CI/CD
This example demonstrates the integration of Gitlab CI with Phoenix, Elixir and This example demonstrates the integration of Gitlab CI with Phoenix, Elixir and
Postgres. Postgres.
### Add `.gitlab-ci.yml` file to project ## Add `.gitlab-ci.yml` to project
The following `.gitlab-ci.yml` should be added in the root of your The following `.gitlab-ci.yml` should be added in the root of your
repository to trigger CI: repository to trigger CI:
...@@ -36,7 +36,7 @@ run your migrations. ...@@ -36,7 +36,7 @@ run your migrations.
Finally, the test `script` will run your tests. Finally, the test `script` will run your tests.
### Update the Config Settings ## Update the Config Settings
In `config/test.exs`, update the database hostname: In `config/test.exs`, update the database hostname:
...@@ -45,12 +45,12 @@ config :my_app, MyApp.Repo, ...@@ -45,12 +45,12 @@ config :my_app, MyApp.Repo,
hostname: if(System.get_env("CI"), do: "postgres", else: "localhost"), hostname: if(System.get_env("CI"), do: "postgres", else: "localhost"),
``` ```
### Add the Migrations Folder ## Add the Migrations Folder
If you do not have any migrations yet, you will need to create an empty If you do not have any migrations yet, you will need to create an empty
`.gitkeep` file in `priv/repo/migrations`. `.gitkeep` file in `priv/repo/migrations`.
### Sources ## Sources
- https://medium.com/@nahtnam/using-phoenix-on-gitlab-ci-5a51eec81142 - https://medium.com/@nahtnam/using-phoenix-on-gitlab-ci-5a51eec81142
- https://davejlong.com/ci-with-phoenix-and-gitlab/ - https://davejlong.com/ci-with-phoenix-and-gitlab/
# Users Permissions
This document was moved to [user/permissions.md](../../user/permissions.md#gitlab-ci). This document was moved to [user/permissions.md](../../user/permissions.md#gitlab-ci).
# Getting started with GitLab CI # Getting started with GitLab CI/CD
>**Note:** Starting from version 8.0, GitLab [Continuous Integration][ci] (CI) >**Note:** Starting from version 8.0, GitLab [Continuous Integration][ci] (CI)
is fully integrated into GitLab itself and is [enabled] by default on all is fully integrated into GitLab itself and is [enabled] by default on all
......
# Runners # Configuring GitLab Runners
In GitLab CI, Runners run the code defined in [`.gitlab-ci.yml`](../yaml/README.md). In GitLab CI, Runners run the code defined in [`.gitlab-ci.yml`](../yaml/README.md).
They are isolated (virtual) machines that pick up jobs through the coordinator They are isolated (virtual) machines that pick up jobs through the coordinator
......
## GitLab CI Services ---
comments: false
---
# GitLab CI Services
GitLab CI uses the `services` keyword to define what docker containers should GitLab CI uses the `services` keyword to define what docker containers should
be linked with your base image. Below is a list of examples you may use. be linked with your base image. Below is a list of examples you may use.
......
## GitLab CI Services ---
comments: false
---
+ [Using MySQL](mysql.md) # GitLab CI Services
+ [Using PostgreSQL](postgres.md)
+ [Using Redis](redis.md) - [Using MySQL](mysql.md)
- [Using PostgreSQL](postgres.md)
- [Using Redis](redis.md)
# Variables # GitLab CI/CD Variables
When receiving a job from GitLab CI, the [Runner] prepares the build environment. When receiving a job from GitLab CI, the [Runner] prepares the build environment.
It starts by setting a list of **predefined variables** (environment variables) It starts by setting a list of **predefined variables** (environment variables)
......
---
comments: false
---
# GitLab development guides # GitLab development guides
## Get started! ## Get started!
......
## Testing Rake tasks # Testing Rake tasks
To make testing Rake tasks a little easier, there is a helper that can be included To make testing Rake tasks a little easier, there is a helper that can be included
in lieu of the standard Spec helper. Instead of `require 'spec_helper'`, use in lieu of the standard Spec helper. Instead of `require 'spec_helper'`, use
......
This diff is collapsed.
---
comments: false
---
# GitLab basics # GitLab basics
Step-by-step guides on the basics of working with Git and GitLab. Step-by-step guides on the basics of working with Git and GitLab.
......
---
comments: false
---
# Installation # Installation
GitLab can be installed via various ways. Check the [installation methods][methods] GitLab can be installed via various ways. Check the [installation methods][methods]
......
## Install GitLab under a relative URL # Install GitLab under a relative URL
_**Note:** NOTE: **Note:**
This document describes how to run GitLab under a relative URL for installations This document describes how to run GitLab under a relative URL for installations
from source. If you are using an Omnibus package, from source. If you are using an Omnibus package,
[the steps are different][omnibus-rel]. Use this guide along with the [the steps are different][omnibus-rel]. Use this guide along with the
[installation guide](installation.md) if you are installing GitLab for the [installation guide](installation.md) if you are installing GitLab for the
first time._ first time.
--- ---
...@@ -33,7 +33,7 @@ serve GitLab under a relative URL is: ...@@ -33,7 +33,7 @@ serve GitLab under a relative URL is:
After all the changes you need to recompile the assets and [restart GitLab]. After all the changes you need to recompile the assets and [restart GitLab].
### Relative URL requirements ## Relative URL requirements
If you configure GitLab with a relative URL, the assets (JavaScript, CSS, fonts, If you configure GitLab with a relative URL, the assets (JavaScript, CSS, fonts,
images, etc.) will need to be recompiled, which is a task which consumes a lot images, etc.) will need to be recompiled, which is a task which consumes a lot
...@@ -43,11 +43,11 @@ least 2GB of RAM available on your system, while we recommend 4GB RAM, and 4 or ...@@ -43,11 +43,11 @@ least 2GB of RAM available on your system, while we recommend 4GB RAM, and 4 or
See the [requirements](requirements.md) document for more information. See the [requirements](requirements.md) document for more information.
### Enable relative URL in GitLab ## Enable relative URL in GitLab
_**Note:** NOTE: **Note:**
Do not make any changes to your web server configuration file regarding Do not make any changes to your web server configuration file regarding
relative URL. The relative URL support is implemented by GitLab Workhorse._ relative URL. The relative URL support is implemented by GitLab Workhorse.
--- ---
...@@ -115,7 +115,7 @@ Make sure to follow all steps below: ...@@ -115,7 +115,7 @@ Make sure to follow all steps below:
1. [Restart GitLab][] for the changes to take effect. 1. [Restart GitLab][] for the changes to take effect.
### Disable relative URL in GitLab ## Disable relative URL in GitLab
To disable the relative URL: To disable the relative URL:
......
---
comments: false
---
# GitLab Integration # GitLab Integration
GitLab integrates with multiple third-party services to allow external issue GitLab integrates with multiple third-party services to allow external issue
......
---
comments: false
---
# Get started with GitLab # Get started with GitLab
## Organize ## Organize
......
---
comments: false
---
# Legal # Legal
- [Corporate contributor license agreement](corporate_contributor_license_agreement.md) - [Corporate contributor license agreement](corporate_contributor_license_agreement.md)
......
...@@ -372,8 +372,10 @@ CREATE TABLE ...@@ -372,8 +372,10 @@ CREATE TABLE
``` ```
To fix that you need to apply this SQL statement before doing final backup: To fix that you need to apply this SQL statement before doing final backup:
```
# Omnibus ```sql
## Omnibus GitLab
gitlab-ci-rails dbconsole <<EOF gitlab-ci-rails dbconsole <<EOF
-- ALTER TABLES - DROP DEFAULTS -- ALTER TABLES - DROP DEFAULTS
ALTER TABLE ONLY ci_application_settings ALTER COLUMN id DROP DEFAULT; ALTER TABLE ONLY ci_application_settings ALTER COLUMN id DROP DEFAULT;
...@@ -427,7 +429,8 @@ ALTER TABLE ONLY ci_variables ALTER COLUMN id SET DEFAULT nextval('ci_variables_ ...@@ -427,7 +429,8 @@ ALTER TABLE ONLY ci_variables ALTER COLUMN id SET DEFAULT nextval('ci_variables_
ALTER TABLE ONLY ci_web_hooks ALTER COLUMN id SET DEFAULT nextval('ci_web_hooks_id_seq'::regclass); ALTER TABLE ONLY ci_web_hooks ALTER COLUMN id SET DEFAULT nextval('ci_web_hooks_id_seq'::regclass);
EOF EOF
# Source ## Source installations
cd /home/gitlab_ci/gitlab-ci cd /home/gitlab_ci/gitlab-ci
sudo -u gitlab_ci -H bundle exec rails dbconsole production <<EOF sudo -u gitlab_ci -H bundle exec rails dbconsole production <<EOF
... COPY SQL STATEMENTS FROM ABOVE ... ... COPY SQL STATEMENTS FROM ABOVE ...
......
---
comments: false
---
# Rake tasks # Rake tasks
- [Backup restore](backup_restore.md) - [Backup restore](backup_restore.md)
......
---
comments: false
---
# Security # Security
- [Password length limits](password_length_limits.md) - [Password length limits](password_length_limits.md)
......
# SSH # GitLab and SSH keys
Git is a distributed version control system, which means you can work locally Git is a distributed version control system, which means you can work locally
but you can also share or "push" your changes to other servers. but you can also share or "push" your changes to other servers.
...@@ -114,7 +114,7 @@ custom name continue onto the next step. ...@@ -114,7 +114,7 @@ custom name continue onto the next step.
If you manually copied your public SSH key make sure you copied the entire If you manually copied your public SSH key make sure you copied the entire
key starting with `ssh-rsa` and ending with your email. key starting with `ssh-rsa` and ending with your email.
1. Optionally you can test your setup by running `ssh -T git@example.com` 1. Optionally you can test your setup by running `ssh -T git@example.com`
(replacing `example.com` with your GitLab domain) and verifying that you (replacing `example.com` with your GitLab domain) and verifying that you
receive a `Welcome to GitLab` message. receive a `Welcome to GitLab` message.
...@@ -172,7 +172,7 @@ dummy user account. ...@@ -172,7 +172,7 @@ dummy user account.
If you are a project master or owner, you can add a deploy key in the If you are a project master or owner, you can add a deploy key in the
project settings under the section 'Repository'. Specify a title for the new project settings under the section 'Repository'. Specify a title for the new
deploy key and paste a public SSH key. After this, the machine that uses deploy key and paste a public SSH key. After this, the machine that uses
the corresponding private SSH key has read-only or read-write (if enabled) the corresponding private SSH key has read-only or read-write (if enabled)
access to the project. access to the project.
You can't add the same deploy key twice using the form. You can't add the same deploy key twice using the form.
...@@ -232,7 +232,7 @@ something is wrong with your SSH setup. ...@@ -232,7 +232,7 @@ something is wrong with your SSH setup.
- Ensure that you generated your SSH key pair correctly and added the public SSH - Ensure that you generated your SSH key pair correctly and added the public SSH
key to your GitLab profile key to your GitLab profile
- Try manually registering your private SSH key using `ssh-agent` as documented - Try manually registering your private SSH key using `ssh-agent` as documented
earlier in this document earlier in this document
- Try to debug the connection by running `ssh -Tv git@example.com` - Try to debug the connection by running `ssh -Tv git@example.com`
(replacing `example.com` with your GitLab domain) (replacing `example.com` with your GitLab domain)
---
comments: false
---
# GitLab University # GitLab University
GitLab University is the best place to learn about **Version Control with Git and GitLab**. GitLab University is the best place to learn about **Version Control with Git and GitLab**.
......
---
comments: false
---
# Books # Books
List of books and resources, that may be worth reading. List of books and resources, that may be worth reading.
......
---
comments: false
---
# The GitLab Book Club # The GitLab Book Club
The Book Club is a casual meet-up to read and discuss books we like. The Book Club is a casual meet-up to read and discuss books we like.
......
## What is the Glossary ---
comments: false
---
# What is the Glossary
This contains a simplified list and definitions of some of the terms that you will encounter in your day to day activities when working with GitLab. This contains a simplified list and definitions of some of the terms that you will encounter in your day to day activities when working with GitLab.
Please add any terms that you discover that you think would be useful for others. Please add any terms that you discover that you think would be useful for others.
......
---
comments: false
---
# High Availability on AWS # High Availability on AWS
......
---
comments: false
---
--- ---
title: University | Process title: University | Process
--- ---
## Suggesting improvements # Suggesting improvements
If you would like to teach a class or participate or help in any way please If you would like to teach a class or participate or help in any way please
submit a merge request and assign it to [Job](https://gitlab.com/u/JobV). submit a merge request and assign it to [Job](https://gitlab.com/u/JobV).
......
---
comments: false
---
## Support Boot Camp
# Support Boot Camp
**Goal:** Prepare new Service Engineers at GitLab **Goal:** Prepare new Service Engineers at GitLab
......
---
comments: false
---
# Training # Training
......
---
comments: false
---
# GitLab Flow # GitLab Flow
- A simplified branching strategy - A simplified branching strategy
......
---
comments: false
---
# GitLab Training Material # GitLab Training Material
All GitLab training material is stored in markdown format. Slides are All GitLab training material is stored in markdown format. Slides are
......
## Additional Resources ---
comments: false
---
# Additional Resources
1. GitLab Documentation [http://docs.gitlab.com](http://docs.gitlab.com/) 1. GitLab Documentation [http://docs.gitlab.com](http://docs.gitlab.com/)
2. GUI Clients [http://git-scm.com/downloads/guis](http://git-scm.com/downloads/guis) 2. GUI Clients [http://git-scm.com/downloads/guis](http://git-scm.com/downloads/guis)
......
---
comments: false
---
# Agile and Git # Agile and Git
---------- ----------
......
---
comments: false
---
# Bisect # Bisect
---------- ----------
......
---
comments: false
---
# Cherry Pick # Cherry Pick
---------- ----------
......
---
comments: false
---
# Configure your environment # Configure your environment
---------- ----------
......
---
comments: false
---
# Explore GitLab projects # Explore GitLab projects
---------- ----------
......
---
comments: false
---
# Feature branching # Feature branching
---------- ----------
......
---
comments: false
---
# Getting Started # Getting Started
---------- ----------
......
---
comments: false
---
# Git Add # Git Add
---------- ----------
......
---
comments: false
---
# Git introduction # Git introduction
---------- ----------
......
---
comments: false
---
# Git Log # Git Log
---------- ----------
......
---
comments: false
---
# GitLab Flow # GitLab Flow
---------- ----------
......
---
comments: false
---
# Merge conflicts # Merge conflicts
---------- ----------
......
---
comments: false
---
# Merge requests # Merge requests
---------- ----------
......
---
comments: false
---
# Rollback Commits # Rollback Commits
---------- ----------
......
---
comments: false
---
# Git Stash # Git Stash
---------- ----------
......
## Subtree ---
comments: false
---
---------- # Subtree
## Subtree
* Used when there are nested repositories. * Used when there are nested repositories.
* Not recommended when the amount of dependencies is too large * Not recommended when the amount of dependencies is too large
......
---
comments: false
---
# Tags # Tags
---------- ----------
......
---
comments: false
---
# Unstage # Unstage
---------- ----------
......
---
comments: false
---
# GitLab Git Workshop # GitLab Git Workshop
--- ---
......
---
comments: false
---
# From 10.0 to 10.1 # From 10.0 to 10.1
Make sure you view this update guide from the tag (version) of GitLab you would Make sure you view this update guide from the tag (version) of GitLab you would
......
---
comments: false
---
# From 2.6 to 3.0 # From 2.6 to 3.0
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/2.6-to-3.0.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/2.6-to-3.0.md) for the most up to date instructions.*
......
---
comments: false
---
# From 2.9 to 3.0 # From 2.9 to 3.0
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/2.9-to-3.0.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/2.9-to-3.0.md) for the most up to date instructions.*
......
---
comments: false
---
# From 3.0 to 3.1 # From 3.0 to 3.1
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/3.0-to-3.1.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/3.0-to-3.1.md) for the most up to date instructions.*
......
---
comments: false
---
# From 3.1 to 4.0 # From 3.1 to 4.0
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/3.1-to-4.0.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/3.1-to-4.0.md) for the most up to date instructions.*
......
---
comments: false
---
# From 4.0 to 4.1 # From 4.0 to 4.1
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/4.0-to-4.1.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/4.0-to-4.1.md) for the most up to date instructions.*
......
---
comments: false
---
# From 4.1 to 4.2 # From 4.1 to 4.2
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/4.1-to-4.2.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/4.1-to-4.2.md) for the most up to date instructions.*
......
---
comments: false
---
# From 4.2 to 5.0 # From 4.2 to 5.0
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/4.2-to-5.0.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/4.2-to-5.0.md) for the most up to date instructions.*
......
---
comments: false
---
# From 5.0 to 5.1 # From 5.0 to 5.1
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/5.0-to-5.1.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/5.0-to-5.1.md) for the most up to date instructions.*
......
---
comments: false
---
# From 5.1 to 5.2 # From 5.1 to 5.2
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/5.1-to-5.2.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/5.1-to-5.2.md) for the most up to date instructions.*
......
---
comments: false
---
# From 5.1 to 5.4 # From 5.1 to 5.4
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/5.1-to-5.4.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/5.1-to-5.4.md) for the most up to date instructions.*
......
---
comments: false
---
# From 5.1 to 6.0 # From 5.1 to 6.0
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/5.1-to-6.0.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/5.1-to-6.0.md) for the most up to date instructions.*
......
---
comments: false
---
# From 5.2 to 5.3 # From 5.2 to 5.3
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/5.2-to-5.3.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/5.2-to-5.3.md) for the most up to date instructions.*
......
---
comments: false
---
# From 5.3 to 5.4 # From 5.3 to 5.4
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/5.3-to-5.4.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/5.3-to-5.4.md) for the most up to date instructions.*
......
---
comments: false
---
# From 5.4 to 6.0 # From 5.4 to 6.0
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/5.4-to-6.0.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/5.4-to-6.0.md) for the most up to date instructions.*
......
---
comments: false
---
# From 6.0 to 6.1 # From 6.0 to 6.1
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.0-to-6.1.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.0-to-6.1.md) for the most up to date instructions.*
......
---
comments: false
---
# From 6.1 to 6.2 # From 6.1 to 6.2
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.1-to-6.2.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.1-to-6.2.md) for the most up to date instructions.*
......
---
comments: false
---
# From 6.2 to 6.3 # From 6.2 to 6.3
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.2-to-6.3.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.2-to-6.3.md) for the most up to date instructions.*
......
---
comments: false
---
# From 6.3 to 6.4 # From 6.3 to 6.4
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.3-to-6.4.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.3-to-6.4.md) for the most up to date instructions.*
......
---
comments: false
---
# From 6.4 to 6.5 # From 6.4 to 6.5
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.4-to-6.5.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.4-to-6.5.md) for the most up to date instructions.*
......
---
comments: false
---
# From 6.5 to 6.6 # From 6.5 to 6.6
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.5-to-6.6.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.5-to-6.6.md) for the most up to date instructions.*
......
---
comments: false
---
# From 6.6 to 6.7 # From 6.6 to 6.7
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.6-to-6.7.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.6-to-6.7.md) for the most up to date instructions.*
......
---
comments: false
---
# From 6.7 to 6.8 # From 6.7 to 6.8
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.7-to-6.8.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.7-to-6.8.md) for the most up to date instructions.*
......
---
comments: false
---
# From 6.8 to 6.9 # From 6.8 to 6.9
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.8-to-6.9.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.8-to-6.9.md) for the most up to date instructions.*
......
---
comments: false
---
# From 6.9 to 7.0 # From 6.9 to 7.0
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.9-to-7.0.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.9-to-7.0.md) for the most up to date instructions.*
......
---
comments: false
---
# From 6.x or 7.x to 7.14 # From 6.x or 7.x to 7.14
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.x-or-7.x-to-7.14.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/6.x-or-7.x-to-7.14.md) for the most up to date instructions.*
......
---
comments: false
---
# From 7.0 to 7.1 # From 7.0 to 7.1
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/7.0-to-7.1.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/7.0-to-7.1.md) for the most up to date instructions.*
......
---
comments: false
---
# From 7.1 to 7.2 # From 7.1 to 7.2
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/7.1-to-7.2.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/7.1-to-7.2.md) for the most up to date instructions.*
......
---
comments: false
---
# From 7.10 to 7.11 # From 7.10 to 7.11
### 0. Stop server ### 0. Stop server
......
---
comments: false
---
# From 7.11 to 7.12 # From 7.11 to 7.12
### 0. Double-check your Git version ### 0. Double-check your Git version
......
---
comments: false
---
# From 7.12 to 7.13 # From 7.12 to 7.13
### 0. Double-check your Git version ### 0. Double-check your Git version
......
---
comments: false
---
# From 7.13 to 7.14 # From 7.13 to 7.14
### 0. Double-check your Git version ### 0. Double-check your Git version
......
---
comments: false
---
# From 7.14 to 8.0 # From 7.14 to 8.0
### 0. Double-check your Git version ### 0. Double-check your Git version
......
---
comments: false
---
# From 7.2 to 7.3 # From 7.2 to 7.3
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/7.2-to-7.3.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/7.2-to-7.3.md) for the most up to date instructions.*
......
---
comments: false
---
# From 7.3 to 7.4 # From 7.3 to 7.4
*Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/7.3-to-7.4.md) for the most up to date instructions.* *Make sure you view this [upgrade guide from the `master` branch](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update/7.3-to-7.4.md) for the most up to date instructions.*
......
---
comments: false
---
# From 7.4 to 7.5 # From 7.4 to 7.5
### 0. Stop server ### 0. Stop server
......
---
comments: false
---
# From 7.5 to 7.6 # From 7.5 to 7.6
### 0. Stop server ### 0. Stop server
......
---
comments: false
---
# From 7.6 to 7.7 # From 7.6 to 7.7
### 0. Stop server ### 0. Stop server
......
---
comments: false
---
# From 7.7 to 7.8 # From 7.7 to 7.8
### 0. Stop server ### 0. Stop server
......
---
comments: false
---
# From 7.8 to 7.9 # From 7.8 to 7.9
### 0. Stop server ### 0. Stop server
......
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment