{"id":16900028,"url":"https://github.com/runlevel5/pulumi-eks-custom","last_synced_at":"2026-04-05T20:38:02.427Z","repository":{"id":142032861,"uuid":"337691447","full_name":"runlevel5/pulumi-eks-custom","owner":"runlevel5","description":null,"archived":false,"fork":false,"pushed_at":"2021-02-10T11:22:00.000Z","size":98,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-25T12:27:56.429Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/runlevel5.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"securitygroup.d.ts","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-02-10T10:38:26.000Z","updated_at":"2021-02-10T11:22:03.000Z","dependencies_parsed_at":"2024-05-31T08:51:40.770Z","dependency_job_id":null,"html_url":"https://github.com/runlevel5/pulumi-eks-custom","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runlevel5%2Fpulumi-eks-custom","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runlevel5%2Fpulumi-eks-custom/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runlevel5%2Fpulumi-eks-custom/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runlevel5%2Fpulumi-eks-custom/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/runlevel5","download_url":"https://codeload.github.com/runlevel5/pulumi-eks-custom/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244610330,"owners_count":20480961,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-13T17:51:20.522Z","updated_at":"2025-12-31T00:05:44.183Z","avatar_url":"https://github.com/runlevel5.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.com/pulumi/pulumi-eks.svg?token=eHg7Zp5zdDDJfTjY8ejq\u0026branch=master)](https://travis-ci.com/pulumi/pulumi-eks)\n\n# Pulumi Amazon Web Services (AWS) EKS Components\n\nPulumi's library for easily creating and managing EKS Kubernetes clusters.\n\n* [Introduction](#introduction)\n* [References](#references)\n* [Pre-Requisites](#pre-requisites)\n* [Installing](#installing)\n* [Quick Examples](#quick-examples)\n  * [Create a Default EKS Cluster](#create-a-default-eks-cluster)\n  * [Deploying a Helm Chart](#deploying-a-helm-chart)\n  * [Deploying a Workload](#deploying-a-workload)\n* [Contributing](#contributing)\n* [Code of Conduct](#code-of-conduct)\n\n## Introduction\n\n`pulumi/eks` provides a Pulumi component that creates and manages the resources necessary to run an EKS Kubernetes cluster in AWS.\n\nThis includes:\n- The EKS cluster control plane.\n- The cluster's worker nodes configured as node groups, which are managed by an auto scaling group.\n- The AWS CNI Plugin [`aws-k8s-cni`](https://github.com/aws/amazon-vpc-cni-k8s/) to manage pod networking in Kubernetes.\n\n## References\n\n* [Reference Documentation](https://www.pulumi.com/docs/reference/clouds/kubernetes/)\n* [Node.js API Documentation](https://pulumi.io/reference/pkg/nodejs/@pulumi/eks/index.html)\n* [Examples](./examples)\n* [Crosswalk for AWS \u0026 EKS Guide](https://www.pulumi.com/docs/guides/crosswalk/aws/eks/)\n* [Tutorials](https://www.pulumi.com/docs/reference/tutorials/kubernetes/)\n\n## Pre-Requisites\n\n1. [Install Pulumi](https://www.pulumi.com/docs/reference/install).\n1. Install [Node.js](https://nodejs.org/en/download).\n1. Install a package manager for Node.js, such as [NPM](https://www.npmjs.com/get-npm) or [Yarn](https://yarnpkg.com/lang/en/docs/install).\n1. [Install and Configure the AWS CLI](https://www.pulumi.com/docs/reference/clouds/aws/setup/).\n    * Use AWS CLI version \u003e= `1.18.17`.\n    * See the [AWS docs](https://docs.aws.amazon.com/eks/latest/userguide/managing-auth.html) for more details.\n1. [Install `kubectl`](https://kubernetes.io/docs/tasks/tools/install-kubectl/#install-kubectl).\n\n## Installing\n\nThis package is available in JavaScript/TypeScript for use with Node.js. Install it using either `npm` or `yarn`.\n\n`npm`:\n\n```bash\n$ npm install @pulumi/eks\n```\n\n`yarn`:\n\n```bash\n$ yarn add @pulumi/eks\n```\n\n## Quick Examples\n\n### Create a Default EKS Cluster\n\nThe default cluster configuration will use the default VPC of the AWS user\nor role transiently signed in. It will create the EKS control plane and a default\nworker node group using an autoscaling group of two `t2.medium` EC2 instances.\n\n```typescript\nimport * as eks from \"@pulumi/eks\";\n\n// Create an EKS cluster with the default configuration.\nconst cluster = new eks.Cluster(\"my-cluster\");\n\n// Export the cluster's kubeconfig.\nexport const kubeconfig = cluster.kubeconfig;\n```\n\nOnce the cluster is created, you can deploy into the cluster using usual methods\nsuch as `kubectl` and Helm, or using the\n[`@pulumi/kubernetes`][pulumi-kubernetes] SDK to deploy in various ways\nas shown below.\n\nYou can retrieve the new EKS cluster's `kubeconfig` from Pulumi by querying the\n[stack](https://www.pulumi.com/docs/intro/concepts/stack/) for its\n[output](https://www.pulumi.com/docs/intro/concepts/stack/#outputs) of exported\nvariables if working with the `kubectl` or Helm tools directly.\n\n```bash\npulumi stack output kubeconfig \u003e kubeconfig.json\nexport KUBECONFIG=$PWD/kubeconfig.json\n```\n\n### Deploying a Helm Chart\n\nThis example creates a EKS cluster and then deploys a Helm chart from the\nstable repo. We extract the cluster's `kubeconfig` from its [Pulumi provider](https://www.pulumi.com/docs/reference/programming-model/#providers) to specifically target this cluster for deployments with\n[`pulumi-kubernetes`][pulumi-kubernetes].\n\n```typescript\nimport * as eks from \"@pulumi/eks\";\nimport * as k8s from \"@pulumi/kubernetes\";\n\n// Create an EKS cluster.\nconst cluster = new eks.Cluster(\"my-cluster\");\n\n// Deploy Wordpress into our cluster.\nconst wordpress = new k8s.helm.v2.Chart(\"wordpress\", {\n    repo: \"stable\",\n    chart: \"wordpress\",\n    values: {\n        wordpressBlogName: \"My Cool Kubernetes Blog!\",\n    },\n}, { providers: { \"kubernetes\": cluster.provider } });\n\n// Export the cluster's kubeconfig.\nexport const kubeconfig = cluster.kubeconfig;\n```\n\n### Deploying a Workload\n\nThis example creates a EKS cluster and then deploys an NGINX Deployment and\nService using the [`pulumi/kubernetes`][pulumi-kubernetes] SDK, and the\n`kubeconfig` credentials from the cluster's\n[Pulumi provider](https://www.pulumi.com/docs/reference/programming-model/#providers).\n\n```typescript\nimport * as eks from \"@pulumi/eks\";\nimport * as k8s from \"@pulumi/kubernetes\";\n\n// Create an EKS cluster with the default configuration.\nconst cluster = new eks.Cluster(\"my-cluster\");\n\n// Create a NGINX Deployment and Service.\nconst appName = \"my-app\";\nconst appLabels = { appClass: appName };\nconst deployment = new k8s.apps.v1.Deployment(`${appName}-dep`, {\n    metadata: { labels: appLabels },\n    spec: {\n        replicas: 2,\n        selector: { matchLabels: appLabels },\n        template: {\n            metadata: { labels: appLabels },\n            spec: {\n                containers: [{\n                    name: appName,\n                    image: \"nginx\",\n                    ports: [{ name: \"http\", containerPort: 80 }]\n                }],\n            }\n        }\n    },\n}, { provider: cluster.provider });\n\nconst service = new k8s.core.v1.Service(`${appName}-svc`, {\n    metadata: { labels: appLabels },\n    spec: {\n        type: \"LoadBalancer\",\n        ports: [{ port: 80, targetPort: \"http\" }],\n        selector: appLabels,\n    },\n}, { provider: cluster.provider });\n\n// Export the URL for the load balanced service.\nexport const url = service.status.loadBalancer.ingress[0].hostname;\n\n// Export the cluster's kubeconfig.\nexport const kubeconfig = cluster.kubeconfig;\n```\n\n### Contributing\n\nIf you are interested in contributing, please see the [contributing docs][contributing].\n\n### Code of Conduct\n\nYou can read the code of conduct [here][code-of-conduct].\n\n[pulumi-kubernetes]: https://github.com/pulumi/pulumi-kubernetes\n[contributing]: CONTRIBUTING.md\n[code-of-conduct]: CODE-OF-CONDUCT.md\n[workload-example]: #deploying-a-workload-on-aws-eks\n[how-pulumi-works]: https://www.pulumi.com/docs/intro/concepts/how-pulumi-works\n[workload-example]: #deploying-a-workload\n[faq]: https://www.pulumi.com/docs/intro/cloud-providers/kubernetes/faq/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frunlevel5%2Fpulumi-eks-custom","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frunlevel5%2Fpulumi-eks-custom","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frunlevel5%2Fpulumi-eks-custom/lists"}