diff --git a/website/docs/guides/4.0-beta.html.markdown b/website/docs/guides/4.0-beta.html.markdown deleted file mode 100644 index a500f6efe39a..000000000000 --- a/website/docs/guides/4.0-beta.html.markdown +++ /dev/null @@ -1,56 +0,0 @@ ---- -layout: "azurerm" -page_title: "Azure Resource Manager: Opting into the 4.0 Beta" -description: |- -Azure Resource Manager: Opting into Beta Functionality coming in version 4.0 of the Azure Provider - ---- - -# Opting into Beta Functionality coming in version 4.0 of the Azure Provider - -Version 4.0 of the Azure Provider will introduce several new features ([full details can be found in the 4.0 Upgrade Guide](/docs/providers/azurerm/guides/4.0-upgrade-guide.html)): - -- Improved control and granularity over Resource Provider registration -- Provider functions -- Additional configuration options for Subnets defined in-line in the Virtual Network Resource. -- Improved consistency in updating and removing lists and blocks - -Since both Azure and Terraform's Azure Provider move quickly - in order to continue rapidly shipping new features we've used Feature Toggles to gradually add support for the new functionality coming in version 4.0 of the Azure Provider as we've been developing 3.x versions of the Azure Provider. - -What this means is that the most recent 3.x versions of the Azure Provider are able to opt-into certain functionality coming in version 4.0 of the Azure Provider. - -This guide details how to enable these features and how you can submit feedback prior to the final release. - -## Disclaimers - --> The functionality provided in this Beta is subject to change - as such **this Beta should not be used in Production**. - --> Once opted in, it will not be possible to opt-out of the Beta, this is because the new functionality and removal of deprecated functionality in 4.0 will make **irreversible changes to the Terraform state**. We recommend making backups of your environment and state files before activating the Beta in case a rollback of the environment is required. - --> Whilst certain feature flags may be available in earlier versions of the Azure Provider they existed in an incomplete manner - **the Beta is only supported when using version 3.114 (or later) of the Azure Provider**. - -## 4.0 Features, Removals and Deprecations - -It's possible to opt into the Beta by setting the Environment Variable `ARM_FOURPOINTZERO_BETA` to `true`. - -On a macOS/Linux system you can do this via: - -```bash -export ARM_FOURPOINTZERO_BETA=true -``` - -On a Windows System (in PowerShell) you can do this via: - -```powershell -[System.Environment]::SetEnvironmentVariable('ARM_FOURPOINTZERO_BETA', 'true', [System.EnvironmentVariableTarget]::User) -``` - --> **Note:** You may need to reload/re-open your Terminal after setting this Environment Variable. - ---- - -## Providing Feedback - -Firstly - thanks for trialling the new functionality coming in version 4.0 of the Azure Provider. - -We're keeping track of Beta Feedback in the GitHub Repository - as such [please follow this link to open an issue containing your feedback](https://github.com/terraform-providers/terraform-provider-azurerm/issues/new?template=Beta_Feedback.md). diff --git a/website/docs/guides/4.0-overview.html.markdown b/website/docs/guides/4.0-overview.html.markdown index 2d13b7dc4fcd..00955101200e 100644 --- a/website/docs/guides/4.0-overview.html.markdown +++ b/website/docs/guides/4.0-overview.html.markdown @@ -1,21 +1,21 @@ --- layout: "azurerm" -page_title: "Azure Resource Manager: Upcoming Version 4.0 of the Azure Provider" +page_title: "Azure Resource Manager: Version 4.0 of the Azure Provider" description: |- -Azure Resource Manager: Upcoming Version 4.0 of the Azure Provider +Azure Resource Manager: Version 4.0 of the Azure Provider --- -# Upcoming Version 4.0 of the Azure Provider +# Version 4.0 of the Azure Provider -> **Note:** Since this documentation is versioned, we recommend checking [the latest version of this document](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/guides/4.0-overview). -Version 4.0 of the Azure Provider will be a major release, which means that this will include breaking changes as required, in addition to new functionality and bug fixes. +Version 4.0 of the Azure Provider is a major release. It has introduced breaking changes as required, in addition to new functionality and bug fixes. During the development of version 2.0 as well as 3.0 of the Azure Provider we made use of Feature Toggling to gradually add support for the new functionality. This allows users to try out the next major release of the provider in non-production environments, to get a sense of the upcoming changes that will be required in their configuration and to provide invaluable feedback on the changes. We have used the same approach for version 4.0 of the Azure Provider too, providing an opt-in Beta for the changes coming in version 4.0 whilst using 3.x versions of the Azure Provider. -Since we'll be iteratively adding this functionality over time, we encourage you to use the latest version of the Azure Provider when using this functionality. Please note that this is subject to change (including breaking changes) prior to the release of version 4.0 of the Azure Provider. In addition, an upgrade guide containing the detailed changes coming in version 4.0 of the Azure Provider has been made available and can be found [here](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/guides/4.0-upgrade-guide). +An upgrade guide containing the detailed changes coming in version 4.0 of the Azure Provider has been made available and can be found [here](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/guides/4.0-upgrade-guide). ## Disclaimer @@ -45,7 +45,7 @@ provider "azurerm" { -> **Note:** Since new functionality is being added iteratively, this page will be updated as new functionality is added to the 4.0 Beta -Version 4.0 of the Azure Provider is a work-in-progress, as such only functionality which is currently available is documented here. +Version 4.0 of the Azure Provider is now released. Below is a brief overview of the biggest changes and new features coming in 4.0. For more details on these please see the [4.0 upgrade guide](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/guides/4.0-upgrade-guide). diff --git a/website/docs/guides/4.0-upgrade-guide.html.markdown b/website/docs/guides/4.0-upgrade-guide.html.markdown index 5e8a06eeb7b1..8f91d46a6bfc 100644 --- a/website/docs/guides/4.0-upgrade-guide.html.markdown +++ b/website/docs/guides/4.0-upgrade-guide.html.markdown @@ -10,7 +10,7 @@ Azure Resource Manager: 4.0 Upgrade Guide ## Azure Provider Version v4.0 -The last major release for the Azure Provider was in March 2022. Since then we've added support for nearly 340 Resources and 120 Data Sources, bringing the total supported features to 1101 Resources and 358 Data Sources at the time of writing this guide. +Version 3.0 of the Azure Provider was in March 2022. Since then we've added support for nearly 340 Resources and 120 Data Sources, bringing the total supported features to 1101 Resources and 358 Data Sources at the time of writing this guide. ### Considerations @@ -18,7 +18,7 @@ Version 4.0 of the Azure Provider is a major release and includes breaking chang When upgrading to version 4.0 of the Azure Provider, we recommend upgrading to the latest version of Terraform Core ([which can be found here](https://www.terraform.io/downloads)). -This guide will continue to receive updates as we incorporate feedback and continue to fix any issues during the Beta. +This guide will continue to receive updates as we incorporate feedback and continue to fix any issues. ### Pinning your Provider Version @@ -29,7 +29,7 @@ terraform { required_providers { azurerm = { source = "hashicorp/azurerm" - version = "=3.114.0" + version = "=4.4.0" } } } @@ -39,14 +39,14 @@ provider "azurerm" { } ``` -.. or to any 3.x release: +.. or to any 4.x release: ```hcl terraform { required_providers { azurerm = { source = "hashicorp/azurerm" - version = "~> 3.x" + version = "~> 4.x" } } } @@ -63,8 +63,6 @@ More information on [how to pin the version of a Terraform Provider being used c ## What's available in Version 4.0 of the Azure Provider? --> **Note:** Version `3.114.0`-`3.x` of the Azure Provider allows you to opt-into the Beta of some of these features - [read the Disclaimers in the Beta guide before doing this](https://registry.terraform.io/providers/hashicorp/azurerm/3.114.0/docs/guides/4.0-beta) - Below is an overview of the changes coming 4.0. Each topic is covered in more detail further down. * [Improved Resource Provider Registration](#improved-resource-provider-registration)