Arepas-commander NPM

arepas-commander

Arepas Commander is an NPM CLI tool to interact with an ADEs (Arepas Development Environments)

Prerequisites

The following software needs to be installed on your system:

Arepas Development Environment (ADE)

Any ADE have the following components

A Vagrant Box provisioned for an specific development platform (currently we support only PHP and Go)
A .json file to manage environment settings
A shared folder structure to share files between your computer and the vagrant box (you can use your preferred IDE or text editor to edit your files).
A set of shell recipes to install and setup software related to the chosen development platform and also recipes to perform automated tasks in an easy way.
An internal CLI installed in the vagrant box(see the arepas-cli repository)

All this components are managed by an external CLI (which is provided by this package/repository)

Installation

Just install arepas-commander as any other npm package at the npm registry.

npm install -g arepas-commander

Setting up your ADE

Create a folder wherever you want on your filesystem to home your workspace. Then use the arepas init command to initialize your ADE

In example:

mkdir workspace
cd workspace
arepas init php

After initializing your ADE you will have a new folder in your workspace with a Vagrantfile and an ade_{platform}.json file.

Example for PHP

{
	"ade": {
		"platforms": {
			"PHP": {
				"version": "20171030",
				"platform": "php",
				"hostname": "php.arepasapp.com",
				"memory": "1024",
				"ip": "192.168.56.151",
				"dns": {
					"entry": [
						{
							"domain": "php.arepasapp.com",
							"active": "yes"
						},
						{
							"domain": "phpapp.arepasapp.com",
							"active": "yes"
						}
					]
				},
				"apps": {
					"docs": {
						"dns": "php.arepasapp.com",
						"uri": "/docs",
						"webroot": "/var/www/projects/arepas-docs",
						"port": "80",
						"ssl": "no",
						"require": [
							"laravel",
							"bedrock",
							"wp-cli"
						]
					}
				}
			}
		}
	}
}

The meaining of every setting is explained in each ADE's github repository.

Starting your ADE

Once initilized your ADE you need to start it. On the first start up vagrant will run the provisioning process to setup all software. You just need to type this on your workspace: