Gitlab部署CI并使用.gitlab-ci.yml配置您的作业(中文翻译)

.gitlab-ci.yml

.gitlab-ci.yml

.gitlab-ci.yml

script

job1:
script: "execute-script-for-job1"

job2:
script: "execute-script-for-job2"

./configure;make;make
install

test.sh

image: ruby:2.1
services:
- postgres

before_script:
- bundle install

after_script:
- rm secrets

stages:
- build
- test
- deploy

job1:
stage: build
script:
- execute-script-for-job1
only:
- master
tags:
- docker

keywords

stages

形象和服务

before_script

before_script

after_script

after_script

阶段

stages

stages

stages

stages:
- build
- test
- deploy

build

build

test

test

deploy

deploy

success

failed

stages

.gitlab-ci.yml

build

test

deploy

stage

test

类型

变量

.gitlab-ci.yml

variables:
DATABASE_URL: "postgres://postgres@postgres/my_database"

CI_COMMIT_REF_NAME

.gitlab-ci.yml

缓存

cache

cache

binaries

.config

rspec:
script: test
cache:
paths:
- binaries/
- .config

rspec:
script: test
cache:
untracked: true

binaries

rspec:
script: test
cache:
untracked: truepaths:
- binaries/

rspec

binaries/

cache:
paths:
- my/files

rspec:
script: test
cache:
key: rspec
paths:
- binaries/

缓存：键

key

cache:key

cache:
key: "$CI_JOB_NAME"
untracked: true

cache:
key: "$CI_COMMIT_REF_NAME"
untracked: true

cache:
key: "$CI_JOB_NAME/$CI_COMMIT_REF_NAME"
untracked: true

cache:
key: "$CI_JOB_STAGE/$CI_COMMIT_REF_NAME"
untracked: true

$

%

cache:
key: "%CI_JOB_STAGE%/%CI_COMMIT_REF_NAME%"
untracked: true

工作

.gitlab-ci.yml

job_name:
script:
- rake spec
- coverage
stage: test
only:
- master
except:
- develop
tags:
- ruby
- postgres
allow_failure: true

test

stage

on_success

on_failure

always

manual

脚本

script

job:
script: "bundle exec rspec"

job:
script:
- uname -a
- bundle exec rspec

script

:

:

{

}

[

]

,

&

*

#

?

|

-

<

>

=

!

%

@

`

阶段

stage

stage

parallel

stage

只有和除外

only

except

only

except

only

except

only

except

only

except

only

except

only

except

branches

tags

triggers

only

except

job

issue-

job:
# use regexp
only:
- /^issue-.*$/
# use special keyword
except:
- branches

job

job:
# use special keywords
only:
- tags
- triggers

job:
only:
- branches@gitlab-org/gitlab-ce
except:
- master@gitlab-org/gitlab-ce

job

gitlab-org/gitlab-ce

工作变量

variables

variables

job_name:
variables: []

标签

tags

ruby

postgres

development

tags

job:
tags:
- ruby
- postgres

job

ruby

postgres

allow_failure

allow_failure

job1

job2

job1

allow_failure:
true

job1:
stage: test
script:
- execute_script_that_will_fail
allow_failure: true

job2:
stage: test
script:
- execute_script_that_will_succeed

job3:
stage: deploy
script:
- deploy_to_staging

什么时候

when

when

on_success

on_failure

always

manual

stages:
- build
- cleanup_build
- test
- deploy
- cleanup

build_job:
stage: build
script:
- make build

cleanup_build_job:
stage: cleanup_build
script:
- cleanup build when failed
when: on_failure

test_job:
stage: test
script:
- make test

deploy_job:
stage: deploy
script:
- make deploy
when: manual

cleanup_job:
stage: cleanup
script:
- cleanup after jobs
when: always

cleanup_build_job

build_job

cleanup_job

deploy_job

手动操作

allow_failure:
false

.gitlab-ci.yml

allow_failure:
true

环境

environment

environment

environment

deploy to production:
stage: deploy
script: git push production HEAD:master
environment:
name: production

deploy
to production

production

环境：名称

environment:
production

name

environment

-

_

/

$

{

}

qa

staging

production

environment

name

environment

deploy to production:
stage: deploy
script: git push production HEAD:master
environment:
name: production

环境：url

.gitlab-ci.yml

https://prod.example.com

deploy to production:
stage: deploy
script: git push production HEAD:master
environment:
name: productionurl: https://prod.example.com 

environment：on_stop

on_stop

environment

environment:action

环境：行动

action

on_stop

review_app:
stage: deploy
script: make deploy-app
environment:
name: review
on_stop: stop_review_app

stop_review_app:
stage: deploy
script: make delete-app
when: manual
environment:
name: review
action: stop

review_app

review

stop_review_app

on_stop

review_app

stop_review_app

when

manual

stop_review_app

when

environment:name

environment:action

stage

review_app

动态环境

$CI_ENVIRONMENT_SLUG

environment

name

url

.gitlab-ci.yml

deploy as review app:
stage: deploy
script: make deploy
environment:
name: review/$CI_COMMIT_REF_NAME
url: https://$CI_ENVIRONMENT_SLUG.example.com/

deploy
as review app

review/$CI_COMMIT_REF_NAME

$CI_COMMIT_REF_NAME

$CI_ENVIRONMENT_SLUG

deploy
as review app

pow

https://review-pow.example.com/

文物

artifacts

binaries

.config

artifacts:
paths:
- binaries/
- .config

artifacts:
untracked: true

binaries

artifacts:
untracked: truepaths:
- binaries/

job:
stage: build
script: make build
dependencies: []

default-job

default-job:
script:
- mvn test -U
except:
- tags

release-job:
script:
- mvn package -U
artifacts:
paths:
- target/*.war
only:
- tags

文物：名称

name

artifacts:name

artifacts

artifacts.zip

job:
artifacts:
name: "$CI_JOB_NAME"

job:
artifacts:
name: "$CI_COMMIT_REF_NAME"
untracked: true

job:
artifacts:
name: "${CI_JOB_NAME}_${CI_COMMIT_REF_NAME}"
untracked: true

job:
artifacts:
name: "${CI_JOB_STAGE}_${CI_COMMIT_REF_NAME}"
untracked: true

$

%

job:
artifacts:
name: "%CI_JOB_STAGE%_%CI_COMMIT_REF_NAME%"
untracked: true

文物：何时

artifacts:when

artifacts:when

on_success

on_failure

always

job:
artifacts:
when: on_failure

文物：expire_in

artifacts:expire_in

expire_in

expire_in

job:
artifacts:
expire_in: 1 week

依赖关系

artifacts

artifacts

dependencies

build:osx

build:linux

test:osx

build:osx

test:linux

build:linux

deploy

build:osx:
stage: build
script: make build:osx
artifacts:
paths:
- binaries/

build:linux:
stage: build
script: make build:linux
artifacts:
paths:
- binaries/

test:osx:
stage: test
script: make test:osx
dependencies:
- build:osx

test:linux:
stage: test
script: make test:linux
dependencies:
- build:linux

deploy:
stage: deploy
script: make deploy

before_script和after_script

before_script

after_script

before_script:
- global before script

job:
before_script:
- execute this instead of global before script
script:
- my command
after_script:
- execute this after my script

覆盖面

coverage

/

job1:
coverage: '/Code coverage: \d+\.\d+/'

Git策略

GIT_STRATEGY=none

GIT_STRATEGY

variables

variables

clone

fetch

none

clone

variables:
GIT_STRATEGY: clone

fetch

clone

git
clean

git
fetch

variables:
GIT_STRATEGY: fetch

none

deploy

variables:
GIT_STRATEGY: none

Git子模块策略

GIT_SUBMODULE_STRATEGY

GIT_STRATEGY

variables

variables

none

normal

recursive

none

normal

git submodule sync
git submodule update --init

recursive

git submodule sync --recursive
git submodule update --init --recursive

.gitmodules

作业阶段尝试

variables:
GET_SOURCES_ATTEMPTS: "3"

variables

variables

浅克隆

GIT_DEPTH

git
fetch

git
clone

GIT_DEPTH

unresolved
reference

GIT_DEPTH

git
describe

GIT_DEPTH

variables:
GIT_DEPTH: "3"

隐藏键

.

.key_name

.key_name:
script:
- rake spec

特殊YAML功能

&

*

<<

.gitlab-ci.yml

锚点

test1

test2

.job_template

script

.job_template: &job_definition  # Hidden key that defines an anchor named 'job_definition'
image: ruby:2.1
services:
- postgres
- redis

test1:
<<: *job_definition           # Merge the contents of the 'job_definition' alias
script:
- test1 project

test2:
<<: *job_definition           # Merge the contents of the 'job_definition' alias
script:
- test2 project

&

job_definition

<<

*

job_definition

.job_template:
image: ruby:2.1
services:
- postgres
- redis

test1:
image: ruby:2.1
services:
- postgres
- redis
script:
- test1 project

test2:
image: ruby:2.1
services:
- postgres
- redis
script:
- test2 project

test:postgres

test:mysql

script

.job_template

services

.postgres_services

.mysql_services

.job_template: &job_definition
script:
- test project

.postgres_services:
services: &postgres_definition
- postgres
- ruby

.mysql_services:
services: &mysql_definition
- mysql
- ruby

test:postgres:
<<: *job_definition
services: *postgres_definition

test:mysql:
<<: *job_definition
services: *mysql_definition

.job_template:
script:
- test project

.postgres_services:
services:
- postgres
- ruby

.mysql_services:
services:
- mysql
- ruby

test:postgres:
script:
- test project
services:
- postgres
- ruby

test:mysql:
script:
- test project
services:
- mysql
- ruby

触发器

页面

pages

public/

artifacts

public/

public/

.public

cp

public/

pages:
stage: deploy
script:
- mkdir .public
- cp -r * .public
- mv .public public
artifacts:
paths:
- public
only:
- master

验证.gitlab-ci.yml

/ci/lint