tree: 539a78c418e6b7c2c6d042f8c2444a6554c1d885 [path history] [tgz]
  1. .reuse/
  2. LICENSES/
  3. Makefile
  4. README.md
  5. VERSION
  6. defaults/
  7. handlers/
  8. meta/
  9. molecule/
  10. tasks/
  11. vars/
README.md

devtools

This role installs tools for development on CI systems

This is used against the following types of systems:

  • Physical machines
  • Virtual machines (both cloud and on-prem)
  • Docker containers

There are two sets of installed, one common set, and optional extended sets of tools.

The default sets of tools are specified in the tasks/main.yml and tasks/Debian.yml. This contains basic development tools (git, make, python, repo, etc.) that are frequently used.

The extended set of tools is dynamic and customizable, for projects that have individual tool requirements. These additional tools are specified using the devtools_install list which is loaded from tasks/main.yml. This list specifies filenames in the tasks/ directory.

Adding a new development tool

If you have a new tool (or set of tools) named example:

  1. Create a task file tasks/example.yml

  2. Add plays to the file to perform tool installation.

    If required, add versions, download URLs, and SHA256 checksums for downloaded files to the defaults/main.yml. Prefix these variables with devtools_example_

  3. Add Molecule tests for the tool to verify that it functions:

    a. Add the installation to the devtools_install list in molecule/default/converge.yml

    b. Add tests tomolecule/default/verify.yml that checks that the tools will function correctly - mostly this would be running some variant of printing the version, ie: example --version or similar, and verifying the version number.

Note that some tools that have more complicated installations, and in those cases a separate role should be created. One example of a more complicated tool that has it's own role is Docker, which requires a GPG key and apt repo, installs multiple tools, customizes it's configuration file, and so on.

Example Playbook

- hosts: all
  vars:
    devtools_install:
      - k8s
      - terraform
      - yq
  roles:
    - devtools

License and Author

Copyright 2022 Open Networking Foundation support@opennetworking.org

License: Apache-2.0