Differences

This shows you the differences between two versions of the page.

--- gitlabci [2022/09/22 14:01] – skipidar
+++ gitlabci [2022/09/22 16:35] (current) – skipidar
@@ Line 171: / Line 171: @@
-=== disable job ===
+=== hide a job (.job) ===
 Start the job name with a dot (.) and it is not processed by GitLab CI/CD
+https://docs.gitlab.com/ee/ci/jobs/#hide-jobs
 <sxh yaml>
@@ Line 183: / Line 184: @@
+=== includes of another files ===
+You can include
+ - from a subfolder
+ - from another gitlab-repository using "project" syntax
+<sxh yaml>
+include:
+  - gitlab_pipeline_jobs/shared.yml
+  - gitlab_pipeline_jobs/deployment.yml
+  - project: "mygroup/pipeline/autodevops"
+    ref: master
+    file: "templates/pipeline-cypress.yml"
+</sxh>
+=== extends: syntax ===
+You can use the ".extends" mechanism to refer to included modules,
+when the included modules shouldnt be activated automatically.
+Instead you should include those with customized variables.
+https://docs.gitlab.com/ee/ci/yaml/#extends
+<sxh yaml>
+.tests:
+  script: rake test
+  stage: test
+  only:
+    refs:
+      - branches
+rspec:
+  extends: .tests
+  script: rake rspec
+  only:
+    variables:
+      - $RSPEC
+</sxh>
+=== extends: syntax ===
+=== <<: *my_anchor reuse properties with anchors ===
+Using anchors you can reuse attriburtes across jobs,
+especially from a disabled job:
+<sxh yaml>
+.deployment: &deployment
+  image: path/to/image.jpg
+  tags:
+    - LAUNCHTAG
+.deploy_to_prod:
+  <<: *deployment
+  variables: !reference [.env_variables, prod]
+.deploy_to_prodint:
+  <<: *deployment
+  variables: !reference [.env_variables, prodint]
+</sxh>
+=== !reference [.terraform, feature_destroy] ===
+Reference some piece of code.
+https://docs.gitlab.com/ee/ci/yaml/yaml_optimization.html#reference-tags
+Use the !reference custom YAML tag to select keyword configuration from other job sections and reuse it in the current section.
+Unlike YAML anchors, you can use `!reference` tags to reuse configuration from included configuration files as well.
+setup.yml
+<sxh yaml>
+.setup:
+  script:
+    - echo creating environment
+</sxh>
+gitlab-ci.yml
+<sxh yaml>
+include:
+  - local: setup.yml
+.teardown:
+  after_script:
+    - echo deleting environment
+test:
+  script:
+    - !reference [.setup, script]
+    - echo running my own command
+  after_script:
+    - !reference [.teardown, after_script]
+</sxh>