From 9f763eec76491294bfaa27217aa6c100c60a7dfe Mon Sep 17 00:00:00 2001 From: Paul W. Frields Date: Apr 11 2018 13:03:49 +0000 Subject: Add independent doc for client setup Signed-off-by: Paul W. Frields --- diff --git a/content/en-US/packaging_setup.adoc b/content/en-US/packaging_setup.adoc new file mode 100644 index 0000000..f7049f2 --- /dev/null +++ b/content/en-US/packaging_setup.adoc @@ -0,0 +1,50 @@ += How do I setup my system for packaging work? + +All the tools you need to do packaging work in Fedora are freely available through the official Fedora repositories. + + +[[install-the-packaging-client-tools]] +== Install the packaging client tools + +The _fedora-packager_ package provides tools to help you setup and work with Fedora. +When you install it, that package brings in everything necessary for general packaging work. +Run the following command link:https://fedoramagazine.org/howto-use-sudo/[using sudo]: + +`sudo dnf install fedora-packager` + + +[[configure-your-git]] +== Configure git + +First, configure your user name and email address for Git. +These are linked in each commit you do to Fedora packages. + +-------------------------------------------------- +git config --global user.name "John Doe" +git config --global user.email johndoe@example.com +-------------------------------------------------- + + +[[set-up-koji-client-config]] +== Set up Koji client configuration + +Fedora and EPEL use the Fedora build system link:https://fedoraproject.org/wiki/Using_the_Koji_build_system[Koji] to build packages. +Use the following command to link:https://fedoraproject.org/wiki/Using_the_Koji_build_system#Fedora_Account_System_.28FAS2.29_Setup[setup your Koji client configuration]. +Do not use _sudo_ or run this command as the _root_ user: + +`fedora-packager-setup` + + +[[get-a-kerberos-ticket]] +== Get a Kerberos ticket + +You should know your Fedora Account System login name. +Write this name to the _.fedora.upn_ file in your home directory, for use by additional tools. +Substitute your FAS login name for _your-fasname_: + +`echo _your-fasname_ > ~/.fedora.upn` + +Then get a Kerberos ticket using this command. +Use all uppercase letters for FEDORAPROJECT.ORG as shown: + +`kinit _your-fasname_@FEDORAPROJECT.ORG`