Skip to content
This repository

Offer self service to your automated operations.

Octocat-spinner-32 core Merge branch 'issue/714-run-f' into maint-2.0.4 April 11, 2014
Octocat-spinner-32 docs Storage config should be defined in rundeck-properties #726 April 08, 2014
Octocat-spinner-32 examples Add example encryption plugin for storage converter April 04, 2014
Octocat-spinner-32 gradle reformat: remove tabs March 31, 2014
Octocat-spinner-32 graphics Node run icon updated January 29, 2014
Octocat-spinner-32 packaging Remove jetty6 jars from debian contents #735 April 14, 2014
Octocat-spinner-32 plugins allow file-copy.file usage in remote file path setting #725 April 08, 2014
Octocat-spinner-32 rundeck-launcher Fix java source/target versions April 03, 2014
Octocat-spinner-32 rundeck-storage Update dependencies to match core and grails app April 03, 2014
Octocat-spinner-32 rundeckapp Logout doesn't cause redirect to secure scope #703 April 11, 2014
Octocat-spinner-32 test Use /tmp for file locations in case write perms are not present April 01, 2014
Octocat-spinner-32 .gitignore gitignore: add **/target March 21, 2014
Octocat-spinner-32 .travis.yml Travis build uses dumb terminal for gradle output January 16, 2014
Octocat-spinner-32 Makefile Add storage lib javadocs to exported docs March 29, 2014
Octocat-spinner-32 README.md Update readme January 31, 2014
Octocat-spinner-32 RELEASE.md Update release notes for 2.0.3 March 24, 2014
Octocat-spinner-32 build.gradle Apply java gradle settings to subprojects at one place March 31, 2014
Octocat-spinner-32 gradle.properties Update version to 2.1.0-0-SNAPSHOT March 18, 2014
Octocat-spinner-32 gradlew Upgrade gradle wrapper to 1.4 August 12, 2013
Octocat-spinner-32 gradlew.bat Adding gradle wrapper files for 1.2 September 26, 2012
Octocat-spinner-32 jenkins-build.sh jenkins build script use release opts for nexus repo release March 13, 2014
Octocat-spinner-32 pom.xml missing rundeck-storage module in pom April 03, 2014
Octocat-spinner-32 settings.gradle core build with rundeck-storage dependencies fixed March 14, 2014
Octocat-spinner-32 setversion.sh Allow release tag July 04, 2013
Octocat-spinner-32 testbuild.groovy Update build manifest for rundeck-storage libs April 01, 2014
Octocat-spinner-32 version.properties Update version to 2.1.0-0-SNAPSHOT March 18, 2014
README.md

Rundeck

Rundeck is an open source automation service with a web console, command line tools and a WebAPI. It lets you easily run automation tasks across a set of nodes.

For more information, mailing lists, IRC channel, visit http://rundeck.org

See the Release Notes for the latest version information.

To Build:

Primary build is supported with either gradle or maven2+.

Gradle Build

./gradlew build

Artifacts:

  • rundeckapp/target/rundeck-X.Y.war
  • rundeck-launcher/launcher/build/libs/rundeck-launcher-X.Y.jar

Maven2 Build

MAVEN_OPTS="-Xmx512m -XX:MaxPermSize=192m" mvn clean package

Artifacts:

  • rundeckapp/target/rundeck-X.Y.war
  • rundeck-launcher/launcher/target/rundeck-launcher-X.Y.jar

Notes:

  • the underlying Grails build requires the MaxPermSize to be increased in the MAVEN_OPTS as shown above.

Other builds

The documentation can be built with pandoc.

Build the documentation. Artifacts in docs/en/dist:

cd docs
make

You can build .rpm or .deb files (requires pandoc to build the docs):

Build the RPM. Artifacts in packaging/rpmdist/RPMS/noarch/*.rpm

make rpm

Build the .deb. Artifacts in packaging/*.deb:

make deb

To build clean:

make clean

Installation

There are several install options: a self-contained jar file, or RPM, or Debian.

To start from the rundeck-launcher.jar, put it in a directory named ~/rundeck, then execute:

java -XX:MaxPermSize=256m -Xmx1024m -Xms256m -server -jar rundeck-launcher-2.0.0.jar

If you'd like to install via RPM, you can use Yum:

rpm -Uvh http://repo.rundeck.org/latest.rpm 
yum install rundeck

OR install directly from RPM:

rpm -ivh rundeck-2.0.0-xxx.rpm rundeck-config-2.0.0-xxx.rpm

Once the RPM is installed, execute:

sudo /etc/init.d/rundeckd start

The server should launch on port 4440, with default username/password of admin/admin.

For Debian, download the .deb from the downloads page, then run:

dpkg -i rundeck-2.0.0-x.deb
  • For more info and configuration information, see the Rundeck docs.

Requirements

Java 6/7 (openjdk, sun)

Pandoc (documentation build only)

Documentation

Available online at http://rundeck.org/docs

FAQ: https://github.com/rundeck/rundeck/wiki/FAQ

Development

Refer to the IDE Development Environment to get set up using IntelliJ IDEA or Eclipse/STS.

Do you have changes to contribute? Please see the Development wiki page.

License

Copyright 2014 SimplifyOps

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Something went wrong with that request. Please try again.