tripleo-quickstart/roles/repo-setup

tripleo-repo-setup

Set up yum repositories on host or in image This Ansible role allows setting up repositories on a live host or within an image.

Requirements

libguestfs-tools-c package is required in case of injecting repositories into an image.

Role Variables

• repo_setup_script - path to repositories setup script template

• repo_setup_log - path to repositories setup script log

• repo_run_live: false/true - where to run repo setup script on host (live host that playbook runs on it) (default: true)

• repo_inject_image_path - path to image, in case of injecting repositories into the image (default: not defined)

• repo_cmd_before: - shell commands to run before repos setup

• repo_cmd_after: - shell commands to run after repos setup

• libvirt_uri - URI of libvirt in case of using virt-customize to inject repos into the image

• repos - dictionary or repositories to set, the keys are explained below:

• repos.type - file / generic / package / rpm_url

• repos.releases - for which releases to set up this repo, if not defined - for all releases. It supports shortcut for all stable releases - '{{ stable }}'

• add_repos - dictionary of additional repositories to add, could be populated in code, by default is empty. Note that this dictionary will be constructed in the same manner as a typical repos dictionary. See examples below.

  File

  Just download the repo file from URL and change some of its parameters if required.

  • repos.filename - filename for saving the downloaded file
  • repos.down_url - URL to download repo file from
  • repos.priority - change priority of this repo (default: not defined)

  Generic

  Construct repository file from various parameters and use parameters from downloaded file if required (for example DLRN hash).

  • repos.filename - filename for saving the resulting repo (mandatory)
  • repos.reponame - name of repository (mandatory)
  • repos.baseurl - base URL of the repository (mandatory)
  • repos.hash_url - URL of repo file in network, used for extracting trunk hash (optional)
  • repos.priority - priority of resulting repo (optional)
  • repos.includepkgs - includepkgs parameter of resulting repo (use this repo only for these packages) (optional)
  • repos.enabled - 0/1 whether the repo is enabled or not (default: 1 - enabled)
  • repos.gpgcheck - whether to check GPG keys for repo (default: 0 - don't check)

  Package

  Install repository from package

  • repos.pkg_name - package name (should be available in the installed repositories)
  • repos.custom_cmd - custom command to install this package (default: 'yum install -y')
  • repos.pkg_url - direct URL of the package to install

  RHSM

  Setup the yum repositories with Red Hat Subscription Manager, https://access.redhat.com/

  • use_rhsm: - boolean to turn rhsm public repos on or off, this by default is false.
  • rhsm_username: - rhsm username
  • rhsm_password: rhsm password
  • pool_id: The subscription manager pool id with RHOSP entilements
  • rhel_version_number: The major version of RHEL
  • osp_release_version_number: The major version of RHOSP
  • rhceph_version_number: The version of RHCeph
  • rhsm_repos: a yaml list of yum repos that should be enabled via subscription manager, an example config is in config/release/rhos-11-rhn-baseos-undercloud.yml

Dependencies

No dependencies

Example Playbook

Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:

---
- name:  Run repo setup
  hosts: undercloud
  gather_facts: no
  roles:
    - repo-setup

Settings example for repositories:

  repos:
      # Just download file
      - type: file
        filename: delorean.repo
        down_url: https://trunk.rdoproject.org/centos7-{{ release }}/current/delorean.repo

      # In case of stable release
      - type: generic
        reponame: delorean
        filename: delorean.repo
        baseurl: https://trunk.rdoproject.org/centos7-{{ release }}/current/
        hash_url: https://trunk.rdoproject.org/centos7-{{ release }}/current/delorean.repo
        priority: 20
        releases: "{{ stable }}"

      # In case of master
      - type: generic
        reponame: delorean
        filename: delorean.repo
        baseurl: https://buildlogs.centos.org/centos/7/cloud/x86_64/rdo-trunk-master-tripleo/
        hash_url: https://buildlogs.centos.org/centos/7/cloud/x86_64/rdo-trunk-master-tripleo/delorean.repo
        priority: 20
        releases:
          - master

      # In case of master
      - type: generic
        reponame: delorean-current
        filename: delorean-current.repo
        baseurl: https://trunk.rdoproject.org/centos7/current
        hash_url: https://trunk.rdoproject.org/centos7/current/delorean.repo
        priority: 10
        includepkgs:
          - diskimage-builder
          - instack
          - instack-undercloud
          - os-apply-config
          - os-collect-config
          - os-net-config
          - os-refresh-config
          - python-tripleoclient
          - openstack-tripleo-common
          - openstack-tripleo-heat-templates
          - openstack-tripleo-image-elements
          - openstack-tripleo
          - openstack-tripleo-puppet-elements
          - openstack-tripleo-ui
          - puppet-*
        releases:
          - master

      # In case of all releases
      - type: file
        filename: delorean-deps.repo
        down_url: https://trunk.rdoproject.org/centos7-{{ release }}/delorean-deps.repo
        priority: 30

      - type: package
        pkg_name: centos-release-ceph-hammer
        custom_cmd: 'yum install -y --enablerepo=extras'
        releases:
          - liberty
          - mitaka

      - type: package
        pkg_name: centos-release-ceph-jewel
        custom_cmd: 'yum install -y --enablerepo=extras'
        releases:
          - newton
          - master

      - type: package
        pkg_url: https://rdoproject.org/repos/openstack-{{ release }}/rdo-release-{{ release }}.rpm
        releases:
          - newton

License

Apache 2.0

Author Information

RDO-CI Team