Uploading to Extras-devel

m (Preparing a source package: Add back in, -i - it does make sense, and doesn't *require* an option)
m (Minor imrpovements)
Line 1: Line 1:
== Pre-requisites ==
== Pre-requisites ==
* A [http://garage.maemo.org/ Garage] account: [[https://garage.maemo.org/account/register.php signup]]
* A [http://garage.maemo.org/ Garage] account: [[https://garage.maemo.org/account/register.php signup]]
-
* An "invitation" to upload: [[https://garage.maemo.org/extras-assistant/index.php?target=invitation_request fill in this form]]
+
* An "invitation" to upload: [[https://garage.maemo.org/extras-assistant/index.php?target=invitation_request request]]
* <code>ssh-keygen</code>
* <code>ssh-keygen</code>
* <code>debsign</code>
* <code>debsign</code>
== Setup ==
== Setup ==
-
 
=== Setting up SSH and PGP to upload to extras ===
=== Setting up SSH and PGP to upload to extras ===
Put your SSH key[http://kimmo.suominen.com/docs/ssh/#ssh-keygen] and PGP key[http://fedoraproject.org/wiki/DocsProject/UsingGpg/CreatingKeys] into Garage.
Put your SSH key[http://kimmo.suominen.com/docs/ssh/#ssh-keygen] and PGP key[http://fedoraproject.org/wiki/DocsProject/UsingGpg/CreatingKeys] into Garage.
Line 36: Line 35:
== Preparing a source package ==
== Preparing a source package ==
 +
Upstream sources can be easily repacked using [[User:Jaffa/mud design|mud-builder]] which automates the steps below. Alternatively, you can do it directly using Debian tooling:
Create your package with dpkg-buildpackage in the project source directory:
Create your package with dpkg-buildpackage in the project source directory:
Line 47: Line 47:
in the source tree.  (You'll need to <code>fakeroot apt-get install devscripts</code> for this to work).
in the source tree.  (You'll need to <code>fakeroot apt-get install devscripts</code> for this to work).
 +
 +
== Upload ==
 +
=== Sign the package ===
Sign the .changes file (you'll need to do it outside scratchbox) with
Sign the .changes file (you'll need to do it outside scratchbox) with
  debsign -k<key-id> <package>.changes
  debsign -k<key-id> <package>.changes
-
== Upload ==
+
=== Upload the package ===
Describe: upload source package to diablo-extras-builder via <code>dput</code>[http://extras-cauldron.garage.maemo.org/HOWTO.html#how-to-prepare-and-upload-source-packages-for-build], <code>scp</code>[http://lists.maemo.org/pipermail/maemo-users/2006-September/002080.html] or through the web interface[https://garage.maemo.org/extras-assistant/index.php].
Describe: upload source package to diablo-extras-builder via <code>dput</code>[http://extras-cauldron.garage.maemo.org/HOWTO.html#how-to-prepare-and-upload-source-packages-for-build], <code>scp</code>[http://lists.maemo.org/pipermail/maemo-users/2006-September/002080.html] or through the web interface[https://garage.maemo.org/extras-assistant/index.php].

Revision as of 13:42, 7 July 2008

Contents

Pre-requisites

Setup

Setting up SSH and PGP to upload to extras

Put your SSH key[1] and PGP key[2] into Garage.

  • If you need to create an RSA SSH key (Make sure it is an RSA key):
  1. ssk-keygen -t rsa (enter enter enter).
  2. Copy the contents of ~/.ssh/id_rsa.pub in the "Public SSH keys" section of your garage account maintenance page.
  • If you need to create a PGP key:
  1. Create the key using: gpg --gen-key: enter your name, email address etc.
  2. Export the key using: gpg --export --armor jqdoe@example.com
  3. Copy the text to the extras sign-up page.

Setting up Scratchbox to use the extras repository

Add the extras repository to your Scratchbox install:

  1. Login to Scratchbox
  2. Create /etc/apt/sources.list.d/extras-repo.list
  3. Update apt's information.

Note: this should be done in both your ARMEL and x86 targets.

/scratchbox/login
cat >/etc/apt/sources.list.d/extras-repo.list <<EOT
#Maemo extras
deb http://repository.maemo.org/extras/ diablo free non-free
deb-src http://repository.maemo.org/extras/ diablo free
EOT
fakeroot apt-get update

Preparing a source package

Upstream sources can be easily repacked using mud-builder which automates the steps below. Alternatively, you can do it directly using Debian tooling:

Create your package with dpkg-buildpackage in the project source directory:

dpkg-buildpackage -rfakeroot -sa -S -i

You may verify that your Build-Depends field in debian/control is complete by running

dpkg-depcheck -m dpkg-buildpackage -rfakeroot -b

in the source tree. (You'll need to fakeroot apt-get install devscripts for this to work).


Upload

Sign the package

Sign the .changes file (you'll need to do it outside scratchbox) with

debsign -k<key-id> <package>.changes

Upload the package

Describe: upload source package to diablo-extras-builder via dput[3], scp[4] or through the web interface[5].

Point to: existing documentation

Promotion

After the autobuilder builds a package, it will be available in Extras-Devel. This is the experimental repository. If you think your package is ready for the masses, you can promote your package to Extras with the promotion interface.

Resources

Reference