Setting up dev/test environment

Get go installed and environment configured


cd $GOPATH
mkdir -pv src/github.com/{hashicorp,armon,circonus-labs}

cd $GOPATH/src/github.com/hashicorp
git clone https://github.com/maier/consul.git

cd $GOPATH/src/github.com/armon
git clone https://github.com/maier/go-metrics.git

cd $GOPATH/src/github.com/circonus-labs
git clone https://github.com/maier/circonus-gometrics.git


cd $GOPATH/src/github.com/hashicorp/consul
make dev

In $GOPATH/src/github.com/hashicorp/consul/bin is the binary just created.

Create a consul configuration file somewhere (e.g. ~/testconfig.json) and add any applicable configuration settings. As an example:

{
    "datacenter": "mcfl",
    "server": true,
    "log_level": "debug",
    "telemetry": {
        "statsd_address": "127.0.0.1:8125",
        "circonus_api_token": "...",
        "circonus_api_host": "..."
    }
}

StatsD was used as a check to see what metrics consul was sending and what metrics circonus was receiving. So, it can safely be elided.

Fill in appropriate cirocnus specific settings:

circonus_api_token - required
circonus_api_app - optional, default is circonus-gometrics
circonus_api_host - optional, default is api.circonus.com (for dev stuff yon can use "http://..." to circumvent ssl)
circonus_submission_url - optional
circonus_submission_interval - optional, seconds, defaults to 10 seconds
circonus_check_id - optional
circonus_broker_id - optional (unless you want to use the public one, then add it)

The actual circonus-gometrics package has more configuraiton options, the above are exposed in the consul configuration.

CirconusMetrics.InstanceId is derived from consul's config.NodeName and config.Datacenter CirconusMetrics.SearchTag is hardcoded as 'service:consul'

The defaults are taken for other options.

To run after creating the config:

$GOPATH/src/github.com/hashicorp/consul/bin/consul agent -dev -config-file <config file>

or, to add the ui (localhost:8500)

$GOPATH/src/github.com/hashicorp/consul/bin/consul agent -dev -ui -config-file <config file>

2.1 KiB Raw Blame History

Setting up dev/test environment

2.1 KiB

Raw Blame History