Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/terraform-ibm-modules/terraform-ibm-watsonx-governance

Terraform module to create and work with IBM watsonx.governance.
https://github.com/terraform-ibm-modules/terraform-ibm-watsonx-governance

aiopenscale core-team governance ibm-cloud terraform terraform-module watsonx watsonx-governance

Last synced: about 1 month ago
JSON representation

Terraform module to create and work with IBM watsonx.governance.

Awesome Lists containing this project

README 

        

# IBM watsonx.governance module



[![Stable (With quality checks)](https://img.shields.io/badge/Status-Stable%20(With%20quality%20checks)-green)](https://terraform-ibm-modules.github.io/documentation/#/badge-status)

[![latest release](https://img.shields.io/github/v/release/terraform-ibm-modules/terraform-ibm-watsonx-governance?logo=GitHub&sort=semver)](https://github.com/terraform-ibm-modules/terraform-ibm-watsonx-governance/releases/latest)

[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)](https://github.com/pre-commit/pre-commit)

[![Renovate enabled](https://img.shields.io/badge/renovate-enabled-brightgreen.svg)](https://renovatebot.com/)

[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)



The IBM watsonx.governance Terraform module is designed to automate the deployment and configuration of IBM watsonx.governance, which is a toolkit which seamlessly integrates with your existing systems to automate and accelerate responsible AI workflows to help save time, reduce costs and comply with regulations.



For further information on IBM watsonx.governance, including supported features, plans, and regions, please refer the official watsonx.governance [documentation](https://dataplatform.cloud.ibm.com/docs/content/svc-welcome/aiopenscale.html?context=wx)



## Overview

* [terraform-ibm-watsonx-governance](#terraform-ibm-watsonx-governance)

* [Examples](./examples)

    * [Basic example](./examples/basic)

    * [Existing instance example](./examples/existing-instance)

* [Contributing](#contributing)



## terraform-ibm-watsonx-governance



This module supports provisioning the watsonx.governance instance with a selectable service plan.



### Usage



```hcl

module "watsonx_governance" {

  source                = "terraform-ibm-modules/watsonx-governance/ibm"

  watsonx_governance_name = "watsonx-governance"

  resource_group_id     = module.resource_group.resource_group_id

}



```



### Required access policies



You need the following permissions to run this module:



* Account Management

  * **Resource Group**

        - `Viewer` role

* IAM Services

  * **watsonx.governance** service

        - `Editor` platform access



To attach access management tags to resources in this module, you need the following permissions.



- IAM Services

    - **Tagging** service

        - `Administrator` platform access



### Requirements



| Name | Version |

|------|---------|

|  [terraform](#requirement\_terraform) | >= 1.9.0 |

|  [ibm](#requirement\_ibm) | >= 1.70.1, < 2.0.0 |



### Modules



| Name | Source | Version |

|------|--------|---------|

|  [crn\_parser](#module\_crn\_parser) | terraform-ibm-modules/common-utilities/ibm//modules/crn-parser | 1.1.0 |



### Resources



| Name | Type |

|------|------|

| [ibm_resource_instance.watsonx_governance_instance](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/resource_instance) | resource |

| [ibm_resource_tag.watsonx_governance_tag](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/resource_tag) | resource |

| [ibm_resource_instance.existing_watsonx_governance_instance](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/data-sources/resource_instance) | data source |



### Inputs



| Name | Description | Type | Default | Required |

|------|-------------|------|---------|:--------:|

|  [access\_tags](#input\_access\_tags) | A list of access tags to apply to the watsonx.governance instance. For more information, see https://cloud.ibm.com/docs/account?topic=account-access-tags-tutorial. | `list(string)` | `[]` | no |

|  [existing\_watsonx\_governance\_instance\_crn](#input\_existing\_watsonx\_governance\_instance\_crn) | The CRN of an existing watsonx.governance instance. | `string` | `null` | no |

|  [plan](#input\_plan) | The plan that is required to provision the watsonx.governance instance. Possible values are: lite, essentials. | `string` | `"lite"` | no |

|  [region](#input\_region) | Region where watsonx.governance instance will be provisioned. Required if creating a new instance. | `string` | `"us-south"` | no |

|  [resource\_group\_id](#input\_resource\_group\_id) | The resource group ID where the watsonx.governance instance will be grouped. Required when creating a new instance. | `string` | `null` | no |

|  [resource\_tags](#input\_resource\_tags) | Optional list of tags to describe the watsonx.governance instance created by the module. | `list(string)` | `[]` | no |

|  [watsonx\_governance\_name](#input\_watsonx\_governance\_name) | The name of the watsonx.governance instance. Required if creating a new instance. | `string` | `null` | no |



### Outputs



| Name | Description |

|------|-------------|

|  [account\_id](#output\_account\_id) | Account ID of the watsonx.governance instance. |

|  [crn](#output\_crn) | The CRN of the watsonx.governance instance. |

|  [dashboard\_url](#output\_dashboard\_url) | The dashboard URL of the watsonx.governance instance. |

|  [guid](#output\_guid) | The GUID of the watsonx.governance instance. |

|  [id](#output\_id) | ID of the watsonx.governance instance. |

|  [name](#output\_name) | The name of the watsonx.governance instance. |

|  [plan\_id](#output\_plan\_id) | The plan ID of the watsonx.governance instance. |



## Contributing



You can report issues and request features for this module in GitHub issues in the module repo. See [Report an issue or request a feature](https://github.com/terraform-ibm-modules/.github/blob/main/.github/SUPPORT.md).



To set up your local development environment, see [Local development setup](https://terraform-ibm-modules.github.io/documentation/#/local-dev-setup) in the project documentation.