airflow.providers.amazon.aws.operators.eks
¶
This module contains Amazon EKS operators.
Module Contents¶
Classes¶
Creates an Amazon EKS Cluster control plane. |
|
Creates an Amazon EKS managed node group for an existing Amazon EKS Cluster. |
|
Creates an AWS Fargate profile for an Amazon EKS cluster. |
|
Deletes the Amazon EKS Cluster control plane and all nodegroups attached to it. |
|
Deletes an Amazon EKS managed node group from an Amazon EKS Cluster. |
|
Deletes an AWS Fargate profile from an Amazon EKS Cluster. |
|
Executes a task in a Kubernetes pod on the specified Amazon EKS Cluster. |
|
This operator is deprecated. |
|
This operator is deprecated. |
|
This operator is deprecated. |
|
This operator is deprecated. |
|
This operator is deprecated. |
|
This operator is deprecated. |
|
This operator is deprecated. |
Attributes¶
- airflow.providers.amazon.aws.operators.eks.ABORT_MSG = {compute} are still active after the allocated time limit. Aborting.[source]¶
- airflow.providers.amazon.aws.operators.eks.CAN_NOT_DELETE_MSG = A cluster can not be deleted with attached {compute}. Deleting {count} {compute}.[source]¶
- airflow.providers.amazon.aws.operators.eks.MISSING_ARN_MSG = Creating an {compute} requires {requirement} to be passed in.[source]¶
- airflow.providers.amazon.aws.operators.eks.SUCCESS_MSG = No {compute} remain, deleting cluster.[source]¶
- airflow.providers.amazon.aws.operators.eks.NODEGROUP_FULL_NAME = Amazon EKS managed node groups[source]¶
- class airflow.providers.amazon.aws.operators.eks.EksCreateClusterOperator(cluster_name, cluster_role_arn, resources_vpc_config, compute=DEFAULT_COMPUTE_TYPE, create_cluster_kwargs=None, nodegroup_name=DEFAULT_NODEGROUP_NAME, nodegroup_role_arn=None, create_nodegroup_kwargs=None, fargate_profile_name=DEFAULT_FARGATE_PROFILE_NAME, fargate_pod_execution_role_arn=None, fargate_selectors=None, create_fargate_profile_kwargs=None, aws_conn_id=DEFAULT_CONN_ID, region=None, **kwargs)[source]¶
Bases:
airflow.models.BaseOperator
Creates an Amazon EKS Cluster control plane.
Optionally, can also create the supporting compute architecture:
- If argument ‘compute’ is provided with a value of ‘nodegroup’, will also
attempt to create an Amazon EKS Managed Nodegroup for the cluster. See
EksCreateNodegroupOperator
documentation for requirements.
- If argument ‘compute’ is provided with a value of ‘fargate’, will also attempt to create an AWS
Fargate profile for the cluster. See
EksCreateFargateProfileOperator
documentation for requirements.
See also
For more information on how to use this operator, take a look at the guide: Create an Amazon EKS cluster
- Parameters
cluster_name (str) – The unique name to give to your Amazon EKS Cluster. (templated)
cluster_role_arn (str) – The Amazon Resource Name (ARN) of the IAM role that provides permissions for the Kubernetes control plane to make calls to AWS API operations on your behalf. (templated)
resources_vpc_config (Dict[str, Any]) – The VPC configuration used by the cluster control plane. (templated)
compute (Optional[str]) – The type of compute architecture to generate along with the cluster. (templated) Defaults to ‘nodegroup’ to generate an EKS Managed Nodegroup.
create_cluster_kwargs (Optional[Dict]) – Optional parameters to pass to the CreateCluster API (templated)
aws_conn_id (str) – The Airflow connection used for AWS credentials. (templated) If this is None or empty then the default boto3 behaviour is used. If running Airflow in a distributed manner and aws_conn_id is None or empty, then the default boto3 configuration would be used (and must be maintained on each worker node).
region (Optional[str]) – Which AWS region the connection should use. (templated) If this is None or empty then the default boto3 behaviour is used.
If compute is assigned the value of ‘nodegroup’:
- Parameters
nodegroup_name (str) – REQUIRED The unique name to give your Amazon EKS managed node group. (templated)
nodegroup_role_arn (Optional[str]) – REQUIRED The Amazon Resource Name (ARN) of the IAM role to associate with the Amazon EKS managed node group. (templated)
create_nodegroup_kwargs (Optional[Dict]) – Optional parameters to pass to the CreateNodegroup API (templated)
If compute is assigned the value of ‘fargate’:
- Parameters
fargate_profile_name (str) – REQUIRED The unique name to give your AWS Fargate profile. (templated)
fargate_pod_execution_role_arn (Optional[str]) – REQUIRED The Amazon Resource Name (ARN) of the pod execution role to use for pods that match the selectors in the AWS Fargate profile. (templated)
fargate_selectors (Optional[List]) – The selectors to match for pods to use this AWS Fargate profile. (templated)
create_fargate_profile_kwargs (Optional[Dict]) – Optional parameters to pass to the CreateFargateProfile API (templated)
- class airflow.providers.amazon.aws.operators.eks.EksCreateNodegroupOperator(cluster_name, nodegroup_subnets, nodegroup_role_arn, nodegroup_name=DEFAULT_NODEGROUP_NAME, create_nodegroup_kwargs=None, aws_conn_id=DEFAULT_CONN_ID, region=None, **kwargs)[source]¶
Bases:
airflow.models.BaseOperator
Creates an Amazon EKS managed node group for an existing Amazon EKS Cluster.
See also
For more information on how to use this operator, take a look at the guide: Create an Amazon EKS managed node group
- Parameters
cluster_name (str) – The name of the Amazon EKS Cluster to create the managed nodegroup in. (templated)
nodegroup_name (str) – The unique name to give your managed nodegroup. (templated)
nodegroup_subnets (Union[List[str], str]) – The subnets to use for the Auto Scaling group that is created for the managed nodegroup. (templated)
nodegroup_role_arn (str) – The Amazon Resource Name (ARN) of the IAM role to associate with the managed nodegroup. (templated)
create_nodegroup_kwargs (Optional[Dict]) – Optional parameters to pass to the Create Nodegroup API (templated)
aws_conn_id (str) – The Airflow connection used for AWS credentials. (templated) If this is None or empty then the default boto3 behaviour is used. If running Airflow in a distributed manner and aws_conn_id is None or empty, then the default boto3 configuration would be used (and must be maintained on each worker node).
region (Optional[str]) – Which AWS region the connection should use. (templated) If this is None or empty then the default boto3 behaviour is used.
- class airflow.providers.amazon.aws.operators.eks.EksCreateFargateProfileOperator(cluster_name, pod_execution_role_arn, selectors, fargate_profile_name=DEFAULT_FARGATE_PROFILE_NAME, create_fargate_profile_kwargs=None, aws_conn_id=DEFAULT_CONN_ID, region=None, **kwargs)[source]¶
Bases:
airflow.models.BaseOperator
Creates an AWS Fargate profile for an Amazon EKS cluster.
See also
For more information on how to use this operator, take a look at the guide: Create an AWS Fargate Profile
- Parameters
cluster_name (str) – The name of the Amazon EKS cluster to apply the AWS Fargate profile to. (templated)
pod_execution_role_arn (str) – The Amazon Resource Name (ARN) of the pod execution role to use for pods that match the selectors in the AWS Fargate profile. (templated)
selectors (List) – The selectors to match for pods to use this AWS Fargate profile. (templated)
fargate_profile_name (Optional[str]) – The unique name to give your AWS Fargate profile. (templated)
create_fargate_profile_kwargs (Optional[Dict]) – Optional parameters to pass to the CreateFargate Profile API (templated)
aws_conn_id (str) – The Airflow connection used for AWS credentials. (templated) If this is None or empty then the default boto3 behaviour is used. If running Airflow in a distributed manner and aws_conn_id is None or empty, then the default boto3 configuration would be used (and must be maintained on each worker node).
region (Optional[str]) – Which AWS region the connection should use. (templated) If this is None or empty then the default boto3 behaviour is used.
- class airflow.providers.amazon.aws.operators.eks.EksDeleteClusterOperator(cluster_name, force_delete_compute=False, aws_conn_id=DEFAULT_CONN_ID, region=None, **kwargs)[source]¶
Bases:
airflow.models.BaseOperator
Deletes the Amazon EKS Cluster control plane and all nodegroups attached to it.
See also
For more information on how to use this operator, take a look at the guide: Delete an Amazon EKS Cluster
- Parameters
cluster_name (str) – The name of the Amazon EKS Cluster to delete. (templated)
force_delete_compute (bool) – If True, will delete any attached resources. (templated) Defaults to False.
aws_conn_id (str) – The Airflow connection used for AWS credentials. (templated) If this is None or empty then the default boto3 behaviour is used. If running Airflow in a distributed manner and aws_conn_id is None or empty, then the default boto3 configuration would be used (and must be maintained on each worker node).
region (Optional[str]) – Which AWS region the connection should use. (templated) If this is None or empty then the default boto3 behaviour is used.
- template_fields :Sequence[str] = ['cluster_name', 'force_delete_compute', 'aws_conn_id', 'region'][source]¶
- execute(self, context)[source]¶
This is the main method to derive when creating an operator. Context is the same dictionary used as when rendering jinja templates.
Refer to get_template_context for more context.
- class airflow.providers.amazon.aws.operators.eks.EksDeleteNodegroupOperator(cluster_name, nodegroup_name, aws_conn_id=DEFAULT_CONN_ID, region=None, **kwargs)[source]¶
Bases:
airflow.models.BaseOperator
Deletes an Amazon EKS managed node group from an Amazon EKS Cluster.
See also
For more information on how to use this operator, take a look at the guide: Delete an Amazon EKS managed node group
- Parameters
cluster_name (str) – The name of the Amazon EKS Cluster associated with your nodegroup. (templated)
nodegroup_name (str) – The name of the nodegroup to delete. (templated)
aws_conn_id (str) – The Airflow connection used for AWS credentials. (templated) If this is None or empty then the default boto3 behaviour is used. If running Airflow in a distributed manner and aws_conn_id is None or empty, then the default boto3 configuration would be used (and must be maintained on each worker node).
region (Optional[str]) – Which AWS region the connection should use. (templated) If this is None or empty then the default boto3 behaviour is used.
- class airflow.providers.amazon.aws.operators.eks.EksDeleteFargateProfileOperator(cluster_name, fargate_profile_name, aws_conn_id=DEFAULT_CONN_ID, region=None, **kwargs)[source]¶
Bases:
airflow.models.BaseOperator
Deletes an AWS Fargate profile from an Amazon EKS Cluster.
See also
For more information on how to use this operator, take a look at the guide: Delete an AWS Fargate Profile
- Parameters
cluster_name (str) – The name of the Amazon EKS cluster associated with your Fargate profile. (templated)
fargate_profile_name (str) – The name of the AWS Fargate profile to delete. (templated)
aws_conn_id (str) – The Airflow connection used for AWS credentials. (templated) If this is None or empty then the default boto3 behaviour is used. If running Airflow in a distributed manner and aws_conn_id is None or empty, then the default boto3 configuration would be used (and must be maintained on each worker node).
region (Optional[str]) – Which AWS region the connection should use. (templated) If this is None or empty then the default boto3 behaviour is used.
- class airflow.providers.amazon.aws.operators.eks.EksPodOperator(cluster_name, in_cluster=False, namespace=DEFAULT_NAMESPACE_NAME, pod_context=None, pod_name=None, pod_username=None, aws_conn_id=DEFAULT_CONN_ID, region=None, is_delete_operator_pod=None, **kwargs)[source]¶
Bases:
airflow.providers.cncf.kubernetes.operators.kubernetes_pod.KubernetesPodOperator
Executes a task in a Kubernetes pod on the specified Amazon EKS Cluster.
See also
For more information on how to use this operator, take a look at the guide: Perform a Task on an Amazon EKS Cluster
- Parameters
cluster_name (str) – The name of the Amazon EKS Cluster to execute the task on. (templated)
cluster_role_arn – The Amazon Resource Name (ARN) of the IAM role that provides permissions for the Kubernetes control plane to make calls to AWS API operations on your behalf. (templated)
in_cluster (bool) – If True, look for config inside the cluster; if False look for a local file path.
namespace (str) – The namespace in which to execute the pod. (templated)
pod_name (Optional[str]) – The unique name to give the pod. (templated)
aws_profile – The named profile containing the credentials for the AWS CLI tool to use.
aws_profile – str
region (Optional[str]) – Which AWS region the connection should use. (templated) If this is None or empty then the default boto3 behaviour is used.
aws_conn_id (str) – The Airflow connection used for AWS credentials. (templated) If this is None or empty then the default boto3 behaviour is used. If running Airflow in a distributed manner and aws_conn_id is None or empty, then the default boto3 configuration would be used (and must be maintained on each worker node).
is_delete_operator_pod (Optional[bool]) – What to do when the pod reaches its final state, or the execution is interrupted. If True, delete the pod; if False, leave the pod. Current default is False, but this will be changed in the next major release of this provider.
- class airflow.providers.amazon.aws.operators.eks.EKSCreateClusterOperator(*args, **kwargs)[source]¶
Bases:
EksCreateClusterOperator
This operator is deprecated. Please use
airflow.providers.amazon.aws.operators.eks.EksCreateClusterOperator
.
- class airflow.providers.amazon.aws.operators.eks.EKSCreateNodegroupOperator(*args, **kwargs)[source]¶
Bases:
EksCreateNodegroupOperator
This operator is deprecated. Please use
airflow.providers.amazon.aws.operators.eks.EksCreateNodegroupOperator
.
- class airflow.providers.amazon.aws.operators.eks.EKSCreateFargateProfileOperator(*args, **kwargs)[source]¶
Bases:
EksCreateFargateProfileOperator
This operator is deprecated. Please use
airflow.providers.amazon.aws.operators.eks.EksCreateFargateProfileOperator
.
- class airflow.providers.amazon.aws.operators.eks.EKSDeleteClusterOperator(*args, **kwargs)[source]¶
Bases:
EksDeleteClusterOperator
This operator is deprecated. Please use
airflow.providers.amazon.aws.operators.eks.EksDeleteClusterOperator
.
- class airflow.providers.amazon.aws.operators.eks.EKSDeleteNodegroupOperator(*args, **kwargs)[source]¶
Bases:
EksDeleteNodegroupOperator
This operator is deprecated. Please use
airflow.providers.amazon.aws.operators.eks.EksDeleteNodegroupOperator
.
- class airflow.providers.amazon.aws.operators.eks.EKSDeleteFargateProfileOperator(*args, **kwargs)[source]¶
Bases:
EksDeleteFargateProfileOperator
This operator is deprecated. Please use
airflow.providers.amazon.aws.operators.eks.EksDeleteFargateProfileOperator
.
- class airflow.providers.amazon.aws.operators.eks.EKSPodOperator(*args, **kwargs)[source]¶
Bases:
EksPodOperator
This operator is deprecated. Please use
airflow.providers.amazon.aws.operators.eks.EksPodOperator
.