This repository contains comprehensive guides, tools, and solutions for deploying, configuring, and integrating Azure Data Manager for Energy (ADME) with various Azure services and external systems. These solutions are designed to help organizations maximize the value of their OSDU-based energy data platform.
- Automatic Data Lake Ingestion - Automated pipeline for ingesting binary data from Azure Data Lake Storage (ADLS) into ADME using Azure Synapse Analytics
- Schema Upgrade Tool - Automated container-based tool for upgrading OSDU schema versions in your ADME instance
- Connected Production DDMS - Deploy production data management services with Azure App Services and PostgreSQL
- Connected Reservoir DDMS - Kubernetes-based reservoir data management service deployment guide
- Connected Rock and Fluid DDMS - Sample rock and fluid data management service using Azure Container Apps or AKS
- Azure AD to Entitlements Sync - Logic App solution for synchronizing Azure AD groups with ADME entitlements, supporting dynamic group assignments
- Dedicated Token App Registration - Secure token provisioning solution separating authentication from data access privileges
- Custom Domain Configuration - Deploy Azure API Management as a gateway with custom DNS domains for ADME APIs (supports both public and private endpoint configurations)
- Complete API Collections - Comprehensive Postman and Bruno collections covering all ADME M18 core services APIs
- Notification Relay - Service to relay notifications from ADME/OSDU to Azure Services
- Power Connector API Specifications - OpenAPI specifications for M23 services including compliance, dataset, entitlements, and various DDMS services
- Power BI Integration - Ready-to-use Power BI templates for visualizing ADME data, including TNO dataset examples and generic query templates
| Solution | Type | Use Case |
|---|---|---|
| Data Lake Ingestion | Azure Synapse Pipeline | Automated binary data ingestion from external storage |
| Schema Upgrade Tool | Container App | OSDU schema version management |
| Solution | Platform | Description |
|---|---|---|
| Production DDMS | Azure App Services | Production data management with PostgreSQL backend |
| Reservoir DDMS | Azure Kubernetes Service | Scalable reservoir data management |
| Rock & Fluid DDMS | Container Apps/AKS | Sample implementation for rock and fluid data |
| Solution | Technology | Purpose |
|---|---|---|
| AAD Entitlements Sync | Azure Logic Apps | Group membership synchronization |
| Token App Registration | Azure AD | Secure token provisioning |
| Solution | Service | Benefit |
|---|---|---|
| Custom Domain | API Management | Brand consistency and custom DNS |
| API Collections | Postman/Bruno | Complete API testing and documentation |
| Notification Relay | Message Queue | Service to relay notifications from ADME/OSDU to Azure Services |
| Power Connector | OpenAPI Specs | M23 service specifications |
| Solution | Platform | Focus |
|---|---|---|
| Power BI Templates | Power BI | Data visualization and reporting |
- Choose your deployment scenario based on your organization's requirements
- Review prerequisites for each solution in their respective guides
- Follow step-by-step instructions provided in each guide
- Test and validate your deployment using the included validation steps
Each solution guide includes:
- Overview and architecture diagrams
- Prerequisites and dependencies
- Step-by-step deployment instructions
- Configuration parameters and options
- Validation and testing procedures
- Troubleshooting guidance
- Cleanup instructions
I welcome contributions to improve these solutions:
- Issues: Report bugs or request features
- Pull Requests: Submit improvements or new solutions
- Documentation: Help improve guides and examples
Please ensure all contributions follow best practices and include appropriate documentation.
This repository contains community-contributed solutions and is not officially affiliated with Microsoft employment. These solutions are provided as-is for educational and reference purposes. Always review and test thoroughly before implementing in production environments.
For issues related to:
- Azure Data Manager for Energy: Use official Microsoft support channels
- OSDU Platform: Refer to the OSDU Community
- Repository Solutions: Create an issue in this repository