Skip to content

Commit

Permalink
Prepare for 0.11.0 release (#558)
Browse files Browse the repository at this point in the history
* fix: update bug

* fix: improve examples

* fix: 0.11.0 update

* fix: spell check

* ci: Prepare for the 0.11.0 release

* fix: added change log date

* refactor: naming and comments
  • Loading branch information
wai-wong-edb authored Jun 20, 2024
1 parent 88c8951 commit c2bbd2d
Show file tree
Hide file tree
Showing 52 changed files with 347 additions and 67 deletions.
1 change: 1 addition & 0 deletions .wordlist-en-custom.txt
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ InstanceType
MPL
PGD
Postgres
analytics
aws
awsconnection
azureconnection
Expand Down
5 changes: 5 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
## v0.11.0 (June 20. 2024)
Features:
* New Resource to manage Analytical clusters: `biganimal_analytics_cluster`
* New Data Source: `biganimal_analytics_cluster`

## v0.10.0 (May 13. 2024)
Features:
* PostGIS support for `biganimal_cluster` resources
Expand Down
2 changes: 1 addition & 1 deletion GNUmakefile
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ HOSTNAME=registry.terraform.io
NAMESPACE=EnterpriseDB
NAME=biganimal
BINARY=terraform-provider-${NAME}
VERSION=0.10.0
VERSION=0.11.0

# Figure out the OS and ARCH of the
# builder machine
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ terraform {
required_providers {
biganimal = {
source = "EnterpriseDB/biganimal"
version = "0.10.0"
version = "0.11.0"
}
}
}
Expand Down
166 changes: 166 additions & 0 deletions docs/data-sources/analytics_cluster.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,166 @@
---
# generated by https://github.com/hashicorp/terraform-plugin-docs
page_title: "biganimal_analytics_cluster Data Source - terraform-provider-biganimal"
subcategory: ""
description: |-
The analytics cluster resource is used to manage BigAnimal analytics clusters.
---

# biganimal_analytics_cluster (Data Source)

The analytics cluster resource is used to manage BigAnimal analytics clusters.

## Example Usage

```terraform
variable "cluster_id" {
type = string
description = "The id of the cluster"
}
variable "project_id" {
type = string
description = "BigAnimal Project ID"
}
data "biganimal_analytics_cluster" "this" {
cluster_id = var.cluster_id
project_id = var.project_id
}
output "backup_retention_period" {
value = data.biganimal_analytics_cluster.this.backup_retention_period
}
output "cluster_name" {
value = data.biganimal_analytics_cluster.this.cluster_name
}
output "created_at" {
value = data.biganimal_analytics_cluster.this.created_at
}
output "csp_auth" {
value = coalesce(data.biganimal_analytics_cluster.this.csp_auth, false)
}
output "instance_type" {
value = data.biganimal_analytics_cluster.this.instance_type
}
output "metrics_url" {
value = data.biganimal_analytics_cluster.this.metrics_url
}
output "logs_url" {
value = data.biganimal_analytics_cluster.this.logs_url
}
output "pg_type" {
value = data.biganimal_analytics_cluster.this.pg_type
}
output "pg_version" {
value = data.biganimal_analytics_cluster.this.pg_version
}
output "phase" {
value = data.biganimal_analytics_cluster.this.phase
}
output "private_networking" {
value = coalesce(data.biganimal_analytics_cluster.this.private_networking, false)
}
output "cloud_provider" {
value = data.biganimal_analytics_cluster.this.cloud_provider
}
output "region" {
value = data.biganimal_analytics_cluster.this.region
}
output "resizing_pvc" {
value = data.biganimal_analytics_cluster.this.resizing_pvc
}
output "pe_allowed_principal_ids" {
value = data.biganimal_analytics_cluster.this.pe_allowed_principal_ids
}
output "service_account_ids" {
value = data.biganimal_analytics_cluster.this.service_account_ids
}
```

<!-- schema generated by tfplugindocs -->
## Schema

### Required

- `cluster_id` (String) Cluster ID.
- `project_id` (String) BigAnimal Project ID.

### Optional

- `allowed_ip_ranges` (Attributes Set) Allowed IP ranges. (see [below for nested schema](#nestedatt--allowed_ip_ranges))
- `backup_retention_period` (String) Backup retention period. For example, "7d", "2w", or "3m".
- `csp_auth` (Boolean) Is authentication handled by the cloud service provider.
- `maintenance_window` (Attributes) Custom maintenance window. (see [below for nested schema](#nestedatt--maintenance_window))
- `pause` (Boolean) Pause cluster. If true it will put the cluster on pause and set the phase as paused, if false it will resume the cluster and set the phase as healthy. Pausing a cluster allows you to save on compute costs without losing data or cluster configuration settings. While paused, clusters aren't upgraded or patched, but changes are applied when the cluster resumes. Pausing a high availability cluster shuts down all cluster nodes
- `pe_allowed_principal_ids` (Set of String) Cloud provider subscription/account ID, need to be specified when cluster is deployed on BigAnimal's cloud account.
- `service_account_ids` (Set of String) A Google Cloud Service Account is used for logs. If you leave this blank, then you will be unable to access log details for this cluster. Required when cluster is deployed on BigAnimal's cloud account.
- `timeouts` (Block, Optional) (see [below for nested schema](#nestedblock--timeouts))

### Read-Only

- `cloud_provider` (String) Cloud provider. For example, "aws" or "bah:aws".
- `cluster_name` (String) Name of the cluster.
- `connection_uri` (String) Cluster connection URI.
- `created_at` (String) Cluster creation time.
- `first_recoverability_point_at` (String) Earliest backup recover time.
- `id` (String) Resource ID of the cluster.
- `instance_type` (String) Instance type. For example, "azure:Standard_D2s_v3", "aws:c5.large" or "gcp:e2-highcpu-4".
- `logs_url` (String) The URL to find the logs of this cluster.
- `metrics_url` (String) The URL to find the metrics of this cluster.
- `password` (String) Password for the user edb_admin. It must be 12 characters or more.
- `pg_type` (String) Postgres type. For example, "epas" or "pgextended".
- `pg_version` (String) Postgres version. For example 16
- `phase` (String) Current phase of the cluster.
- `private_networking` (Boolean) Is private networking enabled.
- `region` (String) Region to deploy the cluster. See [Supported regions](https://www.enterprisedb.com/docs/biganimal/latest/overview/03a_region_support/) for supported regions.
- `resizing_pvc` (List of String) Resizing PVC.

<a id="nestedatt--allowed_ip_ranges"></a>
### Nested Schema for `allowed_ip_ranges`

Required:

- `cidr_block` (String) CIDR block

Optional:

- `description` (String) Description of CIDR block


<a id="nestedatt--maintenance_window"></a>
### Nested Schema for `maintenance_window`

Required:

- `is_enabled` (Boolean) Is maintenance window enabled.

Optional:

- `start_day` (Number) The day of week, 0 represents Sunday, 1 is Monday, and so on.
- `start_time` (String) Start time. "hh:mm", for example: "23:59".


<a id="nestedblock--timeouts"></a>
### Nested Schema for `timeouts`

Optional:

- `create` (String) A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- `delete` (String) A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
- `update` (String) A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
2 changes: 1 addition & 1 deletion docs/data-sources/pgd.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@ terraform {
required_providers {
biganimal = {
source = "EnterpriseDB/biganimal"
version = "0.10.0"
version = "0.11.0"
}
}
}
Expand Down
94 changes: 94 additions & 0 deletions docs/resources/analytics_cluster.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,94 @@
---
# generated by https://github.com/hashicorp/terraform-plugin-docs
page_title: "biganimal_analytics_cluster Resource - terraform-provider-biganimal"
subcategory: ""
description: |-
The analytics cluster resource is used to manage BigAnimal analytics clusters.
---

# biganimal_analytics_cluster (Resource)

The analytics cluster resource is used to manage BigAnimal analytics clusters.



<!-- schema generated by tfplugindocs -->
## Schema

### Required

- `cloud_provider` (String) Cloud provider. For example, "aws" or "bah:aws".
- `cluster_name` (String) Name of the cluster.
- `instance_type` (String) Instance type. For example, "azure:Standard_D2s_v3", "aws:c5.large" or "gcp:e2-highcpu-4".
- `password` (String) Password for the user edb_admin. It must be 12 characters or more.
- `pg_type` (String) Postgres type. For example, "epas" or "pgextended".
- `pg_version` (String) Postgres version. For example 16
- `project_id` (String) BigAnimal Project ID.
- `region` (String) Region to deploy the cluster. See [Supported regions](https://www.enterprisedb.com/docs/biganimal/latest/overview/03a_region_support/) for supported regions.

### Optional

- `allowed_ip_ranges` (Attributes Set) Allowed IP ranges. (see [below for nested schema](#nestedatt--allowed_ip_ranges))
- `backup_retention_period` (String) Backup retention period. For example, "7d", "2w", or "3m".
- `csp_auth` (Boolean) Is authentication handled by the cloud service provider.
- `maintenance_window` (Attributes) Custom maintenance window. (see [below for nested schema](#nestedatt--maintenance_window))
- `pause` (Boolean) Pause cluster. If true it will put the cluster on pause and set the phase as paused, if false it will resume the cluster and set the phase as healthy. Pausing a cluster allows you to save on compute costs without losing data or cluster configuration settings. While paused, clusters aren't upgraded or patched, but changes are applied when the cluster resumes. Pausing a high availability cluster shuts down all cluster nodes
- `pe_allowed_principal_ids` (Set of String) Cloud provider subscription/account ID, need to be specified when cluster is deployed on BigAnimal's cloud account.
- `private_networking` (Boolean) Is private networking enabled.
- `service_account_ids` (Set of String) A Google Cloud Service Account is used for logs. If you leave this blank, then you will be unable to access log details for this cluster. Required when cluster is deployed on BigAnimal's cloud account.
- `timeouts` (Block, Optional) (see [below for nested schema](#nestedblock--timeouts))

### Read-Only

- `cluster_id` (String) Cluster ID.
- `connection_uri` (String) Cluster connection URI.
- `created_at` (String) Cluster creation time.
- `first_recoverability_point_at` (String) Earliest backup recover time.
- `id` (String) Resource ID of the cluster.
- `logs_url` (String) The URL to find the logs of this cluster.
- `metrics_url` (String) The URL to find the metrics of this cluster.
- `phase` (String) Current phase of the cluster.
- `resizing_pvc` (List of String) Resizing PVC.

<a id="nestedatt--allowed_ip_ranges"></a>
### Nested Schema for `allowed_ip_ranges`

Required:

- `cidr_block` (String) CIDR block

Optional:

- `description` (String) Description of CIDR block


<a id="nestedatt--maintenance_window"></a>
### Nested Schema for `maintenance_window`

Required:

- `is_enabled` (Boolean) Is maintenance window enabled.

Optional:

- `start_day` (Number) The day of week, 0 represents Sunday, 1 is Monday, and so on.
- `start_time` (String) Start time. "hh:mm", for example: "23:59".


<a id="nestedblock--timeouts"></a>
### Nested Schema for `timeouts`

Optional:

- `create` (String) A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- `delete` (String) A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
- `update` (String) A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).

## Import

Import is supported using the following syntax:

```shell
# terraform import biganimal_analytics_cluster.<resource_name> <project_id>/<cluster_id>
terraform import biganimal_analytics_cluster.analytics_cluster prj_deadbeef01234567/p-abcd123456
```
2 changes: 1 addition & 1 deletion docs/resources/aws_connection.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ terraform {
required_providers {
biganimal = {
source = "EnterpriseDB/biganimal"
version = "0.10.0"
version = "0.11.0"
}
}
}
Expand Down
2 changes: 1 addition & 1 deletion docs/resources/azure_connection.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ terraform {
required_providers {
biganimal = {
source = "EnterpriseDB/biganimal"
version = "0.10.0"
version = "0.11.0"
}
}
}
Expand Down
4 changes: 2 additions & 2 deletions docs/resources/cluster.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ terraform {
required_providers {
biganimal = {
source = "EnterpriseDB/biganimal"
version = "0.10.0"
version = "0.11.0"
}
random = {
source = "hashicorp/random"
Expand Down Expand Up @@ -127,7 +127,7 @@ terraform {
required_providers {
biganimal = {
source = "EnterpriseDB/biganimal"
version = "0.10.0"
version = "0.11.0"
}
random = {
source = "hashicorp/random"
Expand Down
4 changes: 2 additions & 2 deletions docs/resources/faraway_replica.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ terraform {
required_providers {
biganimal = {
source = "EnterpriseDB/biganimal"
version = "0.10.0"
version = "0.11.0"
}
random = {
source = "hashicorp/random"
Expand Down Expand Up @@ -102,7 +102,7 @@ terraform {
required_providers {
biganimal = {
source = "EnterpriseDB/biganimal"
version = "0.10.0"
version = "0.11.0"
}
random = {
source = "hashicorp/random"
Expand Down
Loading

0 comments on commit c2bbd2d

Please sign in to comment.