Revision as of 15:02, 15 July 2010

Getting the source code

Because we're in this interesting open-source-yet-hidden state this week, there are a few hitches in the system. You will not be able to view the swift or ozone code via the web ui, but you can branch using bzr. (This restriction will go away at 12:01am EST on July 19. :) )

Additionally, launchpad projects usually have a convenient URL shortcut to branch code, in the form of lp:projectname - this also will not work until next week.

For this week only to get the code, you need to do:

bzr branch lp:~swift-core/swift/trunk

or

bzr branch lp:~ozone-core/ozone/trunk

You will also need to ensure you have logged in to launchpad with bzr. So the full walkthrough of getting started is:

bzr lp-login "your-launchpad-id"

then:

bzr init-repo swift
cd swift
bzr branch lp:~swift-core/swift/trunk

or:

bzr init-repo ozone
cd ozone
bzr branch lp:~ozone-core/ozone/trunk

Swift All in One (Manual Install)

Once you check out the swift code, docs can be built by running "python setup.py build_sphinx" and then browsing to "doc/build/html/index.html". The Swift All in One document will lead you through the steps of making a development VM with swift installed.

Swift All In One (Auto Install)

You'll want to have an Ubuntu 10.04 system/VM that you're willing to turn in to a Swift development environment. First step is to get the SSH key you are using for launchpad in your ~/.ssh directory.

Log in as your user, and do the following:

curl http://c0020195.cdn1.cloudfiles.rackspacecloud.com/install-swift.sh > install-swift.sh
bash install-swift.sh

You'll be prompted for your username, group name (which is likely identical to your username), launchpad login, and the email address you want bzr to use when sending commits. Eventually, you will also be prompted to accept the Launchpad SSH Host Key, and may be prompted for your keyphrase.

When the script completes, you'll have a functioning Swift All In One that's prepped for running the functional tests.