Oracle Cloud Usage Discord Bot

This bot notifies you daily on Discord about your Oracle Cloud usage, helping you avoid exceeding your free tier or incurring charges.

Features

• Fetches daily Oracle Cloud usage via the Oracle Cloud API
• Sends a daily summary to a specified Discord channel
• Customizable notification thresholds and schedule

---

Quick Start (Docker)

1. Prepare your environment

• Copy env.sample to .env and fill in your values:

  cp env.sample .env
  # Edit .env with your credentials and preferences

• Make sure your Oracle Cloud API private key (e.g., key.pem) is in the project directory.
• You can obtain your Oracle Cloud credentials (User OCID, Tenancy OCID, API Key, etc.) from the Oracle Cloud Auth Tokens page.

2. Build the Docker image (optional)

If you want to build locally:

docker build -t ocm-bot .

3. Run with Docker Compose (recommended)

version: '3.8'
services:
  ocm:
    image: ghcr.io/iamneuro/ocm:latest  # or use 'ocm-bot' if you built locally
    container_name: ocm
    restart: unless-stopped
    env_file:
      - .env
    volumes:
      - ./key.pem:/app/key.pem:ro

Start the service:

docker-compose up -d

4. Run with plain Docker

docker run -d \
  --name ocm \
  --env-file .env \
  -v $(pwd)/key.pem:/app/key.pem:ro \
  ghcr.io/iamneuro/ocm:latest

---

Environment Variables

Variable	Required	Description	Example / Default
OCI_USER_OCID	Yes	Oracle Cloud User OCID	ocid1.user.oc1..xxxx
OCI_TENANCY_OCID	Yes	Oracle Cloud Tenancy OCID	ocid1.tenancy.oc1..xxxx
OCI_FINGERPRINT	Yes	API Key fingerprint	12:34:56:78:90:ab:cd:ef
OCI_REGION	Yes	Oracle Cloud region	us-ashburn-1
DISCORD_WEBHOOK_URL	Yes	Discord webhook URL for notifications	https://discord.com/api/webhooks/...
MIN_DAILY_USAGE	No	Minimum daily usage to trigger a notification (float, in your currency)	0
MAX_DAILY_USAGE	No	Maximum daily usage to trigger an alert (float, in your currency)	0
CURRENCY	No	Currency symbol for notifications	$
SUMMARY_SCHEDULE	No	Cron for summary notifications (default: weekly)	0 0 * * 0
DAILY_LIMIT_SCHEDULE	No	Cron for daily limit alerts (default: daily)	0 0 * * *

Note: The private key file (e.g., key.pem) must be mounted into the container at /app/key.pem.

---

Notes

• The bot checks usage on the schedule you define and posts the result to your Discord channel.
• Make sure your private key file is accessible and permissions are set correctly.
• You can use the provided docker-compose.yml or run the container manually.

License

MIT