REVU

Differences between revisions 85 and 86
Revision 85 as of 2008-07-26 19:33:30
Size: 7070
Editor: cpe-69-207-147-100
Comment:
Revision 86 as of 2008-07-28 14:48:40
Size: 7275
Editor: 77
Comment:
Deletions are marked like this. Additions are marked like this.
Line 18: Line 18:
You need:

 * A ["GPGKey"]
 * A [https://launchpad.net Launchpad] account
 * To be a member of the [https://launchpad.net/~revu-uploaders/ Revu Uploaders Group]
 * To know how to make Debian packages (see PackagingTips)
 * One or more new or updated packages to upload

In order to upload to REVU, you will need to be added to the REVU keyring. Be sure that you have a [https://launchpad.net Launchpad] account and that you have added your ["GPGKey"] to it. Then logon to REVU, it will automatically sync any new keys from Launchpad.
In order to upload to REVU, you will need to be added to the REVU keyring. Be sure that you have a [https://launchpad.net Launchpad] account and that you have added your ["GPGKey"] to it. Then log in to REVU and it will automatically get your GPG key from Launchpad, which it will then use to recognize your uploads.
Line 30: Line 22:
Uploading to REVU uses dput. Uploading to REVU is done with dput.
Line 101: Line 93:
REVU uses Launchpad's OpenID server. When you click Login via Launchpad ID, you'll be redirected to Launchpad to login and confirm login, and then redirected back to REVU. REVU uses Launchpad's OpenID server. When you click "Login via Launchpad OpenID", you'll be redirected to Launchpad to confirm the login and then redirected back to REVU.
Line 106: Line 98:
However, commenting uploads is only available to registered users. Commenting on your own packages can be useful to give reviewers some info on the changes you have made between two uploaxs of your packages.
However, only registered users can comment. Commenting on your own packages can be useful to give reviewers some info on the changes you have made between two uploads of your packages. You can also review packages from other people, even if you are not a MOTU, if you know for sure that what you write is true.

In order to know if a comment is from a MOTU, look at the icon before his name; if it shows a light bulb, it's from a contributor; if it shows the MOTU emblem, it's from a MOTU (or a REVU admin), and if it shows a green tick, that does not only mean that it's from a MOTU but also that he advocated the package.
Line 110: Line 105:
 * you must have reviewed this package for known security vulnerabilities and provide patches for all of them
 * we can refuse the package on the grounds of known security problems and design
 * you must have included a copyright and license file, and those must allow inclusion of the package in the universe component and on mirrors
 * the package must be known to build on top of the main component of the current ubuntu stable release; it may require other packages already in universe
 * You must have reviewed your package for known security vulnerabilities and provide patches for all of them.
 * We can refuse the package on the grounds of known security problems and design.
 * You must have included a copyright and license file, and those must allow inclusion of the package in the universe component and on mirrors.
 * The package must be known to build on top of the main component of the current Ubuntu stable release; it may require other packages already in universe.
Line 118: Line 113:
If you need help on these steps or if you have more questions about REVU, you can ask on #ubuntu-motu on the Freenode network. If you need help on these steps or if you have more questions about REVU, you can ask in #ubuntu-motu on the Freenode network.

What is REVU?

[http://revu.ubuntuwire.com/ REVU] (http://revu.ubuntuwire.com) is a web-based tool to give people who have worked on packages a chance to "put their packages out there" for other people to look at and comment on in a structured manner. The packager can begin to upload his packages to REVU. The packages can then be commented on by reviewers, and the packager can send updates of their package to REVU until it gets advocated by at least 2 ["MOTU"]s. At that point, a MOTU can upload the approved package to Universe.

This service is experimental at the moment, and involves some manual interaction.

Contribute as an Uploader

Why contribute as an Uploader?

If you've built a package of a program that's not available in the development version of either Ubuntu (currently IntrepidIbex) or Debian (Sid), you can upload it to REVU. It can then be checked over by MOTUs and advocated into Ubuntu's Universe archive.

In order to do this, you need to register as an uploader on the REVU system.

Register as a REVU uploader

In order to upload to REVU, you will need to be added to the REVU keyring. Be sure that you have a [https://launchpad.net Launchpad] account and that you have added your ["GPGKey"] to it. Then log in to REVU and it will automatically get your GPG key from Launchpad, which it will then use to recognize your uploads.

Upload your packages

Uploading to REVU is done with dput.

Since Ubuntu 6.06 LTS (Dapper Drake), dput is already configured for REVU uploads, with the [revu] entry. However, if are running an earlier version you can add the following entry to your /etc/dput.cf:

  [revu]
  fqdn = revu.ubuntuwire.com
  incoming = /incoming
  login = anonymous
  progress_indicator = 2
  allow_unsigned_uploads = 0

If you are not an Ubuntu developer, you can set REVU as the default host for dput by modifying the [DEFAULT] section in dput.cf. This way, you don't need to specify what host to use when using dput to upload.

  default_host_main = revu

Building a package for upload

Uploads to REVU should only be signed source files, with the original tarball. Please do not upload unsigned source or binary packages. The allow_unsigned_uploads = 0 in the [revu] stanza in dput.cf should be enforcing this anyway.

Inside your package directory, issue

   dpkg-buildpackage -S -sa -rfakeroot

-S builds a source package, and -sa includes the original source. If your GPG key is not configured correctly, add -kGPGKEYID to the command line.

Uploading it

dpkg-buildpackage will output a package-version_source.changes file, which is uploaded with dput.

   dput revu package_version_source.changes

If your firewall requires passive FTP, dput may hang while uploading. In that case, try dput -P package-version_source.changes.

attachment:IconsPage/note.png If you haven't set REVU as the default host (as explained previously), you need to specify to dput that you wish to use it on the command line: dput revu *_source.changes. The default host is the Ubuntu official repository, and if you are not an Ubuntu developer, your upload to the Ubuntu repository will be rejected.

If you are reuploading a changed package (after receiving reviews), you may get an error like this:

  Upload package to host revu
  Already uploaded to ubuntuwire.com
  Doing nothing for myapp_source.changes

To fix, add the -f option to dput to force the upload.

If you aborted an upload in progress, you might get an error like this:

  Error '553 Could not create file.' during ftp transfer of myapp.dsc
  Note: This problem might be caused by files already existent on the server.
  For the official Debian upload queues, the dcut(1) utility can be used
  to remove stale files from unsuccessful uploads.

To solve this, just wait 5 minutes. Processing of uploads is done every 5 min. If your upload doesn't show up, please contact the REVU administrators on the IRC channel #ubuntu-motu:

How to log in

REVU uses Launchpad's OpenID server. When you click "Login via Launchpad OpenID", you'll be redirected to Launchpad to confirm the login and then redirected back to REVU.

View and comment uploads

Packages uploaded to REVU are made public. You can browse them without logging in to the system.

However, only registered users can comment. Commenting on your own packages can be useful to give reviewers some info on the changes you have made between two uploads of your packages. You can also review packages from other people, even if you are not a MOTU, if you know for sure that what you write is true.

In order to know if a comment is from a MOTU, look at the icon before his name; if it shows a light bulb, it's from a contributor; if it shows the MOTU emblem, it's from a MOTU (or a REVU admin), and if it shows a green tick, that does not only mean that it's from a MOTU but also that he advocated the package.

Additional rules

  • You must have reviewed your package for known security vulnerabilities and provide patches for all of them.
  • We can refuse the package on the grounds of known security problems and design.
  • You must have included a copyright and license file, and those must allow inclusion of the package in the universe component and on mirrors.
  • The package must be known to build on top of the main component of the current Ubuntu stable release; it may require other packages already in universe.

Getting help

If you need help on these steps or if you have more questions about REVU, you can ask in #ubuntu-motu on the Freenode network.

Contribute as Reviewer

Why contribute as Reviewer?

Do you have some experience in packaging and know policy well? Then you can help improving the packages uploaded to universe and guide packagers in doing so, by contributing as a reviewer on REVU.

Register as reviewer

What you need :

  • A ["GPGKey"]
  • Be an ["MOTU"]

Please contact one of the administrators on the IRC channel #ubuntu-motu. We will mark you as Reviewer in the database.

Using REVU-Tools to review on REVU

See [:/REVU-Tools].

Reviewing Guidelines

When reviewing a package that needs work before upload, please summarise as many issues as possible in the REVU comment, so that the Uploader has a larger work list. It can be very frustrating to revise the package for each issue, and Uploaders may wonder if it will ever end.

If you advocate a package, please paste the URL in #ubuntu-motu with a notification of advocation, to encourage someone to upload it.

Tip: You can easily download a source package using the .dsc with dget (package devscripts)

dget -x http://path/to/the/dsc/file

Feature Requests

Please submit feature requests and bug reports to the [https://launchpad.net/revu REVU Project] on Launchpad.


["CategoryMOTU"]

MOTU/Packages/REVU (last edited 2011-12-08 16:58:49 by allison)