Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/inverse-inc/ansible-role-gitlab-buildpkg-tools
https://github.com/inverse-inc/ansible-role-gitlab-buildpkg-tools
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/inverse-inc/ansible-role-gitlab-buildpkg-tools
- Owner: inverse-inc
- License: gpl-3.0
- Created: 2019-06-21T14:06:20.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-01-08T17:48:00.000Z (about 1 year ago)
- Last Synced: 2024-05-12T00:42:21.875Z (8 months ago)
- Language: Jinja
- Size: 118 KB
- Stars: 0
- Watchers: 9
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
gitlab_buildpkg_tools role
==========================
[](https://travis-ci.org/inverse-inc/ansible-role-gitlab-buildpkg-tools)
Install a [gitlab-buildpkg-tools PPA](http://orange-opensource.gitlab.io/gitlab-buildpkg-tools/)
and packages built with [gitlab-buildpkg-tools](https://gitlab.com/Orange-OpenSource/gitlab-buildpkg-tools) in a pipeline.
This role supports also:
* installing additional repositories
* installing GPG keys
* installing packages to meet dependencies of built packages in pipeline
* enable or disable repositories for EL
* set priority for EL repositories (needs yum-priorirites package before EL8)
Requirements
------------
Role designed to be launch in a GitLab pipeline. It can be called outside a
pipeline but you will need to set some variables by hand.
Role Variables
--------------
Available variables are listed below, check `defaults/main.yml` for defaults values:
gitlab_buildpkg_tools__ppa_enabled
Controls whether PPA repo and key should be installed.
gitlab_buildpkg_tools__ppa_url
URL of the PPA.
gitlab_buildpkg_tools__ppa_url_deb
URL of the PPA with Debian part.
gitlab_buildpkg_tools__ppa_url_deb
URL of the PPA with CentOS part.
gitlab_buildpkg_tools__deb_ppa
Debian PPA repo parameters.
gitlab_buildpkg_tools__rpm_ppa
RPM PPA repo parameters.
gitlab_buildpkg_tools__deb_deps_pkgs
List of Debian dependencies to install repos.
gitlab_buildpkg_tools__deb_deps_pkgs_state
State of Debian dependencies.
gitlab_buildpkg_tools__deb_keys
List of GPG keys **URL**.
gitlab_buildpkg_tools__deb_combined_keys
List of GPG keys to install (PPA + additional).
gitlab_buildpkg_tools__deb_sources_dir
Debian directory to store repos files.
gitlab_buildpkg_tools__deb_deps_repos
List of additional Debian repos.
gitlab_buildpkg_tools__deb_combined_repos
List of Debian repos to install.
gitlab_buildpkg_tools__deb_pkgs
List of Debian packages to install.
gitlab_buildpkg_tools__deb_pkgs_state
State of Debian packages to install.
gitlab_buildpkg_tools__rpm_deps_pkgs
List of CentOS dependencies to install repos.
gitlab_buildpkg_tools__rpm_deps_pkgs_state
State of CentOS dependencies.
gitlab_buildpkg_tools__rpm_keys
List of GPG keys URL or files.
gitlab_buildpkg_tools__rpm_combined_keys
List of GPG keys to install (PPA + additional).
gitlab_buildpkg_tools__rpm_deps_repos
List of additional CentOS repos.
gitlab_buildpkg_tools__rpm_enabled_repos
List of CentOS repos to enable/disable.
gitlab_buildpkg_tools__rpm_combined_repos
List of CentOS repos to install.
gitlab_buildpkg_tools__rpm_pkgs
List of CentOS packages to install.
gitlab_buildpkg_tools__rpm_pkgs_state
State of CentOS packages to install.
Environment variables to set in a pipeline (see below):
* `CI_PROJECT_NAME`
* `CI_PAGES_URL`
* `DEB_PACKAGES_NAME`
* `RPM_PACKAGES_NAME`
Limitations
-----------
### Debian limitations ###
- GPG keys need to be added by URL
- Debian packages need to be installed by name
### Environment Variables in .gitlab-ci.yml ###
In a `.gitlab-ci.yml` file, you can define environment variables like
`DEB_PACKAGES_NAME:` but theses variables can't be a pure YAML list or
dictionnary. Consequently, you need to use an inline YAML syntax.
Examples
--------
### Example to install packages **inside** of a CI ###
* `.gitlab-ci.yml`:
```yaml
variables:
DEB_PACKAGES_NAME: "['apt-add-gitlab', 'gitlab-buildpkg-tools']"
RPM_PACKAGES_NAME: "['yum-add-gitlab', 'gitlab-buildpkg-tools']"
CI_PROJECT_NAME: gitlab-buildpkg-tools
CI_PAGES_URL: http://orange-opensource.gitlab.io/gitlab-buildpkg-tools
```
Of course, if you use this playbook inside a pipeline where
`gitlab-buildpkg-tools` is used, you don't need to define `CI_PROJECT_NAME`
and `CI_PAGES_URL` variables.
* example playbook: see [playbook.yml use for molecule tests](molecule/default/playbook.yml)
### Example to install packages with additional repos and keys ###
See [playbook-additional.yml use for molecule
tests](molecule/default/playbook-additional.yml).
### Example to enable or disable repos for Entreprise Linux ###
See [playbook-enable-disable-repos.yml use for molecule
tests](molecule/default/playbook-enable-disable-repos.yml).
Test of this role
-----------------
This role can't be completely test in a GitLab CI pipeline because we want to
use predefined environment variables that can't be overriden (`CI_PAGES_URL`
and `CI_PROJECT_NAME`). For this reason, we use Travis CI to test this role.
### Local tests ###
Prerequisites:
- molecule[docker]
- ansible
- docker
Examples:
```shell
$ MOLECULE_DISTRO=debian11 \
CI_PROJECT_NAME=gitlab-buildpkg-tools \
CI_PAGES_URL=http://orange-opensource.gitlab.io/gitlab-buildpkg-tools \
MOLECULE_PLAYBOOK=playbook-ppa-and-additional.yml molecule test
$ MOLECULE_DISTRO=centos8 \
CI_PROJECT_NAME=gitlab-buildpkg-tools \
CI_PAGES_URL=http://orange-opensource.gitlab.io/gitlab-buildpkg-tools \
MOLECULE_PLAYBOOK=playbook-ppa-and-additional.yml molecule test
```
License
-------
GPL-3.0
Author Information
------------------
Inverse inc