CivCloud: Getting Started

Workspace

The workspace is a common execution environment which provides all of the binaries needed to operate the CivCloud platform. It is defined as a Habitat package (habitat/ops-console).

Requirements

• Linux environment with root or sudo privileges. Windows and OS X users can consider some of the following methods to run a linux environment on the local workstation:
  • Windows Subsystem for Linux (Windows only, untested)
  • Habitat Studio
  • Docker/Docker Compose
  • Vagrant/VirtualBox
• Habitat installation in Linux environment
• Ops repository cloned into linux environment

Installation

From within the local repository:

./script/bootstrap

To update the workspace package to the latest version:

./script/update

Usage

The ops-console workspace can be run either interactively or non-interactively.

• Interactive: ./script/console
• Non-interactive: ./script/console <cmd>

The console script simply executes the bash executable installed by the ops-console package with all the associated habitat environment. The console executes in the host linux environment as the running user in the running namespace within the current working directory. It essentially overlays the running bash shell of the running user.