tripleo-quickstart-extras/roles/repo-setup
Harry Rybacki ce7982192f Integrate undercloud_user var into oooq-extras
We need to differentiate local_working_dir from working_dir
as well as decouple the stack user from `ansible_user` var.
Both of these are causing issues as we begin to automate
deployments in more environments.

- Cleanup duplicate variables that are consumed via extras-common
  - Note: extras-common depends on the common role in OOOQ
- Cleanup redundant var and superfluous quotes from overcloud-scale
  role
- Cleanup redundant comments in <role>/defaults/main.yml

Closes-bug: 1654574
Change-Id: I9c7a3166ed1fc5042c11e420223134ea912b45c5
2017-01-18 09:32:16 -05:00
..
defaults Integrate undercloud_user var into oooq-extras 2017-01-18 09:32:16 -05:00
meta Integrate undercloud_user var into oooq-extras 2017-01-18 09:32:16 -05:00
tasks Repositories setup role 2016-12-19 16:50:57 +02:00
templates repo_setup: Add sudo to specific commands for non-root running 2017-01-06 05:46:24 +00:00
README.md Repositories setup role 2016-12-19 16:50:57 +02:00

README.md

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: false/true - whether to run yum update after repositories are set up (default: true)

  • repo_cmd_after: false/true - whether to include Ceph repositories (default: true)

  • 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 support shortcut for all stable releases - '{{ stable }}'

    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 delorean 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

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: http://buildlogs.centos.org/centos/7/cloud/x86_64/rdo-trunk-master-tripleo/
        hash_url: http://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: http://trunk.rdoproject.org/centos7/current
        hash_url: http://trunk.rdoproject.org/centos7/current/delorean.repo
        priority: 10
        includepkgs:
          - diskimage-builder
          - instack
          - instack-undercloud
          - os-apply-config
          - os-cloud-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-puppet-modules
          - openstack-tripleo-ui
          - puppet-*
        releases:
          - master

      # In case of all releases
      - type: file
        filename: delorean-deps.repo
        down_url: http://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