particle-os/debian-koji
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Document supported SCMs

Browse source 
Related: https://pagure.io/koji/issue/4265
This commit is contained in:
Tomas Kopecek 2024-11-26 12:49:17 +01:00
parent af275200ce
commit fd026e7353
1 changed files with 17 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

27
docs/source/server_howto.rst
View file

@ -98,10 +98,10 @@ koji components.
HOME = . HOME = .
RANDFILE = .rand RANDFILE = .rand
[ca] [ca]
default_ca = ca_default default_ca = ca_default
[ca_default] [ca_default]
dir = . dir = .
certs = $dir/certs certs = $dir/certs
crl_dir = $dir/crl crl_dir = $dir/crl
@ -120,7 +120,7 @@ koji components.
preserve = no preserve = no
policy = policy_match policy = policy_match
[policy_match] [policy_match]
countryName = match countryName = match
stateOrProvinceName = match stateOrProvinceName = match
organizationName = match organizationName = match
@ -128,7 +128,7 @@ koji components.
commonName = supplied commonName = supplied
emailAddress = optional emailAddress = optional
[req] [req]
default_bits = 2048 default_bits = 2048
default_keyfile = privkey.pem default_keyfile = privkey.pem
default_md = sha256 default_md = sha256
@ -137,7 +137,7 @@ koji components.
x509_extensions = v3_ca # The extensions to add to the self signed cert x509_extensions = v3_ca # The extensions to add to the self signed cert
string_mask = MASK:0x2002 string_mask = MASK:0x2002
[req_distinguished_name] [req_distinguished_name]
countryName = Country Name (2 letter code) countryName = Country Name (2 letter code)
countryName_default = AT countryName_default = AT
countryName_min = 2 countryName_min = 2
@ -154,19 +154,19 @@ koji components.
emailAddress = Email Address emailAddress = Email Address
emailAddress_max = 64 emailAddress_max = 64
[req_attributes] [req_attributes]
challengePassword = A challenge password challengePassword = A challenge password
challengePassword_min = 4 challengePassword_min = 4
challengePassword_max = 20 challengePassword_max = 20
unstructuredName = An optional company name unstructuredName = An optional company name
[usr_cert] [usr_cert]
basicConstraints = CA:FALSE basicConstraints = CA:FALSE
nsComment = "OpenSSL Generated Certificate" nsComment = "OpenSSL Generated Certificate"
subjectKeyIdentifier = hash subjectKeyIdentifier = hash
authorityKeyIdentifier = keyid,issuer:always authorityKeyIdentifier = keyid,issuer:always
[v3_ca] [v3_ca]
subjectKeyIdentifier = hash subjectKeyIdentifier = hash
authorityKeyIdentifier = keyid:always,issuer:always authorityKeyIdentifier = keyid:always,issuer:always
basicConstraints = CA:true basicConstraints = CA:true
@ -979,7 +979,7 @@ override all these values. So, you can use e.g.
[web] [web]
SiteName = koji SiteName = koji
# KojiTheme = # KojiTheme =
# Necessary urls # Necessary urls
KojiHubURL = https://koji-hub.example.com/kojihub KojiHubURL = https://koji-hub.example.com/kojihub
@ -1220,6 +1220,13 @@ SCM checkout can contain multiple spec files (checkouted or created by
``source_cmd``). In such case spec file named same as a checkout directory will ``source_cmd``). In such case spec file named same as a checkout directory will
be selected. be selected.
Supported SCMs are `git <https://git-scm.com/>`_ (base and over
http/https/rsync), `Subversion <https://subversion.apache.org/>`_ (base and
over http/https) and `CVS <https://www.nongnu.org/cvs/>`_ (base and over ssh).
As CVS is the least used these days, it is now not installed by default on
builders. If you need it, you've to ensure that ``cvs`` binary is available at
the builders.
.. note:: .. note::
We provide ``build_from_scm`` hub policy as an equivalent in version We provide ``build_from_scm`` hub policy as an equivalent in version
@ -1390,4 +1397,4 @@ operating a koji server.
.. _createrepo: http://createrepo.baseurl.org/ .. _createrepo: http://createrepo.baseurl.org/
.. _mock: https://fedoraproject.org/wiki/Mock .. _mock: https://fedoraproject.org/wiki/Mock
.. _Apache mod_ssl documentation: .. _Apache mod_ssl documentation:
https://httpd.apache.org/docs/trunk/mod/mod_ssl.html#ssloptions https://httpd.apache.org/docs/trunk/mod/mod_ssl.html#ssloptions