Message Aid

Docker

The following is a step-by-step list of instructions for installing your Agent on to a machine with a working Docker setup.

SetUp

1. Provide your AWS Account Number to Message Aid

This should look like XXXXXXXXXXXX

2. Verify network access

Outbound Internet

So you can pull the docker image

ping google.com

Access to Message Aid Broker

ability to relay information back to Message Aid

> telnet agents.us.messageaid.com 5671

Trying 3.92.156.37...
Connected to agents.us.messageaid.com.
Escape character is '^]'.

Access to your Broker

So the agent can connect to the broker

AMQP

> telnet $YOUR_HOST 5671

Trying 10.0.0.0 ...
Connected to $YOUR_HOST.
Escape character is '^]'.

HTTPS

> telnet $YOUR_HOST 443

Trying 10.0.0.0 ...
Connected to $YOUR_HOST.
Escape character is '^]'.

Access to your Locker

S3

telnet $S3_ENDPOINT 443

Installation

1. Authenticate to AWS Elastic Container Registry

aws ecr get-login-password --region region | docker login --username AWS --password-stdin 550846617829.dkr.ecr.us-east-1.amazonaws.com

Detail Documentation

2. Run via Docker

docker run -it \
  --env MESSAGEAID__CONNECTION_STRING=amqps://$USERNAME:$PASSWORD@agents.us.messageaid.com/$QUEUE
\
  550846617829.dkr.ecr.us-east-1.amazonaws.com/prod-us-agent:latest

3. Expected Log Output

[11:16:49 INF] Config Root = /src/MessageAid.Agent
[11:16:49 INF] Loading /src/MessageAid.Agent/appsettings.yaml into config
[11:16:49 INF] Loading [env] /src/MessageAid.Agent/appsettings.Development.yaml into config
[11:16:49 INF] Connection via YAML
[11:16:49 INF] Connection via EnvVar
[11:16:49 INF] Intercom: amqps://agents.us.messageaid.com/prod-us-kernel
[11:16:49 INF] amqps://agents.us.messageaid.com/prod-us-kernel/dev-local-agent-00000000-0000-0000-0000-000000000000
[11:16:50 INF] Initialization PreCheck:: Dns=Resolved - TCP:5671=Ok - amqps=Connected
Next
Setup