Job scheduler and runbook automation. Enable self-service access to existing scripts and tools.
Groovy Java JavaScript Shell CSS Batchfile Other
Permalink
Failed to load latest commit information.
core use file.separator in log4j templates Aug 24, 2016
docs Add documentation for run job at time api #1987 Aug 25, 2016
examples fix #1845 add syntax mode for CODE rendering option Jun 9, 2016
gradle update to gradle 1.12 Aug 4, 2016
graphics Add EPS vector image of rundeck logo Jul 17, 2014
packaging default to ERROR log level for #1816 Apr 20, 2016
plugins remove subproject gradle wrappers Aug 11, 2016
rundeck-launcher use file.separator in log4j templates Aug 24, 2016
rundeck-storage remove subproject gradle wrappers Aug 11, 2016
rundeckapp Show startup warning if default charset is not UTF-8 Aug 26, 2016
test Example installing rundeck via apt on ubuntu with docker Aug 26, 2016
.gitignore ignore deb build dir Jun 16, 2016
.travis.yml enable docker for travis Aug 25, 2016
CHANGELOG.md Update release documentation for 2.6.9-1-GA Aug 3, 2016
LICENSE Adds Apache 2.0 License Sep 1, 2015
Makefile Add storage lib javadocs to exported docs Mar 29, 2014
README.md update copyright May 11, 2015
RELEASE.md Update release documentation for 2.6.9-1-GA Aug 3, 2016
build.gradle update copyright Aug 11, 2016
gradle.properties update copyright Aug 11, 2016
gradlew Upgrade gradle wrapper to 1.4 Aug 12, 2013
gradlew.bat Adding gradle wrapper files for 1.2 Sep 26, 2012
jenkins-build.sh jenkins build script use release opts for nexus repo release Mar 14, 2014
pom.xml update copyright Aug 11, 2016
rd_versions.sh Scripts for creating release tag Dec 16, 2014
release.sh add CHANGELOG.md to release process Feb 25, 2016
run-api-tests.sh argument to run single test Oct 6, 2015
run-docker-tests.sh add top level scripts for running docker tests of built jar Aug 25, 2016
settings.gradle update copyright Aug 11, 2016
setversion.sh format modified pom.xml files after updating version Dec 2, 2014
testbuild.groovy fix groovy script Aug 11, 2016
version.properties update copyright Aug 11, 2016

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 gradle. More info in the wiki.

Gradle Build

./gradlew build

Artifacts:

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

Note: some pom.xml files exist, but the Maven build is not currently working.

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 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 2015 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.