#2349 doc: dist-repo and exporting repos
Closed 3 years ago by tkopecek. Opened 3 years ago by tkopecek.
tkopecek/koji issue1964  into  master

@@ -0,0 +1,26 @@ 

+ ======================

+ Exporting repositories

+ ======================

+ 

+ There are multiple ways how to export repositories from koji. In first place,

+ koji is not a repository manager - it is a build system. anyway, due to

+ architecture and build logic it know about some repositories, typically those

grammar: it knows

+ needed to populate buildroots. These are stored at

+ ``<topdir>/repos/<tag_name>/<repo_id>`` and can be consumed by builders via

+ http. Of course, other users can download them also. Anyway, these repos are by

+ design not suited for distribution.

+ 

+ Simplest way ho to create distribution-ready repo is to use ``koji dist-repo``

+ command. It allows user with ``dist-repo`` permission (non-default requirements

+ can be specified via :doc:`hub policy <defining_hub_policies>`. ``dist-repo``

+ command takes two basic arguments, where first is the name of the tag, while

+ second is signing key id. You can create also repositories from unsigned rpms by

+ supplying non-sensual signing key and adding ``--allow-missing-signatures``.

+ Further options can tell koji if debuginfo or source rpms are needed, if zck

+ dictionaries or multilib support should be used, etc. Feel free to go through

+ whole ``koji dist-repo --help``.

+ 

+ If you're aiming to have more control about repositories, varieties of

+ distribution flavours, etc. use `pungi <https://pagure.io/pungi/>`_ which can

+ create whole composes and which uses koji for some of the subtasks. Pungi + koji

+ is what Fedora currently uses for composes.

file modified
+1
@@ -27,6 +27,7 @@ 

      external_repo_server_bootstrap

      image_build

      winbuild

+     exporting_repositories

      tag_inheritance

      misc

      release_notes/release_notes

Metadata Update from @tkopecek:
- Pull-request tagged with: doc, no_qe

3 years ago

I started reviewing this and ended up substantially rewriting and expanding. I've filed that as PR #2385

Pull-Request has been closed by tkopecek

3 years ago