add Dockerfile and associated configuration

.gitignore

@@ -0,0 +1 @@
+.env

Dockerfile

@@ -0,0 +1,13 @@
+FROM python:3.12-slim
+
+ENV DATADOG_SITE=datadoghq.eu
+
+WORKDIR /app
+
+COPY src/ ./
+COPY requirements.txt ./
+COPY entrypoint.sh ./
+
+RUN pip install --no-cache-dir -r requirements.txt
+
+ENTRYPOINT ["./entrypoint.sh"]

README.md

@@ -48,6 +48,37 @@ To learn more about graphs using python, check out [Matplotlib](https://matplotl
 - An organisation ID is required. This defaults to the ID of the organisation that is executing the job on CircleCI.
 - If sending metrics to Datadog, then a `DATADOG_API_KEY` is required.
 
+## Docker Usage
+
+To build the Docker image:
+
+```sh
+docker build --tag circleci-usage-api-exporter ./
+```
+
+To run the container (set environment variables as needed):
+
+```sh
+docker run --rm \
+  --env CIRCLECI_API_TOKEN=your_token \
+  --env DATADOG_API_KEY=your_datadog_key \
+  --env DATADOG_SITE=your_datadog_site \
+  --env START_DATE=2025-07-22 \
+  --env END_DATE=2025-07-23 \
+  --env MERGE_USAGE_REPORTS=false \
+  --env ORG_ID=your_org_id \
+  --env SEND_TO_DATADOG=true \
+  circleci-usage-api-exporter
+```
+
+or
+
+```sh
+docker run --env-file .env --rm circleci-usage-api-exporter
+```
+
+Adjust the environment variables as required for your use case.
+
 ### Caveats
 
 - My python skillz aren't great.

entrypoint.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+set -e
+
+./get_usage_report.py
+
+if [ "${SEND_TO_DATADOG}" = "true" ]; then
+  for csv_file in /tmp/reports/*.csv; do
+    # Check if the file actually exists (in case the glob didn't match anything)
+    if [ -e "$csv_file" ]; then
+      ./send_to_datadog.py --site "$DATADOG_SITE" "$csv_file"
+    else
+      echo "No CSV files found in /tmp/reports, skipping."
+      break
+    fi
+  done
+fi

requirements.txt

@@ -0,0 +1,9 @@
+certifi==2025.7.14
+charset-normalizer==3.4.2
+datadog-api-client==2.40.0
+idna==3.10
+python-dateutil==2.9.0.post0
+requests==2.32.4
+six==1.17.0
+typing_extensions==4.14.1
+urllib3==2.5.0

src/get_usage_report.py

@@ -1,3 +1,4 @@
+#!/usr/bin/env python3
 # Import modules
 import os
 import requests