wehub-resource-sync
bf2343b7e4
Integration Tests - MySQL + Elasticsearch / Detect Changes (push) Waiting to run
Integration Tests - MySQL + Elasticsearch / integration-tests-mysql-elasticsearch (push) Blocked by required conditions
Integration Tests - PostgreSQL + Elasticsearch + Redis / Detect Changes (push) Waiting to run
Integration Tests - PostgreSQL + Elasticsearch + Redis / integration-tests-postgres-elasticsearch-redis (push) Blocked by required conditions
Integration Tests - PostgreSQL + OpenSearch / Detect Changes (push) Waiting to run
Integration Tests - PostgreSQL + OpenSearch / integration-tests-postgres-opensearch (push) Blocked by required conditions
Java Checkstyle / java-checkstyle (push) Waiting to run
Maven Collate Tests / maven-collate-ci (push) Waiting to run
OpenMetadata Service Unit Tests / Detect Changes (push) Waiting to run
OpenMetadata Service Unit Tests / openmetadata-service-unit-tests (push) Blocked by required conditions
OpenMetadata Service Unit Tests / k8s_operator-unit-tests (push) Blocked by required conditions
OpenMetadata Service Unit Tests / openmetadata-service-unit-tests-status (push) Blocked by required conditions
Publish Package to Maven Central Repository / publish-maven-packages (push) Waiting to run
49 lines
2.7 KiB
Markdown
49 lines
2.7 KiB
Markdown
How to Add a New Application
|
|
|
|
## Create App Config
|
|
|
|
in `openmetadata-spec/src/main/resources/json/schema/entity/applications/configuration` define the json schema representing your application configuration.
|
|
- external: these are applications that will run externaly (e.g. Airflow). If your application has its execution logic defined in Python, this is where the code logic should live
|
|
- internal: these will application will be executed through the Qwartz scheduler form the application itself. The code logic for this application will be written in Java.
|
|
|
|
you can follow this naming convention <yourAppName>AppConfig.json
|
|
|
|
|
|
## Define default app config
|
|
|
|
in `openmetadata-service/src/main/resources/json/data/app` define the default setting of your application. Create a new json following this naming convention `<youAppName>Application.json`
|
|
|
|
## Define your app in the Application Marketplace
|
|
|
|
In `openmetadata-service/src/main/resources/json/data/appMarketPlaceDefinition`, define the elements of your application as they will appear in the app marketplace.
|
|
|
|
Note that you can specify a `"sourcePythonClass": “path.to.python.class”` if your application code logic is defined in Python
|
|
|
|
## Add the config to the UI
|
|
|
|
In `openmetadata-ui/src/main/resources/ui/src/utils/ApplicationSchemas` add the config for your application so it can be rendered from the UI. Follow this naming convention `<yourAppName>Application.json`
|
|
|
|
## Implement Java class
|
|
In `openmetadata-service/src/main/java/org/openmetadata/service/apps/bundles` implement the java class corresponding to your application.
|
|
|
|
Not that the value of the `className` from step 3 should match the class name / path defined at this stage
|
|
|
|
## [Optional] Implement Python logic
|
|
If you have defined an external application, you need to create the relevant Python class that implements the logic. The path of the class needs to match the value of `sourcePythonClass`. You will need to inherit from the `AppRunner` class and at minimum implement the `def run` method.
|
|
|
|
e.g. `ingestion/src/metadata/applications/observability_data_exporter/app.py`
|
|
|
|
## [Optional] Disabling the application
|
|
In `openmetadata-service/src/main/resources/applications` you can add private configuration to your application. You also have the possibility to disable the application by setting `enabled: false` so that users cannot install it. Below is an example of the configuration.
|
|
|
|
```
|
|
enabled: false
|
|
parameters:
|
|
instance: <instance>
|
|
token: <token?
|
|
omURL: <omURL>
|
|
```
|
|
|
|
Setting `enabled: false` will prevent users from being able to install the application. The private configuration parameters can be set at `openmetadata-spec/src/main/resources/json/schema/entity/applications/configuration/private`
|
|
|