~ce-orange-squad/charms/precise/jenkins-launchpad/trunk

« back to all changes in this revision

Viewing changes to README.md

  • Committer: Aaron Bentley
  • Date: 2013-09-26 20:45:12 UTC
  • Revision ID: aaron@canonical.com-20130926204512-1qvov8cxq128fbi2
Initial commit with confidential info removed.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
Jenkins Charm for Juju
 
2
----------------------
 
3
 
 
4
This charm (along with its companion, jenkins-slave) provide an
 
5
easy way to deploy Jenkins on Ubuntu server and scale out
 
6
jenkins slaves::
 
7
    
 
8
    juju deploy jenkins
 
9
    juju deploy -n 5 jenkins-slave
 
10
    juju add-relation jenkins jenkins-slave
 
11
 
 
12
The default password for the 'admin' account will be auto-generated.
 
13
 
 
14
You can set it using::
 
15
 
 
16
    juju set jenkins password=mypassword
 
17
 
 
18
Always change it this way - this account is used by the charm to
 
19
manage slave configuration.
 
20
 
 
21
Then feel free to expose your jenkins master::
 
22
 
 
23
    juju expose jenkins
 
24
 
 
25
The jenkins UI will be accessible on http://<master>:8080
 
26
 
 
27
Extending this charm
 
28
--------------------
 
29
 
 
30
If you wish to perform custom configuration of either the master
 
31
or slave services, you can branch this charm and add install hooks
 
32
into hooks/install.d.
 
33
 
 
34
These will be executed when the main install, config-changed or
 
35
upgrade-charm hooks are executed (as the config-changed and
 
36
upgrade-charm hooks just call install)..
 
37
 
 
38
Additional hooks are executed in the context of the install hook
 
39
so may use any variables which are defined in this hook.