smeserver-koji/README.md
2023-09-01 15:52:30 +10:00

3.7 KiB

smeserver-koji

Koji Setup Scripts

The purpose of these scripts it to enable setting up a koji environment quickly with reasonable configurations.

These scripts have been borrowed from Clear Linux and modified to suit the smeserver (Koozali.org) setup. Thanks to George T Kramer for doing a lot of the prework for these over at ClearLinux.

Assumptions

  • All scripts are run as the root user
  • The root user has a password set
  • These are run on a bare Rocky 8 minimal install
  • Basic configurations (e.g. network, time, etc.) have been applied
  • servers are reachable by their FQDNs (DNS or you've added them into the appropriate /etc/hosts files)
  • Only one koji builder is required

Getting Going

The install script will install all required components on the hub and build servers. You will need to fill in some information on the way through If you add debug on the install-koji-farm.sh line it will print each command executed (still noisy without)

    curl https://src.koozali.org/smedev/smeserver-koji/raw/branch/master/install-koji-farm.sh > install-koji-farm.sh
    chmod o+x install-koji-farm.sh
    ./install-koji-farm

Using the scripts yourself

The install script now does all of this, but, if you want to do individual components, or understand the process better...

  1. On the koji hub, copy these scripts into your ~/bin directory and make sure they are executeable

     mkdir -p ~/bin
     curl https://src.koozali.org/smedev/smeserver-koji/raw/branch/master/koji-setup/gencert.sh > ~/bin/gencert.sh
     curl https://src.koozali.org/smedev/smeserver-koji/raw/branch/master/koji-setup/globals.sh > ~/bin/globals.sh
     curl https://src.koozali.org/smedev/smeserver-koji/raw/branch/master/koji-setup/parameters.sh > ~/bin/parameters.sh
     curl https://src.koozali.org/smedev/smeserver-koji/raw/branch/master/koji-setup/deploy-koji.sh > ~/bin/deploy-koji.sh
     curl https://src.koozali.org/smedev/smeserver-koji/raw/branch/master/koji-setup/bootstrap-build.sh > ~/bin/bootstrap-build.sh
     curl https://src.koozali.org/smedev/smeserver-koji/raw/branch/master/koji-setup/deploy-koji-nfs-server.sh > ~/bin/deploy-koji-nfs-server.sh
     chmod a+x ~/bin/*.sh
    
  2. Edit parameters.sh as needed. If running in a production environment, be sure to supply reasonable SSL certificate field values.

  3. Run the required following scripts

     deploy-koji.sh
    

If koji builder machine is not the same as koji master machine:

  1. On the koji master, run

     deploy-koji-nfs-server.sh
    
  2. On the koji builder, copy over keys and parameters from the Hub

     mkdir -p /etc/pki/koji
     scp root@<FQDN of koji hub>:/etc/pki/koji/<FQDN of builder>.pem /etc/pki/koji/.
     scp root@<FQDN of koji hub>:/etc/pki/koji/koji_ca_cert.crt /etc/pki/koji/.
     mkdir -p ~/bin
     scp root@<FQDN of koji hub>:/root/bin/globals.sh ~/bin/.
     scp root@<FQDN of koji hub>:/root/bin/parameters.sh ~/bin/.
     You will need to edir ~/bin/parameters.sh and change the KOJI_HUB_FQN to the correct value (NOT $(hostname -f))
    
  3. On the koji builder, copy down the scripts needed and run

     curl https://src.koozali.org/smedev/smeserver-koji/raw/branch/master/koji-setup/deploy-koji-nfs-client.sh > ~/bin/deploy-koji-nfs-client.sh
     curl https://src.koozali.org/smedev/smeserver-koji/raw/branch/master/koji-setup/deploy-koji-builder.sh > ~/bin/deploy-koji-builder.sh
     chmod a+x ~/bin/*.sh
     deploy-koji-nfs-client.sh
     deploy-koji-builder.sh
    
  4. Return to the hub and run (this isn't right yet....)

     bootstrap-build.sh