Skip to content

Commit dff68b4

Browse files
committed
updated README
1 parent 1405f3d commit dff68b4

File tree

1 file changed

+9
-14
lines changed

1 file changed

+9
-14
lines changed

ansible/roles/dnf_repos/README.md

Lines changed: 9 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,42 +1,37 @@
11
dnf_repos
22
=========
33

4-
Modifies repo definitions for repofiles in `/etc/yum.repos.d` to point to snapshots in StackHPC's Ark Pulp server.
4+
Modifies repo definitions for repofiles in `/etc/yum.repos.d` to point to snapshots in StackHPC's Ark Pulp server or mirrors of them
5+
on a local Pulp server.
56

67
Requirements
78
------------
89

9-
Requires Ark credentials.
10+
Requires Ark credentials if using StackHPC's upstream Ark server.
1011

1112
Role Variables
1213
--------------
1314

1415
Variables in this role are also required by `pulp_site` so set in
1516
`environments/common/inventory/groups_vars/all/dnf_repos.yml`. See that file for detailed default values.
1617

17-
- `dnf_repos_all`: Dict of dicts containing information to construct URLs for timestamped repos from Ark for each Rocky version. For example:
18+
- `dnf_repos_repos`: Dict of dicts containing information to construct URLs for Ark snapshots from the target Pulp server for each Rocky version. For example:
1819
```
19-
dnf_repos_all:
20+
dnf_repos_repos:
2021
appstream: # ansible.builtin.yum_repository:name
2122
'8.10': # ansible_distribution_version or ansible_distribution_major_version
2223
repo_file: Rocky-AppStream # yum_repository: file
2324
# repo_name: # optional, override yum_repository:name
24-
pulp_path: rocky/8.10/AppStream/x86_64/os
25+
pulp_path: rocky/8.10/AppStream/x86_64/os # The subpath of the the upstream Ark server's content endpoint URL for the repo's snapshots, see https://ark.stackhpc.com/pulp/content/
2526
pulp_timestamp: 20250614T013846
2627
# pulp_content_url: # optional, dnf_repos_pulp_content_url
2728
'9.6':
2829
...
2930
```
30-
- `dnf_repos_default`: Appliance default repos to use Ark snapshots for. Follows same format as
31-
`dnf_repos_all`, but includes top level keys to allow repos to be conditionally included in
32-
`dnf_repos_all`. See `environments/common/inventory/group_vars/all/dnf_repos.yml` and
33-
`environments/common/inventory/group_vars/all/timestamps.yml` for full templating logic.
31+
- `dnf_repos_default`: Appliance default repos to use Ark snapshots for. Following same format as `dnf_repos_repos`.
32+
See for appliance default repo list `environments/common/inventory/group_vars/all/timestamps.yml`.
3433
- `dnf_repos_extra`: Additional repos to use Ark snapshots for. Follows same format as
35-
`dnf_repos_all`. Defaults to `{}`
36-
- `dnf_repos_no_epel`: Dict of all repos included in `dnf_repos_all` excluding
37-
`epel`, used to prevent conflicts with repofile installed by `epel-release`
38-
- `dnf_repos_default_epel`: Dict of repos objects following same format as `dnf_repos_all` but only
39-
including `epel` repo.
34+
`dnf_repos_repos`. Defaults to `{}`
4035
- `dnf_repos_pulp_content_url`: Optional str. Content URL of Pulp server to use Ark snapshots from.
4136
Defaults to `{{ appliances_pulp_url }}/pulp/content`
4237
- `dnf_repos_username`: Optional str. Username for Ark. Should be set if using upstream StackHPC Ark

0 commit comments

Comments
 (0)