github.com/kyma-incubator/compass/components/director@v0.0.0-20230623144113-d764f56ff805/cmd/ordaggregator/README.md (about)

     1  # Open Resource Discovery Aggregator
     2  
     3  ## Overview
     4  
     5  The Aggregator application collects, aggregates, and stores the ORD information from multiple ORD providers to the Compass's database.
     6  
     7  
     8  ## Details
     9  
    10  The Aggregator basic workflow is as follows:
    11  
    12  1. The Aggregator goes through all available applications, stored in the Compass's database.
    13  2. For each application that has a webhook of type `OPEN_RESOURCE_DISCOVERY` it calls the URL that is attached to that webhook.
    14  3. That URL has predefined endpoints, which provide the necessary information to the Aggregator.
    15  4. The Aggregator aggregates and stores the provided information in the Compass's database.
    16  
    17  ## Configuration
    18  
    19  The ORD Aggregator binary allows you to override some configuration parameters. To get a list of the configurable parameters, see [main.go](https://github.com/kyma-incubator/compass/blob/75aff5226d4a105f4f04608416c8fa9a722d3534/components/director/cmd/ordaggregator/main.go#L49).
    20  
    21  ## Local Development
    22  ### Prerequisites
    23  The Aggregator requires access to:
    24  1. A configured PostgreSQL database with the imported Director's database schema.
    25  2. An existing application with a `OPEN_RESOURCE_DISCOVERY` webhook. It can be created manually in the database or can be created via the Director GraphQL API. To run Director locally, see [Director](../director/README.md).
    26  3. An API that can be called to fetch and process ORD documents.
    27  
    28  ### Run
    29  Since the ORD Aggregator is usually a short-lived process, it is useful to start and debug it directly from your IDE.
    30  Make sure that you provide all required configuration properties as environment variables.