Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs - Updated documentation to reflect that v4 of the provider is now released #27568

Merged
merged 1 commit into from
Oct 15, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
56 changes: 0 additions & 56 deletions website/docs/guides/4.0-beta.html.markdown

This file was deleted.

12 changes: 6 additions & 6 deletions website/docs/guides/4.0-overview.html.markdown
Original file line number Diff line number Diff line change
@@ -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

Expand Down Expand Up @@ -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).

Expand Down
12 changes: 5 additions & 7 deletions website/docs/guides/4.0-upgrade-guide.html.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -10,15 +10,15 @@ 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

Version 4.0 of the Azure Provider is a major release and includes breaking changes which are outlined in this document.

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

Expand All @@ -29,7 +29,7 @@ terraform {
required_providers {
azurerm = {
source = "hashicorp/azurerm"
version = "=3.114.0"
version = "=4.4.0"
}
}
}
Expand All @@ -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"
}
}
}
Expand All @@ -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)
Expand Down
Loading