Activating the Kubernetes Terraform provider

You can use Terraform manifests to create Kubernetes resources. To do this, activate the kubernetes Terraform provider. It supports Terraform resources that are mapped to YAML configuration files for various Kubernetes resources.

For more information about the provider resources, see the relevant provider reference on the Terraform website.

Getting startedGetting started

To activate the kubernetes provider, create a Kubernetes cluster using Terraform.

The kubernetes provider is initialized only after creating and setting up a Kubernetes cluster for the following reasons:

• The provider requires the cluster data.
• The provider is used to create Kubernetes resources. You can only create them when the cluster is ready.

Activating the providerActivating the provider

1. Navigate to the working directory with Terraform files.

2. Open the .tf file with yandex provider settings you used when creating the Kubernetes cluster. It must have the following structure:

   terraform {
     required_providers {
       yandex = {
         source = "yandex-cloud/yandex"
       }
     }
   
     required_version = ">= 0.13"
   }
   
   provider "yandex" {
     cloud_id  = "<cloud_ID>"
     folder_id = "<folder_ID>"
     zone      = "<default_availability_zone>"
   }
   

3. In the file, specify the parameters required for the kubernetes provider:

   1. Under required_providers, add:

      kubernetes = {
        source = "hashicorp/kubernetes"
      }
      

   2. Under required_providers, change required_version to ">= 0.14.8".

   3. Add a new section at the end of the file:

      data "yandex_client_config" "client" {}
      
      provider "kubernetes" {
        host                   = yandex_kubernetes_cluster.<Kubernetes_cluster_name>.master[0].external_v4_endpoint
        cluster_ca_certificate = yandex_kubernetes_cluster.<Kubernetes_cluster_name>.master[0].cluster_ca_certificate
        token                  = data.yandex_client_config.client.iam_token
      }
      

4. Make sure the file you get has the following contents:

   terraform {
     required_providers {
       yandex = {
         source = "yandex-cloud/yandex"
       }
       kubernetes = {
         source = "hashicorp/kubernetes"
       }
     }
     required_version = ">= 0.14.8"
   }
   
   provider "yandex" {
     cloud_id  = "<cloud_ID>"
     folder_id = "<folder_ID>"
     zone      = "<default_availability_zone>"
   }
   
   data "yandex_client_config" "client" {}
   
   provider "kubernetes" {
     host                   = yandex_kubernetes_cluster.<Kubernetes_cluster_name>.master[0].external_v4_endpoint
     cluster_ca_certificate = yandex_kubernetes_cluster.<Kubernetes_cluster_name>.master[0].cluster_ca_certificate
     token                  = data.yandex_client_config.client.iam_token
   }
   

5. Initialize the kubernetes provider:

   terraform init
   

Useful links {see-also}Useful links

Managing Kubernetes resources via the Terraform provider