summaryrefslogtreecommitdiffstats
path: root/roles/yum_repos/README.md
blob: 908ab49725ee6f3346d374acb33c1fdd3e761133 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
Yum Repos
=========

This role allows easy deployment of yum repository config files.

Requirements
------------

Yum or dnf

Role Variables
--------------

| Name              | Default value |                                            |
|-------------------|---------------|--------------------------------------------|
| repo_files        | None          |                                            |
| repo_enabled      | 1             | Should repos be enabled by default         |
| repo_gpgcheck     | 1             | Should repo gpgcheck be enabled by default |

Dependencies
------------

Example Playbook
----------------

A single repo file containing a single repo:
  - hosts: servers
    roles:
    - role: yum_repos
      repo_files:
      - id: my_repo
        repos:
        - id: my_repo
          name: My Awesome Repo
          baseurl: https://my.awesome.repo/is/available/here
          skip_if_unavailable: yes
	  gpgkey: https://my.awesome.repo/pubkey.gpg
        
A single repo file containing a single repo, disabling gpgcheck
  - hosts: servers
    roles:
    - role: yum_repos
      repo_files:
      - id: my_other_repo
        repos:
        - id: my_other_repo
          name: My Other Awesome Repo
          baseurl: https://my.other.awesome.repo/is/available/here
          gpgcheck: no

A single repo file containing a single disabled repo
  - hosts: servers
    roles:
    - role: yum_repos
      repo_files:
      - id: my_other_repo
        repos:
        - id: my_other_repo
          name: My Other Awesome Repo
          baseurl: https://my.other.awesome.repo/is/available/here
          enabled: no

A single repo file containing multiple repos
  - hosts: servers
    roles:
    - role: yum_repos
      repo_files:
        id: my_repos
        repos:
        - id: my_repo
          name: My Awesome Repo
          baseurl: https://my.awesome.repo/is/available/here
	  gpgkey: https://my.awesome.repo/pubkey.gpg
        - id: my_other_repo
          name: My Other Awesome Repo
          baseurl: https://my.other.awesome.repo/is/available/here
          gpgkey: https://my.other.awesome.repo/pubkey.gpg

Multiple repo files containing multiple repos
  - hosts: servers
    roles:
    - role: yum_repos
      repo_files:
      - id: my_repos
        repos:
          - id: my_repo
            name: My Awesome Repo
            baseurl: https://my.awesome.repo/is/available/here
	    gpgkey: https://my.awesome.repo/pubkey.gpg
          - id: my_other_repo
            name: My Other Awesome Repo
            baseurl: https://my.other.awesome.repo/is/available/here
	    gpgkey: https://my.other.awesome.repo/pubkey.gpg
      - id: joes_repos
        repos:
          - id: joes_repo
            name: Joe's Less Awesome Repo
            baseurl: https://joes.repo/is/here
	    gpgkey: https://joes.repo/pubkey.gpg
          - id: joes_otherrepo
            name: Joe's Other Less Awesome Repo
            baseurl: https://joes.repo/is/there
	    gpgkey: https://joes.repo/pubkey.gpg
 
License
-------

ASL 2.0

Author Information
------------------

openshift online operations