diff --git a/examples/simple/README.md b/examples/simple/README.md index 6b0d258..3b4815d 100644 --- a/examples/simple/README.md +++ b/examples/simple/README.md @@ -56,9 +56,9 @@ No providers. | Name | Source | Version | |------|--------|---------| -| [tfc\_agent\_pool](#module\_tfc\_agent\_pool) | terraform-cisco-modules/tfe//modules/tfc_agent_pools | n/a | -| [tfc\_variables\_global](#module\_tfc\_variables\_global) | terraform-cisco-modules/tfe//modules/tfc_variables | n/a | -| [tfc\_workspaces](#module\_tfc\_workspaces) | terraform-cisco-modules/tfe//modules/tfc_workspaces | n/a | +| [tfc\_agent\_pool](#module\_tfc\_agent\_pool) | terraform-cisco-modules/modules/tfe//modules/tfc_agent_pool | n/a | +| [tfc\_variables\_global](#module\_tfc\_variables\_global) | terraform-cisco-modules/modules/tfe//modules/tfc_variables | n/a | +| [tfc\_workspaces](#module\_tfc\_workspaces) | terraform-cisco-modules/modules/tfe//modules/tfc_workspaces | n/a | ## Resources diff --git a/modules/tfc_workspace/README.md b/modules/tfc_workspace/README.md index 08336f6..adf02c9 100644 --- a/modules/tfc_workspace/README.md +++ b/modules/tfc_workspace/README.md @@ -38,14 +38,30 @@ No modules. | Name | Description | Type | Default | Required | |------|-------------|------|---------|:--------:| +| [agent\_pool](#input\_agent\_pool) | The ID of an agent pool to assign to the workspace. Requires execution\_mode to be set to agent. This value must not be provided if execution\_mode is set to any other value or if operations is provided. | `string` | `""` | no | +| [allow\_destroy\_plan](#input\_allow\_destroy\_plan) | Whether destroy plans can be queued on the workspace. | `bool` | `true` | no | +| [auto\_apply](#input\_auto\_apply) | Automatically apply changes when a Terraform plan is successful. Plans that have no changes will not be applied. If this workspace is linked to version control, a push to the default branch of the linked repository will trigger a plan and apply. | `bool` | `false` | no | +| [branch](#input\_branch) | The repository branch that Terraform will execute from. Default to master. | `string` | `"master"` | no | +| [description](#input\_description) | A description for the workspace. | `string` | `""` | no | +| [execution\_mode](#input\_execution\_mode) | Which execution mode to use. Using Terraform Cloud, valid values are remote, local or agent. Using Terraform Enterprise, only remote and local execution modes are valid. When set to local, the workspace will be used for state storage only. Defaults to remote. This value must not be provided if operations is provided. | `string` | `"remote"` | no | +| [file\_triggers\_enabled](#input\_file\_triggers\_enabled) | Whether to filter runs based on the changed files in a VCS push. If enabled, the working directory and trigger prefixes describe a set of paths which must contain changes for a VCS push to trigger a run. If disabled, any push will trigger a run. Defaults to true. | `bool` | `true` | no | +| [global\_remote\_state](#input\_global\_remote\_state) | Whether the workspace allows all workspaces in the organization to access its state data during runs. If false, then only specifically approved workspaces can access its state (remote\_state\_consumer\_ids). | `bool` | `false` | no | +| [ingress\_submodules](#input\_ingress\_submodules) | Whether submodules should be fetched when cloning the VCS repository. Defaults to false. | `bool` | `false` | no | +| [name](#input\_name) | Name for the workspace. | `string` | n/a | yes | +| [queue\_all\_runs](#input\_queue\_all\_runs) | n/a | `bool` | `false` | no | +| [remote\_state\_consumer\_ids](#input\_remote\_state\_consumer\_ids) | The set of workspace IDs set as explicit remote state consumers for the given workspace. | `list(string)` | `[]` | no | +| [speculative\_enabled](#input\_speculative\_enabled) | Whether this workspace allows speculative plans. Setting this to false prevents Terraform Cloud or the Terraform Enterprise instance from running plans on pull requests, which can improve security if the VCS repository is public or includes untrusted contributors. Defaults to true. | `bool` | `true` | no | +| [ssh\_key\_id](#input\_ssh\_key\_id) | The ID of an SSH key to assign to the workspace. | `string` | `""` | no | +| [terraform\_version](#input\_terraform\_version) | The version of Terraform to use for this workspace. Defaults to the latest available version. | `string` | `"1.0.0"` | no | | [tfc\_oath\_token](#input\_tfc\_oath\_token) | Terraform Cloud OAuth Token for VCS\_Repo Integration. | `string` | n/a | yes | | [tfc\_org\_name](#input\_tfc\_org\_name) | Terraform Cloud Organization Name. | `string` | n/a | yes | -| [workspace\_list](#input\_workspace\_list) | Workspaces (containing agent\_pool, description, exec\_mode, name, vcs\_repo, working\_dir). |
map(object({|
auto_apply = optional(bool)
agent_pool = optional(string)
description = optional(string)
execution_mode = optional(string)
global_remote_state = optional(bool)
name = string
queue_all_runs = optional(bool)
remote_state_consumer_ids = optional(list(string))
terraform_version = optional(string)
trigger_prefixes = optional(list(string))
working_directory = optional(string)
vcs_repo = optional(string)
}))
{| no | +| [trigger\_prefixes](#input\_trigger\_prefixes) | List of repository-root-relative paths which describe all locations to be tracked for changes. | `list(string)` | `[]` | no | +| [vcs\_repo](#input\_vcs\_repo) | A reference to your VCS repository in the format
"default": {
"agent_pool": "",
"auto_apply": false,
"description": "",
"execution_mode": "remote",
"global_remote_state": false,
"name": "",
"queue_all_runs": false,
"remote_state_consumer_ids": [],
"terraform_version": "1.0.0",
"trigger_prefixes": [],
"vcs_repo": "",
"working_directory": ""
}
}