Create a Kubernetes Cluster

At Argument Reference (oci_containerengine_cluster), find all required arguments:

• compartment_id
• kubernetes_version
• name
• vcn_id

Construct a resource block:

• Declare a resource block with the keyword: resource
• Add a label for resource type: "oci_containerengine_cluster"
• Add a label for a local name (your choice):
  • The label can contain letters, digits, underscores (_), and hyphens (-). The first character must not be a digit.
  • Example: "oke-cluster"
• Inside the code block, provide a value for the required arguments:
  • compartment_id: Point to the compartment declared in compartment.tf: oci_identity_compartment.tf-compartment.id
  • kubernetes_version: This tutorial uses version v1.21.5. You can check the Quick Create option in the Console for the latest version.
  • name: Assign a name of your choice.
  • vcn_id: Point to the compartment declared in vcn-module.tf: module.vcn.vcn_id

  A required argument doesn't have a default value.

• Provide values for the following optional arguments to override their default values.
  • add_ons: Assign true or false for the following arguments:
    • is_kubernetes_dashboard_enabled
    • is_tiller_enabled
  • kubernetes_network_config: Assign a CIDR block as a string for the following arguments:
    • pods_cidr
    • services_cidr
    Note
    
    

    The CIDR block for the pods must not overlap with the worker node and load balancer subnet CIDR blocks.

    The CIDR block for the Kubernetes service must not overlap with the VCN CIDR block.

    The example code in this tutorial uses the same CIDR blocks as the Quick Create option in the Console.

    For more explanation, see CIDR Blocks and Kubernetes Engine (OKE).

  • service_lb_subnet_ids: Assign the public subnet you declared in public-subnet.tf
    Note
    
    The argument, service_lb_subnet_ids accepts a list of subnet ids:

    • Even if you have one subnet, use square brackets to denote a list.
    • Example: [oci_core_subnet.vcn-public-subnet.id]

At Alarm Reference (oci_containerengine_node_pool), find all required arguments:

• cluster_id
• compartment_id
• kubernetes_version
• name
• node_config_details
  • placement_configs
    • availability_domain
    • subnet_id
• node_shape
• node_source_details
  • image_id
  • source_type

Construct a resource block:

• Declare a resource block with the keyword: resource
• Add a label for resource type:

  "oci_containerengine_node_pool"

• Add a label for a local name (your choice):
  • The label can contain letters, digits, underscores (_), and hyphens (-). The first character must not be a digit.
  • Example:"oke-node-pool"
• Inside the code block, provide a value for the required arguments:
  • cluster_id: Point to the cluster declared in cluster.tf:

    oci_containerengine_cluster.oke-cluster.id

  • compartment_id Point to the compartment declared in compartment.tf:

    oci_identity_compartment.tf-compartment.id

  • kubernetes_version: This tutorial uses the same version as the Console Create Cluster wizard.
  • name: Assign a name of your choice. The Console Create Cluster wizard uses the name pool1.
  • node_shape: Enter information you gathered in section one.
  • node_source_details:
    • image_id: Enter information you gathered in section one.
    • source_type: Set to "image".
• Provide values for the following optional arguments to override their default values.
  • initial_node_labels: Assign key/value pairs for the nodes.
    • key: Assign a key of your choice. The Console Quick Create option creates the key "name".
    • value: Assign a value for the key. The Console Quick Create option assigns "<your-cluster-name>" to the "name" key.

• For cluster outputs, see Attribute Reference at oci_containerengine_cluster.
• For node pool outputs, see Attribute Reference at oci_containerengine_node_pool page.