Skip to content

Conversation

@lcarli
Copy link

@lcarli lcarli commented Nov 3, 2025

🛠️ Description
This PR adds optional custom resource naming and centralized networking support for FinOps hub deployments, enabling better integration with enterprise naming conventions and Hub & Spoke network topologies.

Key Features:

  1. Custom Resource Naming (Optional)

Added 7 optional parameters to customize resource names:
storageAccountName - Storage Account
dataFactoryName - Data Factory
keyVaultName - Key Vault
virtualNetworkName - Virtual Network
managedIdentityName - Managed Identity
dataExplorerClusterName - Data Explorer Cluster
privateEndpointNamePrefix - Private Endpoint prefix
If parameters are empty, default names are auto-generated following Azure best practices
Simplified implementation: removed boolean flag complexity, using simple !empty() checks

  1. Centralized Networking (Hub & Spoke)

Added 6 optional parameters to reference existing Private DNS Zones:
existingBlobDnsZoneId - Blob Storage DNS Zone
existingDfsDnsZoneId - Data Lake Storage DNS Zone
existingQueueDnsZoneId - Queue Storage DNS Zone
existingTableDnsZoneId - Table Storage DNS Zone
existingVaultDnsZoneId - Key Vault DNS Zone
existingDataExplorerDnsZoneId - Data Explorer DNS Zone
Prevents duplicate DNS Zone creation in centralized network environments
Automatically links Private Endpoints to existing DNS Zones via DNS Zone Groups

Changes:
Updated all Bicep modules with conditional logic for custom naming
Added new "Customization" tab in createUiDefinition.json with organized sections
Updated README with comprehensive customization documentation
Added test cases for custom naming and centralized networking scenarios
Compiled ARM template (azuredeploy.json) for portal deployment
Updated metadata with current date and enhanced description
Fixes #

📷 Screenshots
New "Customization" Tab in Azure Portal:
The new tab appears between "Advanced" and "Tags", providing a clean interface for optional customizations without cluttering the basic deployment experience.

Section 1: Resource naming - 7 optional name fields with validation
Section 2: Centralized networking (Hub & Spoke) - 6 DNS Zone resource ID fields

image

📋 Checklist

🔬 How did you test this change?

 💪 Unit tests

🙋‍♀️ Do any of the following that apply?

 🚨 This is a breaking change.

📑 Did you update docs/changelog.md?

❎ Log not needed (small/internal change)

📖 Did you update documentation?

✅ Public docs in docs (required for dev)
✅ Internal dev docs in src (required for dev)

- Added 'Resource customization architecture' section to docs/README.md
- Documented custom naming implementation with architecture diagrams
- Explained centralized networking (Hub & Spoke) integration patterns
- Included testing guide for 4 scenarios (default, custom names, DNS zones, hybrid)
- Added UI implementation structure details for createUiDefinition.json
- Documented best practices for developers maintaining the codebase
- Added migration guide confirming full backward compatibility
- Included troubleshooting section for common deployment issues

This technical documentation complements the user-facing README.md and
supports maintainers working with the resource customization features.
@lcarli lcarli marked this pull request as ready for review November 3, 2025 22:50
@flanakin flanakin added this to the v13 milestone Jan 6, 2026
@flanakin flanakin changed the title Lcarli/dev/naming [Hubs] Enable custom resource naming Jan 6, 2026
@flanakin
Copy link
Collaborator

flanakin commented Jan 6, 2026

@lcarli Sorry for the delay here. I'm hoping to discuss this with the other contributors on Wednesday. We previously had some concerns around custom naming, but need to revisit that. I also want @MSBrett to review the networking changes.

@flanakin flanakin modified the milestones: v13, v14 Jan 6, 2026
@flanakin
Copy link
Collaborator

flanakin commented Jan 6, 2026

Actually, given the risk this would introduce to the in-progress release, I'm going to move this to v14, but we'll still discuss it at the contributor sync on Wednesday.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Needs: Review 👀 PR that is ready to be reviewed Tool: FinOps hubs Data pipeline solution

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants