run-agent

Pikacloud run-agent

On-premise run-agent for Pikacloud services.

Features

• Docker container management
• aggregate multiples hosts from any provider (bare-metal servers, virtual machines, development machines...) to build run-agent clusters
• stream and store docker containers logs
• remote terminals
• build Docker images from Git repository
• realtime metrics

How to run Pikacloud run-agent

Requirements:

• Up to date Docker daemon
• Access to the Docker socket
• a Pikacloud API token in order to connect the Agent to your Pikacloud account: available here.

Launch run-agent with Docker:

docker run -e PIKACLOUD_API_TOKEN=xxxxxxxxx -e PIKACLOUD_AGENT_LABELS="cluster=nginx,dc1" --restart=always --net=host -v /var/run/docker.sock:/var/run/docker.sock --name=run-agent pikacloud/run-agent

You can assign labels to your agent with PIKACLOUD_AGENT_LABELS environment variable. Containers can be assigned by selecting agents with their labels. Example:

# Separate each label with a comma
PIKACLOUD_AGENT_LABELS="web,database=mysql,region=eu-west-1"

For developers

Build source code

$ go get github.com/pikacloud/run-agent
$ cd $HOME/go/src/github.com/run-agent
$ [Env Variables...] ./run-agent

Run tests:

go test -v

Running inside a docker container:

$ docker build -t run-agent-dev .
$ docker run -it --rm -e PIKACLOUD_WS_URL=ws://devserver:8080 -e PIKACLOUD_AGENT_URL=http://devserver:28002/api/ -e PIKACLOUD_API_TOKEN=XXXX -e PIKACLOUD_AGENT_LABELS="sandbox,builder,cluster" -e LOG_LEVEL=debug --net=host -v /var/run/docker.sock:/var/run/docker.sock --name=run-agent-dev run-agent-dev run-agent

Environment variables

Pikacloud API

https://pikacloud.com/api/v1/