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 | + | * 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):
-
ssk-keygen -t rsa
(enter enter enter). - 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:
- Create the key using:
gpg --gen-key
: enter your name, email address etc. - Export the key using: gpg --export --armor jqdoe@example.com
- 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:
- Login to Scratchbox
- Create
/etc/apt/sources.list.d/extras-repo.list
- 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
- Extras assistant
- Garage SSH key
- Build logs: chinook, diablo