Add Terraform drift guidance for stateful Azure resources (#9588)
* Add storage account drift best practices article
* Add storage account migration drift warning
* Add storage account migration drift warning
* Add storage account migration drift guidance
* Add storage account drift article navigation
* Apply suggestion from @learn-build-service-prod-07[bot]
Co-authored-by: learn-build-service-prod-07[bot] <274430390+learn-build-service-prod-07[bot]@users.noreply.github.com>
* Apply suggestion from @learn-build-service-prod-07[bot]
Co-authored-by: learn-build-service-prod-07[bot] <274430390+learn-build-service-prod-07[bot]@users.noreply.github.com>
* Apply suggestion from @learn-build-service-prod-07[bot]
Co-authored-by: learn-build-service-prod-07[bot] <274430390+learn-build-service-prod-07[bot]@users.noreply.github.com>
* Apply suggestion from @learn-build-service-prod-07[bot]
Co-authored-by: learn-build-service-prod-07[bot] <274430390+learn-build-service-prod-07[bot]@users.noreply.github.com>
* Apply suggestion from @learn-build-service-prod-07[bot]
Co-authored-by: learn-build-service-prod-07[bot] <274430390+learn-build-service-prod-07[bot]@users.noreply.github.com>
* Apply suggestion from @learn-build-service-prod-07[bot]
Co-authored-by: learn-build-service-prod-07[bot] <274430390+learn-build-service-prod-07[bot]@users.noreply.github.com>
* Revise article on preventing Terraform drift for Azure resources
Updated the article to focus on preventing Terraform drift for stateful Azure resources, with an emphasis on Azure Storage account migrations. Adjusted the title, description, and content to reflect best practices and risks associated with configuration drift.
* Update text for Terraform drift guidance
* Revise note on Azure Storage account migration guidance
Updated note regarding Azure Storage account migrations to clarify guidance on preventing unexpected recreation during migrations.
* Update warning message for storage account migration
* Update link text for preventing Terraform drift
* Update note on Azure Storage account migrations
* Update section title for Azure resource drift
* Apply suggestion from @learn-build-service-prod-01[bot]
Co-authored-by: learn-build-service-prod-01[bot] <274427437+learn-build-service-prod-01[bot]@users.noreply.github.com>
* Apply suggestion from @learn-build-service-prod-08[bot]
Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com>
* Apply suggestion from @learn-build-service-prod-08[bot]
Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com>
* Apply suggestion from @learn-build-service-prod-08[bot]
Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com>
* Apply suggestion from @learn-build-service-prod-08[bot]
Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com>
* Apply suggestion from @learn-build-service-prod-08[bot]
Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com>
* Update migration guidance for Azure Storage accounts
* Update and rename storage-account-drift-best-practices.md to prevent-terraform-drift-stateful-resources.md
* Fix URL for preventing Terraform drift
* Update link for preventing Terraform drift
* Fix link for preventing Terraform drift guidance
Updated link in Terraform overview to point to the correct document on preventing drift.
* Fix link for Terraform drift prevention guidance
Updated link for preventing Terraform drift during Azure Storage account migrations.
* Update link for drift prevention documentation
* Update link for preventing Terraform drift
* Fix link to prevent Terraform drift documentation
Updated link to migration guidance for Azure resources.
* Fix typo in Terraform drift guide entry
* Clarify drift warning for storage account migration
Updated warning message for storage account migration to clarify the handling of account replication type changes.
* Fix include syntax for storage account migration warning
* Fix note formatting in Terraform overview
* Remove Azure storage account migration example
Removed example section about Azure storage account migration.
* Update documentation on prevent_destroy and ignore_changes
Clarify the behavior of prevent_destroy and introduce ignore_changes for stateful resources.
* Update guidance on storage account migration and Terraform state
Clarify conditions under which Terraform replaces storage accounts during redundancy changes and update instructions for reconciling Terraform state after out-of-band changes.
* Clarify post-migration steps for Terraform configuration
Updated instructions for reconciling Terraform configuration after storage account migration.
* Update troubleshooting guidance for Azure storage accounts
Clarified the conditions under which Terraform may plan to delete and recreate an Azure storage account, specifying the impact of redundancy migrations on the `account_replication_type`. Updated recommendations for managing storage account migrations.
* Fix markdown syntax for include directive
* Update guidance on Terraform state reconciliation and locks
Clarified the process for reconciling Terraform state after cross-family redundancy changes and emphasized the use of Azure resource locks for protection.
* Clarify instructions for reconciling Terraform state
* Apply suggestion from @learn-build-service-prod-04[bot]
Co-authored-by: learn-build-service-prod-04[bot] <274428985+learn-build-service-prod-04[bot]@users.noreply.github.com>
* Update migration instructions for Terraform state management
Clarified steps for reconciling Terraform configuration after storage account migrations, including handling same-family and cross-family redundancy updates.
* Revise storage account migration steps in troubleshoot.md
Updated migration instructions for storage accounts to include running 'terraform apply -refresh-only' and confirming no unexpected changes before removing 'ignore_changes'.
* Apply suggestion from @learn-build-service-prod-02[bot]
Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com>
* Apply suggestion from @learn-build-service-prod-02[bot]
Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com>
* Clarify note on Azure Storage account changes
Updated note on Azure Storage account migrations to refer to conversions instead.
* Fix note on Azure Storage account conversions
Corrected capitalization and formatting for clarity.
* Update warning for storage account conversion process
* Update drift warning include in AVD storage guide
* Update drift warning include for storage account
* Update note on Azure Storage account changes
* Clarify terminology from migration to conversion
Updated references from 'migration' to 'conversion' throughout the article to clarify the context of Azure Storage account changes.
* Update drift warning include in Azure storage guide
* Update troubleshooting section for storage account changes
* Fix grammar and clarity in testing overview
Correct grammatical errors and improve clarity in the overview of testing Terraform code.
* Refine language in Azure Files Terraform article
Updated wording for clarity and consistency in the article.
* Update instructions for creating Terraform directory
* Refine language and improve clarity in comparison article
Updated language for clarity and consistency throughout the article, including changes to terminology and phrasing related to infrastructure as code, cloud environments, and deployment processes.
* Update storage-account-conversion-drift-warning.md
* Improve clarity and conciseness in overview.md
Refactor language for clarity and conciseness in the Terraform overview.
* Refine Terraform Azure Storage documentation
Updated wording for clarity and consistency in the documentation regarding Terraform state management in Azure Storage.
* Update troubleshoot.md
* Update troubleshoot.md
* Update create-avd-azure-files-storage.md
* Update storage account conversion drift warning metadata
Added metadata properties for author, topic, date, and custom tracking.
* Fix markdown syntax for Terraform abstract inclusion
---------
Co-authored-by: learn-build-service-prod-07[bot] <274430390+learn-build-service-prod-07[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod-01[bot] <274427437+learn-build-service-prod-01[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod-08[bot] <274430765+learn-build-service-prod-08[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod-04[bot] <274428985+learn-build-service-prod-04[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod-02[bot] <274428175+learn-build-service-prod-02[bot]@users.noreply.github.com>