Skip to content

Conversation

@emekanwaoma
Copy link
Contributor

@emekanwaoma emekanwaoma commented Aug 22, 2025

Description

This PR adds comprehensive documentation for the Azure Incremental Sync integration and improves the main Azure documentation to clearly distinguish between different sync approaches. The changes address the need for users to understand when and how to use the lightweight incremental sync integration versus the standard Azure exporter.

Motivation and Context

Users currently have access to two different Azure synchronization approaches but lack clear guidance on:

  • When to use each approach
  • How they differ in architecture and deployment
  • What the incremental sync integration actually provides

The incremental sync integration is a standalone Python application that uses Azure Resource Graph change detection, while the Azure exporter is an Ocean-based integration with Event Grid support. This documentation clarifies these differences and provides complete setup instructions for both approaches.

Added docs pages

  • Azure Incremental Sync (/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/incremental-sync)

Updated docs pages

  • Azure main documentation (/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/azure)
    • Added "Sync Approaches" section explaining differences between Azure exporter and incremental sync
    • Added cross-reference to incremental sync documentation
    • Updated "Next Steps" section to include incremental sync option

@aws-amplify-eu-west-1
Copy link

This pull request is automatically being deployed by Amplify Hosting (learn more).

Access this pull request here: https://pr-2710.d2ngvl90zqbob8.amplifyapp.com

@emekanwaoma emekanwaoma marked this pull request as ready for review August 25, 2025 08:06
Copy link
Contributor

@sivanel97 sivanel97 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi :) I added some styling suggestions to change, if you have any questions let me know...

emekanwaoma and others added 14 commits September 1, 2025 17:28
…oviders/azure/incremental-sync.md

Co-authored-by: sivanel97 <sivane@getport.io>
…oviders/azure/azure.md

Co-authored-by: sivanel97 <sivane@getport.io>
…oviders/azure/incremental-sync.md

Co-authored-by: sivanel97 <sivane@getport.io>
…oviders/azure/incremental-sync.md

Co-authored-by: sivanel97 <sivane@getport.io>
…oviders/azure/azure.md

Co-authored-by: sivanel97 <sivane@getport.io>
…oviders/azure/incremental-sync.md

Co-authored-by: sivanel97 <sivane@getport.io>
…oviders/azure/incremental-sync.md

Co-authored-by: sivanel97 <sivane@getport.io>
…oviders/azure/incremental-sync.md

Co-authored-by: sivanel97 <sivane@getport.io>
…oviders/azure/incremental-sync.md

Co-authored-by: sivanel97 <sivane@getport.io>
…oviders/azure/incremental-sync.md

Co-authored-by: sivanel97 <sivane@getport.io>
Copy link
Member

@matan84 matan84 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@sivanel97 sivanel97 merged commit feb91d5 into main Sep 2, 2025
2 checks passed
@sivanel97 sivanel97 deleted the PORT-16061 branch September 2, 2025 11:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants