[Epic] Azure Native V2

[mnlumi]

Overview

The primary goals for the next major version of Azure Native (V2) are:

• Reduce the size of SDKs, and so the size of related schemata
• Allow for a reasonably painless local development experience on the provider itself

References

• PR/FAQ
• Design Doc
• Roadmap

Work Items ⚙️

• Represent user assigned identity inputs as string arrays #1833 - done, just needs merging
• Azure Native data gathering and analysis of version usage #2198 Data gathering / analysis for impact and feasibility of versions of resources which are removable, and for which resources a migration path exists
• Updates to schema-tools to list deprecatable versions
  • Enable schema-tools to calculate compatibility of resources across API versions #2197
• Document deprecated resources with upgrade path
  • Adds methods for inserting removal deprecation warnings for v2 #2480
• Document previous resource version in default resources #2334
• Create V2 version selection #2080
• Identify all resources which have different paths in v2 vs v1 #2420 and disambiguate the resources (more details)
• MySQL and Postres Flexible Server are becoming the new default "Server" resource but are physically different resources. Disambiguate resources with different paths in v1 and v2 #2484
• Azure Native v2 schema missing a lot of resources in the default module #2359
• Remove invokes for explicit versions #2468
• Missing insights/diagnosticsetting in v2 alpha #2477
• web.ContainerApp shouldn't light up in 2.0 #2491
• Replace link in descriptions with docs side-panel link
  • Remove migration link from descriptions #2513
• Finish Migration Guide
• Unexpected diffs on network resources with v2 alpha #2475
• Some invokes are still not removed from 2.0 #2502
• [ ] [sdks/go] Return Go SDK back to this repo #2511
• Review curation warnings before v2 GA #2519
• Update v2 to latest specs and squeeze before GA #2520
• fix azure-native.cdn.AFDCustomDomain Doc #2523
• [sdks/python] UserAssignedIdentities string array fails in Python for 2.0.0-beta.1 #2525
• Add shorthand reference field when self-references are required #631

Authentication

• OIDC Design
• GitHub workflow OIDC with Azure #1324 (This may be released separately but we should work with marketing to determine if it needs to be)

Pre-release testing

• Cut a pre-release version
• Identify friendly customer
• Gather feedback on upgrade experience

For discussion

• Specify custom API version on resources #2467

Launch Finalization

• Update hosted arm2pulumi or at least put an info banner there arm2pulumi#34
• Update Azure Native templates
• Update Azure Native examples
• GA Blog post (@lukehoban and @mnlumi)

Post Release

• Go generated SDKs do not set Version option on resources and invokes pulumi#13012
• Implement generic resource for deploying untyped/unsupported ARM resource through the provider #2591
• Make arm2pulumi work when the specific explicit version is not available.
• Test using same schema for SDK and docs #2592
  • Can we get the schema under 100mb?
  • Can we rework docs to pull the schema from release assets instead?
  • Do we still need the docs schema separate to the main schema because of registry performance or SDK size limits?
• Document vNext schema generation process (squeeze, etc) #2583
• Add ability in schema gen to ignore curation, removals, etc
  • Re-calculate removable resources based on schema-tools squeeze #2536

[mnlumi]

Update: The first pre-release of Azure Native v2 is available. I am currently seeking and gathering feedback from internal and external users.

[mnlumi]

Update: v2 has been released and is now generally available. Check out the blog post and upgrade guide for more info.

Current items remaining are post-release tasks including updates to documentation, examples, templates, etc.

[mnlumi]

Closing out the epic. Outstanding post-release tasks will be prioritized alongside other work.