gregory/docs/config-reference.md

Config Reference

• Config location: gregory.yml
• Example: see gregory.example.yml

Note: This primarily uses LibreWolf and Fedora as examples of packages and distros. Also note that rather than separating by what distro, you can instead use those field to define which repo.

Top-level config

• log-level: Log level 0-3 (error, warning, info, or debug)
• max-threads: The maximum number of threads to be used
  • See also: threads
• max-jobs: The maximum number of jobs to be run at once

Multithreading notes (IMPORTANT): Gregory will first run compilation jobs, then packaging jobs for whatever programs are done, then run the update-repo for whichever distros are finished. For this reason, the distro names listed under packaging and update-repo must match.

Job config

• threads: The maximum number of vCPUs/threads to dedicate to a job; this can be a fractional number
  • Set this as less than or equal to the max number of threads the thing you're running will use
  • See --cpus in the podman run docs
  • Root may be required for this argument
  • If not specified, it will fall back to max-threads
• image: The Docker image to run the job in
• commands: The commands to run
  • TODO: Add command file/bash script instead
• volumes: Names of volumes as defined in volumes (top level)

Packages (packages)

Example:

packages:
  librewolf:
    compilation:
      image: 'debian'
      commands:
        - './mach build'
    
    packaging:
      fedora:
        image: 'lesbi-oops-i-mean/debian'
        commands:
          - './lesbiab package thingy'

Compilation (optional)

Defines the compilation of a program, if applicable. Stuff like Python scripts can skip this.

It's defined in this format:

packages:
  pkgname:
    compilation:
      image: 'fedora'
      commands:
        - 'echo hi'

  other-package:
    compilation:
      job-details-go-here:

Packaging

Defines the packaging of a program into stuff like .deb or .rpm files.

Example:

packages:
  pkgname:
    packaging:
      distro-name:
        image: 'fedora'
        commands:
          - 'echo hi'
  
  other-package:
    packaging:
      distro-name:
        job-details-go-here:

Replace distro-name with the name of a distro, like fedora or debian

Update repo (update-repo)

Defines how to update a repo.

Example:

update-repo:
  distro-name:
    image: 'fedora'
    command:
      - 'echo hi'

Volumes

Lists a volume in Docker's volume format, to be used in job configs

volumes:
  librewolf: './local/path:/path/in/container'