The very first thing you want to do, no two ways about it, is install the FatFractal Engine on your development machine. Installing the local runtime and Command Line Interface (CLI) tools is really simple. All you need to do is download the distribution, unzip it, copy the contents to the directory you want and the add the location to your path. It only takes a few minutes and does not invade your machine with a lot of unnecessary stuff.
The FatFractal runtime download is required to deploy apps and to run a local instance of the FatFractal engine. After downloading, getting started is a snap:
cdinto FatFractal_Runtime and run the command
> cd <FatFractal_Runtime>; > bin/ff-service cl
The Hoodyoodoo Tutorial's sample app is written using the acme.fatfractal.com API on the cloud, which means that it really works when you download it. To create and use your own API, you need to follow the getting started sections below and change the baseUrl of the FatFractal instance to use yours. You can choose to deploy your API either locally or in the cloud; it really is up to you. If you feel like keeping it away from the InterWebs, you may do that as well. You will want to jump for joy, upon learning that the FatFractal Engine is identical whether on your local setup or in the cloud. It's not a simulator. It is the whole schlemiel. If you do choose to work locally and deploy to the cloud later, it will work just as you would expect.
If you download the sample files, you will notice you can run the application immediately using the acme.fatfractal.com/hoodyoodoo API that we have deployed. To create your own instance of the hoodyoodoo API, you need to scaffold your application and configure the API.
First, create a directory for your project called hoodyoodoo.
> cd $HOME; > cd ffapps > mkdir hoodyoodoo > cd hoodyoodoo
Then, scaffold the application by doing the following using your subdomain:
> <install directory>/fatfractal/runtime/ffnsbin/ffef newapp hoodyoodoo <your subdomain>
Note: The subdomain refers to one you've registered in the FatFractal Console or during the installation process (e.g. 'acme' in acme.fatfractal.com)
This will create all the information your API needs to work with your application.
If you haven't already, go to the Console and add an application called hoodyoodoo to <your subdomain>.
To deploy the now-scaffolded hoodyoodoo API to the NoServer Public Cloud via the command line, you use the command ffef deployFFFabric:
> <install directory>/fatfractal/runtime/ffnsbin/ffef deployFFFabric
In a few seconds, your application will be available at http://<your subdomain>.fatfractal.com/hoodyoodoo
For more information, see Getting Started.
Assuming that the FatFractal Engine is running, you can deploy to your development machine via the command line using ffef deploylocal:
> <install directory>/fatfractal/runtime/ffnsbin/ffef deploylocal
Your API will be available at http://localhost:8080/hoodyoodoo