diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 89 |
1 files changed, 89 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..bacfde2 --- /dev/null +++ b/README.md @@ -0,0 +1,89 @@ +Chained-CI +========== + +Role +---- +Chained-CI is a way to run a set of projects, each one as a job in a top level +pipeline. + +This project, running on gitlab CE, is triggering configured projects one +after the other, or in parallele, sharing configuration through artifacts. This +allow to integrate projects managed by third parties, or running together +independent projects. + +This project is hosting the pipelines and the pipeline configuration. +See [Orange CI Roles](https://gitlab.com/Orange-OpenSource/lfn/ci_cd/chained-ci-roles "Orange CI Roles") to see the +roles needed to run thoses pipelines + +Input +----- + - Environment variables: + - __Required__: + - POD: + - role: pod name as defined in pod_inventory/inventory + - example: pod1 + - default: none + - Optional: + - RUNNER_TAG: + - override the default gitlab-runner tag (ta5_tnaplab) + - "old" lab runner tag: tnaplab2 + - USER_ROLE: + - overrides the name of the "member" role in Openstack + - default role: "Member" (used in "old" DT lab) + - AREYOUSURE: + - role: disable the deployment protection on some pods + - default: '' + - values: '' or 'MAIS OUI !!!' + - ansible_verbose: + - role: verbose option for ansible + - values: "", "-vvv" + - default: "" + - infra_branch: + - role: the branch for project infra_manager + - default: master + - os_infra_branch: + - role: the branch for project os_infra_manager + - default: master + - vim_branch: + - role: the branch for the VIMs projects (kolla, k8s) + - default: master + - kolla_branch: + - role: a value to pass to project kolla + - default: 'stable/queens' + - kolla_ansible_branch: + - role: a value to pass to project kolla + - default: 'stable/queens' + - functest_branch: + - role: the branch for project functest + - default: master + - acumos_branch: + - role: the branch for project acumos-installer + - default: master + +Output +------ + - artifacts: each step can fetch the artifact generate by the sub-project as + defined in the git_projects variables pull_artifacts + +Details +------- + - [Chained-CI intro](./doc/chained-ci-intro.md "Chained-CI intro") + +Quick Guide to create a pipeline +-------------------------------- + - Reuse or create a inventory file-pair under pod_config/config + - k8s*.yaml defining the VMs and their resource settings (RAM, Disk, CPUs) + - idf-k8s*.yaml defining the inventory setting (tenant, network, node roles...) + - Create pipeline definition file under pod_inventory/host_vars + - Add name of the pipeline in pod_inventory/inventory + - Update the submodules (git submodule init; git submodule update) + - Run ansible script to regenerate .gitlab-ci.yaml + - ansible-playbook -vvv --vault-password-file ./.vault -i ./pod_inventory/inventory ./gitlab-ci-generator.yml + - (Workarround) add RUNNER_TAG default variable in .gitlab-ci.yaml + ``` + variables: + GIT_SUBMODULE_STRATEGY: recursive + VAULT_FILE: .vault + RUNNER_TAG: ta5_tnaplab + ``` + - check-in code and create a pipeline |