Modified: aurora/site/source/documentation/latest/developing-aurora-scheduler.md URL: http://svn.apache.org/viewvc/aurora/site/source/documentation/latest/developing-aurora-scheduler.md?rev=1721854&r1=1721853&r2=1721854&view=diff ============================================================================== --- aurora/site/source/documentation/latest/developing-aurora-scheduler.md (original) +++ aurora/site/source/documentation/latest/developing-aurora-scheduler.md Sun Dec 27 22:09:27 2015 @@ -1,8 +1,25 @@ Java code in the aurora repo is built with [Gradle](http://gradle.org). + +Prerequisite +============ + +When using Apache Aurora checked out from the source repository or the binary +distribution, the Gradle wrapper and JavaScript dependencies are provided. +However, you need to manually install them when using the source release +downloads: + +1. Install Gradle following the instructions on the [Gradle web site](http://gradle.org) +2. From the root directory of the Apache Aurora project generate the gradle +wrapper by running: + + gradle wrapper + + Getting Started =============== -You will need Java 7 installed and on your `PATH` or unzipped somewhere with `JAVA_HOME` set. Then + +You will need Java 8 installed and on your `PATH` or unzipped somewhere with `JAVA_HOME` set. Then ./gradlew tasks @@ -28,6 +45,21 @@ commit to origin/master. ./gradlew build -Pq +Running integration tests +------------------------- +To run the same tests that are run in the Apache Aurora continuous integration +environment: + + ./build-support/jenkins/build.sh + + +In addition, there is an end-to-end test that runs a suite of aurora commands +using a virtual cluster: + + bash src/test/sh/org/apache/aurora/e2e/test_end_to_end.sh + + + Creating a bundle for deployment -------------------------------- Gradle can create a zip file containing Aurora, all of its dependencies, and a launch script with
Added: aurora/site/source/documentation/latest/images/aurora_logo.png URL: http://svn.apache.org/viewvc/aurora/site/source/documentation/latest/images/aurora_logo.png?rev=1721854&view=auto ============================================================================== Binary file - no diff available. Propchange: aurora/site/source/documentation/latest/images/aurora_logo.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: aurora/site/source/documentation/latest/images/components.odg URL: http://svn.apache.org/viewvc/aurora/site/source/documentation/latest/images/components.odg?rev=1721854&view=auto ============================================================================== Binary file - no diff available. Propchange: aurora/site/source/documentation/latest/images/components.odg ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: aurora/site/source/documentation/latest/images/components.png URL: http://svn.apache.org/viewvc/aurora/site/source/documentation/latest/images/components.png?rev=1721854&view=auto ============================================================================== Binary file - no diff available. Propchange: aurora/site/source/documentation/latest/images/components.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Modified: aurora/site/source/documentation/latest/index.html.md URL: http://svn.apache.org/viewvc/aurora/site/source/documentation/latest/index.html.md?rev=1721854&r1=1721853&r2=1721854&view=diff ============================================================================== --- aurora/site/source/documentation/latest/index.html.md (original) +++ aurora/site/source/documentation/latest/index.html.md Sun Dec 27 22:09:27 2015 @@ -1,6 +1,6 @@ ## Introduction Apache Aurora is a service scheduler that runs on top of Apache Mesos, enabling you to run long-running services that take advantage of Apache Mesos' scalability, fault-tolerance, and resource isolation. This documentation has been organized into sections with three audiences in mind: - + * Users: General information about the project and to learn how to run an Aurora job. * Operators: For those that wish to manage and fine-tune an Aurora cluster. * Developers: All the information you need to start modifying Aurora and contributing back to the project. @@ -14,24 +14,31 @@ We encourage you to ask questions on the * [Configuration Tutorial](/documentation/latest/configuration-tutorial/) * [Aurora + Thermos Reference](/documentation/latest/configuration-reference/) * [Command Line Client](/documentation/latest/client-commands/) + * [Client cluster configuration](/documentation/latest/client-cluster-configuration/) * [Cron Jobs](/documentation/latest/cron-jobs/) ## Operators - * [Deploy Aurora](/documentation/latest/deploying-aurora-scheduler/) + * [Installation](/documentation/latest/installing/) + * [Deployment and cluster configuraiton](/documentation/latest/deploying-aurora-scheduler/) + * [Security](/documentation/latest/security/) * [Monitoring](/documentation/latest/monitoring/) * [Hooks for Aurora Client API](/documentation/latest/hooks/) * [Scheduler Storage](/documentation/latest/storage/) * [Scheduler Storage and Maintenance](/documentation/latest/storage-config/) + * [Scheduler Storage Performance Tuning](/documentation/latest/scheduler-storage/) * [SLA Measurement](/documentation/latest/sla/) * [Resource Isolation and Sizing](/documentation/latest/resources/) - * [Generating test resources](/documentation/latest/test-resource-generation/) ## Developers * [Contributing to the project](contributing/) * [Developing the Aurora Scheduler](/documentation/latest/developing-aurora-scheduler/) * [Developing the Aurora Client](/documentation/latest/developing-aurora-client/) * [Committers Guide](/documentation/latest/committers/) + * [Deprecation Guide](/documentation/latest/thrift-deprecation/) * [Build System](/documentation/latest/build-system/) - + * [Generating test resources](/documentation/latest/test-resource-generation/) + + ## Additional Resources + * [Tools integrating with Aurora](/documentation/latest/tools/) * [Presentation videos and slides](/documentation/latest/presentations/) Modified: aurora/site/source/documentation/latest/installing.md URL: http://svn.apache.org/viewvc/aurora/site/source/documentation/latest/installing.md?rev=1721854&r1=1721853&r2=1721854&view=diff ============================================================================== --- aurora/site/source/documentation/latest/installing.md (original) +++ aurora/site/source/documentation/latest/installing.md Sun Dec 27 22:09:27 2015 @@ -30,6 +30,8 @@ Before installing Aurora, it's important to have an understanding of the components that make up a functioning Aurora cluster. + + * **Aurora scheduler** The scheduler will be your primary interface to the work you run in your cluster. You will instruct it to run jobs, and it will manage them in Mesos for you. You will also frequently use Added: aurora/site/source/documentation/latest/tools.md URL: http://svn.apache.org/viewvc/aurora/site/source/documentation/latest/tools.md?rev=1721854&view=auto ============================================================================== --- aurora/site/source/documentation/latest/tools.md (added) +++ aurora/site/source/documentation/latest/tools.md Sun Dec 27 22:09:27 2015 @@ -0,0 +1,16 @@ +# Tools + +Various tools integrate with Aurora. There is a tool missing? Let us know, or submit a patch to add it! + +* Load-balacing technology used to direct traffic to services running on Aurora + - [synapse](https://github.com/airbnb/synapse) based on HAProxy + - [aurproxy](https://github.com/tellapart/aurproxy) based on nginx + - [jobhopper](https://github.com/benley/aurora-jobhopper) performing HTTP redirects for easy developers and administor access + +* Monitoring + - [collectd-aurora](https://github.com/zircote/collectd-aurora) for cluster monitoring using collectd + - [Prometheus Aurora exporter](https://github.com/tommyulfsparre/aurora_exporter) for cluster monitoring using Prometheus + - [Prometheus service discovery integration](http://prometheus.io/docs/operating/configuration/#zookeeper-serverset-sd-configurations-serverset_sd_config) for discovering and monitoring services running on Aurora + +* Packaging and deployment + - [aurora-packaging](https://github.com/apache/aurora-packaging), the source of the official Aurora packaes
