Launchpad Setup History

Here we give a historical trace of how the NixNote project was set up in Launchpad to deliver automated builds for Ubuntu and its derivatives.

Before you start

These instructions assume you have already

• Created Launchpad account
• Uploaded PGP key to Sign the Code of Conduct (see help for creating PPA)

Create basic Launchpad entities

Note: Many of the "Create Xxxxx" options in Launchpad use generic URLs, rather than sub-URLs of any user / site / repo you may already be browsed to.

• Log into Launchpad
  • https://launchpad.net/+login

Team

• Create a Team: help
  • https://launchpad.net/people/+newteam
  • Name: nixnote
  • Display name and title: NixNote
  • Summary and description:
  • Membership policy: Moderated

PPA

Under the team...

• Create ('activate') a new PPA
  • https://launchpad.net/~nixnote/+activate-ppa
  • URL: nixnote2-daily
    • automatically postpended to http://ppa.launchpad.net/nixnote/
  • Display name: NixNote2 daily builds
  • Description: NixNote2 binaries built from the code at the head stored in GitHub. Project is published under OSI Approved GPLv2 license.

Project

• Create a new project: help
  • https://launchpad.net/projects/+new
  • Display name and title: NixNote2
  • URL: nixnote2
  • Summary: Launchpad project for re-publishing NixNote2 to Ubuntu and derivative distros, NOT for code or issues.
  • Description: This is a Launchpad project created simply for building and publishing NixNote2 packages. Note that source, issues, knowledge etc are all maintained in GitHub, NOT here. See https://github.com/baumgarr/Nixnote2
  • Homepage: https://github.com/baumgarr/Nixnote2
  • Licenses: GNU GPL v2
  • Maintainer: nixnote

Set up Code Branches under Project

head (or trunk)

• New Import

  • https://code.launchpad.net/nixnote2/+new-import
  • Owner: nixnote
  • Branch Name: baumgarr_head
  • Type: Git (see note below on [Target-version-control-system] = Git)
  • URL: https://github.com/baumgarr/Nixnote2.git
  • Request Import

• Ensure this is the main trunk branch

  • https://launchpad.net/nixnote2/trunk/+setbranch
  • Branch: ~nixnote/nixnote2/baumgarr_head
  • Update

Target version control system

Since October 2016, Launchpad supports importing git code directly into Git mirrors, rather than converting them into Bzr. Aside from other advantages, this mitigates the issue importing gpgsig commits.

When setting up new imports of code projects from Git, you should now check the option

Target version control system = Git

When importing the main code repo use Configure Code...

* https://code.launchpad.net/nixnote2/+configure-code
* Git Settings / Import a Git repository hosted somewhere else

And for all others just add a new import

* https://code.launchpad.net/nixnote2/+new-import

See Launchpad Git Mirroring documentation for more information.

Converting Bzr imports to Git Mirrors

• See Converting from Bazaar to Git.
• Don't forget to clean your bzr import settings from old setup or you couldn't set a recipe for git code even if it's there.

See also:

• how to build Launchpad Git Recipes
  • this includes important instructions for disambiguating by using the full git URLs for the repos
• bug 1084403 explaining the issue

Branch

• Request a code import: introduction and [detail]7(https://help.launchpad.net/VcsImports)
  • https://code.launchpad.net/+code-imports/+new
  • Owner: NixNote
  • Project: nixnote2
  • Branch: artemgy_head
    • once baumgarr repo contains any required pulls we can redo for just "head"
  • Git repo: https://github.com/artmg/Nixnote2.git
    • just as with git commands, you must suffix your repo URL with .git
  • Request Import

Set up Code Branches under packaging

• Add new GitHub repo with just the packaging control file(s)

  • https://github.com/artmg/nixnote2-packaging/

• Went into Code settings

  • https://code.launchpad.net/nixnote2/+configure-code
  • Import branch
  • Name: packaging
  • Owner: nixnote
  • URL: https://github.com/artmg/nixnote2-packaging.git
  • Type: Git

create Recipe

After a few minutes, check the import logs

• New Recipe (under newly imported branch)
  • https://code.launchpad.net/~nixnote/nixnote2/baumgarr_head/+new-recipe
  • Name: nixnote2-daily
  • Description: Recipe to build nixnote2, using package_scripts/deb as the debian directory containing the DSC control file
  • Owner: nixnote
  • Built Daily: Yes
  • PPA: NixNote2 daily builds
  • Distros: Wily / Vivid
  • Recipe Text: see the nixnote recipe page to know what recipe(s) we currently use

After an hour or so (?), check the build logs