Installation and Configuration

Installation

To install the CLI tool for use in your own project, execute pip install heliumcli. The tool is now available by running helium-cli.

Configuration

The following environment variables can be overriden. Their defaults can be found here.

• HELIUMCLI_GIT_PROJECT - parent URL of all Git repos
• HELIUMCLI_PROJECTS - repo name of each Git project (relative to HELIUMCLI_GIT_PROJECT)
• HELIUMCLI_PROJECTS_RELATIVE_DIR - where all projects will be cloned and stored relative to this tool
• HELIUMCLI_SERVER_BIN_FILENAME - the relative path of the server executable for each project (if one exists)
• HELIUMCLI_ANSIBLE_RELATIVE_DIR - where Ansible configurations, used for deployment, live relative to this tool; ignore if not using Ansible
• HELIUMCLI_ANSIBLE_COPYRIGHT_NAME_VAR - the name of the Ansible variable that contains copyright information for updating headers; use HELIUMCLI_COPYRIGHT_NAME if not using Ansible
• HELIUMCLI_COPYRIGHT_NAME - the copyright information for updating headers—if set, HELIUMCLI_ANSIBLE_COPYRIGHT_NAME_VAR will be ignored.
• HELIUMCLI_UPDATE_COPYRIGHT_YEAR - defaults true, set false if copyright headers should not be updated when prepping code for release
• HELIUMCLI_HOST_PROVISION_COMMAND - a command (or chain of commands) that will be run immediately after SSHing into every host node—the default is to install Python; ignore if not using Ansible
• HELIUMCLI_VERSION_INFO_PROJECT - the project that holds the master version file
• HELIUMCLI_VERSION_INFO_PATH - the location of the version file, relative to VERSION_INFO_PROJECT
• HELIUMCLI_TAG_ROOT_RELEASE - defaults true, set to false if root repo should not be tagged when prepping a release

The above configuration will be stored in a file .heliumcli.yml (this can be overridden with HELIUMCLI_CONFIG_PATH). If this file does not already exist in the current directory the helium-cli command is being run, you will be prompted to start a new project and create it.