[AV-106890] Upgrade guide (#365)

Co-authored-by: PaulomeeCb <paulomee.de@couchbase.com>

Author: l0n3star

docs/guides/1.5.2-upgrade-guide.md

@@ -0,0 +1,69 @@
+---
+layout: "couchbase-capella"
+page_title: "Couchbase Capella Provider 1.5.2: Upgrade and Information Guide"
+sidebar_current: "docs-couchbase-capella-guides-151-upgrade-guide"
+description: |-
+Couchbase Capella Provider 1.5.2: Upgrade and Information Guide
+---
+
+
+# Couchbase Capella Provider 1.5.2: Upgrade and Information Guide
+
+## Bug Fixes
+
+* Creating index was throwing unknown value error in 1.5.1 release, which has been rectified in 1.5.2 release
+
+## Changes
+
+There are no deprecations as part of this release.
+
+1.5.2 includes new GCP Private Endpoint Command support and App Services Allowed CIDR resources. For more information, see the [CHANGELOG](https://github.com/couchbasecloud/terraform-provider-couchbase-capella/blob/master/CHANGELOG.md).
+
+## GCP Private Endpoint Command
+
+Use the new `gcp_private_endpoint_command`  data source to get a GCP command for configuring VPC endpoint.
+
+```
+data "couchbase-capella_gcp_private_endpoint_command" "gcp_command" {
+  organization_id     = var.organization_id
+  project_id          = var.project_id
+  cluster_id          = var.cluster_id
+  vpc_network_id      = var.vpc_network_id
+  subnet_ids          = var.subnet_ids
+}
+```
+For more information, see the [gcp private endpoint examples](https://github.com/couchbasecloud/terraform-provider-couchbase-capella/tree/main/examples/private_endpoint_command/GCP).
+
+## App Services Allowed CIDR
+
+Use the new `app_services_cidr` resource to manage the IP addresses allowed to connect to App Services in Capella.
+
+```
+resource "couchbase-capella_app_services_cidr" "new_allowlist" {
+  organization_id = var.organization_id
+  project_id      = var.project_id
+  cluster_id      = var.cluster_id
+  app_service_id  = var.app_service_id
+  cidr            = var.app_services_cidr.cidr
+  comment         = var.app_services_cidr.comment
+  expires_at      = var.app_services_cidr.expires_at
+}
+```
+
+Use the new `app_services_cidr` data source to retrieve the allowed CIDR blocks for a Capella App Service.
+
+```
+data "couchbase-capella_app_services_cidr" "existing_allowlists" {
+  organization_id = var.organization_id
+  project_id      = var.project_id
+  cluster_id      = var.cluster_id
+  app_service_id  = var.app_service_id
+}
+```
+For more information, see the [app services cidr examples](https://github.com/couchbasecloud/terraform-provider-couchbase-capella/tree/main/examples/app_services_cidr).
+
+### Helpful Links
+
+- [Getting Started with the Terraform Provider](https://github.com/couchbasecloud/terraform-provider-couchbase-capella/blob/master/examples/getting_started)
+- [Capella Management API v4.0](https://docs.couchbase.com/cloud/management-api-reference/index.html)
+- [See Specific Examples](https://github.com/couchbasecloud/terraform-provider-couchbase-capella/blob/master/examples)