Overview#

PKI Theme source package is located at https://src.fedoraproject.org/rpms/dogtag-pki-theme.

Getting PKI Theme Source Package#

To get the source package:

$ fedpkg clone dogtag-pki-theme ``\ ``Fedora/dogtag-pki-theme

The above command will create a new Fedora/dogtag-pki-theme folder.

To add a forked repository:

$ cd Fedora/dogtag-pki-theme
$ git remote add ``\ `` ``\ ```ssh:// <ssh://>`__@pkgs.fedoraproject.org/forks//rpms/dogtag-pki-theme.git

Updating PKI Theme Package#

Creating Source Tarball from Current Directory#

To create a source tarball from the current directory:

$ cd pki
$ tar cvzf pki-10.6.0.tar.gz \
 --transform 's,^./,pki-10.6.0/,' \
 --exclude .git \
 --exclude .svn \
 --exclude .swp \
 --exclude .metadata \
 --exclude build \
 --exclude .tox \
 --exclude dist \
 --exclude MANIFEST \
 --exclude *.pyc \
 --exclude __pycache__ \
 .
$ mv pki-10.6.0.tar.gz ../Fedora/dogtag-pki-theme

Note: Since the tar command will include all files by default, a number of exclusions needs to be specified. Because of that, this should only be used for development, not for the official build.

Creating Source Tarball from Git Repository#

To create a source tarball from Git repository:

$ cd pki
$ git archive \
 --format=tar.gz \
 --prefix pki-10.6.0/ \
 -o pki-10.6.0.tar.gz \
 -v \
 HEAD
$ mv pki-10.6.0.tar.gz ../Fedora/dogtag-pki-theme

Note: Since the git archive command will only include files already in Git repository, any changes will have to be committed first. Because of that, this procedure can be used for the official build.

Downloading Source Tarball from GitHub#

Source tarball and patch files can be downloaded directly from GitHub, for example:

Updating Source Checksum#

To update the source checksum:

$ cd Fedora/dogtag-pki-theme
$ sha512sum --tag pki-10.6.0.tar.gz > sources

The sources file should contain something like this:

SHA512 (pki-10.6.0.tar.gz) = b3fc3f78e7d4a34e378a5b2b985218aa8157248483fb86da8e94f014b4de62561eb37b213d0c5215bad547296f0305f28c3ff1131b20aec1bf13459fee20bdbc

Merging RPM Spec Changes#

Changes in RPM spec file template needs to be merged with the actual RPM spec file. Use a visual merge tools such as Meld or Diffuse.

$ meld specs/dogtag-pki-theme.spec.in ../Fedora/dogtag-pki-theme/dogtag-pki-theme.spec

Building PKI Console Package#

Creating Local Build#

To create a local build:

$ fedpkg local

Creating SRPM#

To create an SRPM:

$ fedpkg srpm

Creating Mock Build#

To create Mock build:

$ fedpkg mockbuild --root fedora-rawhide-x86_64

Creating COPR Build#

To create a COPR build for all platforms:

$ fedpkg copr-build @pki/10.6

To create a COPR build for certain platforms only, create an SRPM, then execute the following command:

$ copr build @pki/10.6 <SRPM> \
  -r fedora-27-x86_64 \
  -r fedora-28-x86_64 \
  -r fedora-rawhide-x86_64

Creating Koji Build#

To upload new sources:

$ fedpkg new-sources pki-10.6.0.tar.gz

This will update sources and .gitignore.

To commit and push the changes:

$ git commit
$ git push origin <branch>

Except for rawhide, create BuildRoot overrides for unpublished dependencies, for example:

$ bodhi overrides save pki-core-10.6.0-0.2.fc28
$ koji wait-repo f28-build --build=pki-core-10.6.0-0.2.fc28

To create a scratch build:

$ fedpkg scratch-build

To create an official build:

$ fedpkg build

References#