Merge pull request #76 from delphix-integrations/source_changes

HUBS-2073 Source changes

Author: ankit-patil-hubs

.goreleaser.yml

@@ -1,7 +1,7 @@
 # Visit https://goreleaser.com for documentation on how to customize this
 # behavior.
 env:
-  - PROVIDER_VERSION=3.1.0
+  - PROVIDER_VERSION=3.2.0
 before:
   hooks:
     # this is just an example and not a requirement for provider building/publishing

GNUmakefile

@@ -3,7 +3,7 @@ HOSTNAME=delphix.com
 NAMESPACE=dct
 NAME=delphix
 BINARY=terraform-provider-${NAME}
-VERSION=3.1.0
+VERSION=3.2.0
 OS_ARCH=darwin_amd64
 
 default: install

docs/index.md

@@ -63,5 +63,17 @@ resource "delphix_vdb" "vdb_name" {
 * __key__ : The API Key which is used to authenticate with DCT. (Example `apk 2.abc123...`).
 * __tls_insecure_skip__: (Optional) A boolean value which determines whether to skip the SSL/TLS check. The default value is `false`. Skipping any SSL/TLS check is not recommended for production environments. 
 * __host_scheme__: (Optional) Determines the configured host URL's scheme. The default value is `https`.
-
+  
 Consult the documentation's Resources section for details on individual resources, such as VDB, dSource, and Environment.
+
+## Support Matrix
+
+Feature/Product | Provider Version | DCT version 
+--- |------------------| --- | 
+delphix_vdb | v 1.0.0          | v 2.0.0 
+delphix_vdb_group | v 1.0.0          | v 2.0.0 
+delphix_environment | v 1.0.0          | v 2.0.0 
+delphix_appdata_dsource | v 2.1.0          | v 10.0.0 
+delphix_oracle_dsource | v 3.1.0          | v 10.0.0 
+delphix_database_postgresql | v 3.2.0          | v 14.0.0 
+

docs/resources/appdata_dsource.md

@@ -179,4 +179,8 @@ resource "delphix_appdata_dsource" "dsource_name" {
 
 * `parameters` - (Optional) The JSON payload is based on the type of dSource being created. Different data sources require different parameters.
 
-* `sync_parameters` - (Optional) The JSON payload conforming to the snapshot parameters definition in a LUA toolkit or platform plugin.
+* `sync_parameters` - (Optional) The JSON payload conforming to the snapshot parameters definition in a LUA toolkit or platform plugin.
+
+* `skip_wait_for_snapshot_creation` - (Optional) By default this resource will wait for a snapshot to be created post-dSource creation. This ensure a snapshot is available during the VDB provisioning. This behavior can be skipped by setting this parameter to `true`.
+
+* `wait_time` - (Optional) By default this resource waits 3 minutes for a snapshot to be created. Increase the integer value as needed for larger dSource snapshots. This parameter can be ignored if 'skip_wait_for_snapshot_creation' is set to `true`.

docs/resources/database_postgresql.md

@@ -0,0 +1,68 @@
+# Resource: <resource name> delphix_database_postgresql
+
+In the Delphix Platform, a Database (or Source Config) identifies the environment's location from which a specific source dataset can be ingested from. dSources are then created from these Databases.
+
+## System Requirements
+
+* Data Control Tower v14.0.1+ is required for database management. Lower versions are not supported.
+* The Database PostgreSQL resource only supports the Delphix PostgreSQL database type (POSTGRES). This resource does not support Oracle, SQL Server, or SAP ASE.
+
+## Example Usage
+
+```hcl
+# Create a postgres database/source. 
+
+resource "delphix_database_postgresql" "source" {
+  name             = "test"
+  repository_value = "REPO-1"
+  engine_value = "2"
+  environment_value = "ENV-1"
+}
+
+```
+
+## Argument Reference
+
+* `name` - (Required) The name of the new source.
+
+* `repository_value` - (Required)  The Id or Name of the Repository onto which the source will be created..
+
+* `environment_value` - (Optional) The Id or Name of the environment to create the source on.
+
+* `engine_value` - (Optional) The Id or Name of the engine to create the source on.
+
+* `id` - The Source object entity ID.
+
+* `database_type` - The type of this source database.
+
+* `namespace_id` - The namespace id of this source database.
+
+* `namespace_name` - The namespace name of this source database.
+
+* `is_replica` - Is this a replicated object.
+
+* `database_version` - The version of this source database.
+
+* `data_uuid` - A universal ID that uniquely identifies this source database.
+
+* `ip_address` - The IP address of the source's host.
+
+* `fqdn` - The FQDN of the source's host.
+
+* `size` - The total size of this source database, in bytes.
+
+* `jdbc_connection_string` - The JDBC connection URL for this source database.
+
+* `plugin_version` - The version of the plugin associated with this source database.
+
+* `toolkit_id` - The ID of the toolkit associated with this source database(AppData only).
+
+* `is_dsource` - Is this associated with dSource.
+
+* `repository` - The repository id for this source.
+
+* `appdata_source_type` - The type of this appdata source database (Appdata Only).
+
+* `tags` -  The tags to be created for database. This is a map of 2 parameters:
+    * `key` - Key of the tag
+    * `value` - Value of the tag

docs/resources/environment.md

@@ -210,3 +210,4 @@ resource "delphix_environment" "fc-tgt-cluster" {
 * `engine_id` - A reference to the Engine that this Environment connection is associated with.
 * `enabled` - True if this environment is enabled.
 * `hosts` - The hosts that are part of this environment.
+* `repositories` - The repositories that are part of this environment.

docs/resources/oracle_dsource.md

@@ -195,3 +195,6 @@ resource "delphix_oracle_dsource" "test_oracle_dsource" {
         * `azure_vault_secret_key` - Azure vault key in the key-value store.
         * `cyberark_vault_query_string` - Query to find a credential in the CyberArk vault.
 
+* `skip_wait_for_snapshot_creation` - (Optional) By default this resource will wait for a snapshot to be created post-dSource creation. This ensure a snapshot is available during the VDB provisioning. This behavior can be skipped by setting this parameter to `true`.
+
+* `wait_time` - (Optional) By default this resource waits 3 minutes for a snapshot to be created. Increase the integer value as needed for larger dSource snapshots. This parameter can be ignored if 'skip_wait_for_snapshot_creation' is set to `true`.

examples/appdata_dsource/mysql/main.tf

@@ -0,0 +1,51 @@
+/**
+* Summary: This template showcases the properties available when creating an app data dsource.
+*/
+
+terraform {
+  required_providers {
+    delphix = {
+      version = "VERSION"
+      source  = "delphix-integrations/delphix"
+    }
+  }
+}
+
+provider "delphix" {
+  tls_insecure_skip = true
+  key               = "1.XXXX"
+  host              = "HOSTNAME"
+}
+
+#dsource with replication
+
+ resource "delphix_appdata_dsource" "test_app_data_dsource" {
+   source_value                  = "1-APPDATA_STAGED_SOURCE_CONFIG-6"
+   group_id                   = "1-GROUP-1"
+   log_sync_enabled           = false
+   make_current_account_owner = true
+   link_type                  = "AppDataStaged"
+   name                       = "appdata_dsource"
+   staging_mount_base         = ""
+   environment_user           = "HOST_USER-2"
+   staging_environment        = "1-UNIX_HOST_ENVIRONMENT-2"
+   parameters = jsonencode({
+    dSourceType : "Replication",
+    mountPath : "/delphix/zfs3",
+    stagingPort : 3310,
+    serverId : 106 ,
+    sourceip : "10.110.203.176",
+    sourceUse : "XXXX",
+    sourcePass : "XXXX",
+    logSync: true,
+    replicationUser: "XXXX",
+    replicationPass: "XXXX",
+    databaseList: "ALL",
+    backupPath: "",
+    stagingBasedir: "/usr",
+    stagingPass: "XXXX"
+   })
+   sync_parameters = jsonencode({
+     resync = true
+   })
+ }

examples/appdata_dsource/main.tf renamed to examples/appdata_dsource/postgresql/main.tf

@@ -0,0 +1,25 @@
+/**
+* Summary: This template showcases the properties available when creating an source.
+*/
+
+terraform {
+  required_providers {
+    delphix = {
+      version = "VERSION"
+      source  = "delphix-integrations/delphix"
+    }
+  }
+}
+
+provider "delphix" {
+  key  = "1.XXXX"
+  host = "HOSTNAME"
+}
+
+resource "delphix_database_postgresql" "source" {
+  name              = "test"
+  repository_value  = "REPO-1"
+  engine_value      = "2"
+  environment_value = "ENV-1"
+}
+