Skip to content

API Reference

Structs

AddChildrenProps

Initializer 

1
2
3
import { AddChildrenProps } from '@gcix/gcix'

const addChildrenProps: AddChildrenProps = { ... }

Properties

Name Type Description
jobsOrJobCollections Job | JobCollection[] No description.
name string No description.
stage string No description.
jobsOrJobCollectionsRequired 
1
public readonly jobsOrJobCollections: Job | JobCollection[];
nameOptional 
1
public readonly name: string;
  • Type: string
stageOptional 
1
public readonly stage: string;
  • Type: string

ArtifactsProps

Initializer 

1
2
3
import { ArtifactsProps } from '@gcix/gcix'

const artifactsProps: ArtifactsProps = { ... }

Properties

Name Type Description
excludes string[] Paths that prevent files from being added to an artifacts archive.
expireIn string How long the artifacts will be saved before it gets deleted.
exposeAs string Used to expose artifacts in merge requests.
name string Name of the artifacts archive.
paths string[] Paths relative to project directory $CI_PROJECT_DIR, found files will be used to create the artifacts.
public boolean True makes artifacts public.
reports ArtifactsReport[] Reports must be a valid dictionary, the key represents a ArtifactsReport and the value must be a valid relativ file path to the reports file.
untracked boolean If true adds all untracked file to artifacts archive.
when WhenStatement When to upload artifacts, Only on_success, on_failure or always is allowed.
excludesOptional 
1
public readonly excludes: string[];
  • Type: string[]

Paths that prevent files from being added to an artifacts archive.

expireInOptional 
1
public readonly expireIn: string;
  • Type: string

How long the artifacts will be saved before it gets deleted.

exposeAsOptional 
1
public readonly exposeAs: string;
  • Type: string

Used to expose artifacts in merge requests.

nameOptional 
1
public readonly name: string;
  • Type: string

Name of the artifacts archive.

Internally defaults to {PredefinedVariables.ciJobName}-{PredefinedVariables.ciCommitRefSlug}.

pathsOptional 
1
public readonly paths: string[];
  • Type: string[]

Paths relative to project directory $CI_PROJECT_DIR, found files will be used to create the artifacts.

publicOptional 
1
public readonly public: boolean;
  • Type: boolean

True makes artifacts public.

reportsOptional 
1
public readonly reports: ArtifactsReport[];

Reports must be a valid dictionary, the key represents a ArtifactsReport and the value must be a valid relativ file path to the reports file.

untrackedOptional 
1
public readonly untracked: boolean;
  • Type: boolean

If true adds all untracked file to artifacts archive.

whenOptional 
1
public readonly when: WhenStatement;

When to upload artifacts, Only on_success, on_failure or always is allowed.

ArtifactsReport

Initializer 

1
2
3
import { ArtifactsReport } from '@gcix/gcix'

const artifactsReport: ArtifactsReport = { ... }

Properties

Name Type Description
file string Relative path withing the project, where to find the generated report file.
reportType string https://docs.gitlab.com/ee/ci/yaml/artifacts_reports.html ArtifactsReport type to use.
fileRequired 
1
public readonly file: string;
  • Type: string

Relative path withing the project, where to find the generated report file.

reportTypeRequired 
1
public readonly reportType: string;
  • Type: string

https://docs.gitlab.com/ee/ci/yaml/artifacts_reports.html ArtifactsReport type to use.

CacheKeyProps

Initializer 

1
2
3
import { CacheKeyProps } from '@gcix/gcix'

const cacheKeyProps: CacheKeyProps = { ... }

Properties

Name Type Description
files string[] No description.
key string No description.
prefix string No description.
filesOptional 
1
public readonly files: string[];
  • Type: string[]
keyOptional 
1
public readonly key: string;
  • Type: string
  • Default: gcix.PredefinedVariables.ciCommitRefSlug
prefixOptional 
1
public readonly prefix: string;
  • Type: string

CacheProps

Initializer 

1
2
3
import { CacheProps } from '@gcix/gcix'

const cacheProps: CacheProps = { ... }

Properties

Name Type Description
paths string[] No description.
cacheKey CacheKey No description.
policy CachePolicy No description.
untracked boolean Set the untracked keyword to True to cache all files that are untracked in your Git repository.
when WhenStatement No description.
pathsRequired 
1
public readonly paths: string[];
  • Type: string[]
cacheKeyOptional 
1
public readonly cacheKey: CacheKey;
  • Type: CacheKey
  • Default: to CacheKey with default arguments.
policyOptional 
1
public readonly policy: CachePolicy;
untrackedOptional 
1
public readonly untracked: boolean;
  • Type: boolean

Set the untracked keyword to True to cache all files that are untracked in your Git repository.

whenOptional 
1
public readonly when: WhenStatement;

ChildDict

Initializer 

1
2
3
import { ChildDict } from '@gcix/gcix'

const childDict: ChildDict = { ... }

Properties

Name Type Description
child Job | JobCollection No description.
name string No description.
stage string No description.
childRequired 
1
public readonly child: Job | JobCollection;
nameOptional 
1
public readonly name: string;
  • Type: string
stageOptional 
1
public readonly stage: string;
  • Type: string

ImageProps

Initializer 

1
2
3
import { ImageProps } from '@gcix/gcix'

const imageProps: ImageProps = { ... }

Properties

Name Type Description
name string No description.
entrypoint string[] No description.
tag string No description.
nameRequired 
1
public readonly name: string;
  • Type: string
entrypointOptional 
1
public readonly entrypoint: string[];
  • Type: string[]
tagOptional 
1
public readonly tag: string;
  • Type: string

IncludeArtifactProps

Initializer 

1
2
3
import { IncludeArtifactProps } from '@gcix/gcix'

const includeArtifactProps: IncludeArtifactProps = { ... }

Properties

Name Type Description
artifact string Relative path to the artifact which is produced by job.
job string Job name to include the artifact from.
artifactRequired 
1
public readonly artifact: string;
  • Type: string

Relative path to the artifact which is produced by job.

jobRequired 
1
public readonly job: string;
  • Type: string

Job name to include the artifact from.

IncludeFileProps

Initializer 

1
2
3
import { IncludeFileProps } from '@gcix/gcix'

const includeFileProps: IncludeFileProps = { ... }

Properties

Name Type Description
file string Relative path to the file to include.
project string Project to include the file from.
ref string Project branch to include the file from.
fileRequired 
1
public readonly file: string;
  • Type: string

Relative path to the file to include.

projectRequired 
1
public readonly project: string;
  • Type: string

Project to include the file from.

refOptional 
1
public readonly ref: string;
  • Type: string

Project branch to include the file from.

IncludeLocalProps

Initializer 

1
2
3
import { IncludeLocalProps } from '@gcix/gcix'

const includeLocalProps: IncludeLocalProps = { ... }

Properties

Name Type Description
local string Relative path to the file within this repository to include.
localRequired 
1
public readonly local: string;
  • Type: string

Relative path to the file within this repository to include.

IncludeRemoteProps

Initializer 

1
2
3
import { IncludeRemoteProps } from '@gcix/gcix'

const includeRemoteProps: IncludeRemoteProps = { ... }

Properties

Name Type Description
remote string URL to include the file from.
remoteRequired 
1
public readonly remote: string;
  • Type: string

URL to include the file from.

IncludeTemplateProps

Initializer 

1
2
3
import { IncludeTemplateProps } from '@gcix/gcix'

const includeTemplateProps: IncludeTemplateProps = { ... }

Properties

Name Type Description
template string Gitlab template pipeline to include.
templateRequired 
1
public readonly template: string;
  • Type: string

Gitlab template pipeline to include.

JobProps

Initializer 

1
2
3
import { JobProps } from '@gcix/gcix'

const jobProps: JobProps = { ... }

Properties

Name Type Description
scripts string[] No description.
allowFailure boolean | number[] No description.
artifacts Artifacts No description.
cache Cache No description.
dependencies Job | JobCollection[] No description.
image string | Image No description.
name string No description.
needs Job | JobCollection | Need[] No description.
rules Rule[] No description.
stage string No description.
tags string[] No description.
variables {[ key: string ]: string} No description.
scriptsRequired 
1
public readonly scripts: string[];
  • Type: string[]
allowFailureOptional 
1
public readonly allowFailure: boolean | number[];
  • Type: boolean | number[]
artifactsOptional 
1
public readonly artifacts: Artifacts;
cacheOptional 
1
public readonly cache: Cache;
dependenciesOptional 
1
public readonly dependencies: Job | JobCollection[];
imageOptional 
1
public readonly image: string | Image;
nameOptional 
1
public readonly name: string;
  • Type: string
needsOptional 
1
public readonly needs: Job | JobCollection | Need[];
rulesOptional 
1
public readonly rules: Rule[];
stageOptional 
1
public readonly stage: string;
  • Type: string
tagsOptional 
1
public readonly tags: string[];
  • Type: string[]
variablesOptional 
1
public readonly variables: {[ key: string ]: string};
  • Type: {[ key: string ]: string}

NeedProps

Initializer 

1
2
3
import { NeedProps } from '@gcix/gcix'

const needProps: NeedProps = { ... }

Properties

Name Type Description
artifacts boolean No description.
job string No description.
pipeline string No description.
project string No description.
ref string No description.
artifactsOptional 
1
public readonly artifacts: boolean;
  • Type: boolean
  • Default: true
jobOptional 
1
public readonly job: string;
  • Type: string
  • Default: undefined but requires pipeline to be set.
pipelineOptional 
1
public readonly pipeline: string;
  • Type: string
  • Default: undefined which requires job to be set.
projectOptional 
1
public readonly project: string;
  • Type: string
  • Default: undefined
refOptional 
1
public readonly ref: string;
  • Type: string
  • Default: undefined

PipelineProps

Initializer 

1
2
3
import { PipelineProps } from '@gcix/gcix'

const pipelineProps: PipelineProps = { ... }

Properties

Name Type Description
includes Include[] You can add global gcix.Includes to the pipeline. Gitlab CI Documentation: "Use include to include external YAML files in your CI/CD configuration.".
includesOptional 
1
public readonly includes: Include[];

You can add global gcix.Includes to the pipeline. Gitlab CI Documentation: "Use include to include external YAML files in your CI/CD configuration.".

RenderedImage

This module represents the Gitlab CI Image keyword. Use Image to specify a Docker image to use for the gcix.Job.

Instances of this class are intended to be immutable. Image objects are typically defined in a central location and often reused throughout the codebase. Modifying an Image object at one place may result in unexpected changes at any other reference to that object. Therefore, this class does not provide any setter methods to modify its properties directly.

However, you can create an altered copy of an Image object using the .withTag() and .withEntrypoint() methods. These methods return a new Image object with the specified modifications, allowing you to reuse the original Image object while making specific changes for a particular use case.

By following this approach, you can maintain a central repository of Image objects and easily create customized versions as needed, without affecting the original object or introducing unintended side effects.

Initializer 

1
2
3
import { RenderedImage } from '@gcix/gcix'

const renderedImage: RenderedImage = { ... }

Properties

Name Type Description
name string No description.
entrypoint string[] No description.
nameRequired 
1
public readonly name: string;
  • Type: string
entrypointOptional 
1
public readonly entrypoint: string[];
  • Type: string[]

RenderedIncludeArtifact

Initializer 

1
2
3
import { RenderedIncludeArtifact } from '@gcix/gcix'

const renderedIncludeArtifact: RenderedIncludeArtifact = { ... }

Properties

Name Type Description
artifact string No description.
job string No description.
artifactRequired 
1
public readonly artifact: string;
  • Type: string
jobRequired 
1
public readonly job: string;
  • Type: string

RenderedIncludeFile

Initializer 

1
2
3
import { RenderedIncludeFile } from '@gcix/gcix'

const renderedIncludeFile: RenderedIncludeFile = { ... }

Properties

Name Type Description
file string No description.
project string No description.
ref string No description.
fileRequired 
1
public readonly file: string;
  • Type: string
projectRequired 
1
public readonly project: string;
  • Type: string
refOptional 
1
public readonly ref: string;
  • Type: string

RenderedIncludeLocal

Initializer 

1
2
3
import { RenderedIncludeLocal } from '@gcix/gcix'

const renderedIncludeLocal: RenderedIncludeLocal = { ... }

Properties

Name Type Description
local string No description.
localRequired 
1
public readonly local: string;
  • Type: string

RenderedIncludeRemote

Initializer 

1
2
3
import { RenderedIncludeRemote } from '@gcix/gcix'

const renderedIncludeRemote: RenderedIncludeRemote = { ... }

Properties

Name Type Description
remote string No description.
remoteRequired 
1
public readonly remote: string;
  • Type: string

RenderedIncludeTemplate

Initializer 

1
2
3
import { RenderedIncludeTemplate } from '@gcix/gcix'

const renderedIncludeTemplate: RenderedIncludeTemplate = { ... }

Properties

Name Type Description
template string No description.
templateRequired 
1
public readonly template: string;
  • Type: string

RenderedJob

Initializer 

1
2
3
import { RenderedJob } from '@gcix/gcix'

const renderedJob: RenderedJob = { ... }

RuleProps

Initializer 

1
2
3
import { RuleProps } from '@gcix/gcix'

const ruleProps: RuleProps = { ... }

Properties

Name Type Description
allowFailure boolean No description.
changes string[] No description.
exists string[] No description.
ifStatement string No description.
variables {[ key: string ]: string} No description.
when WhenStatement No description.
allowFailureOptional 
1
public readonly allowFailure: boolean;
  • Type: boolean
  • Default: false
changesOptional 
1
public readonly changes: string[];
  • Type: string[]
existsOptional 
1
public readonly exists: string[];
  • Type: string[]
ifStatementOptional 
1
public readonly ifStatement: string;
  • Type: string
variablesOptional 
1
public readonly variables: {[ key: string ]: string};
  • Type: {[ key: string ]: string}
whenOptional 
1
public readonly when: WhenStatement;

ServiceProps

Initializer 

1
2
3
import { ServiceProps } from '@gcix/gcix'

const serviceProps: ServiceProps = { ... }

Properties

Name Type Description
name string No description.
nameRequired 
1
public readonly name: string;
  • Type: string

TriggerJobProps

Initializer 

1
2
3
import { TriggerJobProps } from '@gcix/gcix'

const triggerJobProps: TriggerJobProps = { ... }

Properties

Name Type Description
branch string No description.
includes IncludeLocal | IncludeFile | IncludeRemote | IncludeTemplate | IncludeArtifact[] No description.
name string No description.
project string No description.
stage string No description.
strategy string No description.
branchOptional 
1
public readonly branch: string;
  • Type: string
includesOptional 
1
public readonly includes: IncludeLocal | IncludeFile | IncludeRemote | IncludeTemplate | IncludeArtifact[];
nameOptional 
1
public readonly name: string;
  • Type: string
projectOptional 
1
public readonly project: string;
  • Type: string
stageOptional 
1
public readonly stage: string;
  • Type: string
strategyOptional 
1
public readonly strategy: string;
  • Type: string

Classes

Artifacts

This class represents the artifacts keyword.

Gitlab CI documentation: "Use artifacts to specify a list of files and directories that are attached to the gcix.Job when it succeeds, fails, or always. [...] by default, gcix.Jobs in later stages automatically download all the artifacts created by jobs in earlier stages. You can control artifact download behavior in Job's with dependencies."

Initializers 

1
2
3
import { Artifacts } from '@gcix/gcix'

new Artifacts(props: ArtifactsProps)
Name Type Description
props ArtifactsProps No description.
propsRequired

Methods

Name Description
addExcludes No description.
addPaths No description.
isEqual isEqual checks if this object is equal to given object.
render Returns a representation of any object which implements IBase.
addExcludes 
1
public addExcludes(excludes: string[]): void
excludesRequired
  • Type: string[]
addPaths 
1
public addPaths(paths: string[]): void
pathsRequired
  • Type: string[]
isEqual 
1
public isEqual(comparable: IBase): boolean

isEqual checks if this object is equal to given object.

comparableRequired
render 
1
public render(): any

Returns a representation of any object which implements IBase.

The rendered representation is used by the gcix to dump it in YAML format as part of the .gitlab-ci.yml pipeline.

Properties

Name Type Description
excludes string[] No description.
paths string[] No description.
expireIn string No description.
exposeAs string No description.
name string No description.
public boolean No description.
reports ArtifactsReport[] No description.
untracked boolean No description.
when WhenStatement No description.
orderedExcludes OrderedStringSet No description.
orderedPaths OrderedStringSet No description.
excludesRequired 
1
public readonly excludes: string[];
  • Type: string[]
pathsRequired 
1
public readonly paths: string[];
  • Type: string[]
expireInOptional 
1
public readonly expireIn: string;
  • Type: string
exposeAsOptional 
1
public readonly exposeAs: string;
  • Type: string
nameOptional 
1
public readonly name: string;
  • Type: string
publicOptional 
1
public readonly public: boolean;
  • Type: boolean
reportsOptional 
1
public readonly reports: ArtifactsReport[];
untrackedOptional 
1
public readonly untracked: boolean;
  • Type: boolean
whenOptional 
1
public readonly when: WhenStatement;
orderedExcludesRequired 
1
public readonly orderedExcludes: OrderedStringSet;
orderedPathsRequired 
1
public readonly orderedPaths: OrderedStringSet;

Cache

This class represents the cache keyword.

Gitlab CI documentation:

"Use cache to specify a list of files and directories to cache between gcix.Jobs. [...] Caching is shared between gcix.Pipelines and gcix.Jobs. Caches are restored before artifacts."

Initializers 

1
2
3
import { Cache } from '@gcix/gcix'

new Cache(props: CacheProps)
Name Type Description
props CacheProps No description.
propsRequired

Methods

Name Description
isEqual isEqual checks if this object is equal to given object.
render Returns a representation of any object which implements IBase.
isEqual 
1
public isEqual(comparable: IBase): boolean

isEqual checks if this object is equal to given object.

comparableRequired
render 
1
public render(): any

Returns a representation of any object which implements IBase.

The rendered representation is used by the gcix to dump it in YAML format as part of the .gitlab-ci.yml pipeline.

Properties

Name Type Description
cacheKey CacheKey No description.
paths string[] No description.
policy CachePolicy No description.
untracked boolean No description.
when WhenStatement No description.
cacheKeyRequired 
1
public readonly cacheKey: CacheKey;
pathsRequired 
1
public readonly paths: string[];
  • Type: string[]
policyOptional 
1
public readonly policy: CachePolicy;
untrackedOptional 
1
public readonly untracked: boolean;
  • Type: boolean
whenOptional 
1
public readonly when: WhenStatement;

CacheKey

This class represents the cache:key keyword.

Gitlab CI documentation: "The key keyword defines the affinity of caching between jobs. You can have a single cache for all jobs, cache per-job, cache per-branch, or any other way that fits your workflow."

Initializers 

1
2
3
import { CacheKey } from '@gcix/gcix'

new CacheKey(props: CacheKeyProps)
Name Type Description
props CacheKeyProps No description.
propsRequired

Methods

Name Description
isEqual isEqual checks if this object is equal to given object.
render Returns a representation of any object which implements IBase.
isEqual 
1
public isEqual(comparable: IBase): boolean

isEqual checks if this object is equal to given object.

comparableRequired
render 
1
public render(): any

Returns a representation of any object which implements IBase.

The rendered representation is used by the gcix to dump it in YAML format as part of the .gitlab-ci.yml pipeline.

Properties

Name Type Description
files string[] No description.
key string No description.
prefix string No description.
filesOptional 
1
public readonly files: string[];
  • Type: string[]
keyOptional 
1
public readonly key: string;
  • Type: string
prefixOptional 
1
public readonly prefix: string;
  • Type: string

Image

Initializers 

1
2
3
import { Image } from '@gcix/gcix'

new Image(props: ImageProps)
Name Type Description
props ImageProps No description.
propsRequired

Methods

Name Description
isEqual isEqual checks if this object is equal to given object.
render Returns a representation of any object which implements IBase.
withEntrypoint No description.
withTag No description.
isEqual 
1
public isEqual(comparable: IBase): boolean

isEqual checks if this object is equal to given object.

comparableRequired
render 
1
public render(): any

Returns a representation of any object which implements IBase.

The rendered representation is used by the gcix to dump it in YAML format as part of the .gitlab-ci.yml pipeline.

withEntrypoint 
1
public withEntrypoint(entrypoint: string[]): Image
entrypointRequired
  • Type: string[]
withTag 
1
public withTag(tag: string): Image
tagRequired
  • Type: string

Properties

Name Type Description
name string No description.
entrypoint string[] No description.
tag string No description.
nameRequired 
1
public readonly name: string;
  • Type: string
entrypointOptional 
1
public readonly entrypoint: string[];
  • Type: string[]
tagOptional 
1
public readonly tag: string;
  • Type: string

Include

This is just an abstract superclass.

Please use one of the subclasses:

  • IncludeLocal
  • IncludeFile
  • IncludeRemote
  • IncludeTemplate
  • IncludeArtifact

Initializers 

1
2
3
import { Include } from '@gcix/gcix'

new Include()
Name Type Description

Methods

Name Description
isEqual isEqual checks if this object is equal to given object.
render Returns a representation of any object which implements IBase.
isEqual 
1
public isEqual(comparable: IBase): boolean

isEqual checks if this object is equal to given object.

comparableRequired
render 
1
public render(): any

Returns a representation of any object which implements IBase.

The rendered representation is used by the gcix to dump it in YAML format as part of the .gitlab-ci.yml pipeline.

Properties

Name Type Description
rendered any No description.
renderedRequired 
1
public readonly rendered: any;
  • Type: any

IncludeArtifact

Initializers 

1
2
3
import { IncludeArtifact } from '@gcix/gcix'

new IncludeArtifact(props: IncludeArtifactProps)
Name Type Description
props IncludeArtifactProps No description.
propsRequired

Methods

Name Description
isEqual isEqual checks if this object is equal to given object.
render Returns a representation of any object which implements IBase.
isEqual 
1
public isEqual(comparable: IBase): boolean

isEqual checks if this object is equal to given object.

comparableRequired
render 
1
public render(): any

Returns a representation of any object which implements IBase.

The rendered representation is used by the gcix to dump it in YAML format as part of the .gitlab-ci.yml pipeline.

Properties

Name Type Description
rendered any No description.
renderedRequired 
1
public readonly rendered: any;
  • Type: any

IncludeFile

This module represents the Gitlab CI include:file keyword.

Initializers 

1
2
3
import { IncludeFile } from '@gcix/gcix'

new IncludeFile(props: IncludeFileProps)
Name Type Description
props IncludeFileProps No description.
propsRequired

Methods

Name Description
isEqual isEqual checks if this object is equal to given object.
render Returns a representation of any object which implements IBase.
isEqual 
1
public isEqual(comparable: IBase): boolean

isEqual checks if this object is equal to given object.

comparableRequired
render 
1
public render(): any

Returns a representation of any object which implements IBase.

The rendered representation is used by the gcix to dump it in YAML format as part of the .gitlab-ci.yml pipeline.

Properties

Name Type Description
rendered any No description.
renderedRequired 
1
public readonly rendered: any;
  • Type: any

IncludeLocal

This module represents the Gitlab CI include:local keyword.

Initializers 

1
2
3
import { IncludeLocal } from '@gcix/gcix'

new IncludeLocal(props: IncludeLocalProps)
Name Type Description
props IncludeLocalProps No description.
propsRequired

Methods

Name Description
isEqual isEqual checks if this object is equal to given object.
render Returns a representation of any object which implements IBase.
isEqual 
1
public isEqual(comparable: IBase): boolean

isEqual checks if this object is equal to given object.

comparableRequired
render 
1
public render(): any

Returns a representation of any object which implements IBase.

The rendered representation is used by the gcix to dump it in YAML format as part of the .gitlab-ci.yml pipeline.

Properties

Name Type Description
rendered any No description.
renderedRequired 
1
public readonly rendered: any;
  • Type: any

IncludeRemote

Initializers 

1
2
3
import { IncludeRemote } from '@gcix/gcix'

new IncludeRemote(props: IncludeRemoteProps)
Name Type Description
props IncludeRemoteProps No description.
propsRequired

Methods

Name Description
isEqual isEqual checks if this object is equal to given object.
render Returns a representation of any object which implements IBase.
isEqual 
1
public isEqual(comparable: IBase): boolean

isEqual checks if this object is equal to given object.

comparableRequired
render 
1
public render(): any

Returns a representation of any object which implements IBase.

The rendered representation is used by the gcix to dump it in YAML format as part of the .gitlab-ci.yml pipeline.

Properties

Name Type Description
rendered any No description.
renderedRequired 
1
public readonly rendered: any;
  • Type: any

IncludeTemplate

Initializers 

1
2
3
import { IncludeTemplate } from '@gcix/gcix'

new IncludeTemplate(props: IncludeTemplateProps)
Name Type Description
props IncludeTemplateProps No description.
propsRequired

Methods

Name Description
isEqual isEqual checks if this object is equal to given object.
render Returns a representation of any object which implements IBase.
isEqual 
1
public isEqual(comparable: IBase): boolean

isEqual checks if this object is equal to given object.

comparableRequired
render 
1
public render(): any

Returns a representation of any object which implements IBase.

The rendered representation is used by the gcix to dump it in YAML format as part of the .gitlab-ci.yml pipeline.

Properties

Name Type Description
rendered any No description.
renderedRequired 
1
public readonly rendered: any;
  • Type: any

Job

This class represents the Gitlab CI Job.

Initializers 

1
2
3
import { Job } from '@gcix/gcix'

new Job(props: JobProps)
Name Type Description
props JobProps No description.
propsRequired

Methods

Name Description
addDependencies No description.
addNeeds No description.
addParent This method is called by gcix.JobCollections when the job is added to that JobCollection.
addTags No description.
addVariables No description.
appendRules No description.
appendScripts No description.
assignAllowFailure No description.
assignArtifacts No description.
assignCache No description.
assignDependencies No description.
assignImage Sets the image of this job.
assignNeeds No description.
assignTags No description.
copy Returns an independent, deep copy object of this job.
extendName This method is used by gcix.JobCollections to populate the jobs name.
extendStage This method is used by gcix.JobCollections to populate the jobs name and stage.
extendStageValue This method is used by gcix.JobCollections to populate the jobs stage.
getAllInstanceNames Return all instance names from the given child.
isEqual isEqual checks if this object is equal to given object.
prependRules No description.
prependScripts No description.
render Returns a representation of any object which implements IBase.
addDependencies 
1
public addDependencies(dependencies: Job | JobCollection | Need[]): Job
dependenciesRequired
addNeeds 
1
public addNeeds(needs: Job | JobCollection | Need[]): Job
needsRequired
addParent 
1
public addParent(parent: Job | JobCollection): void

This method is called by gcix.JobCollections when the job is added to that JobCollection.

The job needs to know its parents when getAllInstanceNames() is called.

parentRequired
addTags 
1
public addTags(tags: string[]): Job
tagsRequired
  • Type: string[]
addVariables 
1
public addVariables(variables: {[ key: string ]: string}): Job
variablesRequired
  • Type: {[ key: string ]: string}
appendRules 
1
public appendRules(rules: Rule[]): Job
rulesRequired
appendScripts 
1
public appendScripts(scripts: string[]): Job
scriptsRequired
  • Type: string[]
assignAllowFailure 
1
public assignAllowFailure(allowFailure: boolean | number[]): Job
allowFailureRequired
  • Type: boolean | number[]
assignArtifacts 
1
public assignArtifacts(artifacts: Artifacts): Job
artifactsRequired
assignCache 
1
public assignCache(cache: Cache): Job
cacheRequired
assignDependencies 
1
public assignDependencies(dependencies: Job | JobCollection | Need[]): Job
dependenciesRequired
assignImage 
1
public assignImage(image: string | Image): Job

Sets the image of this job.

For a simple container image you can provide the origin of the image. If you want to set the entrypoint, you have to provide an Image object instead.

!! Any previous values will be overwritten.

imageRequired
assignNeeds 
1
public assignNeeds(needs: Job | JobCollection | Need[]): Job
needsRequired
assignTags 
1
public assignTags(tags: string[]): Job
tagsRequired
  • Type: string[]
copy 
1
public copy(): Job

Returns an independent, deep copy object of this job.

extendName 
1
public extendName(name: string): void

This method is used by gcix.JobCollections to populate the jobs name.

nameRequired
  • Type: string
extendStage 
1
public extendStage(stage: string): void

This method is used by gcix.JobCollections to populate the jobs name and stage.

stageRequired
  • Type: string
extendStageValue 
1
public extendStageValue(stage: string): void

This method is used by gcix.JobCollections to populate the jobs stage.

stageRequired
  • Type: string
getAllInstanceNames 
1
public getAllInstanceNames(child?: Job | JobCollection): OrderedStringSet

Return all instance names from the given child.

That means all combinations of the childs name and stage within this sequence and all parent sequences.

childOptional
isEqual 
1
public isEqual(comparable: IBase): boolean

isEqual checks if this object is equal to given object.

comparableRequired
prependRules 
1
public prependRules(rules: Rule[]): Job
rulesRequired
prependScripts 
1
public prependScripts(scripts: string[]): Job
scriptsRequired
  • Type: string[]
render 
1
public render(): any

Returns a representation of any object which implements IBase.

The rendered representation is used by the gcix to dump it in YAML format as part of the .gitlab-ci.yml pipeline.

Properties

Name Type Description
tags string[] Getter method to receive added tags.
allowFailure string | boolean | number[] No description.
name string No description.
orderedTags OrderedStringSet No description.
parents Job | JobCollection[] No description.
scripts string[] No description.
stage string No description.
artifacts Artifacts No description.
cache Cache No description.
dependencies Job | JobCollection | Need[] No description.
image Image No description.
needs Job | JobCollection | Need[] No description.
original Job No description.
rules Rule[] No description.
variables {[ key: string ]: string} No description.
tagsRequired 
1
public readonly tags: string[];
  • Type: string[]

Getter method to receive added tags.

allowFailureRequired 
1
public readonly allowFailure: string | boolean | number[];
  • Type: string | boolean | number[]
nameRequired 
1
public readonly name: string;
  • Type: string
orderedTagsRequired 
1
public readonly orderedTags: OrderedStringSet;
parentsRequired 
1
public readonly parents: Job | JobCollection[];
scriptsRequired 
1
public readonly scripts: string[];
  • Type: string[]
stageRequired 
1
public readonly stage: string;
  • Type: string
artifactsOptional 
1
public readonly artifacts: Artifacts;
cacheOptional 
1
public readonly cache: Cache;
dependenciesOptional 
1
public readonly dependencies: Job | JobCollection | Need[];
imageOptional 
1
public readonly image: Image;
needsOptional 
1
public readonly needs: Job | JobCollection | Need[];
originalOptional 
1
public readonly original: Job;
rulesOptional 
1
public readonly rules: Rule[];
variablesOptional 
1
public readonly variables: {[ key: string ]: string};
  • Type: {[ key: string ]: string}

JobCollection

A JobCollection collects multiple gcix.Jobs and/or other gcix.JobCollections into a group.

Initializers 

1
2
3
import { JobCollection } from '@gcix/gcix'

new JobCollection()
Name Type Description

Methods

Name Description
addChildren Add gcix.Jobs or other gcix.JobCollections to this JobCollection.
addDependencies No description.
addNeeds No description.
addParent No description.
addTags No description.
addVariables No description.
appendRules No description.
appendScripts No description.
assignArtifacts No description.
assignCache No description.
getAllInstanceNames Return all instance names from the given child.
initializeAllowFailure Calling gcix.Job.assignAllowFailure() to all jobs within this JobCollection that haven't been set the allowFailure before.
initializeArtifacts Sets gcix.Job.artifacts to all jobs within this JobCollection that haven't been set the artifacs before.
initializeCache Calling gcix.Job.assigneCache() to all jobs within this JobCollection that haven't been set the cache before.
initializeDependencies Calling gcix.Job.assignDependencies() to all jobs within the first stage of this JobCollection that haven't been added dependencies before.
initializeImage Calling gcix.Job.assignImage() to all jobs within this JobCollection.
initializeNeeds Calling gcix.Job.assignNeeds() to all jobs within the first stage of this JobCollection that haven't been added needs before.
initializeRules Calling gcix.Job.append_rules() to all jobs within this JobCollection that haven't been added rules before.
initializeTags Calling gcix.Job.addTags([...]) to all jobs within this JobCollection that haven't been added tags before.
initializeVariables Calling gcix.Job.addVariables({...}) to all jobs within this JobCollection that haven't been added variables before.
isEqual isEqual checks if this object is equal to given object.
overrideAllowFailure Calling gcix.Job.assignAllowFailure() to all jobs within this JobCollection overriding any previous set value.
overrideDependencies Calling gcix.Job.assignDependencies() to all jobs within the first stage of this JobCollection and overriding any previously added dependencies to that jobs.
overrideImage Calling gcix.Job.assignImage() to all jobs within this JobCollection overriding any previous set value.
overrideNeeds Calling gcix.Job.assignNeeds() to all jobs within the first stage of this JobCollection and overriding any previously added needs to that jobs.
overrideRules Calling gcix.Job.overrideRules() to all jobs within this JobCollection and overriding any previously added rules to that jobs.
overrideTags Calling gcix.Job.addTags([...]) to all jobs within this JobCollection and overriding any previously added tags to that jobs.
overrideVariables Calling gcix.Job.addVariables({...}) to all jobs within this JobCollection and overriding any previously added variables to that jobs.
prependRules No description.
prependScripts No description.
render Returns a representation of any object which implements IBase.
addChildren 
1
public addChildren(props: AddChildrenProps): JobCollection

Add gcix.Jobs or other gcix.JobCollections to this JobCollection.

Adding a child creates a copy of that child. You should provide a name or stage when adding children, to make them different from other places where they will be used.

propsRequired
addDependencies 
1
public addDependencies(dependencies: Job | JobCollection | Need[]): JobCollection
dependenciesRequired
addNeeds 
1
public addNeeds(needs: Job | JobCollection | Need[]): JobCollection
needsRequired
addParent 
1
public addParent(parent: JobCollection): void
parentRequired
addTags 
1
public addTags(tags: string[]): JobCollection
tagsRequired
  • Type: string[]
addVariables 
1
public addVariables(variables: {[ key: string ]: string}): JobCollection
variablesRequired
  • Type: {[ key: string ]: string}
appendRules 
1
public appendRules(rules: Rule[]): JobCollection
rulesRequired
appendScripts 
1
public appendScripts(scripts: string[]): JobCollection
scriptsRequired
  • Type: string[]
assignArtifacts 
1
public assignArtifacts(artifacts: Artifacts): JobCollection
artifactsRequired
assignCache 
1
public assignCache(cache: Cache): JobCollection
cacheRequired
getAllInstanceNames 
1
public getAllInstanceNames(child?: Job | JobCollection): OrderedStringSet

Return all instance names from the given child.

That means all combinations of the childs name and stage within this JobCollection and all parent JobCollection's.

childOptional
initializeAllowFailure 
1
public initializeAllowFailure(allowFailure: boolean | number[]): JobCollection

Calling gcix.Job.assignAllowFailure() to all jobs within this JobCollection that haven't been set the allowFailure before.

allowFailureRequired
  • Type: boolean | number[]
initializeArtifacts 
1
public initializeArtifacts(artifacts: Artifacts): JobCollection

Sets gcix.Job.artifacts to all jobs within this JobCollection that haven't been set the artifacs before.

artifactsRequired
initializeCache 
1
public initializeCache(cache: Cache): JobCollection

Calling gcix.Job.assigneCache() to all jobs within this JobCollection that haven't been set the cache before.

cacheRequired
initializeDependencies 
1
public initializeDependencies(dependencies: Job | JobCollection | Need[]): JobCollection

Calling gcix.Job.assignDependencies() to all jobs within the first stage of this JobCollection that haven't been added dependencies before.

An empty parameter list means that jobs will get an empty dependency list and thus does not download artifacts by default.

dependenciesRequired
initializeImage 
1
public initializeImage(image: string | Image): JobCollection

Calling gcix.Job.assignImage() to all jobs within this JobCollection.

imageRequired
initializeNeeds 
1
public initializeNeeds(needs: Job | JobCollection | Need[]): JobCollection

Calling gcix.Job.assignNeeds() to all jobs within the first stage of this JobCollection that haven't been added needs before.

An empty parameter list means that jobs will get an empty dependency list and thus does not depend on other jobs by default.

needsRequired
initializeRules 
1
public initializeRules(rules: Rule[]): JobCollection

Calling gcix.Job.append_rules() to all jobs within this JobCollection that haven't been added rules before.

rulesRequired
initializeTags 
1
public initializeTags(tags: string[]): JobCollection

Calling gcix.Job.addTags([...]) to all jobs within this JobCollection that haven't been added tags before.

tagsRequired
  • Type: string[]
initializeVariables 
1
public initializeVariables(variables: {[ key: string ]: string}): JobCollection

Calling gcix.Job.addVariables({...}) to all jobs within this JobCollection that haven't been added variables before.

variablesRequired
  • Type: {[ key: string ]: string}
isEqual 
1
public isEqual(comparable: IBase): boolean

isEqual checks if this object is equal to given object.

comparableRequired
overrideAllowFailure 
1
public overrideAllowFailure(allowFailure: boolean | number[]): JobCollection

Calling gcix.Job.assignAllowFailure() to all jobs within this JobCollection overriding any previous set value.

allowFailureRequired
  • Type: boolean | number[]
overrideDependencies 
1
public overrideDependencies(dependencies: Job | JobCollection | Need[]): JobCollection

Calling gcix.Job.assignDependencies() to all jobs within the first stage of this JobCollection and overriding any previously added dependencies to that jobs.

An empty parameter list means that jobs will get an empty dependency list and thus does not download artifacts.

dependenciesRequired
overrideImage 
1
public overrideImage(image: string | Image): JobCollection

Calling gcix.Job.assignImage() to all jobs within this JobCollection overriding any previous set value.

imageRequired
overrideNeeds 
1
public overrideNeeds(needs: Job | JobCollection | Need[]): JobCollection

Calling gcix.Job.assignNeeds() to all jobs within the first stage of this JobCollection and overriding any previously added needs to that jobs.

An empty parameter list means that jobs will get an empty dependency list and thus does not depend on other jobs.

needsRequired
overrideRules 
1
public overrideRules(rules: Rule[]): JobCollection

Calling gcix.Job.overrideRules() to all jobs within this JobCollection and overriding any previously added rules to that jobs.

rulesRequired
overrideTags 
1
public overrideTags(tags: string[]): JobCollection

Calling gcix.Job.addTags([...]) to all jobs within this JobCollection and overriding any previously added tags to that jobs.

tagsRequired
  • Type: string[]
overrideVariables 
1
public overrideVariables(variables: {[ key: string ]: string}): JobCollection

Calling gcix.Job.addVariables({...}) to all jobs within this JobCollection and overriding any previously added variables to that jobs.

variablesRequired
  • Type: {[ key: string ]: string}
prependRules 
1
public prependRules(rules: Rule[]): JobCollection
rulesRequired
prependScripts 
1
public prependScripts(scripts: string[]): JobCollection
scriptsRequired
  • Type: string[]
render 
1
public render(): any

Returns a representation of any object which implements IBase.

The rendered representation is used by the gcix to dump it in YAML format as part of the .gitlab-ci.yml pipeline.

Properties

Name Type Description
lastJobsExecuted Job[] This property returns all Jobs from the last stage of this JobCollection.
nestedJobs Job[] No description.
populatedJobs Job[] Returns a list with populated copies of all nested jobs of this JobCollection.
children ChildDict[] No description.
orderedTags OrderedStringSet No description.
orderedTagsForInitialization OrderedStringSet No description.
orderedTagsForReplacement OrderedStringSet No description.
parents Job | JobCollection[] No description.
allowFailureForInitialization string | boolean | number[] No description.
allowFailureForReplacement string | boolean | number[] No description.
artifacts Artifacts No description.
artifactsForInitialization Artifacts No description.
artifactsForReplacement Artifacts No description.
cache Cache No description.
cacheForInitialization Cache No description.
dependencies Job | JobCollection | Need[] No description.
dependenciesForInitialization Job | JobCollection | Need[] No description.
dependenciesForReplacement Job | JobCollection | Need[] No description.
imageForInitialization string | Image No description.
imageForReplacement string | Image No description.
needs Job | JobCollection | Need[] No description.
needsForInitialization Job | JobCollection | Need[] No description.
needsForReplacement Job | JobCollection | Need[] No description.
rulesForInitialization Rule[] No description.
rulesForReplacement Rule[] No description.
rulesToAppend Rule[] No description.
rulesToPrepend Rule[] No description.
scriptsToAppend string[] No description.
scriptsToPrepend string[] No description.
variables {[ key: string ]: string} No description.
variablesForInitialization {[ key: string ]: string} No description.
variablesForReplacement {[ key: string ]: string} No description.
lastJobsExecutedRequired 
1
public readonly lastJobsExecuted: Job[];

This property returns all Jobs from the last stage of this JobCollection.

This is typically be requested from a job which has setup this JobCollection as need, to determine all actual jobs of this JobCollection as need.

nestedJobsRequired 
1
public readonly nestedJobs: Job[];
populatedJobsRequired 
1
public readonly populatedJobs: Job[];

Returns a list with populated copies of all nested jobs of this JobCollection.

Populated means, that all attributes of a Job which depends on its context are resolved to their final values. The context is primarily the JobCollection within the jobs resides but also dependencies to other jobs and JobCollection's. Thus this JobCollection will apply its own configuration, like variables to add, tags to set, etc., to all its jobs and JobCollection's.

Copies means what it says, that the returned job are not the same job objects, originally added to this JobCollection, but copies of them.

Nested means, that also jobs from JobCollection's within this JobCollection, are returned, as well as jobs from JobCollection's within JobCollection's within this JobCollection and so on.

childrenRequired 
1
public readonly children: ChildDict[];
orderedTagsRequired 
1
public readonly orderedTags: OrderedStringSet;
orderedTagsForInitializationRequired 
1
public readonly orderedTagsForInitialization: OrderedStringSet;
orderedTagsForReplacementRequired 
1
public readonly orderedTagsForReplacement: OrderedStringSet;
parentsRequired 
1
public readonly parents: Job | JobCollection[];
allowFailureForInitializationOptional 
1
public readonly allowFailureForInitialization: string | boolean | number[];
  • Type: string | boolean | number[]
allowFailureForReplacementOptional 
1
public readonly allowFailureForReplacement: string | boolean | number[];
  • Type: string | boolean | number[]
artifactsOptional 
1
public readonly artifacts: Artifacts;
artifactsForInitializationOptional 
1
public readonly artifactsForInitialization: Artifacts;
artifactsForReplacementOptional 
1
public readonly artifactsForReplacement: Artifacts;
cacheOptional 
1
public readonly cache: Cache;
cacheForInitializationOptional 
1
public readonly cacheForInitialization: Cache;
dependenciesOptional 
1
public readonly dependencies: Job | JobCollection | Need[];
dependenciesForInitializationOptional 
1
public readonly dependenciesForInitialization: Job | JobCollection | Need[];
dependenciesForReplacementOptional 
1
public readonly dependenciesForReplacement: Job | JobCollection | Need[];
imageForInitializationOptional 
1
public readonly imageForInitialization: string | Image;
imageForReplacementOptional 
1
public readonly imageForReplacement: string | Image;
needsOptional 
1
public readonly needs: Job | JobCollection | Need[];
needsForInitializationOptional 
1
public readonly needsForInitialization: Job | JobCollection | Need[];
needsForReplacementOptional 
1
public readonly needsForReplacement: Job | JobCollection | Need[];
rulesForInitializationOptional 
1
public readonly rulesForInitialization: Rule[];
rulesForReplacementOptional 
1
public readonly rulesForReplacement: Rule[];
rulesToAppendOptional 
1
public readonly rulesToAppend: Rule[];
rulesToPrependOptional 
1
public readonly rulesToPrepend: Rule[];
scriptsToAppendOptional 
1
public readonly scriptsToAppend: string[];
  • Type: string[]
scriptsToPrependOptional 
1
public readonly scriptsToPrepend: string[];
  • Type: string[]
variablesOptional 
1
public readonly variables: {[ key: string ]: string};
  • Type: {[ key: string ]: string}
variablesForInitializationOptional 
1
public readonly variablesForInitialization: {[ key: string ]: string};
  • Type: {[ key: string ]: string}
variablesForReplacementOptional 
1
public readonly variablesForReplacement: {[ key: string ]: string};
  • Type: {[ key: string ]: string}

Need

This class represents the Gitlab CI needs keyword. The needs key-word adds a possibility to allow out-of-order Gitlab CI jobs. A job which needed another job runs directly after the other job as finished successfully.

Initializers 

1
2
3
import { Need } from '@gcix/gcix'

new Need(props: NeedProps)
Name Type Description
props NeedProps No description.
propsRequired

Methods

Name Description
isEqual isEqual checks if this object is equal to given object.
render Returns a representation of any object which implements IBase.
isEqual 
1
public isEqual(comparable: IBase): boolean

isEqual checks if this object is equal to given object.

comparableRequired
render 
1
public render(): any

Returns a representation of any object which implements IBase.

The rendered representation is used by the gcix to dump it in YAML format as part of the .gitlab-ci.yml pipeline.

Properties

Name Type Description
artifacts boolean No description.
job string No description.
pipeline string No description.
project string No description.
ref string No description.
artifactsOptional 
1
public readonly artifacts: boolean;
  • Type: boolean
jobOptional 
1
public readonly job: string;
  • Type: string
pipelineOptional 
1
public readonly pipeline: string;
  • Type: string
projectOptional 
1
public readonly project: string;
  • Type: string
refOptional 
1
public readonly ref: string;
  • Type: string

OrderedStringSet

Represents an ordered set of strings.

Initializers 

1
2
3
import { OrderedStringSet } from '@gcix/gcix'

new OrderedStringSet(values?: string[])
Name Type Description
values string[] An optional array of values to initialize the set.
valuesOptional
  • Type: string[]

An optional array of values to initialize the set.

Methods

Name Description
add Adds a value or an array of values to the set.
clear Clears the set, removing all values.
delete Deletes a value from the set.
has Checks if the set contains a specific value.
add 
1
public add(value: string | string[]): void

Adds a value or an array of values to the set.

valueRequired
  • Type: string | string[]

The value(s) to add.

clear 
1
public clear(): void

Clears the set, removing all values.

delete 
1
public delete(value: string): void

Deletes a value from the set.

valueRequired
  • Type: string

The value to delete.

has 
1
public has(value: string): boolean

Checks if the set contains a specific value.

valueRequired
  • Type: string

The value to check.

Properties

Name Type Description
size number Returns the number of values in the set.
values string[] Returns an array of values in the set.
sizeRequired 
1
public readonly size: number;
  • Type: number

Returns the number of values in the set.

valuesRequired 
1
public readonly values: string[];
  • Type: string[]

Returns an array of values in the set.

PagesJob

This is a special kind of jobs which deploys Gitlab Pages.

This job has the static name pages and the static artifacts path ./public. Both preconfigurations can't be altered and are required for deploying Gitlab Pages properly. All methods which would typically alter the name, stage and artifacts of a job are overwritten with an empty implementation.

This job is only for deploying Gitlab Pages artifacts within the ./public artifacts path. To create the artifacts you have to run jobs, that generate those artifacts within the same ./public artifacts path, before this PagesJob in the pipeline.

Because the name of the job can't be altered, this job may only exist once in the generated pipeline output. Typically you should add the PagesJob to the gcix.Pipeline.

The PagesJob is also preconfigured with the stage pages and the image alpine:latest. To change the stage of this job, use the assignStage() method. Please mention to run this job in a stage after all jobs, that fill the public artifacts path with content.

Here a simple example how to use the GitlabPages job:

1
2
3
4
5
const pipeline = new Pipeline()
pipeline.addChildren({
    new Job({stage: "deploy", scripts: ["./create-html.sh"]).assingArtifacts(new Artifacts({paths: ["public"]})}),
    new PagesJob(),
})

Initializers 

1
2
3
import { PagesJob } from '@gcix/gcix'

new PagesJob()
Name Type Description

Methods

Name Description
addDependencies No description.
addNeeds No description.
addParent This method is called by gcix.JobCollections when the job is added to that JobCollection.
addTags No description.
addVariables No description.
appendRules No description.
appendScripts No description.
assignAllowFailure No description.
assignArtifacts No description.
assignCache No description.
assignDependencies No description.
assignImage Sets the image of this job.
assignNeeds No description.
assignTags No description.
copy Returns an independent, deep copy object of this job.
extendName This method is used by gcix.JobCollections to populate the jobs name.
extendStage This method is used by gcix.JobCollections to populate the jobs name and stage.
extendStageValue This method is used by gcix.JobCollections to populate the jobs stage.
getAllInstanceNames Return all instance names from the given child.
isEqual isEqual checks if this object is equal to given object.
prependRules No description.
prependScripts No description.
render Returns a representation of any object which implements IBase.
assignStage Set the name of this jobs stage to a value other than pages.
addDependencies 
1
public addDependencies(dependencies: Job | JobCollection | Need[]): Job
dependenciesRequired
addNeeds 
1
public addNeeds(needs: Job | JobCollection | Need[]): Job
needsRequired
addParent 
1
public addParent(parent: Job | JobCollection): void

This method is called by gcix.JobCollections when the job is added to that JobCollection.

The job needs to know its parents when getAllInstanceNames() is called.

parentRequired
addTags 
1
public addTags(tags: string[]): Job
tagsRequired
  • Type: string[]
addVariables 
1
public addVariables(variables: {[ key: string ]: string}): Job
variablesRequired
  • Type: {[ key: string ]: string}
appendRules 
1
public appendRules(rules: Rule[]): Job
rulesRequired
appendScripts 
1
public appendScripts(scripts: string[]): Job
scriptsRequired
  • Type: string[]
assignAllowFailure 
1
public assignAllowFailure(allowFailure: boolean | number[]): Job
allowFailureRequired
  • Type: boolean | number[]
assignArtifacts 
1
public assignArtifacts(artifacts: Artifacts): Job
artifactsRequired
assignCache 
1
public assignCache(cache: Cache): Job
cacheRequired
assignDependencies 
1
public assignDependencies(dependencies: Job | JobCollection | Need[]): Job
dependenciesRequired
assignImage 
1
public assignImage(image: string | Image): Job

Sets the image of this job.

For a simple container image you can provide the origin of the image. If you want to set the entrypoint, you have to provide an Image object instead.

!! Any previous values will be overwritten.

imageRequired
assignNeeds 
1
public assignNeeds(needs: Job | JobCollection | Need[]): Job
needsRequired
assignTags 
1
public assignTags(tags: string[]): Job
tagsRequired
  • Type: string[]
copy 
1
public copy(): Job

Returns an independent, deep copy object of this job.

extendName 
1
public extendName(name: string): void

This method is used by gcix.JobCollections to populate the jobs name.

nameRequired
  • Type: string
extendStage 
1
public extendStage(name: string): void

This method is used by gcix.JobCollections to populate the jobs name and stage.

nameRequired
  • Type: string
extendStageValue 
1
public extendStageValue(name: string): void

This method is used by gcix.JobCollections to populate the jobs stage.

nameRequired
  • Type: string
getAllInstanceNames 
1
public getAllInstanceNames(child?: Job | JobCollection): OrderedStringSet

Return all instance names from the given child.

That means all combinations of the childs name and stage within this sequence and all parent sequences.

childOptional
isEqual 
1
public isEqual(comparable: IBase): boolean

isEqual checks if this object is equal to given object.

comparableRequired
prependRules 
1
public prependRules(rules: Rule[]): Job
rulesRequired
prependScripts 
1
public prependScripts(scripts: string[]): Job
scriptsRequired
  • Type: string[]
render 
1
public render(): any

Returns a representation of any object which implements IBase.

The rendered representation is used by the gcix to dump it in YAML format as part of the .gitlab-ci.yml pipeline.

assignStage 
1
public assignStage(stage: string): PagesJob

Set the name of this jobs stage to a value other than pages.

stageRequired
  • Type: string

Properties

Name Type Description
tags string[] Getter method to receive added tags.
allowFailure string | boolean | number[] No description.
name string No description.
orderedTags OrderedStringSet No description.
parents Job | JobCollection[] No description.
scripts string[] No description.
stage string No description.
artifacts Artifacts No description.
cache Cache No description.
dependencies Job | JobCollection | Need[] No description.
image Image No description.
needs Job | JobCollection | Need[] No description.
original Job No description.
rules Rule[] No description.
variables {[ key: string ]: string} No description.
tagsRequired 
1
public readonly tags: string[];
  • Type: string[]

Getter method to receive added tags.

allowFailureRequired 
1
public readonly allowFailure: string | boolean | number[];
  • Type: string | boolean | number[]
nameRequired 
1
public readonly name: string;
  • Type: string
orderedTagsRequired 
1
public readonly orderedTags: OrderedStringSet;
parentsRequired 
1
public readonly parents: Job | JobCollection[];
scriptsRequired 
1
public readonly scripts: string[];
  • Type: string[]
stageRequired 
1
public readonly stage: string;
  • Type: string
artifactsOptional 
1
public readonly artifacts: Artifacts;
cacheOptional 
1
public readonly cache: Cache;
dependenciesOptional 
1
public readonly dependencies: Job | JobCollection | Need[];
imageOptional 
1
public readonly image: Image;
needsOptional 
1
public readonly needs: Job | JobCollection | Need[];
originalOptional 
1
public readonly original: Job;
rulesOptional 
1
public readonly rules: Rule[];
variablesOptional 
1
public readonly variables: {[ key: string ]: string};
  • Type: {[ key: string ]: string}

Pipeline

Initializers 

1
2
3
import { Pipeline } from '@gcix/gcix'

new Pipeline(props?: PipelineProps)
Name Type Description
props PipelineProps No description.
propsOptional

Methods

Name Description
addChildren Add gcix.Jobs or other gcix.JobCollections to this JobCollection.
addDependencies No description.
addNeeds No description.
addParent No description.
addTags No description.
addVariables No description.
appendRules No description.
appendScripts No description.
assignArtifacts No description.
assignCache No description.
getAllInstanceNames Return all instance names from the given child.
initializeAllowFailure Calling gcix.Job.assignAllowFailure() to all jobs within this JobCollection that haven't been set the allowFailure before.
initializeArtifacts Sets gcix.Job.artifacts to all jobs within this JobCollection that haven't been set the artifacs before.
initializeCache Calling gcix.Job.assigneCache() to all jobs within this JobCollection that haven't been set the cache before.
initializeDependencies Calling gcix.Job.assignDependencies() to all jobs within the first stage of this JobCollection that haven't been added dependencies before.
initializeImage Calling gcix.Job.assignImage() to all jobs within this JobCollection.
initializeNeeds Calling gcix.Job.assignNeeds() to all jobs within the first stage of this JobCollection that haven't been added needs before.
initializeRules Calling gcix.Job.append_rules() to all jobs within this JobCollection that haven't been added rules before.
initializeTags Calling gcix.Job.addTags([...]) to all jobs within this JobCollection that haven't been added tags before.
initializeVariables Calling gcix.Job.addVariables({...}) to all jobs within this JobCollection that haven't been added variables before.
isEqual isEqual checks if this object is equal to given object.
overrideAllowFailure Calling gcix.Job.assignAllowFailure() to all jobs within this JobCollection overriding any previous set value.
overrideDependencies Calling gcix.Job.assignDependencies() to all jobs within the first stage of this JobCollection and overriding any previously added dependencies to that jobs.
overrideImage Calling gcix.Job.assignImage() to all jobs within this JobCollection overriding any previous set value.
overrideNeeds Calling gcix.Job.assignNeeds() to all jobs within the first stage of this JobCollection and overriding any previously added needs to that jobs.
overrideRules Calling gcix.Job.overrideRules() to all jobs within this JobCollection and overriding any previously added rules to that jobs.
overrideTags Calling gcix.Job.addTags([...]) to all jobs within this JobCollection and overriding any previously added tags to that jobs.
overrideVariables Calling gcix.Job.addVariables({...}) to all jobs within this JobCollection and overriding any previously added variables to that jobs.
prependRules No description.
prependScripts No description.
render Returns a representation of any object which implements IBase.
addInclude Let you add global gcix.Includes to the pipeline. Gitlab CI Documentation: "Use include to include external YAML files in your CI/CD configuration.".
addServices Add one or more gcix.Services to the pipeline.
writeYaml Create the Gitlab CI YAML file from this pipeline object.
addChildren 
1
public addChildren(props: AddChildrenProps): JobCollection

Add gcix.Jobs or other gcix.JobCollections to this JobCollection.

Adding a child creates a copy of that child. You should provide a name or stage when adding children, to make them different from other places where they will be used.

propsRequired
addDependencies 
1
public addDependencies(dependencies: Job | JobCollection | Need[]): JobCollection
dependenciesRequired
addNeeds 
1
public addNeeds(needs: Job | JobCollection | Need[]): JobCollection
needsRequired
addParent 
1
public addParent(parent: JobCollection): void
parentRequired
addTags 
1
public addTags(tags: string[]): JobCollection
tagsRequired
  • Type: string[]
addVariables 
1
public addVariables(variables: {[ key: string ]: string}): JobCollection
variablesRequired
  • Type: {[ key: string ]: string}
appendRules 
1
public appendRules(rules: Rule[]): JobCollection
rulesRequired
appendScripts 
1
public appendScripts(scripts: string[]): JobCollection
scriptsRequired
  • Type: string[]
assignArtifacts 
1
public assignArtifacts(artifacts: Artifacts): JobCollection
artifactsRequired
assignCache 
1
public assignCache(cache: Cache): JobCollection
cacheRequired
getAllInstanceNames 
1
public getAllInstanceNames(child?: Job | JobCollection): OrderedStringSet

Return all instance names from the given child.

That means all combinations of the childs name and stage within this JobCollection and all parent JobCollection's.

childOptional
initializeAllowFailure 
1
public initializeAllowFailure(allowFailure: boolean | number[]): JobCollection

Calling gcix.Job.assignAllowFailure() to all jobs within this JobCollection that haven't been set the allowFailure before.

allowFailureRequired
  • Type: boolean | number[]
initializeArtifacts 
1
public initializeArtifacts(artifacts: Artifacts): JobCollection

Sets gcix.Job.artifacts to all jobs within this JobCollection that haven't been set the artifacs before.

artifactsRequired
initializeCache 
1
public initializeCache(cache: Cache): JobCollection

Calling gcix.Job.assigneCache() to all jobs within this JobCollection that haven't been set the cache before.

cacheRequired
initializeDependencies 
1
public initializeDependencies(dependencies: Job | JobCollection | Need[]): JobCollection

Calling gcix.Job.assignDependencies() to all jobs within the first stage of this JobCollection that haven't been added dependencies before.

An empty parameter list means that jobs will get an empty dependency list and thus does not download artifacts by default.

dependenciesRequired
initializeImage 
1
public initializeImage(image: string | Image): JobCollection

Calling gcix.Job.assignImage() to all jobs within this JobCollection.

imageRequired
initializeNeeds 
1
public initializeNeeds(needs: Job | JobCollection | Need[]): JobCollection

Calling gcix.Job.assignNeeds() to all jobs within the first stage of this JobCollection that haven't been added needs before.

An empty parameter list means that jobs will get an empty dependency list and thus does not depend on other jobs by default.

needsRequired
initializeRules 
1
public initializeRules(rules: Rule[]): JobCollection

Calling gcix.Job.append_rules() to all jobs within this JobCollection that haven't been added rules before.

rulesRequired
initializeTags 
1
public initializeTags(tags: string[]): JobCollection

Calling gcix.Job.addTags([...]) to all jobs within this JobCollection that haven't been added tags before.

tagsRequired
  • Type: string[]
initializeVariables 
1
public initializeVariables(variables: {[ key: string ]: string}): JobCollection

Calling gcix.Job.addVariables({...}) to all jobs within this JobCollection that haven't been added variables before.

variablesRequired
  • Type: {[ key: string ]: string}
isEqual 
1
public isEqual(comparable: IBase): boolean

isEqual checks if this object is equal to given object.

comparableRequired
overrideAllowFailure 
1
public overrideAllowFailure(allowFailure: boolean | number[]): JobCollection

Calling gcix.Job.assignAllowFailure() to all jobs within this JobCollection overriding any previous set value.

allowFailureRequired
  • Type: boolean | number[]
overrideDependencies 
1
public overrideDependencies(dependencies: Job | JobCollection | Need[]): JobCollection

Calling gcix.Job.assignDependencies() to all jobs within the first stage of this JobCollection and overriding any previously added dependencies to that jobs.

An empty parameter list means that jobs will get an empty dependency list and thus does not download artifacts.

dependenciesRequired
overrideImage 
1
public overrideImage(image: string | Image): JobCollection

Calling gcix.Job.assignImage() to all jobs within this JobCollection overriding any previous set value.

imageRequired
overrideNeeds 
1
public overrideNeeds(needs: Job | JobCollection | Need[]): JobCollection

Calling gcix.Job.assignNeeds() to all jobs within the first stage of this JobCollection and overriding any previously added needs to that jobs.

An empty parameter list means that jobs will get an empty dependency list and thus does not depend on other jobs.

needsRequired
overrideRules 
1
public overrideRules(rules: Rule[]): JobCollection

Calling gcix.Job.overrideRules() to all jobs within this JobCollection and overriding any previously added rules to that jobs.

rulesRequired
overrideTags 
1
public overrideTags(tags: string[]): JobCollection

Calling gcix.Job.addTags([...]) to all jobs within this JobCollection and overriding any previously added tags to that jobs.

tagsRequired
  • Type: string[]
overrideVariables 
1
public overrideVariables(variables: {[ key: string ]: string}): JobCollection

Calling gcix.Job.addVariables({...}) to all jobs within this JobCollection and overriding any previously added variables to that jobs.

variablesRequired
  • Type: {[ key: string ]: string}
prependRules 
1
public prependRules(rules: Rule[]): JobCollection
rulesRequired
prependScripts 
1
public prependScripts(scripts: string[]): JobCollection
scriptsRequired
  • Type: string[]
render 
1
public render(): any

Returns a representation of any object which implements IBase.

The rendered representation is used by the gcix to dump it in YAML format as part of the .gitlab-ci.yml pipeline.

addInclude 
1
public addInclude(include: Include): Pipeline

Let you add global gcix.Includes to the pipeline. Gitlab CI Documentation: "Use include to include external YAML files in your CI/CD configuration.".

includeRequired
addServices 
1
public addServices(services: Service[]): Pipeline

Add one or more gcix.Services to the pipeline.

Gitlab CI Documentation: "The services keyword defines a Docker image that runs during a job linked to the Docker image that the image keyword defines."

servicesRequired
writeYaml 
1
public writeYaml(filename?: string): void

Create the Gitlab CI YAML file from this pipeline object.

Use that YAML file to trigger a child pipeline.

filenameOptional
  • Type: string

Properties

Name Type Description
lastJobsExecuted Job[] This property returns all Jobs from the last stage of this JobCollection.
nestedJobs Job[] No description.
populatedJobs Job[] Returns a list with populated copies of all nested jobs of this JobCollection.
children ChildDict[] No description.
orderedTags OrderedStringSet No description.
orderedTagsForInitialization OrderedStringSet No description.
orderedTagsForReplacement OrderedStringSet No description.
parents Job | JobCollection[] No description.
allowFailureForInitialization string | boolean | number[] No description.
allowFailureForReplacement string | boolean | number[] No description.
artifacts Artifacts No description.
artifactsForInitialization Artifacts No description.
artifactsForReplacement Artifacts No description.
cache Cache No description.
cacheForInitialization Cache No description.
dependencies Job | JobCollection | Need[] No description.
dependenciesForInitialization Job | JobCollection | Need[] No description.
dependenciesForReplacement Job | JobCollection | Need[] No description.
imageForInitialization string | Image No description.
imageForReplacement string | Image No description.
needs Job | JobCollection | Need[] No description.
needsForInitialization Job | JobCollection | Need[] No description.
needsForReplacement Job | JobCollection | Need[] No description.
rulesForInitialization Rule[] No description.
rulesForReplacement Rule[] No description.
rulesToAppend Rule[] No description.
rulesToPrepend Rule[] No description.
scriptsToAppend string[] No description.
scriptsToPrepend string[] No description.
variables {[ key: string ]: string} No description.
variablesForInitialization {[ key: string ]: string} No description.
variablesForReplacement {[ key: string ]: string} No description.
includes Include[] No description.
service Service[] No description.
lastJobsExecutedRequired 
1
public readonly lastJobsExecuted: Job[];

This property returns all Jobs from the last stage of this JobCollection.

This is typically be requested from a job which has setup this JobCollection as need, to determine all actual jobs of this JobCollection as need.

nestedJobsRequired 
1
public readonly nestedJobs: Job[];
populatedJobsRequired 
1
public readonly populatedJobs: Job[];

Returns a list with populated copies of all nested jobs of this JobCollection.

Populated means, that all attributes of a Job which depends on its context are resolved to their final values. The context is primarily the JobCollection within the jobs resides but also dependencies to other jobs and JobCollection's. Thus this JobCollection will apply its own configuration, like variables to add, tags to set, etc., to all its jobs and JobCollection's.

Copies means what it says, that the returned job are not the same job objects, originally added to this JobCollection, but copies of them.

Nested means, that also jobs from JobCollection's within this JobCollection, are returned, as well as jobs from JobCollection's within JobCollection's within this JobCollection and so on.

childrenRequired 
1
public readonly children: ChildDict[];
orderedTagsRequired 
1
public readonly orderedTags: OrderedStringSet;
orderedTagsForInitializationRequired 
1
public readonly orderedTagsForInitialization: OrderedStringSet;
orderedTagsForReplacementRequired 
1
public readonly orderedTagsForReplacement: OrderedStringSet;
parentsRequired 
1
public readonly parents: Job | JobCollection[];
allowFailureForInitializationOptional 
1
public readonly allowFailureForInitialization: string | boolean | number[];
  • Type: string | boolean | number[]
allowFailureForReplacementOptional 
1
public readonly allowFailureForReplacement: string | boolean | number[];
  • Type: string | boolean | number[]
artifactsOptional 
1
public readonly artifacts: Artifacts;
artifactsForInitializationOptional 
1
public readonly artifactsForInitialization: Artifacts;
artifactsForReplacementOptional 
1
public readonly artifactsForReplacement: Artifacts;
cacheOptional 
1
public readonly cache: Cache;
cacheForInitializationOptional 
1
public readonly cacheForInitialization: Cache;
dependenciesOptional 
1
public readonly dependencies: Job | JobCollection | Need[];
dependenciesForInitializationOptional 
1
public readonly dependenciesForInitialization: Job | JobCollection | Need[];
dependenciesForReplacementOptional 
1
public readonly dependenciesForReplacement: Job | JobCollection | Need[];
imageForInitializationOptional 
1
public readonly imageForInitialization: string | Image;
imageForReplacementOptional 
1
public readonly imageForReplacement: string | Image;
needsOptional 
1
public readonly needs: Job | JobCollection | Need[];
needsForInitializationOptional 
1
public readonly needsForInitialization: Job | JobCollection | Need[];
needsForReplacementOptional 
1
public readonly needsForReplacement: Job | JobCollection | Need[];
rulesForInitializationOptional 
1
public readonly rulesForInitialization: Rule[];
rulesForReplacementOptional 
1
public readonly rulesForReplacement: Rule[];
rulesToAppendOptional 
1
public readonly rulesToAppend: Rule[];
rulesToPrependOptional 
1
public readonly rulesToPrepend: Rule[];
scriptsToAppendOptional 
1
public readonly scriptsToAppend: string[];
  • Type: string[]
scriptsToPrependOptional 
1
public readonly scriptsToPrepend: string[];
  • Type: string[]
variablesOptional 
1
public readonly variables: {[ key: string ]: string};
  • Type: {[ key: string ]: string}
variablesForInitializationOptional 
1
public readonly variablesForInitialization: {[ key: string ]: string};
  • Type: {[ key: string ]: string}
variablesForReplacementOptional 
1
public readonly variablesForReplacement: {[ key: string ]: string};
  • Type: {[ key: string ]: string}
includesRequired 
1
public readonly includes: Include[];
serviceRequired 
1
public readonly service: Service[];

PredefinedVariables

This class contains constants for Gitlab CI predefined variables.

Initializers 

1
2
3
import { PredefinedVariables } from '@gcix/gcix'

new PredefinedVariables()
Name Type Description

Properties

Name Type Description
chatChannel string Source chat channel which triggered the ChatOps command.
chatInput string Additional arguments passed in the ChatOps command.
ci string Mark that job is executed in CI environment.
ciApiV4Url string The GitLab API v4 root URL.
ciBuildsDir string Top-level directory where builds are executed.
ciCommitBeforeSha string The previous latest commit present on a branch. Is always 0000000000000000000000000000000000000000 in pipelines for merge requests.
ciCommitDescription string The description of the commit the message without first line, if the title is shorter than 100 characters;
ciCommitMessage string The full commit message.
ciCommitRefName string The branch or tag name for which project is built.
ciCommitRefProtected string true if the job is running on a protected reference, false if not.
ciCommitRefSlug string $CI_COMMIT_REF_NAME in lowercase, shortened to 63 bytes, and with everything except 0-9 and a-z replaced with -.
ciCommitSha string The commit revision for which project is built.
ciCommitShortSha string The first eight characters of CI_COMMIT_SHA.
ciCommitTimestamp string The timestamp of the commit in the ISO 8601 format.
ciCommitTitle string The title of the commit - the full first line of the message.
ciConcurrentId string Unique ID of build execution in a single executor.
ciConcurrentProjectId string Unique ID of build execution in a single executor and project.
ciConfigPath string The path to CI configuration file. Defaults to .gitlab-ci.yml.
ciDebugTrace string Whether debug logging (tracing) is enabled.
ciDefaultBranch string The name of the default branch for the project.
ciDependencyProxyGroupImagePrefix string The image prefix for pulling images through the Dependency Proxy.
ciDependencyProxyPassword string The password to use to pull images through the Dependency Proxy.
ciDependencyProxyServer string The server for logging in to the Dependency Proxy. This is equivalent to $CI_SERVER_HOST:$CI_SERVER_PORT.
ciDependencyProxyUser string The username to use to pull images through the Dependency Proxy.
ciDeployPassword string Authentication password of the GitLab Deploy Token, only present if the Project has one related.
ciDeployUser string Authentication username of the GitLab Deploy Token, only present if the Project has one related.
ciJobId string The unique ID of the current job that GitLab CI/CD uses internally.
ciJobImage string The name of the image running the CI job.
ciJobJwt string RS256 JSON web token that can be used for authenticating with third party systems that support JWT authentication, for example HashiCorp’s Vault.
ciJobManual string The flag to indicate that job was manually started.
ciJobName string The name of the job as defined in .gitlab-ci.yml.
ciJobStage string The name of the stage as defined in .gitlab-ci.yml.
ciJobStatus string The state of the job as each runner stage is executed.
ciJobToken string Token used for authenticating with a few API endpoints and downloading dependent repositories.
ciJobUrl string Job details URL.
ciMergeRequestTargetBranchName string The target branch name of the merge request if the pipelines are for merge requests.
ciMergeRequestTargetBranchSha string The HEAD SHA of the target branch of the merge request if the pipelines are for merge requests.
ciNodeTotal string Total number of instances of this job running in parallel.
ciPagesDomain string The configured domain that hosts GitLab Pages.
ciPagesUrl string URL to GitLab Pages-built pages. Always belongs to a subdomain of CI_PAGES_DOMAIN.
ciPipelineId string The instance-level ID of the current pipeline. This is a unique ID across all projects on GitLab.
ciPipelineIid string The project-level IID (internal ID) of the current pipeline. This ID is unique for the current project.
ciPipelineSource string Indicates how the pipeline was triggered.
ciPipelineTriggered string The flag to indicate that job was triggered.
ciPipelineUrl string Pipeline details URL.
ciProjectConfigPath string The CI configuration path for the project.
ciProjectDir string The full path where the repository is cloned and where the job is run.
ciProjectId string The unique ID of the current project that GitLab CI/CD uses internally.
ciProjectName string The name of the directory for the project that is being built.
ciProjectNamespace string The project stage (username or group name) that is being built.
ciProjectPath string The stage with project name.
ciProjectPathSlug string $CI_PROJECT_PATH in lowercase and with everything except 0-9 and a-z replaced with -. Use in URLs and domain names.
ciProjectRepositoryLanguages string Comma-separated, lowercase list of the languages used in the repository (for example ruby,javascript,html,css).
ciProjectRootNamespace string The root project stage (username or group name) that is being built.
ciProjectTitle string The human-readable project name as displayed in the GitLab web interface.
ciProjectUrl string The HTTP(S) address to access project.
ciProjectVisibility string The project visibility (internal, private, public).
ciRegistryPassword string The password to use to push containers to the GitLab Container Registry, for the current project.
ciRepositoryUrl string The URL to clone the Git repository.
ciRunnerDescription string The description of the runner as saved in GitLab.
ciRunnerExecutableArch string The OS/architecture of the GitLab Runner executable (note that this is not necessarily the same as the environment of the executor).
ciRunnerId string The unique ID of runner being used.
ciRunnerRevision string GitLab Runner revision that is executing the current job.
ciRunnerShortToken string First eight characters of the runner’s token used to authenticate new job requests. Used as the runner’s unique ID.
ciRunnerTags string The defined runner tags.
ciRunnerVersion string GitLab Runner version that is executing the current job.
ciServer string Mark that job is executed in CI environment.
ciServerHost string Host component of the GitLab instance URL, without protocol and port (like gitlab.example.com).
ciServerName string The name of CI server that is used to coordinate jobs.
ciServerPort string Port component of the GitLab instance URL, without host and protocol (like 3000).
ciServerProtocol string Protocol component of the GitLab instance URL, without host and port (like https).
ciServerRevision string GitLab revision that is used to schedule jobs.
ciServerUrl string The base URL of the GitLab instance, including protocol and port (like https://gitlab.example.com:8080).
ciServerVersion string GitLab version that is used to schedule jobs.
ciServerVersionMajor string GitLab version major component.
ciServerVersionMinor string GitLab version minor component.
ciServerVersionPatch string GitLab version patch component.
gitlabCi string Mark that job is executed in GitLab CI/CD environment.
gitlabFeatures string The comma separated list of licensed features available for your instance and plan.
gitlabUserEmail string The email of the user who started the job.
gitlabUserId string The ID of the user who started the job.
gitlabUserLogin string The login username of the user who started the job.
gitlabUserName string The real name of the user who started the job.
ciCommitBranch string The commit branch name.
ciCommitTag string The commit tag name. Present only when building tags.
ciDeployFreeze string Included with the value true if the pipeline runs during a deploy freeze window.
ciDisposableEnvironment string Marks that the job is executed in a disposable environment (something that is created only for this job and disposed of/destroyed after the execution - all executors except shell and ssh).
ciEnvironmentName string The name of the environment for this job. Only present if environment:name is set.
ciEnvironmentSlug string A simplified version of the environment name, suitable for inclusion in DNS, URLs, Kubernetes labels, and so on.
ciEnvironmentUrl string The URL of the environment for this job. Only present if environment:url is set.
ciExternalPullRequestIid string Pull Request ID from GitHub if the pipelines are for external pull requests.
ciExternalPullRequestSourceBranchName string The source branch name of the pull request if the pipelines are for external pull requests.
ciExternalPullRequestSourceBranchSha string The HEAD SHA of the source branch of the pull request if the pipelines are for external pull requests.
ciExternalPullRequestSourceRepository string The source repository name of the pull request if the pipelines are for external pull requests.
ciExternalPullRequestTargetBranchName string The target branch name of the pull request if the pipelines are for external pull requests.
ciExternalPullRequestTargetBranchSha string The HEAD SHA of the target branch of the pull request if the pipelines are for external pull requests.
ciExternalPullRequestTargetRepository string The target repository name of the pull request if the pipelines are for external pull requests.
ciHasOpenRequirements string Included with the value true only if the pipeline’s project has any open requirements.
ciKubernetesActive string Included with the value true only if the pipeline has a Kubernetes cluster available for deployments.
ciMergeRequestAssignees string Comma-separated list of username(s) of assignee(s) for the merge request if the pipelines are for merge requests.
ciMergeRequestDiffBaseSha string The base SHA of the merge request diff, if the pipelines are for merge requests.
ciMergeRequestDiffId string The version of the merge request diff, if the pipelines are for merge requests.
ciMergeRequestEventType string The event type of the merge request, if the pipelines are for merge requests. Can be detached, merged_result or merge_train.
ciMergeRequestId string The instance-level ID of the merge request.
ciMergeRequestIid string The project-level IID (internal ID) of the merge request.
ciMergeRequestLabels string Comma-separated label names of the merge request if the pipelines are for merge requests.
ciMergeRequestMilestone string The milestone title of the merge request if the pipelines are for merge requests.
ciMergeRequestProjectId string The ID of the project of the merge request if the pipelines are for merge requests.
ciMergeRequestProjectPath string The path of the project of the merge request if the pipelines are for merge requests (for example stage/awesome-project).
ciMergeRequestProjectUrl string The URL of the project of the merge request if the pipelines are for merge requests (for example http://192.168.10.15:3000/stage/awesome-project). Available only if only [merge_requests] or rules syntax is used and the merge request is created. * Added in GitLab 11.6 Available in GitLab Runner all.
ciMergeRequestRefPath string The ref path of the merge request if the pipelines are for merge requests.
ciMergeRequestSourceBranchName string The source branch name of the merge request if the pipelines are for merge requests.
ciMergeRequestSourceBranchSha string The HEAD SHA of the source branch of the merge request if the pipelines are for merge requests.
ciMergeRequestSourceProjectId string The ID of the source project of the merge request if the pipelines are for merge requests.
ciMergeRequestSourceProjectPath string The path of the source project of the merge request if the pipelines are for merge requests.
ciMergeRequestSourceProjectUrl string The URL of the source project of the merge request if the pipelines are for merge requests.
ciMergeRequestTitle string The title of the merge request if the pipelines are for merge requests.
ciNodeIndex string Index of the job in the job set. If the job is not parallelized, this variable is not set.
ciOpenMergeRequests string Available in branch and merge request pipelines.
ciRegistry string GitLab Container Registry. This variable includes a :port value if one has been specified in the registry configuration.
ciRegistryImage string the address of the registry tied to the specific project.
ciRegistryUser string The username to use to push containers to the GitLab Container Registry, for the current project.
ciSharedEnvironment string Marks that the job is executed in a shared environment (something that is persisted across CI invocations like shell or ssh executor).
triggerPayload string This variable is available when a pipeline is triggered with a webhook.
chatChannelRequired 
1
public readonly chatChannel: string;
  • Type: string

Source chat channel which triggered the ChatOps command.

Added in GitLab 10.6 Available in GitLab Runner all

chatInputRequired 
1
public readonly chatInput: string;
  • Type: string

Additional arguments passed in the ChatOps command.

Added in GitLab 10.6 Available in GitLab Runner all

ciRequired 
1
public readonly ci: string;
  • Type: string

Mark that job is executed in CI environment.

Added in GitLab all Available in GitLab Runner 0.4

ciApiV4UrlRequired 
1
public readonly ciApiV4Url: string;
  • Type: string

The GitLab API v4 root URL.

Added in GitLab 11.7 Available in GitLab Runner all

ciBuildsDirRequired 
1
public readonly ciBuildsDir: string;
  • Type: string

Top-level directory where builds are executed.

Added in GitLab all Available in GitLab Runner 11.10

ciCommitBeforeShaRequired 
1
public readonly ciCommitBeforeSha: string;
  • Type: string

The previous latest commit present on a branch. Is always 0000000000000000000000000000000000000000 in pipelines for merge requests.

Added in GitLab 11.2 Available in GitLab Runner all

ciCommitDescriptionRequired 
1
public readonly ciCommitDescription: string;
  • Type: string

The description of the commit the message without first line, if the title is shorter than 100 characters;

full message in other case.

Added in GitLab 10.8 Available in GitLab Runner all

ciCommitMessageRequired 
1
public readonly ciCommitMessage: string;
  • Type: string

The full commit message.

Added in GitLab 10.8 Available in GitLab Runner all

ciCommitRefNameRequired 
1
public readonly ciCommitRefName: string;
  • Type: string

The branch or tag name for which project is built.

Added in GitLab 9.0 Available in GitLab Runner all

ciCommitRefProtectedRequired 
1
public readonly ciCommitRefProtected: string;
  • Type: string

true if the job is running on a protected reference, false if not.

Added in GitLab 11.11 Available in GitLab Runner all

ciCommitRefSlugRequired 
1
public readonly ciCommitRefSlug: string;
  • Type: string

$CI_COMMIT_REF_NAME in lowercase, shortened to 63 bytes, and with everything except 0-9 and a-z replaced with -.

No leading / trailing -. Use in URLs, host names and domain names.

Added in GitLab 9.0 Available in GitLab Runner all

ciCommitShaRequired 
1
public readonly ciCommitSha: string;
  • Type: string

The commit revision for which project is built.

Added in GitLab 9.0 Available in GitLab Runner all

ciCommitShortShaRequired 
1
public readonly ciCommitShortSha: string;
  • Type: string

The first eight characters of CI_COMMIT_SHA.

Added in GitLab 11.7 Available in GitLab Runner all

ciCommitTimestampRequired 
1
public readonly ciCommitTimestamp: string;
  • Type: string

The timestamp of the commit in the ISO 8601 format.

Added in GitLab 13.4 Available in GitLab Runner all

ciCommitTitleRequired 
1
public readonly ciCommitTitle: string;
  • Type: string

The title of the commit - the full first line of the message.

Added in GitLab 10.8 Available in GitLab Runner all

ciConcurrentIdRequired 
1
public readonly ciConcurrentId: string;
  • Type: string

Unique ID of build execution in a single executor.

Added in GitLab all Available in GitLab Runner 11.10

ciConcurrentProjectIdRequired 
1
public readonly ciConcurrentProjectId: string;
  • Type: string

Unique ID of build execution in a single executor and project.

Added in GitLab all Available in GitLab Runner 11.10

ciConfigPathRequired 
1
public readonly ciConfigPath: string;
  • Type: string

The path to CI configuration file. Defaults to .gitlab-ci.yml.

Added in GitLab 9.4 Available in GitLab Runner 0.5

ciDebugTraceRequired 
1
public readonly ciDebugTrace: string;
  • Type: string

Whether debug logging (tracing) is enabled.

Added in GitLab all Available in GitLab Runner 1.7

ciDefaultBranchRequired 
1
public readonly ciDefaultBranch: string;
  • Type: string

The name of the default branch for the project.

Added in GitLab 12.4 Available in GitLab Runner all

ciDependencyProxyGroupImagePrefixRequired 
1
public readonly ciDependencyProxyGroupImagePrefix: string;
  • Type: string

The image prefix for pulling images through the Dependency Proxy.

Added in GitLab 13.7 Available in GitLab Runner all

ciDependencyProxyPasswordRequired 
1
public readonly ciDependencyProxyPassword: string;
  • Type: string

The password to use to pull images through the Dependency Proxy.

ATTENTION: Contrary to most other variables in this class, this variable is not resolved at rendering time. Instead the variable string is returned, which is then resolved during pipeline execution. This is because the value contains sensitive information.

Added in GitLab 13.7 Available in GitLab Runner all

ciDependencyProxyServerRequired 
1
public readonly ciDependencyProxyServer: string;
  • Type: string

The server for logging in to the Dependency Proxy. This is equivalent to $CI_SERVER_HOST:$CI_SERVER_PORT.

Added in GitLab 13.7 Available in GitLab Runner all

ciDependencyProxyUserRequired 
1
public readonly ciDependencyProxyUser: string;
  • Type: string

The username to use to pull images through the Dependency Proxy.

Added in GitLab 13.7 Available in GitLab Runner all

ciDeployPasswordRequired 
1
public readonly ciDeployPassword: string;
  • Type: string

Authentication password of the GitLab Deploy Token, only present if the Project has one related.

ATTENTION: Contrary to most other variables in this class, this variable is not resolved at rendering time. Instead the variable string is returned, which is then resolved during pipeline execution. This is because the value contains sensitive information.

Added in GitLab 10.8 Available in GitLab Runner all

ciDeployUserRequired 
1
public readonly ciDeployUser: string;
  • Type: string

Authentication username of the GitLab Deploy Token, only present if the Project has one related.

Added in GitLab 10.8 Available in GitLab Runner all

ciJobIdRequired 
1
public readonly ciJobId: string;
  • Type: string

The unique ID of the current job that GitLab CI/CD uses internally.

Added in GitLab 9.0 Available in GitLab Runner all

ciJobImageRequired 
1
public readonly ciJobImage: string;
  • Type: string

The name of the image running the CI job.

Added in GitLab 12.9 Available in GitLab Runner 12.9

ciJobJwtRequired 
1
public readonly ciJobJwt: string;
  • Type: string

RS256 JSON web token that can be used for authenticating with third party systems that support JWT authentication, for example HashiCorp’s Vault.

ATTENTION: Contrary to most other variables in this class, this variable is not resolved at rendering time. Instead the variable string is returned, which is then resolved during pipeline execution. This is because the value contains sensitive information.

Added in GitLab 12.10 Available in GitLab Runner all

ciJobManualRequired 
1
public readonly ciJobManual: string;
  • Type: string

The flag to indicate that job was manually started.

Added in GitLab 8.12 Available in GitLab Runner all

ciJobNameRequired 
1
public readonly ciJobName: string;
  • Type: string

The name of the job as defined in .gitlab-ci.yml.

Added in GitLab 9.0 Available in GitLab Runner 0.5

ciJobStageRequired 
1
public readonly ciJobStage: string;
  • Type: string

The name of the stage as defined in .gitlab-ci.yml.

Added in GitLab 9.0 Available in GitLab Runner 0.5

ciJobStatusRequired 
1
public readonly ciJobStatus: string;
  • Type: string

The state of the job as each runner stage is executed.

Use with after_script where CI_JOB_STATUS can be either success, failed or canceled.

Added in GitLab all Available in GitLab Runner 13.5

ciJobTokenRequired 
1
public readonly ciJobToken: string;
  • Type: string

Token used for authenticating with a few API endpoints and downloading dependent repositories.

The token is valid as long as the job is running.

ATTENTION: Contrary to most other variables in this class, this variable is not resolved at rendering time. Instead the variable string is returned, which is then resolved during pipeline execution. This is because the value contains sensitive information.

Added in GitLab 9.0 Available in GitLab Runner 1.2

ciJobUrlRequired 
1
public readonly ciJobUrl: string;
  • Type: string

Job details URL.

Added in GitLab 11.1 Available in GitLab Runner 0.5

ciMergeRequestTargetBranchNameRequired 
1
public readonly ciMergeRequestTargetBranchName: string;
  • Type: string

The target branch name of the merge request if the pipelines are for merge requests.

Available only if only [merge_requests] or rules syntax is used and the merge request is created.

Added in GitLab 11.6 Available in GitLab Runner all

ciMergeRequestTargetBranchShaRequired 
1
public readonly ciMergeRequestTargetBranchSha: string;
  • Type: string

The HEAD SHA of the target branch of the merge request if the pipelines are for merge requests.

Available only if only [merge_requests] or rules syntax is used, the merge request is created, and the pipeline is a merged result pipeline.

Added in GitLab 11.9 Available in GitLab Runner all

ciNodeTotalRequired 
1
public readonly ciNodeTotal: string;
  • Type: string

Total number of instances of this job running in parallel.

If the job is not parallelized, this variable is set to 1.

Added in GitLab 11.5 Available in GitLab Runner all

ciPagesDomainRequired 
1
public readonly ciPagesDomain: string;
  • Type: string

The configured domain that hosts GitLab Pages.

Added in GitLab 11.8 Available in GitLab Runner all

ciPagesUrlRequired 
1
public readonly ciPagesUrl: string;
  • Type: string

URL to GitLab Pages-built pages. Always belongs to a subdomain of CI_PAGES_DOMAIN.

Added in GitLab 11.8 Available in GitLab Runner all

ciPipelineIdRequired 
1
public readonly ciPipelineId: string;
  • Type: string

The instance-level ID of the current pipeline. This is a unique ID across all projects on GitLab.

Added in GitLab 8.10 Available in GitLab Runner all

ciPipelineIidRequired 
1
public readonly ciPipelineIid: string;
  • Type: string

The project-level IID (internal ID) of the current pipeline. This ID is unique for the current project.

Added in GitLab 11.0 Available in GitLab Runner all

ciPipelineSourceRequired 
1
public readonly ciPipelineSource: string;
  • Type: string

Indicates how the pipeline was triggered.

Possible options are push, web, schedule, api, external, chat, webide, merge_request_event, external_pull_request_event, parent_pipeline, trigger, or pipeline. For pipelines created before GitLab 9.5, this is displayed as unknown.

Added in GitLab 10.0 Available in GitLab Runner all

ciPipelineTriggeredRequired 
1
public readonly ciPipelineTriggered: string;
  • Type: string

The flag to indicate that job was triggered.

Added in GitLab all Available in GitLab Runner all

ciPipelineUrlRequired 
1
public readonly ciPipelineUrl: string;
  • Type: string

Pipeline details URL.

Added in GitLab 11.1 Available in GitLab Runner 0.5

ciProjectConfigPathRequired 
1
public readonly ciProjectConfigPath: string;
  • Type: string

The CI configuration path for the project.

Added in GitLab 13.8 Available in GitLab Runner all

ciProjectDirRequired 
1
public readonly ciProjectDir: string;
  • Type: string

The full path where the repository is cloned and where the job is run.

If the GitLab Runner builds_dir parameter is set, this variable is set relative to the value of builds_dir. For more information, see Advanced configuration for GitLab Runner.

Added in GitLab all Available in GitLab Runner all

ciProjectIdRequired 
1
public readonly ciProjectId: string;
  • Type: string

The unique ID of the current project that GitLab CI/CD uses internally.

Added in GitLab all Available in GitLab Runner all

ciProjectNameRequired 
1
public readonly ciProjectName: string;
  • Type: string

The name of the directory for the project that is being built.

For example, if the project URL is gitlab.example.com/group-name/project-1, the CI_PROJECT_NAME would be project-1.

Added in GitLab 8.10 Available in GitLab Runner 0.5

ciProjectNamespaceRequired 
1
public readonly ciProjectNamespace: string;
  • Type: string

The project stage (username or group name) that is being built.

Added in GitLab 8.10 Available in GitLab Runner 0.5

ciProjectPathRequired 
1
public readonly ciProjectPath: string;
  • Type: string

The stage with project name.

Added in GitLab 8.10 Available in GitLab Runner 0.5

ciProjectPathSlugRequired 
1
public readonly ciProjectPathSlug: string;
  • Type: string

$CI_PROJECT_PATH in lowercase and with everything except 0-9 and a-z replaced with -. Use in URLs and domain names.

Added in GitLab 9.3 Available in GitLab Runner all

ciProjectRepositoryLanguagesRequired 
1
public readonly ciProjectRepositoryLanguages: string;
  • Type: string

Comma-separated, lowercase list of the languages used in the repository (for example ruby,javascript,html,css).

Added in GitLab 12.3 Available in GitLab Runner all

ciProjectRootNamespaceRequired 
1
public readonly ciProjectRootNamespace: string;
  • Type: string

The root project stage (username or group name) that is being built.

For example, if CI_PROJECT_NAMESPACE is root-group/child-group/grandchild-group, CI_PROJECT_ROOT_NAMESPACE would be root-group.

Added in GitLab 13.2 Available in GitLab Runner 0.5

ciProjectTitleRequired 
1
public readonly ciProjectTitle: string;
  • Type: string

The human-readable project name as displayed in the GitLab web interface.

Added in GitLab 12.4 Available in GitLab Runner all

ciProjectUrlRequired 
1
public readonly ciProjectUrl: string;
  • Type: string

The HTTP(S) address to access project.

Added in GitLab 8.10 Available in GitLab Runner 0.5

ciProjectVisibilityRequired 
1
public readonly ciProjectVisibility: string;
  • Type: string

The project visibility (internal, private, public).

Added in GitLab 10.3 Available in GitLab Runner all

ciRegistryPasswordRequired 
1
public readonly ciRegistryPassword: string;
  • Type: string

The password to use to push containers to the GitLab Container Registry, for the current project.

ATTENTION: Contrary to most other variables in this class, this variable is not resolved at rendering time. Instead the variable string is returned, which is then resolved during pipeline execution. This is because the value contains sensitive information.

Added in GitLab 9.0 Available in GitLab Runner all

ciRepositoryUrlRequired 
1
public readonly ciRepositoryUrl: string;
  • Type: string

The URL to clone the Git repository.

ATTENTION: Contrary to most other variables in this class, this variable is not resolved at rendering time. Instead the variable string is returned, which is then resolved during pipeline execution. This is because the value contains sensitive information.

Added in GitLab 9.0 Available in GitLab Runner all

ciRunnerDescriptionRequired 
1
public readonly ciRunnerDescription: string;
  • Type: string

The description of the runner as saved in GitLab.

Added in GitLab 8.10 Available in GitLab Runner 0.5

ciRunnerExecutableArchRequired 
1
public readonly ciRunnerExecutableArch: string;
  • Type: string

The OS/architecture of the GitLab Runner executable (note that this is not necessarily the same as the environment of the executor).

Added in GitLab all Available in GitLab Runner 10.6

ciRunnerIdRequired 
1
public readonly ciRunnerId: string;
  • Type: string

The unique ID of runner being used.

Added in GitLab 8.10 Available in GitLab Runner 0.5

ciRunnerRevisionRequired 
1
public readonly ciRunnerRevision: string;
  • Type: string

GitLab Runner revision that is executing the current job.

Added in GitLab all Available in GitLab Runner 10.6

ciRunnerShortTokenRequired 
1
public readonly ciRunnerShortToken: string;
  • Type: string

First eight characters of the runner’s token used to authenticate new job requests. Used as the runner’s unique ID.

ATTENTION: Contrary to most other variables in this class, this variable is not resolved at rendering time. Instead the variable string is returned, which is then resolved during pipeline execution. This is because the value contains sensitive information.

Added in GitLab all Available in GitLab Runner 12.3

ciRunnerTagsRequired 
1
public readonly ciRunnerTags: string;
  • Type: string

The defined runner tags.

Added in GitLab 8.10 Available in GitLab Runner 0.5

ciRunnerVersionRequired 
1
public readonly ciRunnerVersion: string;
  • Type: string

GitLab Runner version that is executing the current job.

Added in GitLab all Available in GitLab Runner 10.6

ciServerRequired 
1
public readonly ciServer: string;
  • Type: string

Mark that job is executed in CI environment.

Added in GitLab all Available in GitLab Runner all

ciServerHostRequired 
1
public readonly ciServerHost: string;
  • Type: string

Host component of the GitLab instance URL, without protocol and port (like gitlab.example.com).

Added in GitLab 12.1 Available in GitLab Runner all

ciServerNameRequired 
1
public readonly ciServerName: string;
  • Type: string

The name of CI server that is used to coordinate jobs.

Added in GitLab all Available in GitLab Runner all

ciServerPortRequired 
1
public readonly ciServerPort: string;
  • Type: string

Port component of the GitLab instance URL, without host and protocol (like 3000).

Added in GitLab 12.8 Available in GitLab Runner all

ciServerProtocolRequired 
1
public readonly ciServerProtocol: string;
  • Type: string

Protocol component of the GitLab instance URL, without host and port (like https).

Added in GitLab 12.8 Available in GitLab Runner all

ciServerRevisionRequired 
1
public readonly ciServerRevision: string;
  • Type: string

GitLab revision that is used to schedule jobs.

Added in GitLab all Available in GitLab Runner all

ciServerUrlRequired 
1
public readonly ciServerUrl: string;
  • Type: string

The base URL of the GitLab instance, including protocol and port (like https://gitlab.example.com:8080).

Added in GitLab 12.7 Available in GitLab Runner all

ciServerVersionRequired 
1
public readonly ciServerVersion: string;
  • Type: string

GitLab version that is used to schedule jobs.

Added in GitLab all Available in GitLab Runner all

ciServerVersionMajorRequired 
1
public readonly ciServerVersionMajor: string;
  • Type: string

GitLab version major component.

Added in GitLab 11.4 Available in GitLab Runner all

ciServerVersionMinorRequired 
1
public readonly ciServerVersionMinor: string;
  • Type: string

GitLab version minor component.

Added in GitLab 11.4 Available in GitLab Runner all

ciServerVersionPatchRequired 
1
public readonly ciServerVersionPatch: string;
  • Type: string

GitLab version patch component.

Added in GitLab 11.4 Available in GitLab Runner all

gitlabCiRequired 
1
public readonly gitlabCi: string;
  • Type: string

Mark that job is executed in GitLab CI/CD environment.

Added in GitLab all Available in GitLab Runner all

gitlabFeaturesRequired 
1
public readonly gitlabFeatures: string;
  • Type: string

The comma separated list of licensed features available for your instance and plan.

Added in GitLab 10.6 Available in GitLab Runner all

gitlabUserEmailRequired 
1
public readonly gitlabUserEmail: string;
  • Type: string

The email of the user who started the job.

Added in GitLab 8.12 Available in GitLab Runner all

gitlabUserIdRequired 
1
public readonly gitlabUserId: string;
  • Type: string

The ID of the user who started the job.

Added in GitLab 8.12 Available in GitLab Runner all

gitlabUserLoginRequired 
1
public readonly gitlabUserLogin: string;
  • Type: string

The login username of the user who started the job.

Added in GitLab 10.0 Available in GitLab Runner all

gitlabUserNameRequired 
1
public readonly gitlabUserName: string;
  • Type: string

The real name of the user who started the job.

Added in GitLab 10.0 Available in GitLab Runner all

ciCommitBranchOptional 
1
public readonly ciCommitBranch: string;
  • Type: string

The commit branch name.

Present in branch pipelines, including pipelines for the default branch. Not present in merge request pipelines or tag pipelines.

Added in GitLab 12.6 Available in GitLab Runner 0.5

ciCommitTagOptional 
1
public readonly ciCommitTag: string;
  • Type: string

The commit tag name. Present only when building tags.

Added in GitLab 9.0 Available in GitLab Runner 0.5

ciDeployFreezeOptional 
1
public readonly ciDeployFreeze: string;
  • Type: string

Included with the value true if the pipeline runs during a deploy freeze window.

Added in GitLab 13.2 Available in GitLab Runner all

ciDisposableEnvironmentOptional 
1
public readonly ciDisposableEnvironment: string;
  • Type: string

Marks that the job is executed in a disposable environment (something that is created only for this job and disposed of/destroyed after the execution - all executors except shell and ssh).

If the environment is disposable, it is set to true, otherwise it is not defined at all.

Added in GitLab all Available in GitLab Runner 10.1

ciEnvironmentNameOptional 
1
public readonly ciEnvironmentName: string;
  • Type: string

The name of the environment for this job. Only present if environment:name is set.

Added in GitLab 8.15 Available in GitLab Runner all

ciEnvironmentSlugOptional 
1
public readonly ciEnvironmentSlug: string;
  • Type: string

A simplified version of the environment name, suitable for inclusion in DNS, URLs, Kubernetes labels, and so on.

Only present if environment:name is set.

Added in GitLab 8.15 Available in GitLab Runner all

ciEnvironmentUrlOptional 
1
public readonly ciEnvironmentUrl: string;
  • Type: string

The URL of the environment for this job. Only present if environment:url is set.

Added in GitLab 9.3 Available in GitLab Runner all

ciExternalPullRequestIidOptional 
1
public readonly ciExternalPullRequestIid: string;
  • Type: string

Pull Request ID from GitHub if the pipelines are for external pull requests.

Available only if only [external_pull_requests] or rules syntax is used and the pull request is open.

Added in GitLab 12.3 Available in GitLab Runner all

ciExternalPullRequestSourceBranchNameOptional 
1
public readonly ciExternalPullRequestSourceBranchName: string;
  • Type: string

The source branch name of the pull request if the pipelines are for external pull requests.

Available only if only [external_pull_requests] or rules syntax is used and the pull request is open.

Added in GitLab 12.3 Available in GitLab Runner all

ciExternalPullRequestSourceBranchShaOptional 
1
public readonly ciExternalPullRequestSourceBranchSha: string;
  • Type: string

The HEAD SHA of the source branch of the pull request if the pipelines are for external pull requests.

Available only if only [external_pull_requests] or rules syntax is used and the pull request is open.

Added in GitLab 12.3 Available in GitLab Runner all

ciExternalPullRequestSourceRepositoryOptional 
1
public readonly ciExternalPullRequestSourceRepository: string;
  • Type: string

The source repository name of the pull request if the pipelines are for external pull requests.

Available only if only [external_pull_requests] or rules syntax is used and the pull request is open.

Added in GitLab 13.3 Available in GitLab Runner all

ciExternalPullRequestTargetBranchNameOptional 
1
public readonly ciExternalPullRequestTargetBranchName: string;
  • Type: string

The target branch name of the pull request if the pipelines are for external pull requests.

Available only if only [external_pull_requests] or rules syntax is used and the pull request is open. * Added in GitLab 12.3 Available in GitLab Runner all

ciExternalPullRequestTargetBranchShaOptional 
1
public readonly ciExternalPullRequestTargetBranchSha: string;
  • Type: string

The HEAD SHA of the target branch of the pull request if the pipelines are for external pull requests.

Available only if only [external_pull_requests] or rules syntax is used and the pull request is open.

Added in GitLab 12.3 Available in GitLab Runner all

ciExternalPullRequestTargetRepositoryOptional 
1
public readonly ciExternalPullRequestTargetRepository: string;
  • Type: string

The target repository name of the pull request if the pipelines are for external pull requests.

Available only if only [external_pull_requests] or rules syntax is used and the pull request is open.

Added in GitLab 13.3 Available in GitLab Runner all

ciHasOpenRequirementsOptional 
1
public readonly ciHasOpenRequirements: string;
  • Type: string

Included with the value true only if the pipeline’s project has any open requirements.

Not included if there are no open requirements for the pipeline’s project.

Added in GitLab 13.1 Available in GitLab Runner all

ciKubernetesActiveOptional 
1
public readonly ciKubernetesActive: string;
  • Type: string

Included with the value true only if the pipeline has a Kubernetes cluster available for deployments.

Not included if no cluster is available. Can be used as an alternative to only:kubernetes/except:kubernetes with rules:if.

Added in GitLab 13.0 Available in GitLab Runner all

ciMergeRequestAssigneesOptional 
1
public readonly ciMergeRequestAssignees: string;
  • Type: string

Comma-separated list of username(s) of assignee(s) for the merge request if the pipelines are for merge requests.

Available only if only [merge_requests] or rules syntax is used and the merge request is created.

Added in GitLab 11.9 Available in GitLab Runner all

ciMergeRequestDiffBaseShaOptional 
1
public readonly ciMergeRequestDiffBaseSha: string;
  • Type: string

The base SHA of the merge request diff, if the pipelines are for merge requests.

Added in GitLab 13.7 Available in GitLab Runner all

ciMergeRequestDiffIdOptional 
1
public readonly ciMergeRequestDiffId: string;
  • Type: string

The version of the merge request diff, if the pipelines are for merge requests.

Added in GitLab 13.7 Available in GitLab Runner all

ciMergeRequestEventTypeOptional 
1
public readonly ciMergeRequestEventType: string;
  • Type: string

The event type of the merge request, if the pipelines are for merge requests. Can be detached, merged_result or merge_train.

Added in GitLab 12.3 Available in GitLab Runner all

ciMergeRequestIdOptional 
1
public readonly ciMergeRequestId: string;
  • Type: string

The instance-level ID of the merge request.

Only available if the pipelines are for merge requests and the merge request is created. This is a unique ID across all projects on GitLab.

Added in GitLab 11.6 Available in GitLab Runner all

ciMergeRequestIidOptional 
1
public readonly ciMergeRequestIid: string;
  • Type: string

The project-level IID (internal ID) of the merge request.

Only available If the pipelines are for merge requests and the merge request is created. This ID is unique for the current project.

Added in GitLab 11.6 Available in GitLab Runner all

ciMergeRequestLabelsOptional 
1
public readonly ciMergeRequestLabels: string;
  • Type: string

Comma-separated label names of the merge request if the pipelines are for merge requests.

Available only if only [merge_requests] or rules syntax is used and the merge request is created.

Added in GitLab 11.9 Available in GitLab Runner all

ciMergeRequestMilestoneOptional 
1
public readonly ciMergeRequestMilestone: string;
  • Type: string

The milestone title of the merge request if the pipelines are for merge requests.

Available only if only [merge_requests] or rules syntax is used and the merge request is created.

Added in GitLab 11.9 Available in GitLab Runner all

ciMergeRequestProjectIdOptional 
1
public readonly ciMergeRequestProjectId: string;
  • Type: string

The ID of the project of the merge request if the pipelines are for merge requests.

Available only if only [merge_requests] or rules syntax is used and the merge request is created.

Added in GitLab 11.6 Available in GitLab Runner all

ciMergeRequestProjectPathOptional 
1
public readonly ciMergeRequestProjectPath: string;
  • Type: string

The path of the project of the merge request if the pipelines are for merge requests (for example stage/awesome-project).

Available only if only [merge_requests] or rules syntax is used and the merge request is created.

Added in GitLab 11.6 Available in GitLab Runner all

ciMergeRequestProjectUrlOptional 
1
public readonly ciMergeRequestProjectUrl: string;
  • Type: string

The URL of the project of the merge request if the pipelines are for merge requests (for example http://192.168.10.15:3000/stage/awesome-project). Available only if only [merge_requests] or rules syntax is used and the merge request is created. * Added in GitLab 11.6 Available in GitLab Runner all.

ciMergeRequestRefPathOptional 
1
public readonly ciMergeRequestRefPath: string;
  • Type: string

The ref path of the merge request if the pipelines are for merge requests.

(for example refs/merge-requests/1/head). Available only if only [merge_requests] or rules syntax is used and the merge request is created.

Added in GitLab 11.6 Available in GitLab Runner all

ciMergeRequestSourceBranchNameOptional 
1
public readonly ciMergeRequestSourceBranchName: string;
  • Type: string

The source branch name of the merge request if the pipelines are for merge requests.

Available only if only [merge_requests] or rules syntax is used and the merge request is created.

Added in GitLab 11.6 Available in GitLab Runner all

ciMergeRequestSourceBranchShaOptional 
1
public readonly ciMergeRequestSourceBranchSha: string;
  • Type: string

The HEAD SHA of the source branch of the merge request if the pipelines are for merge requests.

Available only if only [merge_requests] or rules syntax is used, the merge request is created, and the pipeline is a merged result pipeline.

Added in GitLab 11.9 Available in GitLab Runner all

ciMergeRequestSourceProjectIdOptional 
1
public readonly ciMergeRequestSourceProjectId: string;
  • Type: string

The ID of the source project of the merge request if the pipelines are for merge requests.

Available only if only [merge_requests] or rules syntax is used and the merge request is created.

Added in GitLab 11.6 Available in GitLab Runner all

ciMergeRequestSourceProjectPathOptional 
1
public readonly ciMergeRequestSourceProjectPath: string;
  • Type: string

The path of the source project of the merge request if the pipelines are for merge requests.

Available only if only [merge_requests] or rules syntax is used and the merge request is created.

Added in GitLab 11.6 Available in GitLab Runner all

ciMergeRequestSourceProjectUrlOptional 
1
public readonly ciMergeRequestSourceProjectUrl: string;
  • Type: string

The URL of the source project of the merge request if the pipelines are for merge requests.

Available only if only [merge_requests] or rules syntax is used and the merge request is created.

Added in GitLab 11.6 Available in GitLab Runner all

ciMergeRequestTitleOptional 
1
public readonly ciMergeRequestTitle: string;
  • Type: string

The title of the merge request if the pipelines are for merge requests.

Available only if only [merge_requests] or rules syntax is used and the merge request is created.

Added in GitLab 11.9 Available in GitLab Runner all

ciNodeIndexOptional 
1
public readonly ciNodeIndex: string;
  • Type: string

Index of the job in the job set. If the job is not parallelized, this variable is not set.

Added in GitLab 11.5 Available in GitLab Runner all

ciOpenMergeRequestsOptional 
1
public readonly ciOpenMergeRequests: string;
  • Type: string

Available in branch and merge request pipelines.

Contains a comma-separated list of up to four merge requests that use the current branch and project as the merge request source. For example gitlab-org/gitlab!333,gitlab-org/gitlab-foss!11.

Added in GitLab 13.8 Available in GitLab Runner all

ciRegistryOptional 
1
public readonly ciRegistry: string;
  • Type: string

GitLab Container Registry. This variable includes a :port value if one has been specified in the registry configuration.

Added in GitLab 8.10 Available in GitLab Runner 0.5

ciRegistryImageOptional 
1
public readonly ciRegistryImage: string;
  • Type: string

the address of the registry tied to the specific project.

Added in GitLab 8.10 Available in GitLab Runner 0.5

ciRegistryUserOptional 
1
public readonly ciRegistryUser: string;
  • Type: string

The username to use to push containers to the GitLab Container Registry, for the current project.

Added in GitLab 9.0 Available in GitLab Runner all

ciSharedEnvironmentOptional 
1
public readonly ciSharedEnvironment: string;
  • Type: string

Marks that the job is executed in a shared environment (something that is persisted across CI invocations like shell or ssh executor).

If the environment is shared, it is set to true, otherwise it is not defined at all.

Added in GitLab all Available in GitLab Runner 10.1

triggerPayloadOptional 
1
public readonly triggerPayload: string;
  • Type: string

This variable is available when a pipeline is triggered with a webhook.

Added in GitLab 13.9 Available in GitLab Runner all

Rule

Initializers 

1
2
3
import { Rule } from '@gcix/gcix'

new Rule(props: RuleProps)
Name Type Description
props RuleProps No description.
propsRequired

Methods

Name Description
addVariables Adds one or more variables, each as keyword argument, to the rule.
isEqual isEqual checks if this object is equal to given object.
never This method is intended to be used for predefined rules.
render Returns a representation of any object which implements IBase.
addVariables 
1
public addVariables(variables: {[ key: string ]: string}): Rule

Adds one or more variables, each as keyword argument, to the rule.

1
rule.addVariables({GREETING: "hello", LANGUAGE: "typescript"})
variablesRequired
  • Type: {[ key: string ]: string}
isEqual 
1
public isEqual(comparable: IBase): boolean

isEqual checks if this object is equal to given object.

comparableRequired
never 
1
public never(): Rule

This method is intended to be used for predefined rules.

For instance you have defined an often used rule on_master whose if statement checks if the pipeline is executed on branch master. Then you can either run a job, if on master...

1
myJob.appendRules(onMaster)

... or do not run a job if on master...

1
myJob.appendRules(onMaster.never())
render 
1
public render(): any

Returns a representation of any object which implements IBase.

The rendered representation is used by the gcix to dump it in YAML format as part of the .gitlab-ci.yml pipeline.

Properties

Name Type Description
variables {[ key: string ]: string} No description.
allowFailure boolean No description.
changes string[] No description.
exists string[] No description.
ifStatement string No description.
when WhenStatement No description.
variablesRequired 
1
public readonly variables: {[ key: string ]: string};
  • Type: {[ key: string ]: string}
allowFailureOptional 
1
public readonly allowFailure: boolean;
  • Type: boolean
changesOptional 
1
public readonly changes: string[];
  • Type: string[]
existsOptional 
1
public readonly exists: string[];
  • Type: string[]
ifStatementOptional 
1
public readonly ifStatement: string;
  • Type: string
whenOptional 
1
public readonly when: WhenStatement;

RuleLib

Represents a library of static methods to create rules for GitLab CI/CD pipeline conditions.

Static Functions

Name Description
notOnBranch Creates a rule that evaluates to true if the CI/CD pipeline is NOT running on the specified branch.
notOnMain Creates a rule that evaluates to true if the CI/CD pipeline is NOT running on the "main" branch.
notOnMaster Creates a rule that evaluates to true if the CI/CD pipeline is NOT running on the "master" branch.
onBranch Creates a rule that evaluates to true if the CI/CD pipeline is running on the specified branch.
onMain Creates a rule that evaluates to true if the CI/CD pipeline is running on the "main" branch.
onMaster Creates a rule that evaluates to true if the CI/CD pipeline is running on the "master" branch.
onMergeRequestEvents Creates a rule that evaluates to true for merge request events in the CI/CD pipeline.
onPipelineTrigger Creates a rule that evaluates to true for pipelines triggered by API or the trigger keyword.
onSuccess Creates a rule that always evaluates to true (success).
onTags Creates a rule that evaluates to true for CI/CD pipelines triggered by tags.
notOnBranch 
1
2
3
import { RuleLib } from '@gcix/gcix'

RuleLib.notOnBranch(branchName: string)

Creates a rule that evaluates to true if the CI/CD pipeline is NOT running on the specified branch.

branchNameRequired
  • Type: string

The name of the branch to check.

notOnMain 
1
2
3
import { RuleLib } from '@gcix/gcix'

RuleLib.notOnMain()

Creates a rule that evaluates to true if the CI/CD pipeline is NOT running on the "main" branch.

notOnMaster 
1
2
3
import { RuleLib } from '@gcix/gcix'

RuleLib.notOnMaster()

Creates a rule that evaluates to true if the CI/CD pipeline is NOT running on the "master" branch.

onBranch 
1
2
3
import { RuleLib } from '@gcix/gcix'

RuleLib.onBranch(branchName: string)

Creates a rule that evaluates to true if the CI/CD pipeline is running on the specified branch.

branchNameRequired
  • Type: string

The name of the branch to check.

onMain 
1
2
3
import { RuleLib } from '@gcix/gcix'

RuleLib.onMain()

Creates a rule that evaluates to true if the CI/CD pipeline is running on the "main" branch.

onMaster 
1
2
3
import { RuleLib } from '@gcix/gcix'

RuleLib.onMaster()

Creates a rule that evaluates to true if the CI/CD pipeline is running on the "master" branch.

onMergeRequestEvents 
1
2
3
import { RuleLib } from '@gcix/gcix'

RuleLib.onMergeRequestEvents()

Creates a rule that evaluates to true for merge request events in the CI/CD pipeline.

onPipelineTrigger 
1
2
3
import { RuleLib } from '@gcix/gcix'

RuleLib.onPipelineTrigger()

Creates a rule that evaluates to true for pipelines triggered by API or the trigger keyword.

onSuccess 
1
2
3
import { RuleLib } from '@gcix/gcix'

RuleLib.onSuccess()

Creates a rule that always evaluates to true (success).

onTags 
1
2
3
import { RuleLib } from '@gcix/gcix'

RuleLib.onTags()

Creates a rule that evaluates to true for CI/CD pipelines triggered by tags.

Service

Initializers 

1
2
3
import { Service } from '@gcix/gcix'

new Service(props: ServiceProps)
Name Type Description
props ServiceProps No description.
propsRequired

Methods

Name Description
isEqual isEqual checks if this object is equal to given object.
render Returns a representation of any object which implements IBase.
isEqual 
1
public isEqual(comparable: IBase): boolean

isEqual checks if this object is equal to given object.

comparableRequired
render 
1
public render(): any

Returns a representation of any object which implements IBase.

The rendered representation is used by the gcix to dump it in YAML format as part of the .gitlab-ci.yml pipeline.

Properties

Name Type Description
name string No description.
nameRequired 
1
public readonly name: string;
  • Type: string

TriggerJob

This class represents the trigger job.

Jobs with trigger can only use a limited set of keywords. For example, you can’t run commands with script.

Simple example:

1
2
3
4
5
6
7
const triggerJob = new TriggerJob({
    stage: "trigger-other-job",
    project: "myteam/other-project",
    branch: "main",
    strategy: "depend",
})
triggerJob.appendRules(rules.onTags().never(), rules.onMain())

Initializers 

1
2
3
import { TriggerJob } from '@gcix/gcix'

new TriggerJob(props: TriggerJobProps)
Name Type Description
props TriggerJobProps No description.
propsRequired

Methods

Name Description
addDependencies No description.
addNeeds No description.
addParent This method is called by gcix.JobCollections when the job is added to that JobCollection.
addTags No description.
addVariables No description.
appendRules No description.
appendScripts No description.
assignAllowFailure No description.
assignArtifacts No description.
assignCache No description.
assignDependencies No description.
assignImage Sets the image of this job.
assignNeeds No description.
assignTags No description.
copy Returns an independent, deep copy object of this job.
extendName This method is used by gcix.JobCollections to populate the jobs name.
extendStage This method is used by gcix.JobCollections to populate the jobs name and stage.
extendStageValue This method is used by gcix.JobCollections to populate the jobs stage.
getAllInstanceNames Return all instance names from the given child.
isEqual isEqual checks if this object is equal to given object.
prependRules No description.
prependScripts No description.
render Returns a representation of any object which implements IBase.
addDependencies 
1
public addDependencies(dependencies: Job | JobCollection | Need[]): Job
dependenciesRequired
addNeeds 
1
public addNeeds(needs: Job | JobCollection | Need[]): Job
needsRequired
addParent 
1
public addParent(parent: Job | JobCollection): void

This method is called by gcix.JobCollections when the job is added to that JobCollection.

The job needs to know its parents when getAllInstanceNames() is called.

parentRequired
addTags 
1
public addTags(tags: string[]): Job
tagsRequired
  • Type: string[]
addVariables 
1
public addVariables(variables: {[ key: string ]: string}): Job
variablesRequired
  • Type: {[ key: string ]: string}
appendRules 
1
public appendRules(rules: Rule[]): Job
rulesRequired
appendScripts 
1
public appendScripts(scripts: string[]): Job
scriptsRequired
  • Type: string[]
assignAllowFailure 
1
public assignAllowFailure(allowFailure: boolean | number[]): Job
allowFailureRequired
  • Type: boolean | number[]
assignArtifacts 
1
public assignArtifacts(artifacts: Artifacts): Job
artifactsRequired
assignCache 
1
public assignCache(cache: Cache): Job
cacheRequired
assignDependencies 
1
public assignDependencies(dependencies: Job | JobCollection | Need[]): Job
dependenciesRequired
assignImage 
1
public assignImage(image: string | Image): Job

Sets the image of this job.

For a simple container image you can provide the origin of the image. If you want to set the entrypoint, you have to provide an Image object instead.

!! Any previous values will be overwritten.

imageRequired
assignNeeds 
1
public assignNeeds(needs: Job | JobCollection | Need[]): Job
needsRequired
assignTags 
1
public assignTags(tags: string[]): Job
tagsRequired
  • Type: string[]
copy 
1
public copy(): Job

Returns an independent, deep copy object of this job.

extendName 
1
public extendName(name: string): void

This method is used by gcix.JobCollections to populate the jobs name.

nameRequired
  • Type: string
extendStage 
1
public extendStage(stage: string): void

This method is used by gcix.JobCollections to populate the jobs name and stage.

stageRequired
  • Type: string
extendStageValue 
1
public extendStageValue(stage: string): void

This method is used by gcix.JobCollections to populate the jobs stage.

stageRequired
  • Type: string
getAllInstanceNames 
1
public getAllInstanceNames(child?: Job | JobCollection): OrderedStringSet

Return all instance names from the given child.

That means all combinations of the childs name and stage within this sequence and all parent sequences.

childOptional
isEqual 
1
public isEqual(comparable: IBase): boolean

isEqual checks if this object is equal to given object.

comparableRequired
prependRules 
1
public prependRules(rules: Rule[]): Job
rulesRequired
prependScripts 
1
public prependScripts(scripts: string[]): Job
scriptsRequired
  • Type: string[]
render 
1
public render(): any

Returns a representation of any object which implements IBase.

The rendered representation is used by the gcix to dump it in YAML format as part of the .gitlab-ci.yml pipeline.

Properties

Name Type Description
tags string[] Getter method to receive added tags.
allowFailure string | boolean | number[] No description.
name string No description.
orderedTags OrderedStringSet No description.
parents Job | JobCollection[] No description.
scripts string[] No description.
stage string No description.
artifacts Artifacts No description.
cache Cache No description.
dependencies Job | JobCollection | Need[] No description.
image Image No description.
needs Job | JobCollection | Need[] No description.
original Job No description.
rules Rule[] No description.
variables {[ key: string ]: string} No description.
branch string The branch of project the pipeline should be triggered of.
includes IncludeLocal | IncludeFile | IncludeRemote | IncludeTemplate | IncludeArtifact[] Include a pipeline to trigger (Parent-child pipeline trigger) Mutually exclusiv with project.
project string The full name of another Gitlab project to trigger (multi-project pipeline trigger).
strategy string Determines if the result of this pipeline depends on the triggered downstream pipeline (use TriggerStrategy.DEPEND) or if just "fire and forget" the downstream pipeline (use None).
tagsRequired 
1
public readonly tags: string[];
  • Type: string[]

Getter method to receive added tags.

allowFailureRequired 
1
public readonly allowFailure: string | boolean | number[];
  • Type: string | boolean | number[]
nameRequired 
1
public readonly name: string;
  • Type: string
orderedTagsRequired 
1
public readonly orderedTags: OrderedStringSet;
parentsRequired 
1
public readonly parents: Job | JobCollection[];
scriptsRequired 
1
public readonly scripts: string[];
  • Type: string[]
stageRequired 
1
public readonly stage: string;
  • Type: string
artifactsOptional 
1
public readonly artifacts: Artifacts;
cacheOptional 
1
public readonly cache: Cache;
dependenciesOptional 
1
public readonly dependencies: Job | JobCollection | Need[];
imageOptional 
1
public readonly image: Image;
needsOptional 
1
public readonly needs: Job | JobCollection | Need[];
originalOptional 
1
public readonly original: Job;
rulesOptional 
1
public readonly rules: Rule[];
variablesOptional 
1
public readonly variables: {[ key: string ]: string};
  • Type: {[ key: string ]: string}
branchOptional 
1
public readonly branch: string;
  • Type: string

The branch of project the pipeline should be triggered of.

includesOptional 
1
public readonly includes: IncludeLocal | IncludeFile | IncludeRemote | IncludeTemplate | IncludeArtifact[];

Include a pipeline to trigger (Parent-child pipeline trigger) Mutually exclusiv with project.

projectOptional 
1
public readonly project: string;
  • Type: string

The full name of another Gitlab project to trigger (multi-project pipeline trigger).

Mutually exclusive with includes.

strategyOptional 
1
public readonly strategy: string;
  • Type: string

Determines if the result of this pipeline depends on the triggered downstream pipeline (use TriggerStrategy.DEPEND) or if just "fire and forget" the downstream pipeline (use None).

Protocols

IArtifacts

Methods

Name Description
addExcludes No description.
addPaths No description.
addExcludes 
1
public addExcludes(excludes: string[]): void
excludesRequired
  • Type: string[]
addPaths 
1
public addPaths(paths: string[]): void
pathsRequired
  • Type: string[]

Properties

Name Type Description
excludes string[] No description.
paths string[] No description.
expireIn string No description.
exposeAs string No description.
name string No description.
public boolean No description.
reports ArtifactsReport[] No description.
untracked boolean No description.
when WhenStatement No description.
excludesRequired 
1
public readonly excludes: string[];
  • Type: string[]
pathsRequired 
1
public readonly paths: string[];
  • Type: string[]
expireInOptional 
1
public readonly expireIn: string;
  • Type: string
exposeAsOptional 
1
public readonly exposeAs: string;
  • Type: string
nameOptional 
1
public readonly name: string;
  • Type: string
publicOptional 
1
public readonly public: boolean;
  • Type: boolean
reportsOptional 
1
public readonly reports: ArtifactsReport[];
untrackedOptional 
1
public readonly untracked: boolean;
  • Type: boolean
whenOptional 
1
public readonly when: WhenStatement;

IBase

Methods

Name Description
isEqual isEqual checks if this object is equal to given object.
render Returns a representation of any object which implements IBase.
isEqual 
1
public isEqual(comparable: IBase): boolean

isEqual checks if this object is equal to given object.

comparableRequired

An arbitrary object to compare to.

render 
1
public render(): any

Returns a representation of any object which implements IBase.

The rendered representation is used by the gcix to dump it in YAML format as part of the .gitlab-ci.yml pipeline.

ICache

ICacheKey

IImage

Methods

Name Description
withEntrypoint No description.
withTag No description.
withEntrypoint 
1
public withEntrypoint(entrypoint: string[]): Image
entrypointRequired
  • Type: string[]
withTag 
1
public withTag(tag: string): Image
tagRequired
  • Type: string

IInclude

This module represents the Gitlab CI Include keyword.

Use include to include external YAML files in your CI/CD configuration.

include:local example:

1
pipeline.addInclude(new IncludeLocal({local: "/templates/.gitlab-ci-template.yml"}))
include:file example: 
1
2
3
4
5
pipeline.addInclude(new IncludeFile({
        project="my-group/my-project",
        ref="master",
        file="/templates/.gitlab-ci-template.yml"
    }))

include:remote example: 

1
2
3
pipeline.addInclude(new IncludeRemote({
         remote: "https://gitlab.com/example-project/-/raw/master/.gitlab-ci.yml"
     }))

include:template example: 

1
pipeline.addInclude(new IncludeTemplate({template: "Auto-DevOps.gitlab-ci.yml"}))

Special type of include: Use a gcix.TriggerJob with IncludeArtifact to run a child pipeline with a generated configuration file from a previous job: 

1
new TriggerJob({includes=[IncludeArtifact(job="generate-config", artifact="generated-config.yml")]})

IIncludeArtifact

IIncludeFile

IIncludeLocal

IIncludeRemote

IIncludeTemplate

IJob

  • Extends: IJobBase

  • Implemented By: @gcix/gcix.aws.CdkBootstrap, @gcix/gcix.aws.CdkDeploy, @gcix/gcix.aws.CdkDiff, @gcix/gcix.aws.CdkMirrorToCodecommit, @gcix/gcix.container.CraneCopy, @gcix/gcix.container.CranePull, @gcix/gcix.container.CranePush, @gcix/gcix.container.DiveScan, @gcix/gcix.container.DockerBuild, @gcix/gcix.container.DockerPush, @gcix/gcix.container.KanikoExecute, @gcix/gcix.container.TrivyIgnoreFileCheck, @gcix/gcix.container.TrivyScanLocalImage, @gcix/gcix.git.GitMirror, @gcix/gcix.gitlab.PagesAsciiDoctor, @gcix/gcix.python.PagesPdoc3, @gcix/gcix.python.PagesSphinx, @gcix/gcix.python.PythonBuildBdistWheel, @gcix/gcix.python.PythonDeployTwineUpload, @gcix/gcix.python.PythonLintFlake8, @gcix/gcix.python.PythonLintIsort, @gcix/gcix.python.PythonLintMyPy, @gcix/gcix.python.PythonTestEvaluateGitTagPep440Conformity, @gcix/gcix.python.PythonTestPytest, Job, PagesJob, TriggerJob, IJob

Methods

Name Description
addParent This method is called by gcix.JobCollections when the job is added to that JobCollection.
assignAllowFailure No description.
assignDependencies No description.
assignImage Sets the image of this job.
assignNeeds No description.
assignTags No description.
copy Returns an independent, deep copy object of this job.
extendName This method is used by gcix.JobCollections to populate the jobs name.
extendStage This method is used by gcix.JobCollections to populate the jobs name and stage.
extendStageValue This method is used by gcix.JobCollections to populate the jobs stage.
addParent 
1
public addParent(parent: Job | JobCollection): void

This method is called by gcix.JobCollections when the job is added to that JobCollection.

The job needs to know its parents when getAllInstanceNames() is called.

parentRequired

any type of Job or JobCollection.

assignAllowFailure 
1
public assignAllowFailure(allowFailure: boolean | number[]): Job
allowFailureRequired
  • Type: boolean | number[]
assignDependencies 
1
public assignDependencies(dependencies: Job | JobCollection | Need[]): Job
dependenciesRequired
assignImage 
1
public assignImage(image: string | Image): Job

Sets the image of this job.

For a simple container image you can provide the origin of the image. If you want to set the entrypoint, you have to provide an Image object instead.

!! Any previous values will be overwritten.

imageRequired
assignNeeds 
1
public assignNeeds(needs: Job | JobCollection | Need[]): Job
needsRequired
assignTags 
1
public assignTags(tags: string[]): Job
tagsRequired
  • Type: string[]
copy 
1
public copy(): Job

Returns an independent, deep copy object of this job.

extendName 
1
public extendName(name: string): void

This method is used by gcix.JobCollections to populate the jobs name.

nameRequired
  • Type: string

to append to the current name.

extendStage 
1
public extendStage(stage: string): void

This method is used by gcix.JobCollections to populate the jobs name and stage.

stageRequired
  • Type: string

name to extend the stage and the name.

extendStageValue 
1
public extendStageValue(stage: string): void

This method is used by gcix.JobCollections to populate the jobs stage.

stageRequired
  • Type: string

name to extend the stage.

Properties

Name Type Description
tags string[] Getter method to receive added tags.
original Job No description.
tagsRequired 
1
public readonly tags: string[];
  • Type: string[]

Getter method to receive added tags.

originalOptional 
1
public readonly original: Job;

IJobBase

  • Extends: IBase

  • Implemented By: @gcix/gcix.aws.CdkBootstrap, @gcix/gcix.aws.CdkDeploy, @gcix/gcix.aws.CdkDiff, @gcix/gcix.aws.CdkMirrorToCodecommit, @gcix/gcix.container.CraneCopy, @gcix/gcix.container.CranePull, @gcix/gcix.container.CranePush, @gcix/gcix.container.DiveScan, @gcix/gcix.container.DockerBuild, @gcix/gcix.container.DockerPush, @gcix/gcix.container.KanikoExecute, @gcix/gcix.container.TrivyIgnoreFileCheck, @gcix/gcix.container.TrivyScanLocalImage, @gcix/gcix.git.GitMirror, @gcix/gcix.gitlab.PagesAsciiDoctor, @gcix/gcix.python.PagesPdoc3, @gcix/gcix.python.PagesSphinx, @gcix/gcix.python.PythonBuildBdistWheel, @gcix/gcix.python.PythonDeployTwineUpload, @gcix/gcix.python.PythonLintFlake8, @gcix/gcix.python.PythonLintIsort, @gcix/gcix.python.PythonLintMyPy, @gcix/gcix.python.PythonTestEvaluateGitTagPep440Conformity, @gcix/gcix.python.PythonTestPytest, Job, PagesJob, TriggerJob, IJob, IJobBase

Methods

Name Description
addDependencies No description.
addNeeds No description.
addTags No description.
addVariables No description.
appendRules No description.
appendScripts No description.
assignArtifacts No description.
assignCache No description.
getAllInstanceNames Return all instance names from the given child.
prependRules No description.
prependScripts No description.
addDependencies 
1
public addDependencies(dependencies: Job | JobCollection | Need[]): Job
dependenciesRequired
addNeeds 
1
public addNeeds(needs: Job | JobCollection | Need[]): Job
needsRequired
addTags 
1
public addTags(tags: string[]): Job
tagsRequired
  • Type: string[]
addVariables 
1
public addVariables(variables: {[ key: string ]: string}): Job
variablesRequired
  • Type: {[ key: string ]: string}
appendRules 
1
public appendRules(rules: Rule[]): Job
rulesRequired
appendScripts 
1
public appendScripts(scripts: string[]): Job
scriptsRequired
  • Type: string[]
assignArtifacts 
1
public assignArtifacts(artifacts: Artifacts): Job
artifactsRequired
assignCache 
1
public assignCache(cache: Cache): Job
cacheRequired
getAllInstanceNames 
1
public getAllInstanceNames(child?: Job | JobCollection): OrderedStringSet

Return all instance names from the given child.

That means all combinations of the childs name and stage within this sequence and all parent sequences.

childOptional
prependRules 
1
public prependRules(rules: Rule[]): Job
rulesRequired
prependScripts 
1
public prependScripts(scripts: string[]): Job
scriptsRequired
  • Type: string[]

Properties

Name Type Description
tags string[] Getter method to receive added tags.
tagsRequired 
1
public readonly tags: string[];
  • Type: string[]

Getter method to receive added tags.

IJobCollection

  • Extends: IJobCollectionBase

  • Implemented By: @gcix/gcix.aws.CdkDiffDeploy, @gcix/gcix.container.BuildContainerCollection, @gcix/gcix.container.BuildGitlabContainerCollection, @gcix/gcix.container.CopyContainerCollection, @gcix/gcix.python.PythonFullStack, JobCollection, Pipeline, IJobCollection

Methods

Name Description
addChildren Add gcix.Jobs or other gcix.JobCollections to this JobCollection.
addParent No description.
initializeAllowFailure Calling gcix.Job.assignAllowFailure() to all jobs within this JobCollection that haven't been set the allowFailure before.
initializeArtifacts Sets gcix.Job.artifacts to all jobs within this JobCollection that haven't been set the artifacs before.
initializeCache Calling gcix.Job.assigneCache() to all jobs within this JobCollection that haven't been set the cache before.
initializeDependencies Calling gcix.Job.assignDependencies() to all jobs within the first stage of this JobCollection that haven't been added dependencies before.
initializeImage Calling gcix.Job.assignImage() to all jobs within this JobCollection.
initializeNeeds Calling gcix.Job.assignNeeds() to all jobs within the first stage of this JobCollection that haven't been added needs before.
initializeRules Calling gcix.Job.append_rules() to all jobs within this JobCollection that haven't been added rules before.
initializeTags Calling gcix.Job.addTags([...]) to all jobs within this JobCollection that haven't been added tags before.
initializeVariables Calling gcix.Job.addVariables({...}) to all jobs within this JobCollection that haven't been added variables before.
overrideAllowFailure Calling gcix.Job.assignAllowFailure() to all jobs within this JobCollection overriding any previous set value.
overrideDependencies Calling gcix.Job.assignDependencies() to all jobs within the first stage of this JobCollection and overriding any previously added dependencies to that jobs.
overrideImage Calling gcix.Job.assignImage() to all jobs within this JobCollection overriding any previous set value.
overrideNeeds Calling gcix.Job.assignNeeds() to all jobs within the first stage of this JobCollection and overriding any previously added needs to that jobs.
overrideRules Calling gcix.Job.overrideRules() to all jobs within this JobCollection and overriding any previously added rules to that jobs.
overrideTags Calling gcix.Job.addTags([...]) to all jobs within this JobCollection and overriding any previously added tags to that jobs.
overrideVariables Calling gcix.Job.addVariables({...}) to all jobs within this JobCollection and overriding any previously added variables to that jobs.
addChildren 
1
public addChildren(props: AddChildrenProps): JobCollection

Add gcix.Jobs or other gcix.JobCollections to this JobCollection.

Adding a child creates a copy of that child. You should provide a name or stage when adding children, to make them different from other places where they will be used.

propsRequired
addParent 
1
public addParent(parent: JobCollection): void
parentRequired
initializeAllowFailure 
1
public initializeAllowFailure(allowFailure: boolean | number[]): JobCollection

Calling gcix.Job.assignAllowFailure() to all jobs within this JobCollection that haven't been set the allowFailure before.

allowFailureRequired
  • Type: boolean | number[]

???

initializeArtifacts 
1
public initializeArtifacts(artifacts: Artifacts): JobCollection

Sets gcix.Job.artifacts to all jobs within this JobCollection that haven't been set the artifacs before.

artifactsRequired

???

initializeCache 
1
public initializeCache(cache: Cache): JobCollection

Calling gcix.Job.assigneCache() to all jobs within this JobCollection that haven't been set the cache before.

cacheRequired

???

initializeDependencies 
1
public initializeDependencies(dependencies: Job | JobCollection | Need[]): JobCollection

Calling gcix.Job.assignDependencies() to all jobs within the first stage of this JobCollection that haven't been added dependencies before.

An empty parameter list means that jobs will get an empty dependency list and thus does not download artifacts by default.

dependenciesRequired

???

initializeImage 
1
public initializeImage(image: string | Image): JobCollection

Calling gcix.Job.assignImage() to all jobs within this JobCollection.

imageRequired

???

initializeNeeds 
1
public initializeNeeds(needs: Job | JobCollection | Need[]): JobCollection

Calling gcix.Job.assignNeeds() to all jobs within the first stage of this JobCollection that haven't been added needs before.

An empty parameter list means that jobs will get an empty dependency list and thus does not depend on other jobs by default.

needsRequired

???

initializeRules 
1
public initializeRules(rules: Rule[]): JobCollection

Calling gcix.Job.append_rules() to all jobs within this JobCollection that haven't been added rules before.

rulesRequired

???

initializeTags 
1
public initializeTags(tags: string[]): JobCollection

Calling gcix.Job.addTags([...]) to all jobs within this JobCollection that haven't been added tags before.

tagsRequired
  • Type: string[]

???

initializeVariables 
1
public initializeVariables(variables: {[ key: string ]: string}): JobCollection

Calling gcix.Job.addVariables({...}) to all jobs within this JobCollection that haven't been added variables before.

variablesRequired
  • Type: {[ key: string ]: string}

???

overrideAllowFailure 
1
public overrideAllowFailure(allowFailure: boolean | number[]): JobCollection

Calling gcix.Job.assignAllowFailure() to all jobs within this JobCollection overriding any previous set value.

allowFailureRequired
  • Type: boolean | number[]

???

overrideDependencies 
1
public overrideDependencies(dependencies: Job | JobCollection | Need[]): JobCollection

Calling gcix.Job.assignDependencies() to all jobs within the first stage of this JobCollection and overriding any previously added dependencies to that jobs.

An empty parameter list means that jobs will get an empty dependency list and thus does not download artifacts.

dependenciesRequired

???

overrideImage 
1
public overrideImage(image: string | Image): JobCollection

Calling gcix.Job.assignImage() to all jobs within this JobCollection overriding any previous set value.

imageRequired

???

overrideNeeds 
1
public overrideNeeds(needs: Job | JobCollection | Need[]): JobCollection

Calling gcix.Job.assignNeeds() to all jobs within the first stage of this JobCollection and overriding any previously added needs to that jobs.

An empty parameter list means that jobs will get an empty dependency list and thus does not depend on other jobs.

needsRequired

???

overrideRules 
1
public overrideRules(rules: Rule[]): JobCollection

Calling gcix.Job.overrideRules() to all jobs within this JobCollection and overriding any previously added rules to that jobs.

rulesRequired

???

overrideTags 
1
public overrideTags(tags: string[]): JobCollection

Calling gcix.Job.addTags([...]) to all jobs within this JobCollection and overriding any previously added tags to that jobs.

tagsRequired
  • Type: string[]

???

overrideVariables 
1
public overrideVariables(variables: {[ key: string ]: string}): JobCollection

Calling gcix.Job.addVariables({...}) to all jobs within this JobCollection and overriding any previously added variables to that jobs.

variablesRequired
  • Type: {[ key: string ]: string}

???

Properties

Name Type Description
lastJobsExecuted Job[] This property returns all Jobs from the last stage of this JobCollection.
nestedJobs Job[] No description.
populatedJobs Job[] Returns a list with populated copies of all nested jobs of this JobCollection.
children ChildDict[] No description.
orderedTags OrderedStringSet No description.
orderedTagsForInitialization OrderedStringSet No description.
orderedTagsForReplacement OrderedStringSet No description.
parents Job | JobCollection[] No description.
allowFailureForInitialization string | boolean | number[] No description.
allowFailureForReplacement string | boolean | number[] No description.
artifacts Artifacts No description.
artifactsForInitialization Artifacts No description.
artifactsForReplacement Artifacts No description.
cache Cache No description.
cacheForInitialization Cache No description.
dependencies Job | JobCollection | Need[] No description.
dependenciesForInitialization Job | JobCollection | Need[] No description.
dependenciesForReplacement Job | JobCollection | Need[] No description.
imageForInitialization string | Image No description.
imageForReplacement string | Image No description.
needs Job | JobCollection | Need[] No description.
needsForInitialization Job | JobCollection | Need[] No description.
needsForReplacement Job | JobCollection | Need[] No description.
rulesForInitialization Rule[] No description.
rulesForReplacement Rule[] No description.
rulesToAppend Rule[] No description.
rulesToPrepend Rule[] No description.
scriptsToAppend string[] No description.
scriptsToPrepend string[] No description.
variables {[ key: string ]: string} No description.
variablesForInitialization {[ key: string ]: string} No description.
variablesForReplacement {[ key: string ]: string} No description.
lastJobsExecutedRequired 
1
public readonly lastJobsExecuted: Job[];

This property returns all Jobs from the last stage of this JobCollection.

This is typically be requested from a job which has setup this JobCollection as need, to determine all actual jobs of this JobCollection as need.

nestedJobsRequired 
1
public readonly nestedJobs: Job[];
populatedJobsRequired 
1
public readonly populatedJobs: Job[];

Returns a list with populated copies of all nested jobs of this JobCollection.

Populated means, that all attributes of a Job which depends on its context are resolved to their final values. The context is primarily the JobCollection within the jobs resides but also dependencies to other jobs and JobCollection's. Thus this JobCollection will apply its own configuration, like variables to add, tags to set, etc., to all its jobs and JobCollection's.

Copies means what it says, that the returned job are not the same job objects, originally added to this JobCollection, but copies of them.

Nested means, that also jobs from JobCollection's within this JobCollection, are returned, as well as jobs from JobCollection's within JobCollection's within this JobCollection and so on.

childrenRequired 
1
public readonly children: ChildDict[];
orderedTagsRequired 
1
public readonly orderedTags: OrderedStringSet;
orderedTagsForInitializationRequired 
1
public readonly orderedTagsForInitialization: OrderedStringSet;
orderedTagsForReplacementRequired 
1
public readonly orderedTagsForReplacement: OrderedStringSet;
parentsRequired 
1
public readonly parents: Job | JobCollection[];
allowFailureForInitializationOptional 
1
public readonly allowFailureForInitialization: string | boolean | number[];
  • Type: string | boolean | number[]
allowFailureForReplacementOptional 
1
public readonly allowFailureForReplacement: string | boolean | number[];
  • Type: string | boolean | number[]
artifactsOptional 
1
public readonly artifacts: Artifacts;
artifactsForInitializationOptional 
1
public readonly artifactsForInitialization: Artifacts;
artifactsForReplacementOptional 
1
public readonly artifactsForReplacement: Artifacts;
cacheOptional 
1
public readonly cache: Cache;
cacheForInitializationOptional 
1
public readonly cacheForInitialization: Cache;
dependenciesOptional 
1
public readonly dependencies: Job | JobCollection | Need[];
dependenciesForInitializationOptional 
1
public readonly dependenciesForInitialization: Job | JobCollection | Need[];
dependenciesForReplacementOptional 
1
public readonly dependenciesForReplacement: Job | JobCollection | Need[];
imageForInitializationOptional 
1
public readonly imageForInitialization: string | Image;
imageForReplacementOptional 
1
public readonly imageForReplacement: string | Image;
needsOptional 
1
public readonly needs: Job | JobCollection | Need[];
needsForInitializationOptional 
1
public readonly needsForInitialization: Job | JobCollection | Need[];
needsForReplacementOptional 
1
public readonly needsForReplacement: Job | JobCollection | Need[];
rulesForInitializationOptional 
1
public readonly rulesForInitialization: Rule[];
rulesForReplacementOptional 
1
public readonly rulesForReplacement: Rule[];
rulesToAppendOptional 
1
public readonly rulesToAppend: Rule[];
rulesToPrependOptional 
1
public readonly rulesToPrepend: Rule[];
scriptsToAppendOptional 
1
public readonly scriptsToAppend: string[];
  • Type: string[]
scriptsToPrependOptional 
1
public readonly scriptsToPrepend: string[];
  • Type: string[]
variablesOptional 
1
public readonly variables: {[ key: string ]: string};
  • Type: {[ key: string ]: string}
variablesForInitializationOptional 
1
public readonly variablesForInitialization: {[ key: string ]: string};
  • Type: {[ key: string ]: string}
variablesForReplacementOptional 
1
public readonly variablesForReplacement: {[ key: string ]: string};
  • Type: {[ key: string ]: string}

IJobCollectionBase

  • Extends: IBase

  • Implemented By: @gcix/gcix.aws.CdkDiffDeploy, @gcix/gcix.container.BuildContainerCollection, @gcix/gcix.container.BuildGitlabContainerCollection, @gcix/gcix.container.CopyContainerCollection, @gcix/gcix.python.PythonFullStack, JobCollection, Pipeline, IJobCollection, IJobCollectionBase

Methods

Name Description
addDependencies No description.
addNeeds No description.
addTags No description.
addVariables No description.
appendRules No description.
appendScripts No description.
assignArtifacts No description.
assignCache No description.
getAllInstanceNames Return all instance names from the given child.
prependRules No description.
prependScripts No description.
addDependencies 
1
public addDependencies(dependencies: Job | JobCollection | Need[]): JobCollection
dependenciesRequired
addNeeds 
1
public addNeeds(needs: Job | JobCollection | Need[]): JobCollection
needsRequired
addTags 
1
public addTags(tags: string[]): JobCollection
tagsRequired
  • Type: string[]
addVariables 
1
public addVariables(variables: {[ key: string ]: string}): JobCollection
variablesRequired
  • Type: {[ key: string ]: string}
appendRules 
1
public appendRules(rules: Rule[]): JobCollection
rulesRequired
appendScripts 
1
public appendScripts(scripts: string[]): JobCollection
scriptsRequired
  • Type: string[]
assignArtifacts 
1
public assignArtifacts(artifacts: Artifacts): JobCollection
artifactsRequired
assignCache 
1
public assignCache(cache: Cache): JobCollection
cacheRequired
getAllInstanceNames 
1
public getAllInstanceNames(child?: Job | JobCollection): OrderedStringSet

Return all instance names from the given child.

That means all combinations of the childs name and stage within this JobCollection and all parent JobCollection's.

childOptional
prependRules 
1
public prependRules(rules: Rule[]): JobCollection
rulesRequired
prependScripts 
1
public prependScripts(scripts: string[]): JobCollection
scriptsRequired
  • Type: string[]

INeed

IPagesJob

Methods

Name Description
assignStage Set the name of this jobs stage to a value other than pages.
copy There should be only one instance of this job, that is why this method does not return a copy of this job but the job itself.
extendName The jobs name pages is fixed and can't be altered.
extendStage The stage name can't be altered from parent sequences.
extendStageValue Extending the name of the stage is not allowed on this Job.
assignStage 
1
public assignStage(stage: string): PagesJob

Set the name of this jobs stage to a value other than pages.

stageRequired
  • Type: string

A valid Gitlab CI Job stage name.

copy 
1
public copy(): Job

There should be only one instance of this job, that is why this method does not return a copy of this job but the job itself.

extendName 
1
public extendName(name: string): void

The jobs name pages is fixed and can't be altered.

nameRequired
  • Type: string
extendStage 
1
public extendStage(name: string): void

The stage name can't be altered from parent sequences.

nameRequired
  • Type: string
extendStageValue 
1
public extendStageValue(name: string): void

Extending the name of the stage is not allowed on this Job.

nameRequired
  • Type: string

IPipeline

Methods

Name Description
addInclude Let you add global gcix.Includes to the pipeline. Gitlab CI Documentation: "Use include to include external YAML files in your CI/CD configuration.".
addServices Add one or more gcix.Services to the pipeline.
writeYaml Create the Gitlab CI YAML file from this pipeline object.
addInclude 
1
public addInclude(include: Include): Pipeline

Let you add global gcix.Includes to the pipeline. Gitlab CI Documentation: "Use include to include external YAML files in your CI/CD configuration.".

includeRequired
addServices 
1
public addServices(services: Service[]): Pipeline

Add one or more gcix.Services to the pipeline.

Gitlab CI Documentation: "The services keyword defines a Docker image that runs during a job linked to the Docker image that the image keyword defines."

servicesRequired

simply use strings to name the services to link to the pipeline.

Use objects of the gcix.Service class for more complex service configurations.

writeYaml 
1
public writeYaml(filename?: string): void

Create the Gitlab CI YAML file from this pipeline object.

Use that YAML file to trigger a child pipeline.

filenameOptional
  • Type: string

the file name of the created yaml file.

Properties

Name Type Description
includes Include[] No description.
service Service[] No description.
includesRequired 
1
public readonly includes: Include[];
serviceRequired 
1
public readonly service: Service[];

IRule

Methods

Name Description
addVariables Adds one or more variables, each as keyword argument, to the rule.
never This method is intended to be used for predefined rules.
addVariables 
1
public addVariables(variables: {[ key: string ]: string}): Rule

Adds one or more variables, each as keyword argument, to the rule.

1
rule.addVariables({GREETING: "hello", LANGUAGE: "typescript"})
variablesRequired
  • Type: {[ key: string ]: string}

Each variable would be provided as keyword argument:.

never 
1
public never(): Rule

This method is intended to be used for predefined rules.

For instance you have defined an often used rule on_master whose if statement checks if the pipeline is executed on branch master. Then you can either run a job, if on master...

1
myJob.appendRules(onMaster)

... or do not run a job if on master...

1
myJob.appendRules(onMaster.never())

IService

Properties

Name Type Description
name string No description.
nameRequired 
1
public readonly name: string;
  • Type: string

ITriggerJob

Properties

Name Type Description
branch string The branch of project the pipeline should be triggered of.
includes IncludeLocal | IncludeFile | IncludeRemote | IncludeTemplate | IncludeArtifact[] Include a pipeline to trigger (Parent-child pipeline trigger) Mutually exclusiv with project.
project string The full name of another Gitlab project to trigger (multi-project pipeline trigger).
strategy string Determines if the result of this pipeline depends on the triggered downstream pipeline (use TriggerStrategy.DEPEND) or if just "fire and forget" the downstream pipeline (use None).
branchOptional 
1
public readonly branch: string;
  • Type: string

The branch of project the pipeline should be triggered of.

includesOptional 
1
public readonly includes: IncludeLocal | IncludeFile | IncludeRemote | IncludeTemplate | IncludeArtifact[];

Include a pipeline to trigger (Parent-child pipeline trigger) Mutually exclusiv with project.

projectOptional 
1
public readonly project: string;
  • Type: string

The full name of another Gitlab project to trigger (multi-project pipeline trigger).

Mutually exclusive with includes.

strategyOptional 
1
public readonly strategy: string;
  • Type: string

Determines if the result of this pipeline depends on the triggered downstream pipeline (use TriggerStrategy.DEPEND) or if just "fire and forget" the downstream pipeline (use None).

Enums

CachePolicy

This enum represents the cache:policy keyword. The policy determines if a Job can modify the cache or read him only.

Members

Name Description
PULLPUSH The default behavior of a caching job is to download the files at the start of execution and re-upload them at the end.
PULL If you are certain that the job does not modify the cached files, you can specify this policy to skip the upload step.
PULLPUSH

The default behavior of a caching job is to download the files at the start of execution and re-upload them at the end.

This behavior ensures that any changes made by the job are persisted for future runs.

PULL

If you are certain that the job does not modify the cached files, you can specify this policy to skip the upload step.

By setting this policy, the job will only download the cached files at the start of execution without re-uploading them at the end.

WhenStatement

This enum holds different when statements for Rules.

Members

Name Description
ALWAYS No description.
DELAYED No description.
MANUAL No description.
NEVER No description.
ONFAILURE No description.
ONSUCCESS No description.
ALWAYS
DELAYED
MANUAL
NEVER
ONFAILURE
ONSUCCESS