Getting Started

Last updated 6 months ago

Prerequisites

ALM-agent includes the following prerequisites.

REQUIREMENT

DESCRIPTION

Supported Operating System

Instances must run on a supported version of Linux. Amazon Linux 2016.09 or later, Ubuntu Server 14.04 LTS or later, CentOS7 or later, Red Hat Enterprise Linux(RHEL) 7 or later.

Internet Access

If your server configuration design requires services to access the public Internet (e.g. GitHub, DockerHub, etc..), verify that your instances have outbound Internet access first.

Docker

Instances should have Docker installed.

Git

Instances should have Git installed.

Install ALM agent

There are two ways to installing ALM Agent:

  1. Using a precompiled binary

  2. Installing from source

Download and install from a precompiled binary is the recommended option.

Using a precompiled binarys

ALM-agent is distributed as a binary package. To install ALM-agent, you can download it from this link.

ALM-agent is packaged as a tgz archive. After downloading ALM-agent, untgz the package. ALM-agent runs as a single binary named alm-agent.

$ mkdir -p /opt/mobingi/alm-agent /opt/mobingi/etc
$ wget https://download.labs.mobingi.com/alm-agent/develop/current/alm-agent.tgz
$ tar xvzf alm-agent.tgz -C /opt/mobingi/alm-agent
$ ln -sf /opt/mobingi/alm-agent/v* /opt/mobingi/alm-agent/current

Installing from source

We prepare Vagrantfile to compile from source. You will need VirtualBox and Vagrant installed. You can compile in virtual machine.

$ git clone https://github.com/mobingi/alm-agent
$ cd alm-agent
$ vagrant up default
$ vagranth ssh default
vagrant $ cd /home/vagrant/src/github.com/mobingi/alm-agent/
vagrant $ make build

Verifying the Installation

After installing ALM-agent, verify the installation works and check that alm-agent is available.

By executing alm-agent you should see the help output similar to this:

$ alm-agent
NAME:
alm-agent
USAGE:
alm-agent [global options] command [command options] [arguments...]
VERSION:
v0.3.1504270893
COMMANDS:
register initialize alm-agent and start containers
ensure start or update containers
stop stop active container
noop run without container actions.
help, h Shows a list of commands or help for one command
GLOBAL OPTIONS:
--autoupdate, -U auto update before run
--disablereport, -N Do not send crash report to rollbar.
--provider Provider, -P Provider set Provider (default: "aws")
--verbose, -V show debug logs
--help, -h show help
--version, -v print the version