EKS Cluster

Used to connect to an AWS’s Elastic Kubernetes Service (EKS) cluster.

Property Description
Resource type k8s-cluster
Account type aws, aws-role

Inputs

Values

Name Type Description
name string The name of the cluster.
region string The AWS region of the cluster.
loadbalancer string [Optional] The IP or DNS name representing the Load Balancer.
loadbalancer_hosted_zone string [Optional] The Load Balancer Hosted Zone.
proxy_url string [Optional] The Proxy URL if used.

Secrets

Name Type Description
credentials object Provider’s credentials as JSON object.
agent_url object [Optional] The signed URL produced by the humanitec/agent driver. It is expected to be a reference to the url output of a Agent resource.

Examples

Following the instructions provided here, it should be possible to retrieve the secret inputs needed to configure the access to the cluster properly.

Set the following environment variables for the CLI and API commands:

Variable Example Description
HUMANITEC_TOKEN my-token The authentication token for accessing the Humanitec API.
HUMANITEC_ORG my-org-id The unique identifier for the organization in Humanitec.

Use the command below for the interface of your choice.

  1. Create a file defining the Resource Definition you want to create. Adjust or remove the loadbalancer and the loadbalancer_hosted_zone items as needed.
cat << EOF > k8s-cluster.yaml
apiVersion: entity.humanitec.io/v1b1
kind: Definition
metadata:
  id: my-eks-cluster
entity:
  driver_type: humanitec/k8s-cluster-eks
  name: My EKS Cluster
  type: k8s-cluster
  driver_inputs:
    secrets:
      credentials:
        aws_access_key_id: AAABBBCCCDDDEEEFFFGGG
        aws_secret_access_key: zZxXyY123456789aAbBcCdD
    values:
      name: my-cluster
      region: eu-central-1
      loadbalancer: 10.10.10.10
      loadbalancer_hosted_zone: ABC0DEF5WYYZ00
  criteria:
  - env_type: development
EOF
  1. Use the humctl create command to create the Resource Definition in the Organization defined by your configured context:
humctl create -f k8s-cluster.yaml
rm k8s-cluster.yaml



curl https://api.humanitec.io/orgs/${HUMANITEC_ORG}/resources/defs \
  -X POST \
  -H "Authorization: Bearer ${HUMANITEC_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '
{
  "id": "my-eks-cluster",
  "name": "My EKS Cluster",
  "type": "k8s-cluster",
  "criteria": [
    {
      "env_type": "development"
    }
  ],
  "driver_type": "humanitec/k8s-cluster-eks",
  "driver_inputs": {
    "values": {
      "name": "my-cluster",
      "region": "eu-central-1",
      "loadbalancer": "10.10.10.10",
      "loadbalancer_hosted_zone": "ABC0DEF5WYYZ00"
    },
    "secrets": {
      "credentials": {
        "aws_access_key_id": "AAABBBCCCDDDEEEFFFGGG",
        "aws_secret_access_key": "zZxXyY123456789aAbBcCdD"
      }
    }
  }
}'

AKS Cluster

GKE Cluster