Getting Started

Prerequisites

  • .NET SDK version pinned in global.json
  • Docker (for a local RabbitMQ instance)

Run locally

  1. Start a local broker with the repo’s dev docker-compose.yml:

    1
    
    docker compose up -d
    
  2. Create a .env file next to Src/WebhooksHandler/WebhooksHandler.csproj describing at least one broker connection (see Configuration for the full format):

    BROKER_URL_1=amqp://user:password@localhost/
    BROKER_ACTIVE=1
    
  3. Build and run:

    1
    2
    
    dotnet build -c Release
    dotnet run --project Src/WebhooksHandler
    
  4. Open /swagger on the running instance to explore and call the API interactively. The root path (/) redirects there automatically.

Run the tests

1
dotnet test -c Release

This is the same sequence the Build and Test Worker GitHub Actions workflow runs on every push and pull request against main.