Link vars and outputs from README

This commit is contained in:
Julio Castillo
2022-01-22 13:34:35 +01:00
parent b56a231998
commit 31f625f149
82 changed files with 1243 additions and 1495 deletions

View File

@@ -33,56 +33,53 @@ module "cluster-1-nodepool-1" {
}
# tftest:modules=1:resources=2
```
<!-- BEGIN TFDOC -->
## Variables
| name | description | type | required | default |
|---|---|:---:|:---:|:---:|
| cluster_name | Cluster name. | <code>string</code> | ✓ | |
| location | Cluster location. | <code>string</code> | ✓ | |
| project_id | Cluster project id. | <code>string</code> | ✓ | |
| autoscaling_config | Optional autoscaling configuration. | <code title="object&#40;&#123;&#10; min_node_count &#61; number&#10; max_node_count &#61; number&#10;&#125;&#41;">object&#40;&#123;&#8230;&#125;&#41;</code> | | <code>null</code> |
| gke_version | Kubernetes nodes version. Ignored if auto_upgrade is set in management_config. | <code>string</code> | | <code>null</code> |
| initial_node_count | Initial number of nodes for the pool. | <code>number</code> | | <code>1</code> |
| kubelet_config | Kubelet configuration. | <code title="object&#40;&#123;&#10; cpu_cfs_quota &#61; string&#10; cpu_cfs_quota_period &#61; string&#10; cpu_manager_policy &#61; string&#10;&#125;&#41;">object&#40;&#123;&#8230;&#125;&#41;</code> | | <code>null</code> |
| linux_node_config_sysctls | Linux node configuration. | <code>map&#40;string&#41;</code> | | <code>null</code> |
| management_config | Optional node management configuration. | <code title="object&#40;&#123;&#10; auto_repair &#61; bool&#10; auto_upgrade &#61; bool&#10;&#125;&#41;">object&#40;&#123;&#8230;&#125;&#41;</code> | | <code>null</code> |
| max_pods_per_node | Maximum number of pods per node. | <code>number</code> | | <code>null</code> |
| name | Optional nodepool name. | <code>string</code> | | <code>null</code> |
| node_boot_disk_kms_key | Customer Managed Encryption Key used to encrypt the boot disk attached to each node | <code>string</code> | | <code>null</code> |
| node_count | Number of nodes per instance group, can be updated after creation. Ignored when autoscaling is set. | <code>number</code> | | <code>null</code> |
| node_disk_size | Node disk size, defaults to 100GB. | <code>number</code> | | <code>100</code> |
| node_disk_type | Node disk type, defaults to pd-standard. | <code>string</code> | | <code>&#34;pd-standard&#34;</code> |
| node_guest_accelerator | Map of type and count of attached accelerator cards. | <code>map&#40;number&#41;</code> | | <code>&#123;&#125;</code> |
| node_image_type | Nodes image type. | <code>string</code> | | <code>null</code> |
| node_labels | Kubernetes labels attached to nodes. | <code>map&#40;string&#41;</code> | | <code>&#123;&#125;</code> |
| node_local_ssd_count | Number of local SSDs attached to nodes. | <code>number</code> | | <code>0</code> |
| node_locations | Optional list of zones in which nodes should be located. Uses cluster locations if unset. | <code>list&#40;string&#41;</code> | | <code>null</code> |
| node_machine_type | Nodes machine type. | <code>string</code> | | <code>&#34;n1-standard-1&#34;</code> |
| node_metadata | Metadata key/value pairs assigned to nodes. Set disable-legacy-endpoints to true when using this variable. | <code>map&#40;string&#41;</code> | | <code>null</code> |
| node_min_cpu_platform | Minimum CPU platform for nodes. | <code>string</code> | | <code>null</code> |
| node_preemptible | Use preemptible VMs for nodes. | <code>bool</code> | | <code>null</code> |
| node_sandbox_config | GKE Sandbox configuration. Needs image_type set to COS_CONTAINERD and node_version set to 1.12.7-gke.17 when using this variable. | <code>string</code> | | <code>null</code> |
| node_service_account | Service account email. Unused if service account is auto-created. | <code>string</code> | | <code>null</code> |
| node_service_account_create | Auto-create service account. | <code>bool</code> | | <code>false</code> |
| node_service_account_scopes | Scopes applied to service account. Default to: 'cloud-platform' when creating a service account; 'devstorage.read_only', 'logging.write', 'monitoring.write' otherwise. | <code>list&#40;string&#41;</code> | | <code>&#91;&#93;</code> |
| node_shielded_instance_config | Shielded instance options. | <code title="object&#40;&#123;&#10; enable_secure_boot &#61; bool&#10; enable_integrity_monitoring &#61; bool&#10;&#125;&#41;">object&#40;&#123;&#8230;&#125;&#41;</code> | | <code>null</code> |
| node_tags | Network tags applied to nodes. | <code>list&#40;string&#41;</code> | | <code>null</code> |
| node_taints | Kubernetes taints applied to nodes. E.g. type=blue:NoSchedule | <code>list&#40;string&#41;</code> | | <code>&#91;&#93;</code> |
| upgrade_config | Optional node upgrade configuration. | <code title="object&#40;&#123;&#10; max_surge &#61; number&#10; max_unavailable &#61; number&#10;&#125;&#41;">object&#40;&#123;&#8230;&#125;&#41;</code> | | <code>null</code> |
| workload_metadata_config | Metadata configuration to expose to workloads on the node pool. | <code>string</code> | | <code>&#34;GKE_METADATA&#34;</code> |
| [cluster_name](variables.tf#L26) | Cluster name. | <code>string</code> | ✓ | |
| [location](variables.tf#L59) | Cluster location. | <code>string</code> | ✓ | |
| [project_id](variables.tf#L210) | Cluster project id. | <code>string</code> | ✓ | |
| [autoscaling_config](variables.tf#L17) | Optional autoscaling configuration. | <code title="object&#40;&#123;&#10; min_node_count &#61; number&#10; max_node_count &#61; number&#10;&#125;&#41;">object&#40;&#123;&#8230;&#125;&#41;</code> | | <code>null</code> |
| [gke_version](variables.tf#L31) | Kubernetes nodes version. Ignored if auto_upgrade is set in management_config. | <code>string</code> | | <code>null</code> |
| [initial_node_count](variables.tf#L37) | Initial number of nodes for the pool. | <code>number</code> | | <code>1</code> |
| [kubelet_config](variables.tf#L43) | Kubelet configuration. | <code title="object&#40;&#123;&#10; cpu_cfs_quota &#61; string&#10; cpu_cfs_quota_period &#61; string&#10; cpu_manager_policy &#61; string&#10;&#125;&#41;">object&#40;&#123;&#8230;&#125;&#41;</code> | | <code>null</code> |
| [linux_node_config_sysctls](variables.tf#L53) | Linux node configuration. | <code>map&#40;string&#41;</code> | | <code>null</code> |
| [management_config](variables.tf#L64) | Optional node management configuration. | <code title="object&#40;&#123;&#10; auto_repair &#61; bool&#10; auto_upgrade &#61; bool&#10;&#125;&#41;">object&#40;&#123;&#8230;&#125;&#41;</code> | | <code>null</code> |
| [max_pods_per_node](variables.tf#L73) | Maximum number of pods per node. | <code>number</code> | | <code>null</code> |
| [name](variables.tf#L79) | Optional nodepool name. | <code>string</code> | | <code>null</code> |
| [node_boot_disk_kms_key](variables.tf#L85) | Customer Managed Encryption Key used to encrypt the boot disk attached to each node | <code>string</code> | | <code>null</code> |
| [node_count](variables.tf#L91) | Number of nodes per instance group, can be updated after creation. Ignored when autoscaling is set. | <code>number</code> | | <code>null</code> |
| [node_disk_size](variables.tf#L97) | Node disk size, defaults to 100GB. | <code>number</code> | | <code>100</code> |
| [node_disk_type](variables.tf#L103) | Node disk type, defaults to pd-standard. | <code>string</code> | | <code>&#34;pd-standard&#34;</code> |
| [node_guest_accelerator](variables.tf#L109) | Map of type and count of attached accelerator cards. | <code>map&#40;number&#41;</code> | | <code>&#123;&#125;</code> |
| [node_image_type](variables.tf#L115) | Nodes image type. | <code>string</code> | | <code>null</code> |
| [node_labels](variables.tf#L121) | Kubernetes labels attached to nodes. | <code>map&#40;string&#41;</code> | | <code>&#123;&#125;</code> |
| [node_local_ssd_count](variables.tf#L127) | Number of local SSDs attached to nodes. | <code>number</code> | | <code>0</code> |
| [node_locations](variables.tf#L132) | Optional list of zones in which nodes should be located. Uses cluster locations if unset. | <code>list&#40;string&#41;</code> | | <code>null</code> |
| [node_machine_type](variables.tf#L138) | Nodes machine type. | <code>string</code> | | <code>&#34;n1-standard-1&#34;</code> |
| [node_metadata](variables.tf#L144) | Metadata key/value pairs assigned to nodes. Set disable-legacy-endpoints to true when using this variable. | <code>map&#40;string&#41;</code> | | <code>null</code> |
| [node_min_cpu_platform](variables.tf#L150) | Minimum CPU platform for nodes. | <code>string</code> | | <code>null</code> |
| [node_preemptible](variables.tf#L156) | Use preemptible VMs for nodes. | <code>bool</code> | | <code>null</code> |
| [node_sandbox_config](variables.tf#L162) | GKE Sandbox configuration. Needs image_type set to COS_CONTAINERD and node_version set to 1.12.7-gke.17 when using this variable. | <code>string</code> | | <code>null</code> |
| [node_service_account](variables.tf#L168) | Service account email. Unused if service account is auto-created. | <code>string</code> | | <code>null</code> |
| [node_service_account_create](variables.tf#L174) | Auto-create service account. | <code>bool</code> | | <code>false</code> |
| [node_service_account_scopes](variables.tf#L182) | Scopes applied to service account. Default to: 'cloud-platform' when creating a service account; 'devstorage.read_only', 'logging.write', 'monitoring.write' otherwise. | <code>list&#40;string&#41;</code> | | <code>&#91;&#93;</code> |
| [node_shielded_instance_config](variables.tf#L188) | Shielded instance options. | <code title="object&#40;&#123;&#10; enable_secure_boot &#61; bool&#10; enable_integrity_monitoring &#61; bool&#10;&#125;&#41;">object&#40;&#123;&#8230;&#125;&#41;</code> | | <code>null</code> |
| [node_tags](variables.tf#L197) | Network tags applied to nodes. | <code>list&#40;string&#41;</code> | | <code>null</code> |
| [node_taints](variables.tf#L203) | Kubernetes taints applied to nodes. E.g. type=blue:NoSchedule | <code>list&#40;string&#41;</code> | | <code>&#91;&#93;</code> |
| [upgrade_config](variables.tf#L215) | Optional node upgrade configuration. | <code title="object&#40;&#123;&#10; max_surge &#61; number&#10; max_unavailable &#61; number&#10;&#125;&#41;">object&#40;&#123;&#8230;&#125;&#41;</code> | | <code>null</code> |
| [workload_metadata_config](variables.tf#L224) | Metadata configuration to expose to workloads on the node pool. | <code>string</code> | | <code>&#34;GKE_METADATA&#34;</code> |
## Outputs
| name | description | sensitive |
|---|---|:---:|
| name | Nodepool name. | |
| service_account | Service account resource. | |
| service_account_email | Service account email. | |
| service_account_iam_email | Service account email. | |
| [name](outputs.tf#L17) | Nodepool name. | |
| [service_account](outputs.tf#L22) | Service account resource. | |
| [service_account_email](outputs.tf#L31) | Service account email. | |
| [service_account_iam_email](outputs.tf#L36) | Service account email. | |
<!-- END TFDOC -->