Skip to content

Commit

Permalink
v4 docs (#27568)
Browse files Browse the repository at this point in the history
Co-authored-by: BubbleTroubles <[email protected]>
  • Loading branch information
bubbletroubles and BubbleTroubles authored Oct 15, 2024
1 parent c177be6 commit 46f5327
Show file tree
Hide file tree
Showing 3 changed files with 11 additions and 69 deletions.
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

0 comments on commit 46f5327

Please sign in to comment.