APIB Workflow Generator

This generator will create a vagrant box configuration, clone in a base box config, and a base api blueprint. This is a development workflow for a Service Oriented Architecture

First you should cache the box on your local machine by running:

vagrant box add camdesigns/basebox

To install generator-apib from npm, run:

npm install -g generator-apib

This may not be recommended, but I did it:

This will allow the generator to modify your hosts file for you. Otherwise, edit your /etc/hosts file as recommended by the generator each time, this will allow all of the virtual hosts to render properly via nginx.

sudo chown <username> /etc/hosts

Initiate the generator:

yo apib

The VM should be running or you can run vagrant up from the base-box dir

• you can now ssh is and work with your project
• base.dev api.base.dev .. etc. are now all available URLs

Requirements

• vagrant 1.6.3+
• virtualbox 4.3.14+

The Conventions established will create a directory structure similar to this:

base-box
│   README.md
│   Homestead.yaml (symlinked to base-box-config/Homestead.yaml)
│
└─── base-box-config (implementation of the box)
|        |    Homestead.yaml
|        |    readme.md
|        └─── nginx (server configuration)
|           |    base.conf
|           |    base.api.conf
|
└─── base-api-blueprint (the API Blueprint)
|       |     README.md
|       |     template.txt (used for scripting that will come later)
|       └───  resources
|             |     users.md
|
└─── base-api (your api implementation)
└─── base-ui (you ui implementation)
└─── tools (server tooling / monitoring and ui)
        └─── beanstalkd
        └─── genghis
        └─── opcache
        └─── test

Box definition ( Ubuntu 14.04 )

• https://vagrantcloud.com/camdesigns/boxes/basebox

Troubleshooting

• Ports 3306 and 27017 will be forwarded on the VM to the host machine to allow for Mongo and MySQL connections
• ensure you have a ~/.ssh/id_rsa key or remap the key in the Homestead.yaml file
• screens will be running in sudo so to see what servers / processes are running try sudo screen -ls (get familiar with screens if you are not already)

Workflow

• In the base-box-config directory you can script your box to do all the things you need (add / configure packages, add scripts for seeding, migration, etc. so your ENV si fully reproducible everytime)
• In the base-api-blueprint Define your API following the standards in http://apiblueprint.org/
• In the subsequent base-? directories implement your APIs and SPAs as needed.
• https://www.npmjs.org/package/api-mock will be running the initial mock server at mock.base.dev
• https://www.npmjs.org/package/aglio will be running the initial docs server at docs.base.dev
• npm install dredd is availbe for api testing
• go HAM