hudson 0.3.0.beta.19 → 0.3.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (5) hide show
  1. data/Gemfile.lock +1 -1
  2. data/README.md +71 -22
  3. data/hudson.gemspec +2 -2
  4. data/lib/hudson/version.rb +1 -1
  5. metadata +7 -11
data/Gemfile.lock CHANGED
@@ -1,7 +1,7 @@
1
1
  PATH
2
2
  remote: .
3
3
  specs:
4
- hudson (0.3.0.beta.19)
4
+ hudson (0.3.0)
5
5
  builder (~> 2.1.2)
6
6
  hpricot
7
7
  httparty (~> 0.6.1)
data/README.md CHANGED
@@ -12,7 +12,8 @@ Install
12
12
  =======
13
13
 
14
14
  gem install hudson
15
- gem install hudson --pre (bleeding edge)
15
+
16
+ You do not need to download Hudson CI. It is bundled in the RubyGem.
16
17
 
17
18
  Example
18
19
  =======
@@ -24,40 +25,81 @@ The `hudson` application allows you to see the projects/jobs and their statuses:
24
25
  $ hudson list --host hudson.thefrontside.net --port 80
25
26
  hudson.rb - http://hudson.thefrontside.net/job/hudson.rb/
26
27
  TheRubyRacer - http://hudson.thefrontside.net/job/TheRubyRacer/
27
-
28
- # alternately use environment variables
28
+
29
+ Alternately use environment variables:
30
+
29
31
  $ HUDSON_HOST=hudson.thefrontside.net HUDSON_PORT=80 hudson list
30
32
 
33
+ Alternately, it will remember the last Hudson CI master used.
34
+
35
+ $ hudson list
36
+
31
37
  Usage
32
38
  =====
33
39
 
34
- To run Hudson server:
40
+ To run your own Hudson server (by default opens at http://localhost:3001):
35
41
 
36
- Usage: hudson server [HUDSON_HOME] [options]
37
- -d, --daemon fork into background and run as daemon
38
- -p, --port [3001] run hudson on specified port
39
- -c, --control-port [3002] set the shutdown/control port
40
- -k, --kill send shutdown signal to control port
41
- -v, --version show version information
42
- -h, --help
42
+ Usage: hudson server [options]
43
+ -p, --port [3001] run hudson server on this port
44
+ -c, --control [3002] set the shutdown/control port
45
+ --daemon fork into background and run as a daemon
46
+ --logfile [PATH] redirect log messages to this file
47
+ -k, --kill send shutdown signal to control port
48
+ --home [/Users/drnic/.hudson/server] use this directory to store server data
43
49
 
44
- Note: HUDSON_HOME defaults to ~/.hudson
50
+ The remaining CLI tasks are for communicating with a running Hudson server; either the one created above or hosted remotely.
51
+
52
+ ### Jobs
45
53
 
46
54
  To list Jobs/Projects on a Hudson server:
47
55
 
48
- Usage: hudson list [project_path] [options]
49
- -p, --port [3001] find hudson on specified port
50
- --host [localhost] find hudson on specified host
51
- -h, --help
56
+ Usage: hudson list [options]
57
+
58
+ To add Jobs/Projects (create a Job) on a Hudson server:
59
+
60
+ Usage: hudson create PROJECT_PATH [options]
61
+ --public-scm use public scm URL
62
+ --template [ruby] template of job steps (available: rails,rails3,ruby,rubygem)
63
+ --assigned-node [ASSIGNED-NODE] only use slave nodes with this label
64
+ --override override if job exists
65
+ --no-build create job without initial build
66
+
67
+ To trigger a Job to build:
68
+
69
+ Usage: hudson build
70
+
71
+ To remove a Job from a Hudson server:
52
72
 
53
- To add Project (create a Job) on a Hudson server:
73
+ Usage: hudson remove PROJECT_PATH
54
74
 
55
- Usage: hudson create [project_path] [options]
56
- -p, --port [3001] find hudson on specified port
57
- --host [localhost] find hudson on specified host
58
- -h, --help
75
+ ### Slave nodes
76
+
77
+ To list slaves on a Hudson server (including itself):
78
+
79
+ Usage: hudson nodes
80
+
81
+ To add a remote machine/remote VM to a Hudson server as a slave:
82
+
83
+ Usage: hudson add_node SLAVE_HOST
84
+ --slave-port [22] SSH port for Hudson to connect to slave node
85
+ --label [LABEL] Labels for a job --assigned_node to match against to select a slave. --master-key [MASTER-KEY] Location of master public key or identity file
86
+ --slave-fs [SLAVE-FS] Location of file system on slave for Hudson to use
87
+ --name [NAME] Name of slave node (default SLAVE_HOST)
88
+ --slave-user [deploy] SSH user for Hudson to connect to slave node
89
+
90
+
91
+ ### Selecting a Hudson CI server
92
+
93
+ **For all client-side commands, there are `--host` and `--port` options flags.** These are cached after first used, so are only required for the first request to a Hudson CI server. For example:
94
+
95
+ hudson create . --host localhost --port 3001
96
+ hudson list
97
+ hudson create . --override
98
+
99
+ Alternately, `$HUDSON_HOST` and `$HUDSON_PORT` can be provided in lieu of the cached target Hudson CI server
100
+
101
+ HUDSON_HOST=localhost HUDSON_PORT=3001 hudson list
59
102
 
60
- For all commands, if flags for `host:port` are not provided, it will use either `$HUDSON_HOST` and `$HUDSON_PORT` or the previous target Hudson CI server.
61
103
 
62
104
  Developer Instructions
63
105
  ======================
@@ -80,6 +122,13 @@ Alternately, manually launch the Hudson server, run features and close the Hudso
80
122
  rake cucumber:ok
81
123
  rake hudson:server:killtest
82
124
 
125
+ Contributors
126
+ ============
127
+
128
+ * Charles Lowell
129
+ * Dr Nic Williams
130
+ * Bo Jeanes
131
+
83
132
  License
84
133
  =======
85
134
 
data/hudson.gemspec CHANGED
@@ -2,9 +2,9 @@
2
2
 
3
3
  Gem::Specification.new do |s|
4
4
  s.name = %q{hudson}
5
- s.version = "0.3.0.beta.19"
5
+ s.version = "0.3.0"
6
6
 
7
- s.required_rubygems_version = Gem::Requirement.new("> 1.3.1") if s.respond_to? :required_rubygems_version=
7
+ s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
8
8
  s.authors = ["Charles Lowell", "Dr Nic Williams"]
9
9
  s.date = %q{2010-11-08}
10
10
  s.default_executable = %q{hudson}
data/lib/hudson/version.rb CHANGED
@@ -1,3 +1,3 @@
1
1
  module Hudson
2
- VERSION = "0.3.0.beta.19"
2
+ VERSION = "0.3.0"
3
3
  end
metadata CHANGED
@@ -1,15 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: hudson
3
3
  version: !ruby/object:Gem::Version
4
- hash: 62196405
5
- prerelease: true
4
+ hash: 19
5
+ prerelease: false
6
6
  segments:
7
7
  - 0
8
8
  - 3
9
9
  - 0
10
- - beta
11
- - 19
12
- version: 0.3.0.beta.19
10
+ version: 0.3.0
13
11
  platform: ruby
14
12
  authors:
15
13
  - Charles Lowell
@@ -323,14 +321,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
323
321
  required_rubygems_version: !ruby/object:Gem::Requirement
324
322
  none: false
325
323
  requirements:
326
- - - ">"
324
+ - - ">="
327
325
  - !ruby/object:Gem::Version
328
- hash: 25
326
+ hash: 3
329
327
  segments:
330
- - 1
331
- - 3
332
- - 1
333
- version: 1.3.1
328
+ - 0
329
+ version: "0"
334
330
  requirements: []
335
331
 
336
332
  rubyforge_project: hudson