smeserver-koji/README.md
2023-09-11 17:03:34 +10:00

76 lines
3.1 KiB
Markdown

# ![smeserver-koji](https://www.koozali.org/images/koozali/Logo/Png/Koozali_logo_2016.png)
## 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)
* Koji builder can exist on the hub or multiple build servers
### Installing
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.
* info for your ssl certs (Country, State, City, Org, Org Unit)
* If you don't supply build=\<FQDN\> parameters, for each build server:
* enter the FQDN for the build server
* accept the ECDSA key fingerprint of the build server
* enter the root password for the build server
If you add debug on the install-koji-farm.sh line it will print each command executed and be very noisy (still noisy without)
On your koji hub server:
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.sh
There are optional parameters available on the install-koji-farm.sh script
install-koji-farm.sh [web=<web server FQDN> | build=<build server FQDN> | debug]
* The web server FQDN defaults to the hub FQDN, if not enetered.
* You can have multiple build= parameters (up to 7 parameters in total). This will bypass the build server prompt loop.
* If you enter build=\<hub FQDN\> you will get an all-in-one server with the builder installed on the hub.
The web interface will be available at http://\<web FQDN\>/koji
### Adding additional Build servers
To add additional build servers into your farm, just run the following script on your hub as root
koji-add-builder.sh <FQDN of new build server> [debug]
It should already be there from the install, but if not
curl https://src.koozali.org/smedev/smeserver-koji/raw/branch/master/koji-setup/koji-add-builder.sh > ~/bin/koji-add-builder.sh
chmod o+x ~/bin/koji-add-builder.sh
### Adding Users
You can add Users for both the CLI and Web
koji-add-user <User Name> [ permisssion=<permissions> | debug ]
This will add them into the db and generate ssl CLI and browser keys, which will be bundled up in a tgz file at /etc/pki/koji/bundle/koji-\<User Name\>-bundle.tgz.
This bundle should be extracted in their home (~) directory and will create a .koji directory with config and keys.
cd ~
tar -zxf koji-\<User Name\>-bundle.tgz
### Other components
The other scripts in the repository are used by the install-koji-farm.sh and koji-add-builder.sh scripts or I'm still experimenting with them :)