SetupDeveloperEnvironment

Differences between revisions 3 and 26 (spanning 23 versions)
Revision 3 as of 2012-11-12 14:12:39
Size: 1566
Editor: 80
Comment:
Revision 26 as of 2013-03-03 19:36:23
Size: 3399
Editor: h-162-149
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
 * Set up launchpad account
 * Set up developer system
 * Set up testing system
<<Include(UbuntuStudio/Navigation/Header)>>
Line 5: Line 3:
== Keys == = Set Up A Basic Developer Environment =
Line 7: Line 5:
=== Create a GPG Key === ||<tablestyle="float:right; font-size: 0.9em; background:#F1F1ED;margin: 0 0 1em 1em;" style="padding:0.5em;"><<TableOfContents(2)>>||
Line 9: Line 7:
''For a more thorough explanation on GPG, see [[https://help.ubuntu.com/community/GnuPrivacyGuardHowto|GPG How To]]'' Before doing this, it might be best to install the [[UbuntuStudio/InstallDevelopmentRelease|Development Release]] first. You can however export the key you create here to any platform you want. Just backup the folders '''~/.gnupg''' and '''~/.ssh''' after creating the keys.
Line 11: Line 9:
The GPG key is primarily used for signing Debian packages (.deb). To create a GPG key, use this command in a terminal: == Setup Launchpad Account ==

First thing you need to do is set up a [[http://launchpad.net|launchpad]] account. We do most of our planning, tasks management, and team management on launchpad. Some launchpad teams have special privileges. The link for creating an account is: https://login.launchpad.net/+new_account

To use launchpad fully, you'll need a GPG key, which is your virtual ID, and to handle private sources on launchpad you'll need a SSH key (which is sort of like an actual key to a lock).

== Create a GPG Key ==

GPG Stands for [[http://gnupg.org/| Gnu Privacy Guard]].

Initially, you are required to have a GPG key in order to sign the launchpad Code of Conduct. As a developer you will be using the GPG key to sign things like changes to Ubuntu source packages. People will know you make the change from your gpg key signature.

This key is your virtual identity, so be careful with it!

First, make sure you have installed gnupg

{{{
$ sudo apt-get install gnupg
}}}

=== Creating the GPG key in a terminal ===

To create a GPG key, use this command in a terminal:
Line 17: Line 37:
Follow the instructions carefully. Choosing the default options is fine. Make sure to type in your real name and the email you want to have associated with your key. Choose a secure passphrase. If you loose the passphrase, there is no way to retrieve it. Follow the instructions carefully. Choosing the default options is fine. Make sure to type in your '''real name''' and the '''email''' you want to have associated with your key. Choose a secure passphrase. If you loose the passphrase, there is no way to retrieve it.

'''Publish your key'''
Line 39: Line 61:
It may take up to an hour before your key is published and ready to be used. There are alternative key servers to publish to, which may be quicker. For more info on that, please see [[https://help.ubuntu.com/community/GnuPrivacyGuardHowto|GPG How To]] It may take up to an hour before your key is published and ready to be used. There are alternative key servers to publish to, which may be quicker.
Line 41: Line 63:
=== Create SSH Key === Your gpg keys end up in '''~/.gnupg'''
Line 43: Line 65:
== Setup Launchpad Account == ''Read more about [[https://help.ubuntu.com/community/GnuPrivacyGuardHowto|GPG]] at the Ubuntu Community Wiki.''
Line 45: Line 67:
== Setup Developer System == == Create a SSH Key ==
Line 47: Line 69:
== Setup Testing Environment == SSH stands for [[http://www.openssh.com/|Secure Shell]]. It's a method for connecting to remote places.

As a developer, you will need a SSH client in combination with a SSH key in order upload changes to Ubuntu source.

First, make sure you have install the SSH client:

{{{
$ sudo apt-get install openssh-client
}}}

=== Creating the SSH Key in a Terminal ===

To create a SSH key in a terminal:

{{{
$ ssh-keygen -t rsa
}}}

You can now find your keys in '''~/.ssh/'''

''Read more about [[http://help.ubuntu.com/community/SSH|SSH]] at the Ubuntu Community Wiki''

Set Up A Basic Developer Environment

Before doing this, it might be best to install the Development Release first. You can however export the key you create here to any platform you want. Just backup the folders ~/.gnupg and ~/.ssh after creating the keys.

Setup Launchpad Account

First thing you need to do is set up a launchpad account. We do most of our planning, tasks management, and team management on launchpad. Some launchpad teams have special privileges. The link for creating an account is: https://login.launchpad.net/+new_account

To use launchpad fully, you'll need a GPG key, which is your virtual ID, and to handle private sources on launchpad you'll need a SSH key (which is sort of like an actual key to a lock).

Create a GPG Key

GPG Stands for Gnu Privacy Guard.

Initially, you are required to have a GPG key in order to sign the launchpad Code of Conduct. As a developer you will be using the GPG key to sign things like changes to Ubuntu source packages. People will know you make the change from your gpg key signature.

This key is your virtual identity, so be careful with it!

First, make sure you have installed gnupg

$ sudo apt-get install gnupg

Creating the GPG key in a terminal

To create a GPG key, use this command in a terminal:

$ gpg --gen-key

Follow the instructions carefully. Choosing the default options is fine. Make sure to type in your real name and the email you want to have associated with your key. Choose a secure passphrase. If you loose the passphrase, there is no way to retrieve it.

Publish your key

Once you are done, you will need to publish your key to a server in order for it to be usable. First, you need to find out what your public ID is. To see all the GPG keys in your system, do:

$ gpg --list-keys

In this example, the public ID is F06EFAE2

pub   2048R/F06EFAE2 2012-11-12
uid                  Kaj Ailomaa (Debian/Ubuntu signing key) <zequence@mousike.me>
sub   2048R/140030E5 2012-11-12

Now, publish your GPG key using your public ID:

$ gpg --send-keys <KEY ID>

It may take up to an hour before your key is published and ready to be used. There are alternative key servers to publish to, which may be quicker.

Your gpg keys end up in ~/.gnupg

Read more about GPG at the Ubuntu Community Wiki.

Create a SSH Key

SSH stands for Secure Shell. It's a method for connecting to remote places.

As a developer, you will need a SSH client in combination with a SSH key in order upload changes to Ubuntu source.

First, make sure you have install the SSH client:

$ sudo apt-get install openssh-client

Creating the SSH Key in a Terminal

To create a SSH key in a terminal:

$ ssh-keygen -t rsa

You can now find your keys in ~/.ssh/

Read more about SSH at the Ubuntu Community Wiki

UbuntuStudio/SetupDeveloperEnvironment (last edited 2015-11-09 12:16:45 by h-141-65)