This is a compilation of resources to help you learn Onyx. We've listed them in an order that is conducive to teaching the absolute beginning, but you can jump around as you wish.
If you're brand new to Onyx, the best place that you can begin your journey is with onyx-starter. This is a repository that contains one very simple Onyx job that should work 100% out of the box. It exercises a few different features so that you can get a feel for how jobs are structured. Go ahead and follow the instructions below to start playing:
# Are you running Java 8? It's required for Onyx.
$ java -version
$ git clone git@github.com:onyx-platform/onyx-starter.git
$ cd onyx-starter
$ lein testOnce you've gotten your feet wet with the basic idea of Onyx, it's time to learn how to command its API to do your will. The next useful resource is called learn-onyx. This repository contains a large set of exercises that can be studied and completed independently. It is sometimes used for interactive workshops at conferences, but has been designed to be useful for the solo developer. There are loads of comments and documentation tips to help you along. Clone the repository and read the `README.md` for the instructions.
$ git clone git@github.com:onyx-platform/learn-onyx.git
$ cd learn-onyx
$ less README.mdOnce you've mastered the basic features of Onyx, you might still be wondering about how to do more advanced things. We've anticipated this need and created a large suite of fully self-contained, executable examples. The subdirectory name indicates what the example project will do when you run it. If you have any suggestions about further examples that we can write, open an issue on the repository.
$ git clone git@github.com:onyx-platform/onyx-examples.git
$ cd onyx-examples
$ less README.mdBy now you're probably comfortable with the prospect of what Onyx is and how its interfaces let you express various distributed computations. The next step is to write your own application. Distributed programs are generally non-trivial to set up. There's the usual networking problems, infrastructure requirements, metrics and monitoring, deployment - the list goes on. We've created an application template to take the sting out of doing this by hand. Run the following to get a fresh Leiningen application template:
$ lein new onyx-app hello-world
$ cd hello-world
$ less README.mdThe Onyx cheat sheet is the definitive specification for the API and information model. Every allowable parameter is documented with its purpose, type, constraints, and relation to other parameters.
We send out occasional with status updates about the project. You can sign up here.
Onyx has made its appearance at various conferences. These videos are helpful for getting into the finer details of how Onyx works. They are listed in reverse-chronological order.