From 6b132d2ae6e19c88a76a90279da08b7465689f42 Mon Sep 17 00:00:00 2001 From: Paul Sokolovsky Date: Fri, 17 Jun 2011 10:48:20 +0300 Subject: Add install section. --- README | 45 ++++++++++++++++++++++++++++++++++++--------- 1 file changed, 36 insertions(+), 9 deletions(-) (limited to 'README') diff --git a/README b/README index 3d2e535..958c1f5 100644 --- a/README +++ b/README @@ -32,16 +32,43 @@ also intended to be installed in the cloud. It may be possible to install it on a standlone host, but set up scripts described below assume full control of the host, and may alter configuration of other software and services. +Please make sure that you have working (command-line) EC2 environment and can +run ec2-* commands (for example, ec2-describe-instances). See +https://help.ubuntu.com/community/EC2StartersGuide for this initial setup. + +Quick install: + +bzr clone lp:linaro-android-build-tools +cd linaro-android-build-tools/control +./sandbox-create + +This will create complete Cloud Buildd setup, you just need to fill in EC2 +credentials which will be used to create build slave instances. + +Open URL as output when 'sandbox-create' script finished in the browser, +append "/jenkins". Login as username: admin, password: admin. Go to +"Manage Jenkins" -> "Configure System". Search for "Access Key ID", +"Secret Access Key" and fill in EC2 credentials. Now you need to create +keypair which Jenkins will use to create slave instances, this supposed to +be automated by clicking on "Generate Key", but does not work in latest +Jenkins versions, so instead run: + +ec2-add-keypair jenkins@cloud-buildd >jenkins@cloud-buildd.rsa + +Paste contents of jenkins@cloud-buildd.rsa into "EC2 RSA Private Key". Click +"Test Connection" and ensure you get "SUCCESS". + +In addittion to fully automated sandbox-create script which takes care of +instance creation for master node, there're following scripts with narrower +scope: + + control/setup-control-node-via-ssh + * This will set up existing instance/physical host as Cloud Buildd master + node control/setup-control-node - * Sets up Cloud Buildd control node on a blank, freshly installed - host/instance. The host must run Ubuntu Server 10.10 and 11.04. Set up - procedure includes install and configuring Jenkins, Apache, and other - components and services used by Cloud Buildd. - control/setup-control-node-via-ssh - * Runs setup-control-node script above over SSH. - control/sandbox-create - * Creates EC2 instance and installs control node on it, all in one - step. + * This will set up Cloud Buildd control node on the current host, which + should be a blank, freshly installed host/instance running Ubuntu Server + 10.10 or 11.04. Documentation ------------- -- cgit v1.2.3