Skip to content

Container-enabled role for Ansible to build CODE-RADE containers.

License

Notifications You must be signed in to change notification settings

AAROC/CODE-RADE-container

Repository files navigation

CODE-RADE Build Container

Build Status Maintainability DOI

A somewhat OS-independent role to build CODE-RADE slaves for use in a continuous integration environment, using Ansible-Container.

Tools

This role ensures that an image corresponding to the EGI execution environment is built so that applications can be built against it. The image is used in the continuous integration environment in order to build applications which are subsequently delivered to a CVMFS repository.

Included in the image are:

  • a generic user to execute the builds - jenkins
  • build tools (compilers, testing programs and libraries, etc)
  • a consistent SSH installation built from source to be the same across images

The ssh service is used by the Jenkins server to start the connection to the master, it listens on port 2222, which can be tweaked in the variables. The bare minimum of libraries and dependencies are installed, so as to make the image itself lightweight and ensure that unmet dependencies are not requested in the production environment.

Platform

We try to maintain Dev/Prod parity with EGI infrastructure. This means that we support the following Operating Systems:

  • CEntOS6: Docker Repository on Quay
  • CEntOS7: Docker Repository on Quay
  • Ubuntu 14.04: Docker Repository on Quay
  • Ubuntu 16.04: Docker Repository on Quay

Building

Adds a CODE-RADE build container service to your Ansible Container project. To be used in conjunction with CODE-RADE Build Containers. For galaxy info, see meta/main.yml

Run the following commands
to install the service:

# Set the working directory to your Ansible Container project root
$ cd myproject

# Install the service
$ ansible-container install AAROC.code-rade-build-containers

Testing

The role is tested with molecule across a few well-known scenarios - Docker environments, virtualised environments and cloud installations. Testing is done with TestInfra and checks whether the image is valid for the continuous integration environment:

  • build user exists
  • SSH daemon exists, is properly configured and responds on the required port
  • build, deploy and module directories are present and belong to the correct user

Requirements

  • Ansible Container

  • An existing Ansible Container project. To create a project, simply run the following:

    # Create an empty project directory
    $ mkdir myproject
    
    # Set the working directory to the new directory
    $ cd myproject
    
    # Initialize the project
    $ ansible-contiainer init
    

Role Variables

Variables are all in vars/main.yml :

  • modules_path - The OS-dependent path where environment-modules keeps its base configuration by default.
  • modules - CODE-RADE specific modulefiles ci and deploy which set up the build, test and deploy shells. These contain OS-specific variables, using anisble_os_family
  • module_domains - The domain-specific modulefile paths to which CODE-RADE can write application modulefiles. Contain :
    • astronomy
    • bioinformatics
    • compilers
    • languages
    • libraries
    • physical_sciences
    • hep
    • chemistry
  • prerequisites: OS-specific dependencies that need to be in the build environment in order to execute compilation and tests. Intentionally kept small.

Dependencies

None

License

Apache-2.0

Author Information

Bruce Becker | [email protected] | C.S.I.R. Meraka Institute Africa-Arabia Regional Operations Centre Bruce Becker | [email protected] | EGI Foundation

Citing

If you use this role in an academic or research context, please cite : Bruce Becker. (2017). AAROC/CODE-RADE-container: DevOps for CODE-RADE - Build Container role [Data set]. Zenodo. http://doi.org/10.5281/zenodo.572278