tf-gke-test/README.md

96 lines
4.1 KiB
Markdown
Raw Normal View History

2024-05-05 12:06:11 +02:00
# How to use repo
2023-05-03 14:52:20 +02:00
2024-05-05 12:06:11 +02:00
1. Create `terraform.tfvars` file with a few variables
```shell
2023-05-03 14:52:20 +02:00
project = "gcp-project"
region = "europe-west1"
environment_name = "demo"
```
2. Create cluster
2024-05-05 12:06:11 +02:00
All commands will be applied via Terraform 1.7.0 and via OpenTofu, the same version.
Here are OpenTofu commands.
```shell
2024-05-05 12:06:11 +02:00
tofu init
tofu apply
2023-05-03 14:52:20 +02:00
```
2024-05-05 12:06:11 +02:00
3. Get the credentials for the new cluster (configure kubeconfig)
You can see all useful commands and links in the output:
```shell
2024-05-05 12:06:11 +02:00
tofu output
2023-05-03 14:52:20 +02:00
```
2024-05-05 12:06:11 +02:00
There is a manual command:
```shell
gcloud container clusters get-credentials $(tofu output -raw kubernetes_cluster_name) --region $(tofu output -raw zone) --project $(tofu output -raw project)
2023-05-03 14:52:20 +02:00
```
Or just use `./get-credentials.sh`
2023-05-03 14:52:20 +02:00
4. Destroy all resources
```shell
2024-05-05 12:06:11 +02:00
tofu destroy
```
2023-05-03 14:52:20 +02:00
<!-- BEGIN_TF_DOCS -->
## Requirements
| Name | Version |
|------|---------|
2024-05-05 11:35:15 +02:00
| <a name="requirement_terraform"></a> [terraform](#requirement\_terraform) | ~>1.7.0 |
| <a name="requirement_google"></a> [google](#requirement\_google) | ~>5.27.0 |
| <a name="requirement_kubernetes"></a> [kubernetes](#requirement\_kubernetes) | ~>2.29.0 |
2023-05-03 14:52:20 +02:00
## Providers
| Name | Version |
|------|---------|
2024-05-05 11:35:15 +02:00
| <a name="provider_google"></a> [google](#provider\_google) | 5.27.0 |
| <a name="provider_kubernetes"></a> [kubernetes](#provider\_kubernetes) | 2.29.0 |
2023-05-03 14:52:20 +02:00
## Modules
No modules.
## Resources
| Name | Type |
|------|------|
| [google_compute_network.vpc](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/compute_network) | resource |
| [google_compute_subnetwork.subnet](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/compute_subnetwork) | resource |
| [google_container_cluster.primary](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/container_cluster) | resource |
| [google_container_node_pool.primary_nodes](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/container_node_pool) | resource |
| [google_project_service.service_networking](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/project_service) | resource |
| [kubernetes_namespace.demo-cluster](https://registry.terraform.io/providers/hashicorp/kubernetes/latest/docs/resources/namespace) | resource |
2023-05-03 14:52:20 +02:00
| [google_client_config.primary](https://registry.terraform.io/providers/hashicorp/google/latest/docs/data-sources/client_config) | data source |
## Inputs
| Name | Description | Type | Default | Required |
|------|-------------|------|---------|:--------:|
| <a name="input_environment_name"></a> [environment\_name](#input\_environment\_name) | n/a | `string` | `"demo"` | no |
| <a name="input_project"></a> [project](#input\_project) | Google Project to create resources in | `string` | `"demo"` | no |
| <a name="input_region"></a> [region](#input\_region) | The region to host the cluster in | `string` | `"us-central1"` | no |
| <a name="input_vpc_host_project"></a> [vpc\_host\_project](#input\_vpc\_host\_project) | Host Project where virtual network exists | `string` | `"demo"` | no |
2024-05-05 11:35:15 +02:00
| <a name="input_zone"></a> [zone](#input\_zone) | The region to host the cluster in | `string` | `"us-central1-b"` | no |
2023-05-03 14:52:20 +02:00
## Outputs
| Name | Description |
|------|-------------|
2024-05-05 11:35:15 +02:00
| <a name="output_gcloud_gke_get_creds"></a> [gcloud\_gke\_get\_creds](#output\_gcloud\_gke\_get\_creds) | Command to get GKE credentials |
| <a name="output_gcloud_gke_link"></a> [gcloud\_gke\_link](#output\_gcloud\_gke\_link) | GKE web ui link |
| <a name="output_gcloud_vpc_link"></a> [gcloud\_vpc\_link](#output\_gcloud\_vpc\_link) | VPC web ui link |
2023-05-03 14:52:20 +02:00
| <a name="output_kubernetes_cluster_host"></a> [kubernetes\_cluster\_host](#output\_kubernetes\_cluster\_host) | GKE Cluster Host |
| <a name="output_kubernetes_cluster_name"></a> [kubernetes\_cluster\_name](#output\_kubernetes\_cluster\_name) | GKE Cluster Name |
| <a name="output_project"></a> [project](#output\_project) | GCloud Project ID |
| <a name="output_region"></a> [region](#output\_region) | GCloud Region |
| <a name="output_zone"></a> [zone](#output\_zone) | GCloud Project ID |
2023-05-03 14:52:20 +02:00
<!-- END_TF_DOCS -->