arc/docs/dist-git-move/fedpkg.rst
Michal Konecny c32a2c64a6 Fix small errors in dist-git investigation
Found some small issues and typos in investigation.

Remove the link to fedora-scm-requests as this guide is not used anymore.
2023-11-22 15:28:35 +00:00

55 lines
1.6 KiB
ReStructuredText

.. _fedpkg:
Pagure Dist Git Interactions With fedpkg
========================================
`Fedpkg <https://pagure.io/fedpkg>`__ is a CLI tool for packagers that allows them to
work with packages in Fedora package workflow.
Possible Interactions
---------------------
The following are a set of documented interactions possible between Pagure Dist Git and
fedpkg.
Lookaside cache
~~~~~~~~~~~~~~~
- fedpkg is using lookaside cache that is located on same server as dist git
https://src.fedoraproject.org/repo/pkgs
API calls
~~~~~~~~~
- Fedpkg is calling dist git API endpoint ``api/0/fork`` when creating fork of the
project.
- Fedpkg is calling dist git API endpoint ``_dg/anitya/<namespace>/<package_name>`` for
disabling monitoring for repository.
Git interactions
~~~~~~~~~~~~~~~~
- Fedpkg works with cloned dist git repositories using standard git commands.
Changes proposed
----------------
In order to switch out Pagure Dist Git for an alternative that provides a relatively
compatible API pattern, the following changes must be made in the places mentioned
below.
Necessary
~~~~~~~~~
- In case URL will be changed default configuration distributed with fedpkg RPM package
needs to be updated.
- `fedpkg.conf <https://pagure.io/fedpkg/blob/master/f/conf/etc/rpkg/fedpkg.conf>`_
for production fedpkg
- `fedpkg-stage.conf
<https://pagure.io/fedpkg/blob/master/f/conf/etc/rpkg/fedpkg-stage.conf>`_ for
staging fedpkg
- The lookaside cache needs to be still available. In case the location will be
different some changes will be needed with working the lookaside cache in fedpkg as
currently it expects the URL is same as for dist git.