almalinux-git-utils/README.md

1.6 KiB

almalinux-git-utils

Utilities for working with the AlmaLinux OS Git server.

alma_blob_upload

The alma_blob_upload script uploads sources and BLOBs to the AlmaLinux sources cache.

Prerequirements

Install the python3-boto3 package:

# RPM-based distributions. On EL8 derivatives the package is available from EPEL.
$ sudo dnf install python3 python3-boto3

# Debian-based distributions
$ sudo apt install python3-boto3

Create an AWS credentials file ~/.aws/credentials with the following content:

[default]
aws_access_key_id = YOUR_ACCESS_KEY
aws_secret_access_key = YOUR_SECRET_KEY

Usage

The utility supports two types of input: a CentOS git repository metadata file or a list of files to upload.

For CentOS repositories workflow will be the following:

  1. Install the get_sources.sh script from the centos-git-common repository.
  2. Clone a project and download its sources as described on the CentOS Wiki.
  3. Run the alma_blob_upload tool (don't forget to replace PROJECT_NAME with an actual project name):
    $ alma_blob_upload.py -i .PROJECT_NAME.metadata
    

Alternatively, you can upload a list of files in the following way:

$ alma_blob_upload.py -f SOURCES/FILE_1 SOURCES/FILE_N

The alma_blob_upload utility can also generate a CentOS-compatible metadata file:

$ alma_blob_upload.py -o .PROJECT_NAME.metadata -f SOURCES/FILE_1 SOURCES/FILE_N

License

Licensed under the GPLv3 license, see the LICENSE file for details.