# Containerized Edge Agent

A containerized version of the edge agent is built using Github Actions, and is available from AWS
ECR Public Gallery: https://gallery.ecr.aws/aws-iot-fleetwise-edge/aws-iot-fleetwise-edge

## Running the Container

Use `tools/provision.sh` to provision credentials, then run the container by:

1. Mounting the MQTT certificate and private key at `/etc/aws-iot-fleetwise/certificate.pem` and
   `/etc/aws-iot-fleetwise/private-key.key` respectively.
2. Pass the following environment variables to the container:

- `VEHICLE_NAME`: Vehicle name
- `ENDPOINT_URL`: MQTT Endpoint URL
- `CAN_BUS0`: CAN bus 0, e.g. `vcan0`

For example:

```bash
docker run \
    -ti \
    --network=host \
    -v <PATH_TO_CERTIFICATE_FILE>:/etc/aws-iot-fleetwise/certificate.pem \
    -v <PATH_TO_PRIVATE_KEY_FILE>:/etc/aws-iot-fleetwise/private-key.key \
    --env VEHICLE_NAME=<VEHICLE_NAME> \
    --env ENDPOINT_URL=<ENDPOINT_URL> \
    --env CAN_BUS0=<CAN_BUS0> \
    public.ecr.aws/aws-iot-fleetwise-edge/aws-iot-fleetwise-edge
```

3. Alternatively credentials can be directly passed as environment variables to the container:

For example:

```bash
docker run \
    -ti \
    --network=host \
    --env CERTIFICATE="-----BEGIN-----\nXXXXX\n-----END-----\n" \
    --env PRIVATE_KEY="-----BEGIN-----\nXXXXX\n-----END-----\n" \
    --env VEHICLE_NAME=<VEHICLE_NAME> \
    --env ENDPOINT_URL=<ENDPOINT_URL> \
    --env CAN_BUS0=<CAN_BUS0> \
    public.ecr.aws/aws-iot-fleetwise-edge/aws-iot-fleetwise-edge
```