generated from CloudFormations/procfwk
-
Notifications
You must be signed in to change notification settings - Fork 6
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
3590e88
commit 70983c1
Showing
1 changed file
with
3 additions
and
66 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,72 +1,9 @@ | ||
# Read Me - Orchestrate.[procfwk](http://procfwk.com/) | ||
# Read Me - Cloud Formations (CF).Cumulus | ||
|
||
[ ![](https://mrpaulandrew.github.io/procfwk/overview.png) ](https://mrpaulandrew.github.io/procfwk/overview.png) | ||
|
||
## Documentation | ||
|
||
For complete documentation on this solution see [procfwk.com](http://procfwk.com/). | ||
|
||
## Framework Capabilities | ||
|
||
* Granular metadata control. | ||
* Metadata integrity checking. | ||
* Global properties. | ||
* Complete pipeline dependency chains. | ||
* Concurrent batch executions (hourly/daily/monthly). | ||
* Execution restart-ability. | ||
* Parallel pipeline execution. | ||
* Full execution and error logs. | ||
* Operational dashboards. | ||
* Low cost orchestration. | ||
* Disconnection between framework and Worker pipelines. | ||
* Cross Tenant/Subscription/Data Factory control flows. | ||
* Pipeline parameter support. | ||
* Simple troubleshooting. | ||
* Easy deployment. | ||
* Email alerting. | ||
* Automated testing. | ||
* Azure Key Vault integration. | ||
* Is pipeline already running checks. | ||
|
||
## Complete Data Factory Activity Chain | ||
|
||
[ ![](https://mrpaulandrew.github.io/procfwk/activitychain-full.png) ](https://mrpaulandrew.github.io/procfwk/activitychain-full.png) | ||
|
||
## Issues | ||
|
||
If you've found a bug or have a new feature request please log the details using the repository issues. | ||
|
||
Go to... [Issues](https://github.com/mrpaulandrew/procfwk/issues) | ||
|
||
## Projects | ||
Go to... [External Requests](https://github.com/mrpaulandrew/procfwk/projects/2) | ||
|
||
Go to... [Internal Backlog](https://github.com/mrpaulandrew/procfwk/projects/1) | ||
[ ![](https://static.wixstatic.com/media/e66568_635e25cb91f44be580ef08cd83e68c6f~mv2.jpg/v1/crop/x_480,y_506,w_5433,h_2414/fill/w_2221,h_987,al_c,q_90,usm_0.66_1.00_0.01,enc_auto/Cumulus%20Diagram.jpg) ](https://static.wixstatic.com/media/e66568_635e25cb91f44be580ef08cd83e68c6f~mv2.jpg/v1/crop/x_480,y_506,w_5433,h_2414/fill/w_2221,h_987,al_c,q_90,usm_0.66_1.00_0.01,enc_auto/Cumulus%20Diagram.jpg) | ||
|
||
## Release Details | ||
|
||
| Version | Overview | Version Details & Release Notes | | ||
|:----:|--------------|--------| | ||
| 2.0 |Azure Synapse Analytics fully supported as an interchangeable orchestrator of pipelines within the procfwk.|GitHub Pages: </br>[Orchestrators](https://mrpaulandrew.github.io/procfwk/orchestrators)</br>[Orchestrator Types](https://mrpaulandrew.github.io/procfwk/orchestratortypes) </br></br>Release Summary Video: </br>[YouTube - procfwk Playlist](https://www.youtube.com/c/mrpaulandrew)<br/><br/>GitHub Issues:</br>[procfwk #95](https://github.com/mrpaulandrew/procfwk/issues/95) | | ||
| 2.0-beta |<u>Azure Synapse Analytics **Beta** support</u> added.<br/><br/>Development of Azure Functions App completed using the Synapse namespace: _Azure.Analytics.Synapse.Artifacts_ with version **1.0.0-beta.1** of the NuGet package.|GitHub Issues:</br>[procfwk #21](https://github.com/mrpaulandrew/procfwk/issues/21) | | ||
| 1.9.2 |<u>Batch Executions</u> added, plus:<ul><li>Exception Pipeline</li><li>Running Pipeline Check</li><li>Pipeline Parameter Last Values</li><li>Worker Pipeline Validation</li></ul>|GitHub Pages: [Batch Executions](https://mrpaulandrew.github.io/procfwk/executionbatches) </br></br>Release Demo Summary Video: [YouTube - procfwk Playlist](https://www.youtube.com/c/mrpaulandrew)<br/><br/>GitHub Issues:</br>[procfwk #78](https://github.com/mrpaulandrew/procfwk/issues/78)<br/>[procfwk #77](https://github.com/mrpaulandrew/procfwk/issues/77)<br/>[procfwk #71](https://github.com/mrpaulandrew/procfwk/issues/71)<br/>[procfwk #73](https://github.com/mrpaulandrew/procfwk/issues/73)<br/>[procfwk #80](https://github.com/mrpaulandrew/procfwk/issues/80)<br/>[procfwk #72](https://github.com/mrpaulandrew/procfwk/issues/72) | | ||
| 1.9.1 |<u>Activity Policy Update</u>, plus:<ul><li>Secure Activity Inputs/Outputs.</li><li>Execution Wrapper Hardening.</li><li>New Activity Icons and Framework Factory Cosmetics.</li></ul> |GitHub Issues:</br>[procfwk #65](https://github.com/mrpaulandrew/procfwk/issues/65)<br/>[procfwk #66](https://github.com/mrpaulandrew/procfwk/issues/66)<br/>[procfwk #67](https://github.com/mrpaulandrew/procfwk/issues/67)<br/>[procfwk #69](https://github.com/mrpaulandrew/procfwk/issues/69) | | ||
| 1.9.0 |<u>Cross Tenant & Subscription Support</u> added, plus:<ul><li>New integration tests created.</li><li>Infant pipeline refactoring.</li><li>tSQLt project added.</li></ul> |GitHub Issues:</br>[procfwk #34](https://github.com/mrpaulandrew/procfwk/issues/34)<br/>[procfwk #35](https://github.com/mrpaulandrew/procfwk/issues/35)<br/>[procfwk #46](https://github.com/mrpaulandrew/procfwk/issues/46)<br/>[procfwk #55](https://github.com/mrpaulandrew/procfwk/issues/55)<br/>[procfwk #56](https://github.com/mrpaulandrew/procfwk/issues/56)<br/>[procfwk #59](https://github.com/mrpaulandrew/procfwk/issues/59) | | ||
| 1.8.6 |<u>Pipeline Expressions Refactored to Use Variables</u> added, plus:<ul><li>New integration tests created.</li><li>Complete activity chain redrawn in Visio.</li></ul> |GitHub Issues:</br>[procfwk #51](https://github.com/mrpaulandrew/procfwk/issues/51)<br/>[procfwk #52](https://github.com/mrpaulandrew/procfwk/issues/52) | | ||
| 1.8.5 |<u>Execution Precursor</u> added, plus:<ul><li>PowerShell helper to add initial Worker metadata.</li></ul> |[procfwk v1.8.5 - Execution Precursor](https://mrpaulandrew.com/2020/08/17/adf-procfwk-v1-8-5-execution-precursor/) | | ||
| 1.8.4 |<u>Database Schema Reorganise and Restructuring</u> |[procfwk v1.8.4 - Database Schema Reorganise and Restructuring](https://mrpaulandrew.com/2020/07/23/adf-procfwk-v1-8-4-database-schema-reorganise-and-restructuring/) | | ||
| 1.8.3 |<u>Bug Fixes from the Community</u>, including:<ul><li>Email alerts sent to blank email addresses due to wrong flow in Child pipeline.</li><li>Worker pipelines cancelled during an execution fail when the framework is restarted due to missing Parent pipeline clean up condition.</li></ul> |GitHub Issues:</br>[procfwk #38](https://github.com/mrpaulandrew/procfwk/issues/38)<br/>[procfwk #37](https://github.com/mrpaulandrew/procfwk/issues/37) | | ||
| 1.8.2 |<u>Optionally Store SPN Details in Azure Key Vault</u> |[procfwk v1.8.2 - Optionally Store SPN Details in Azure Key Vault](https://mrpaulandrew.com/2020/07/22/adf-procfwk-v1-8-2-optionally-store-spn-details-in-azure-key-vault/) | | ||
| 1.8.1 |<u>Automated Framework Pipeline Testing</u> added, including tests for:<ul><li>A simple grandparent run.</li><li>All types of failure dependency handling.</li><li>Metadata checks when pipelines and staged are disabled.</li><li>No pipeline parameters provided.</li></ul> |Blog Series: <br/><ol><li>[Set up automated testing for Azure Data Factory](https://richardswinbank.net/adf/set_up_automated_testing_for_azure_data_factory)</li><li>[Automate integration tests in Azure Data Factory](https://richardswinbank.net/adf/automate_integration_tests_in_azure_data_factory)</li><li>[Isolated functional tests for Azure Data Factory](https://richardswinbank.net/adf/isolated_functional_tests_for_azure_data_factory)</li><li>[Testing Azure Data Factory in your CI/CD pipeline](https://richardswinbank.net/adf/testing_azure_data_factory_in_your_cicd_pipeline)</li><li>[Unit testing Azure Data Factory pipelines](https://richardswinbank.net/adf/unit_testing_azure_data_factory_pipelines)</li><li>[Calculating Azure Data Factory test coverage](https://richardswinbank.net/adf/calculating_azure_data_factory_test_coverage)</li></ol> | | ||
| 1.8.0 |<u>Complete Pipeline Dependency Chains For Failure Handling</u> added, plus:<ul><li>Clean up of a previous execution run if Workers appear as running.</li><li>New metadata integrity checks.</li><li>Internal get property value function added.</li></ul> |[procfwk v1.8 - Complete Pipeline Dependency Chains For Failure Handling](https://mrpaulandrew.com/2020/07/01/adf-procfwk-v1-8-complete-pipeline-dependency-chains-for-failure-handling/) | | ||
| 1.7.3 |Data Factory Deployment Updated To Use azure.datafactory.tools PowerShell Module |[SQLPlayer/azure.datafactory.tools](https://github.com/SQLPlayer/azure.datafactory.tools) | | ||
| 1.7.2 |<u>Pipeline Parameter NULL Handling</u> added, plus:<ul><li>Worker pipelines with a status of 'Running' protected from a new execution start/restart.</li></ul> |[procfwk v1.7.2 - NULL Pipeline Parameters Handled](https://mrpaulandrew.com/2020/06/22/adf-procfwk-v1-7-2-null-pipeline-parameters-handled/) | | ||
| 1.7.1 |<u>Alerting Check Bug Fix</u> added, plus:<ul><li>Pipeline parameter value size limit removed.</li></ul> |[procfwk v1.7.1 - Alerting Bug Fix And Pipeline Parameter Size Limit Removed](https://mrpaulandrew.com/2020/06/12/adf-procfwk-v1-7-1-alerting-bug-fix-and-pipeline-parameter-size-limit-removed/) | | ||
| 1.7.0 |<u>Pipleline EMail Alerting</u> added, plus:<ul><li>Send email Function implemented and hardened.</li><li>Handy Notebook updates.</li><li>Activity failure paths improved.</li><li>MIT license and code of conduct added.</li><li>Error table bug fix. Error code attribute; INT to VARCHAR</li></ul> |[procfwk v1.7 - Pipeline Email Alerting](https://mrpaulandrew.com/2020/06/08/adf-procfwk-v1-7-pipeline-email-alerting/) | | ||
| 1.6.0 |<u>Error Details for Failed Activities Captured</u>, plus:<ul><li>Pipeline parameters used at runtime captured in execution logs.</li><li>Emailing Function added, not yet implemented.</li><li>Unknown Worker outcomes optionally blocks downstream stages.</li><li>Solution housekeeping.</li></ul> |[procfwk v1.6 - Error Details for Failed Activities Captured](https://mrpaulandrew.com/2020/05/19/adf-procfwk-v1-6-error-details-for-failed-activities-captured/) | | ||
| 1.5.0 |<u>Power BI Dashboard for Framework Executions</u>, plus:<ul><li>Worker Parallelism View.</li><li>Pipeline Run ID now logged.</li><li>Logging Attributes Bug Fix.</li></ul> |[procfwk v1.5 - Power BI Dashboard for Framework Executions](https://mrpaulandrew.com/2020/05/01/adf-procfwk-v1-5-power-bi-dashboard-for-framework-executions/) | | ||
| 1.4.0 |<u>Enhancements for Long Running Pipelines</u>, plus:<ul><li>Pipeline check status function added.</li><li>Function Data Factory client moved to internal class.</li><li>SQL GETDATE() changed to GETUTCDATE().</li><li>Glossary created, [here](https://github.com/mrpaulandrew/procfwk/blob/master/Glossary.md).</li><li>Updated database views.</li></ul> |[procfwk v1.4 - Enhancements for Long Running Pipelines](https://mrpaulandrew.com/2020/04/20/adf-procfwk-v1-4-enhancements-for-long-running-pipelines/) | | ||
| 1.3.0 |<u>Metadata Integrity Checks</u>, plus: <ul><li>Logical pipeline predecessors.</li><li>Data Factory Powershell deployment script.</li><li>Helper Notebook.</li><li>Database objects renames and solution tidy up.</li></ul> |[procfwk v1.3 - Metadata Integrity Checks](https://mrpaulandrew.com/2020/04/07/adf-procfwk-v1-3-metadata-integrity-checks/) | | ||
| 1.2.0 |<u>Execution Restartability</u>, plus: <ul><li>Data Factory annotations and descriptions.</li><li>Database covering indexes.</li><li>Pipeline log status changed from 'Started' to 'Preparing'.</li><li>Pipeline log start date/time now set in child pipeline.</li></ul> |[procfwk v1.2 - Execution Restartability](https://mrpaulandrew.com/2020/03/24/adf-procfwk-v1-2-execution-restartability/) | | ||
| 1.1.0 |<u>Service Principal Handling</u> via Metadata, plus: <ul><li>Data Factory table.</li><li>Properties table and view.</li><li>Function body bug fix.</li><li>New sample data.</li></ul> |[procfwk v1.1 - Service Principal Handling via Metadata](https://mrpaulandrew.com/2020/03/17/adf-procfwk-v1-1-service-principal-handling-via-metadata/) | | ||
| 1.0.0 |Simple <u>framework designed and base compontents built</u>.<br/><ul><li>Part 1 - Design, concepts, service coupling, caveats, problems.</li><li>Part 2 - Database build and metadata.</li><li>Part 3 - Data Factory build.</li><li>Part 4 - Execution, conclusions, enhancements.</li></ul>|Blog Series: <br/>[Creating a Simple Staged Metadata Driven Processing Framework for Azure Data Factory Pipelines](https://mrpaulandrew.com/2020/02/25/creating-a-simple-staged-metadata-driven-processing-framework-for-azure-data-factory-pipelines-part-1-of-4/) | | ||
| 0.1 |Product early release and upgrade from [ProcFwk.com](https://mrpaulandrew.github.io/procfwk/). | See blog post [here.](https://mrpaulandrew.com/2024/01/07/procfwk-is-getting-an-upgrade-to-cf-cumulus/) | |