This is a detailed documentation for the downstream sync functionality of packit. The command creates a new pull request in upstream repository using a selected branch (main by default) from Fedora dist-git repository.
- Fedora dist-git repository.
- Packit config file placed in the upstream repository.
- Pagure API tokens for Fedora Dist-git.
- GitHub API token.
- Starting with packit 0.5.2 and later, you only need to set a single token to
interact with dist-git. You needed two in the past. Please populate your
local config at
~/.config/packit.yamlfor packit so it can talk to the remote services:
# you can obtain the token over here: https://github.com/settings/tokens github_token: 123 # and this one right here: https://src.fedoraproject.org/settings#nav-api-tab pagure_user_token: 456
The files which are synced are listed in
Once you want to sync Fedora dist-git repo into the upstream repo, run
packit sync-from-downstreamin a working directory of your upstream repository:
$ git clone https://github.com/user-cont/colin.git $ cd colin $ packit sync-from-downstream upstream active branch master Cloning repo: https://src.fedoraproject.org/rpms/colin.git -> /tmp/tmph9npe78e using master dist-git branch syncing /tmp/tmph9npe78e/colin.spec PR created: https://api.github.com/repos/phracek/colin/pulls/3
packit sync-from-downstream –help #
Usage: packit sync-from-downstream [OPTIONS] [PATH_OR_URL] Copy synced files from Fedora dist-git into upstream by opening a pull request. PATH_OR_URL argument is a local path or a URL to the upstream git repository, it defaults to the current working directory Options: --dist-git-branch TEXT Comma separated list of target branches in dist-git to sync from. (defaults to repo's default branch) --upstream-branch TEXT Target branch in upstream to sync to. (defaults to repo's default branch) --no-pr Do not create a pull request to upstream repository. --fork / --no-fork Push to a fork before creating a pull request. --remote-to-push TEXT Name of the remote where packit should push. If this is not specified, push to a fork if the repo can be forked. -f, --force Don't discard changes in the git repo by default, unless this is set. -x, --exclude TEXT File to exclude from sync -h, --help Show this message and exit.