SCM Admin SOP
(Add fesco policy on mass changes.)
Revision as of 17:34, 13 October 2010
Creating New Packages
CVSROOT=/cvs/pkgs cvs co CVSROOT cd CVSROOT/admin
See below for detail of invoking the scripts.
- Check Bugzilla Ticket to make sure it looks ok
- Add the package information to the packagedb with pkgdb-client
- Use pkgdb2branch to create the branches on the cvs server
4. Update koji.
Use pkgdb-client to update the pkgdb with new information. For instance, to add a new package:
pkgdb-client edit -u toshio -o terjeros -d 'Python module to extract EXIF information' -b F-10 -b F-11 -b devel python-exif
To update that package later and add someone to the initialcclist do:
pkgdb-client edit -u toshio -c kevin python-exif
To add a new branch for a package:
pkgdb-client edit -u toshio -b F-10 -b EL-5 python-exif
To allow provenpackager to edit a branch:
pkgdb-client edit -u toshio -b devel -a provenpackager python-exif
To remove provenpackager commit rights on a branch:
pkgdb-client edit -u toshio -b EL-5 -b EL-4 -r provenpackager python-exif
More options can be found by running pkgdb-client --help
You must be in the cvsadmin group to use pkgdb-client. It can be run on a non-Fedora Infrastructure box if you set the PACKAGEDBURL environment variable to the public URL:
Use pkgdb2branch.py to create cvs branches for a package. pkgdb2branch.py takes a list of package names on the command line and creates the branches in cvs that are specified in the packagedb. For instance:
./pkgdb2branch.py python-exif qa-assistant
Will create cvs branches specified in the packagedb for python-exif and qa-assistant.
pkgdb2branch can only be run from cvs-int.
Optionally you can synchronize pkgdb and koji by hand: it is done automatically hourly by a cronjob. There is a script for this in the admin/ directory of the CVSROOT module.
Since dist-f11 and later inherit from dist-f10, and currently dist-f10 is the basis of our stack, it's easiest to just call:
./owners-sync-pkgdb for usage output.
This script requires that you have a properly configured koji client installed.
owner-sync-pkgdb requires the koji client libraries which are not available on the cvs server. So you need to run this from one of your machines.
In the CVSROOT/admin checkout, there is a shell script called addpackage. It reads in and parses a New Package Request on stdin, and after checking, generates the new pkgdb entry and makes the branches. There are confirmation prompts along the way to check that each step is right.
You need to invoke the script with your cvsadmin FAS account name (NOT the new package owner's name):
These scripts are invoked by the scripts above, doing some of the heavy lifting. They should not ordinarily be called on their own.
/usr/local/bin/mkbranchwrapper is a shell script which takes a list of packages and branches. For instance:
mkbranchwrapper foo bar EL-5 F-11
will create modules foo and bar for devel if they don't exist and branch them for the other 4 branches passed to the script. If the devel branch exists then it just branches. If there is no branches passed the module is created in devel only.
mkbranchwrapper has to be run from cvs-int.
mkbranchwrapper is not used by any current programs. Use pkgdb2branch instead.
setup_package creates a new blank module in devel only. It can be run from any host. To create a new package run
setup_package needs to be called once for each package. it could be wrapped in a shell script similar to
#!/bin/bash PACKAGES="" for arg in $@; do PACKAGES="$PACKAGES $arg" done echo "packages=$PACKAGES" for package in $PACKAGES; do ~/bin/setup_package $package done
then call the script with all branches after it.
setup_package is currently called from pkgdb2branch.
Pseudo Users for SIGs
See CVS_admin_requests#Pseudo-users_for_SIGs for the current list.
Any packager can retire a package. click on the retire package button for the package in the webui. There's currently no pkgdb-client command to retire a package.
Any cvsadmin can unretire a package. Simply use pkgdb-client to assign an owner and the package will be unretired.
$ pkgdb-client -o toshio -b devel qa-assistant
As a cvsadmin you can also log into the pkgdb webui and click on the unretire package button. Once clicked, the package will be orphaned rather than retired.
Performing mass comaintainer requests
- Confirm that the requestor has 'approveacls' on all packages they wish to operate on. If they do not, they MUST request the change via FESCo.
- Mail maintainers/co-maintainers affected by the change to inform them of who requested the change and why.
- Download a copy of this script:
- Edit the script to have the proper package owners and package name pattern.
- Edit the script to have the proper new comaintainers.
- Ask someone in sysadmin-web to disable email sending on bapp01 for the pkgdb (following the instructions in comments in the script)
- Copy the script to an infrastructure host (like cvs01) that can contact bapp01 and run it.