Managing COPR Repositories

Overview

Each PKI branch that is actively maintained should have a corresponding COPR repository. When a new PKI branch is created from another branch, a new COPR repository should be forked from the COPR repository corresponding to the original branch.

+ master
  + v11.2
  + v11.1
  + v11.0
+ v10
  + v10.12
  + v10.11

For example, below is the process to create a new @pki/11.2 repository for v11.2 branch in PKI. The repository should be forked from an existing @pki/master repository. v10.x repositories should be forked from v10 repository.

Creating New Repository

To create the repository using Web UI, open the @pki/master repository and click Fork this project. Change the Fork owner to @pki and Fork name to 11.2, then click Fork it.

To create the repository using CLI:

$ copr fork @pki/master @pki/11.2

Updating Packages

To update the packages using Web UI, go to Packages in @pki/11.2 repository and change the Committish of pki package to v11.2. Change the Committish of other packages as well if necessary.

To update the packages using CLI:

$ copr edit-package-scm \
    --name jss \
    --clone-url https://github.com/dogtagpki/jss.git \
    --commit v5.2 \
    --method make_srpm \
    --webhook-rebuild on \
    @pki/11.2
$ copr edit-package-scm \
    --name tomcatjss \
    --clone-url https://github.com/dogtagpki/tomcatjss.git \
    --commit v8.2 \
    --method make_srpm \
    --webhook-rebuild on \
    @pki/11.2
$ copr edit-package-scm \
    --name ldapjdk \
    --clone-url https://github.com/dogtagpki/ldap-sdk.git \
    --commit v5.2 \
    --method make_srpm \
    --webhook-rebuild on \
    @pki/11.2
$ copr edit-package-scm \
    --name idm-console-framework \
    --clone-url https://github.com/dogtagpki/idm-console-framework.git \
    --commit v2.0 \
    --method make_srpm \
    --webhook-rebuild on \
    @pki/11.2
$ copr edit-package-scm \
    --name pki \
    --clone-url https://github.com/dogtagpki/pki.git \
    --commit v11.2 \
    --method make_srpm \
    --webhook-rebuild on \
    @pki/11.2

Building Packages

To build the packages:

$ copr build-package --name jss --nowait @pki/11.2
$ copr build-package --name tomcatjss --nowait @pki/11.2
$ copr build-package --name ldapjdk --nowait @pki/11.2
$ copr build-package --name idm-console-framework --nowait @pki/11.2
$ copr build-package --name pki --nowait @pki/11.2

Configuring Webhooks

Go to Settings → Integrations, copy the Webhook URL for GitHub, append ?id=@pki/11.2 to the URL to make it easier to identify, then add the URL to each GitHub project.