pulumi-eks 0.42.8a1668210464__tar.gz → 4.2.0a1765350072__tar.gz

pulumi_eks-4.2.0a1765350072/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: pulumi_eks
+Version: 4.2.0a1765350072
+Summary: Pulumi Amazon Web Services (AWS) EKS Components.
+License: Apache-2.0
+Project-URL: Homepage, https://pulumi.com
+Project-URL: Repository, https://github.com/pulumi/pulumi-eks
+Keywords: pulumi,aws,eks
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: parver>=0.2.1
+Requires-Dist: pulumi<4.0.0,>=3.165.0
+Requires-Dist: pulumi-aws<8.0.0,>=7.10.0
+Requires-Dist: pulumi-kubernetes<5.0.0,>=4.19.0
+Requires-Dist: semver>=2.8.1
+Requires-Dist: typing-extensions<5,>=4.11; python_version < "3.11"
+
+[![Build Status](https://github.com/pulumi/pulumi-eks/actions/workflows/master.yml/badge.svg)](https://github.com/pulumi/pulumi-eks/actions/workflows/master.yml)
+[![Slack](http://www.pulumi.com/images/docs/badges/slack.svg)](https://slack.pulumi.com)
+[![npm version](https://badge.fury.io/js/@pulumi%2Feks.svg)](https://badge.fury.io/js/@pulumi%2Feks)
+[![Python version](https://badge.fury.io/py/pulumi-eks.svg)](https://pypi.org/project/pulumi-eks)
+[![NuGet version](https://badge.fury.io/nu/pulumi.eks.svg)](https://badge.fury.io/nu/pulumi.eks)
+[![PkgGoDev](https://pkg.go.dev/badge/github.com/pulumi/pulumi-eks/sdk/go/eks)](https://pkg.go.dev/github.com/pulumi/pulumi-eks/sdk/go/eks)
+
+# Pulumi Amazon Web Services (AWS) EKS Components
+
+The Pulumi EKS library provides a Pulumi component that creates and manages the resources necessary to run an EKS Kubernetes cluster in AWS. This component exposes the Crosswalk for AWS functionality documented in the [Pulumi Elastic Kubernetes Service guide](https://www.pulumi.com/docs/guides/crosswalk/aws/eks/) as a package available in all Pulumi languages.
+
+
+This includes:
+- The EKS cluster control plane.
+- The cluster's worker nodes configured as node groups, which are managed by an auto scaling group.
+- The AWS CNI Plugin [`aws-k8s-cni`](https://github.com/aws/amazon-vpc-cni-k8s/) to manage pod networking in Kubernetes.
+
+
+<div>
+    <a href="https://www.pulumi.com/templates/kubernetes/aws/" title="Get Started">
+       <img src="https://www.pulumi.com/images/get-started.svg?" width="120">
+    </a>
+</div>
+
+## Installing
+
+This package is available in many languages in the standard packaging formats.
+
+### Node.js (JavaScript/TypeScript)
+
+To use from JavaScript or TypeScript in Node.js, install it using either `npm`:
+
+```bash
+$ npm install @pulumi/eks
+```
+
+ or `yarn`:
+
+```bash
+$ yarn add @pulumi/eks
+```
+
+### Python
+
+To use from Python, install using `pip`:
+
+    $ pip install pulumi_eks
+
+### Go
+
+To use from Go, use `go get` to grab the latest version of the library
+
+    $ go get github.com/pulumi/pulumi-eks/sdk/go
+
+### .NET
+
+To use from .NET, install using `dotnet add package`:
+
+    $ dotnet add package Pulumi.Eks
+
+## References
+
+* [Tutorial](https://www.pulumi.com/blog/easily-create-and-manage-aws-eks-kubernetes-clusters-with-pulumi/)
+* [Reference Documentation](https://www.pulumi.com/registry/packages/eks/api-docs/)
+* [Examples](./examples)
+* [Crosswalk for AWS - EKS Guide](https://www.pulumi.com/docs/guides/crosswalk/aws/eks/)
+
+## Contributing
+
+If you are interested in contributing, please see the [contributing docs][contributing].
+
+## Code of Conduct
+
+Please follow the [code of conduct][code-of-conduct].
+
+[contributing]: CONTRIBUTING.md
+[code-of-conduct]: CODE-OF-CONDUCT.md

{pulumi_eks-0.42.8a1668210464 → pulumi_eks-4.2.0a1765350072}/README.md

@@ -7,22 +7,27 @@
 
 # Pulumi Amazon Web Services (AWS) EKS Components
 
-The Pulumi EKS library provides a Pulumi component that creates and manages the resources necessary to run an EKS Kubernetes cluster in AWS.
+The Pulumi EKS library provides a Pulumi component that creates and manages the resources necessary to run an EKS Kubernetes cluster in AWS. This component exposes the Crosswalk for AWS functionality documented in the [Pulumi Elastic Kubernetes Service guide](https://www.pulumi.com/docs/guides/crosswalk/aws/eks/) as a package available in all Pulumi languages.
+
 
 This includes:
 - The EKS cluster control plane.
 - The cluster's worker nodes configured as node groups, which are managed by an auto scaling group.
 - The AWS CNI Plugin [`aws-k8s-cni`](https://github.com/aws/amazon-vpc-cni-k8s/) to manage pod networking in Kubernetes.
 
-## Pre-Requisites
 
-1. [Install Pulumi](https://www.pulumi.com/docs/reference/install).
-1. [Install `kubectl`](https://kubernetes.io/docs/tasks/tools/install-kubectl/#install-kubectl) (v1.24.0 or higher).
-1. [Install AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) (>=v1.24.0 for v1 or >=2.7.0 for v2).
-1. [Install Node.js](https://nodejs.org/en/download/) (required even if using this library from another Pulumi language).
+<div>
+    <a href="https://www.pulumi.com/templates/kubernetes/aws/" title="Get Started">
+       <img src="https://www.pulumi.com/images/get-started.svg?" width="120">
+    </a>
+</div>
 
 ## Installing
 
+This package is available in many languages in the standard packaging formats.
+
+### Node.js (JavaScript/TypeScript)
+
 To use from JavaScript or TypeScript in Node.js, install it using either `npm`:
 
 ```bash
@@ -56,17 +61,17 @@ To use from .NET, install using `dotnet add package`:
 ## References
 
 * [Tutorial](https://www.pulumi.com/blog/easily-create-and-manage-aws-eks-kubernetes-clusters-with-pulumi/)
-* [Reference Documentation](https://www.pulumi.com/docs/reference/pkg/eks/)
+* [Reference Documentation](https://www.pulumi.com/registry/packages/eks/api-docs/)
 * [Examples](./examples)
-* [Crosswalk for AWS & EKS Guide](https://www.pulumi.com/docs/guides/crosswalk/aws/eks/)
+* [Crosswalk for AWS - EKS Guide](https://www.pulumi.com/docs/guides/crosswalk/aws/eks/)
 
-### Contributing
+## Contributing
 
 If you are interested in contributing, please see the [contributing docs][contributing].
 
-### Code of Conduct
+## Code of Conduct
 
-You can read the code of conduct [here][code-of-conduct].
+Please follow the [code of conduct][code-of-conduct].
 
 [contributing]: CONTRIBUTING.md
 [code-of-conduct]: CODE-OF-CONDUCT.md

{pulumi_eks-0.42.8a1668210464 → pulumi_eks-4.2.0a1765350072}/pulumi_eks/__init__.py

@@ -2,9 +2,12 @@
 # *** WARNING: this file was generated by pulumi-gen-eks. ***
 # *** Do not edit by hand unless you're certain you know what you are doing! ***
 
+import builtins
 from . import _utilities
 import typing
 # Export this package's modules as members:
+from ._enums import *
+from .addon import *
 from .cluster import *
 from .cluster_creation_role_provider import *
 from .managed_node_group import *
@@ -12,7 +15,7 @@ from .node_group import *
 from .node_group_security_group import *
 from .node_group_v2 import *
 from .provider import *
-from .vpc_cni import *
+from .vpc_cni_addon import *
 from ._inputs import *
 from . import outputs
 _utilities.register(
@@ -23,13 +26,14 @@ _utilities.register(
   "mod": "index",
   "fqn": "pulumi_eks",
   "classes": {
+   "eks:index:Addon": "Addon",
    "eks:index:Cluster": "Cluster",
    "eks:index:ClusterCreationRoleProvider": "ClusterCreationRoleProvider",
    "eks:index:ManagedNodeGroup": "ManagedNodeGroup",
    "eks:index:NodeGroup": "NodeGroup",
    "eks:index:NodeGroupSecurityGroup": "NodeGroupSecurityGroup",
    "eks:index:NodeGroupV2": "NodeGroupV2",
-   "eks:index:VpcCni": "VpcCni"
+   "eks:index:VpcCniAddon": "VpcCniAddon"
   }
  }
 ]

pulumi_eks-4.2.0a1765350072/pulumi_eks/_enums.py

@@ -0,0 +1,164 @@
+# coding=utf-8
+# *** WARNING: this file was generated by pulumi-gen-eks. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import builtins
+import pulumi
+from enum import Enum
+
+__all__ = [
+    'AccessEntryType',
+    'AmiType',
+    'AuthenticationMode',
+    'ClusterNodePools',
+    'OperatingSystem',
+    'ResolveConflictsOnCreate',
+    'ResolveConflictsOnUpdate',
+]
+
+
+@pulumi.type_token("eks:index:AccessEntryType")
+class AccessEntryType(builtins.str, Enum):
+    """
+    The type of the new access entry. Valid values are STANDARD, FARGATE_LINUX, EC2_LINUX, and EC2_WINDOWS.
+    Defaults to STANDARD which provides the standard workflow. EC2_LINUX and EC2_WINDOWS types disallow users to input a kubernetesGroup, and prevent associating access policies.
+    """
+    STANDARD = "STANDARD"
+    """
+    Standard Access Entry Workflow. Allows users to input a username and kubernetesGroup, and to associate access policies.
+    """
+    FARGATE_LINUX = "FARGATE_LINUX"
+    """
+    For IAM roles used with AWS Fargate profiles.
+    """
+    EC2_LINUX = "EC2_LINUX"
+    """
+    For IAM roles associated with self-managed Linux node groups. Allows the nodes to join the cluster.
+    """
+    EC2_WINDOWS = "EC2_WINDOWS"
+    """
+    For IAM roles associated with self-managed Windows node groups. Allows the nodes to join the cluster.
+    """
+    EC2 = "EC2"
+    """
+    For IAM roles associated with EC2 instances that need access policies. Allows the nodes to join the cluster.
+    """
+
+
+@pulumi.type_token("eks:index:AmiType")
+class AmiType(builtins.str, Enum):
+    """
+    Predefined AMI types for EKS optimized AMIs. Can be used to select the latest EKS optimized AMI for a node group.
+    """
+    AL2_X86_64 = "AL2_x86_64"
+    AL2_X86_64_GPU = "AL2_x86_64_GPU"
+    AL2_ARM64 = "AL2_ARM_64"
+    AL2023_X86_64_STANDARD = "AL2023_x86_64_STANDARD"
+    AL2023_ARM64_STANDARD = "AL2023_ARM_64_STANDARD"
+    AL2023_X86_64_NVIDIA = "AL2023_x86_64_NVIDIA"
+    BOTTLEROCKET_ARM64 = "BOTTLEROCKET_ARM_64"
+    BOTTLEROCKET_X86_64 = "BOTTLEROCKET_x86_64"
+    BOTTLEROCKET_ARM64_NVIDIA = "BOTTLEROCKET_ARM_64_NVIDIA"
+    BOTTLEROCKET_X86_64_NVIDIA = "BOTTLEROCKET_x86_64_NVIDIA"
+
+
+@pulumi.type_token("eks:index:AuthenticationMode")
+class AuthenticationMode(builtins.str, Enum):
+    """
+    The authentication mode of the cluster. Valid values are `CONFIG_MAP`, `API` or `API_AND_CONFIG_MAP`.
+
+    See for more details:
+    https://docs.aws.amazon.com/eks/latest/userguide/grant-k8s-access.html#set-cam
+    """
+    CONFIG_MAP = "CONFIG_MAP"
+    """
+    Only aws-auth ConfigMap will be used for authenticating to the Kubernetes API.
+    """
+    API = "API"
+    """
+    Only Access Entries will be used for authenticating to the Kubernetes API.
+    """
+    API_AND_CONFIG_MAP = "API_AND_CONFIG_MAP"
+    """
+    Both aws-auth ConfigMap and Access Entries can be used for authenticating to the Kubernetes API.
+    """
+
+
+@pulumi.type_token("eks:index:ClusterNodePools")
+class ClusterNodePools(builtins.str, Enum):
+    """
+    Built-in node pools of EKS Auto Mode. For more details see: https://docs.aws.amazon.com/eks/latest/userguide/set-builtin-node-pools.html
+    """
+    SYSTEM = "system"
+    """
+    This NodePool has a `CriticalAddonsOnly` taint. Many EKS addons, such as CoreDNS, tolerate this taint. Use this system node pool to segregate cluster-critical applications. Supports both `amd64` and `arm64` architectures.
+    """
+    GENERAL_PURPOSE = "general-purpose"
+    """
+    This NodePool provides support for launching nodes for general purpose workloads in your cluster. Only supports `amd64` architecture.
+    """
+
+
+@pulumi.type_token("eks:index:OperatingSystem")
+class OperatingSystem(builtins.str, Enum):
+    """
+    The type of EKS optimized Operating System to use for node groups.
+
+    See for more details:
+    https://docs.aws.amazon.com/eks/latest/userguide/eks-optimized-amis.html
+    """
+    AL2 = "AL2"
+    """
+    EKS optimized OS based on Amazon Linux 2 (AL2).
+    """
+    AL2023 = "AL2023"
+    """
+    EKS optimized OS based on Amazon Linux 2023 (AL2023).
+    See for more details: https://docs.aws.amazon.com/eks/latest/userguide/eks-optimized-ami.html
+    """
+    BOTTLEROCKET = "Bottlerocket"
+    """
+    EKS optimized Container OS based on Bottlerocket.
+    See for more details: https://docs.aws.amazon.com/eks/latest/userguide/eks-optimized-ami-bottlerocket.html
+    """
+    RECOMMENDED = "AL2023"
+    """
+    The recommended EKS optimized OS. Currently Amazon Linux 2023 (AL2023).
+    This will be kept up to date with AWS' recommendations for EKS optimized operating systems.
+
+    See for more details: https://docs.aws.amazon.com/eks/latest/userguide/eks-optimized-ami.html
+    """
+
+
+@pulumi.type_token("eks:index:ResolveConflictsOnCreate")
+class ResolveConflictsOnCreate(builtins.str, Enum):
+    """
+    How to resolve field value conflicts when migrating a self-managed add-on to an Amazon EKS add-on. Valid values are `NONE` and `OVERWRITE`. For more details see the [CreateAddon](https://docs.aws.amazon.com/eks/latest/APIReference/API_CreateAddon.html) API Docs.
+    """
+    NONE = "NONE"
+    """
+    If the self-managed version of the add-on is installed on your cluster, Amazon EKS doesn't change the value. Creation of the add-on might fail.
+    """
+    OVERWRITE = "OVERWRITE"
+    """
+    If the self-managed version of the add-on is installed on your cluster and the Amazon EKS default value is different than the existing value, Amazon EKS changes the value to the Amazon EKS default value.
+    """
+
+
+@pulumi.type_token("eks:index:ResolveConflictsOnUpdate")
+class ResolveConflictsOnUpdate(builtins.str, Enum):
+    """
+    How to resolve field value conflicts for an Amazon EKS add-on if you've changed a value from the Amazon EKS default value. Valid values are `NONE`, `OVERWRITE`, and `PRESERVE`. For more details see the [UpdateAddon](https://docs.aws.amazon.com/eks/latest/APIReference/API_UpdateAddon.html) API Docs.
+    """
+    NONE = "NONE"
+    """
+    Amazon EKS doesn't change the value. The update might fail.
+    """
+    OVERWRITE = "OVERWRITE"
+    """
+    Amazon EKS overwrites the changed value back to the Amazon EKS default value.
+    """
+    PRESERVE = "PRESERVE"
+    """
+    Amazon EKS preserves the value. If you choose this option, we recommend that you test any field and value changes on a non-production cluster before updating the add-on on your production cluster.
+    """