# Control files for CBS ↔ repositories synchronization

This repository contains control files for the synchronization process
between CBS tags and RPM repositories.

The general syntax of these files follows this convention ([wiki][sync-legend-wiki]):

    <tag>|<destination path>|<dir to run createrepo in>|<destination on mirror.centos.org>

Example:

    cloud7-openstack-rocky-release/|7/cloud/x86_64/openstack-rocky/|7/cloud/x86_64/openstack-rocky/|7/cloud/x86_64/openstack-rocky/
    cloud7-openstack-rocky-release/|7/cloud/ppc64le/openstack-rocky/|7/cloud/ppc64le/openstack-rocky/|7/cloud/ppc64le/openstack-rocky/

## Running the lint tool

Included in the root of this repository is a lint tool to check the files for
common errors. Please run this tool before submitting a pull-request. This tool
requires python2

### Check a single file
```
$ ./cclint sign_list
```

### Check all files
```
$ ./cclint
```

[sync-legend-wiki]: https://wiki.centos.org/SIGGuide/Content/Mirror "Steps to request space on the mirror network"

## Buildlogs synchronization

The file in control of buildlogs synchronization is `buildlogs_list`.
As stated at the top of that file, it is universal for all architectures
– the synchronization script will automatically substitute `aarch64`/`ppc64le`
for `x86_64` for any tags that have content on the respective architecture.

## Mirrors synchronization

The synchronization to mirrors is controlled by architecture-specific `sign_list` file:

<table>
  <thead>
    <tr><th>File name</th><th>Architecture</th></tr>
  </thead>
  <tbody>
    <tr><td><code>sign_list</code></td><td>x86_64</td></tr>
    <tr><td><code>sign_list.aarch64</code></td><td>aarch64</td></tr>
    <tr><td><code>sign_list.ppc64le</code></td><td>ppc64le</td></tr>
  </tbody>
</table>