Walkthrough

AppFlow walkthrough

Here we document all steps needed for setting up AppFlow on a blank developer machine, usually running OS X or GNU/Linux.

Requirements

Be sure to have installed this components:

• brew
• VirtualBox
• Vagrant

AppFlow auto installation

% bash <(curl -s https://raw.githubusercontent.com/ttssdev/appflow/master/utils/appflow.sh)

This will Install and run AppFlow locally to provision all the required packages. It will also initialize the base VM (atlantis) if you want. AppFlow installs different packages depending on the local development environment:

• OS X
• GNU/Linux

AppFlow configuration

1. Create new config directory layout - mkdir -p ~/.appflow/{tenant,vault}
2. Copy config.example to ~/.appflow/config and update variables:

• CFG_TENANT_ID - identity of the own tenant
• CFG_TENANT_NAME - name of the own tenant
• CFG_TENANT_ENV - default provisioning environment
• CFG_APPFLOW_SUPPORT_MAIL - e-mail address to send support requests to

3. Copy the appflow-mrrobot folder in examples to ~/.appflow/tenant/
4. Link the folder: ln -s ~/.appflow/tenant/appflow-mrrobot ~/.appflow/tenant/mrrobot
5. Copy the vault folder in examples to ~/.appflow/vault

Now you are ready to deploy! You can start provisioning with: appflow provision env=development tenant=mrrobot

Atlantis VM

In case you did not initialize the VM during the installation process, or you want to initialize a new VM, these are simple steps:

% appflow init-vm
% appflow vagrant up atlantis

This will initialize the default VM (Ubuntu 14.04) In case you prefer CentOS/RHEL (Experimental for now)

% appflow init-vm
% appflow vagrant up atlantis-centos

Provison local assh settings for tenants

% appflow ssh [tenant=<tenant>] [env=<environment>]
% assh config build > ~/.ssh/config