Skip to main content

A .ci.yml parser for Gitlab-CI

Project description

The ci-yml utilities read the local .ci.yml file and run a series of action grouped under jobs.

The .ci.yml file may define a deploy job and a list of other parallel jobs that can be assigned 1-to-1 with the gitlab-CI test jobs.

This is a .ci.yml example file:

  - <shell command>
  - <shell command>
    - <shell command>
    - <shell command>
  - <shell command>
  - <shell command>

In the example below we have two jobs, a prepare job used to install additional package:

  - pip install pyyaml

    - python ./
    - make doc

The commands inside prepare block are executed before that any other jobs is executed and the errors are ignored.

Following the example above you should configure two test jobs in you gitlab-ci instance and just call:

ci-yml test1


ci-yml build_doc

respectively. If you have also a deploy job you should also setup the gitlab-ci deploy job with the only command:

ci-yml deploy

If no arguments are provided to `ci-yml` all the jobs are executed until the first one fails or all jobs are runned than deploy action take place

Environment variables

ci-yml extend the env variables with the follows:


To see the gitlab environment variables see Travis envs doc are available at

You can also define extra env vars using the envs block, the newly defined vars can also combine other env vars. For example:

  pub_path: "/var/www/$USER/$CI_BUILD_REF"


  - cp *.out $PUB_PATH

Note: For your convenience you can define the vars as lower case inside the envs block but they MUST be used upper case inside the command.

ci-yml and travis

This project was intended to supply a job configuration method to gitlab-ci that don’t have any one atm, otherwise it could be useful also in others use cases.

You can use ci-yml locally during developing and you can also call it inside .travis.yml, see the local travis config file for info.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ci-yml-0.3.3.tar.gz (3.3 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page