diff options
Diffstat (limited to 'doc/ci/quick_start/index.md')
-rw-r--r-- | doc/ci/quick_start/index.md | 18 |
1 files changed, 13 insertions, 5 deletions
diff --git a/doc/ci/quick_start/index.md b/doc/ci/quick_start/index.md index d20a0f0d4a1..225794aec17 100644 --- a/doc/ci/quick_start/index.md +++ b/doc/ci/quick_start/index.md @@ -1,6 +1,6 @@ --- stage: Verify -group: Continuous Integration +group: Pipeline Execution info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments type: reference --- @@ -13,13 +13,16 @@ GitLab [continuous integration](https://about.gitlab.com/stages-devops-lifecycle Before you start, make sure you have: - A project in GitLab that you would like to use CI/CD for. -- Maintainer or owner access for the project. +- The [Maintainer or Owner role](../../user/permissions.md) for the project. If you are migrating from another CI/CD tool, view this documentation: - [Migrate from CircleCI](../migration/circleci.md). - [Migrate from Jenkins](../migration/jenkins.md). +> - <i class="fa fa-youtube-play youtube" aria-hidden="true"></i> Watch [First time GitLab & CI/CD](https://www.youtube.com/watch?v=kTNfi5z6Uvk&t=553s). This includes a quick introduction to GitLab, the first steps with CI/CD, building a Go project, running tests, using the CI/CD pipeline editor, detecting secrets and security vulnerabilities and offers more exercises for async practice. +> - <i class="fa fa-youtube-play youtube" aria-hidden="true"></i> Watch [Intro to GitLab CI](https://www.youtube.com/watch?v=l5705U8s_nQ&t=358s). This workshop uses the Web IDE to quickly get going with building source code using CI/CD, and run unit tests. + ## CI/CD process overview To use GitLab CI/CD: @@ -38,7 +41,7 @@ The job results [are displayed in a pipeline](#view-the-status-of-your-pipeline- In GitLab, runners are agents that run your CI/CD jobs. You might already have runners available for your project, including -[shared runners](../runners/README.md#shared-runners), which are +[shared runners](../runners/runners_scope.md), which are available to all projects in your GitLab instance. To view available runners: @@ -73,7 +76,7 @@ All of this is defined in the `.gitlab-ci.yml` file. To create a `.gitlab-ci.yml` file: -1. Go to **Project overview > Details**. +1. On the left sidebar, select **Project information > Details**. 1. Above the file list, select the branch you want to commit to, click the plus icon, then select **New file**: @@ -147,7 +150,7 @@ When you committed your changes, a pipeline started. To view your pipeline: -- Go **CI/CD > Pipelines**. +- Go to **CI/CD > Pipelines**. A pipeline with three stages should be displayed: @@ -162,3 +165,8 @@ To view your pipeline: ![Job details](img/job_details_v13_6.png) If the job status is `stuck`, check to ensure a runner is properly configured for the project. + +> To learn more about GitLab CI/CD, check out these video walkthroughs: +> +> - <i class="fa fa-youtube-play youtube" aria-hidden="true"></i> Watch [First time GitLab & CI/CD](https://www.youtube.com/watch?v=kTNfi5z6Uvk&t=150s). +> - <i class="fa fa-youtube-play youtube" aria-hidden="true"></i> Watch [Intro to GitLab CI](https://www.youtube.com/watch?v=l5705U8s_nQ&t=358s). |