EKSEjemplos de Amazon que utilizan herramientas para PowerShell - AWS SDKEjemplos de código
Acciones

Hay más AWS SDK ejemplos disponibles en el GitHub repositorio de AWS Doc SDK Examples.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

EKSEjemplos de Amazon que utilizan herramientas para PowerShell

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes AWS Tools for PowerShell mediante AmazonEKS.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

En el siguiente ejemplo de código se muestra cómo usar Add-EKSResourceTag.

Herramientas para PowerShell

Ejemplo 1: este cmdlet asocia las etiquetas especificadas a un recurso con el especificado. resourceArn

Add-EKSResourceTag -ResourceArn "arn:aws:eks:us-west-2:012345678912:cluster/PROD" -Tag @{Name = "EKSPRODCLUSTER"}

En el siguiente ejemplo de código se muestra cómo usar Get-EKSCluster.

Herramientas para PowerShell

Ejemplo 1: Este cmdlet devuelve información descriptiva sobre un clúster de AmazonEKS.

Get-EKSCluster -Name "PROD"

Salida:

Arn                  : arn:aws:eks:us-west-2:012345678912:cluster/PROD
CertificateAuthority : Amazon.EKS.Model.Certificate
ClientRequestToken   :
CreatedAt            : 12/25/2019 6:46:17 AM
Endpoint             : https://669608765450FBBE54D1D78A3D71B72C.gr8.us-west-2.eks.amazonaws.com
Identity             : Amazon.EKS.Model.Identity
Logging              : Amazon.EKS.Model.Logging
Name                 : PROD
PlatformVersion      : eks.7
ResourcesVpcConfig   : Amazon.EKS.Model.VpcConfigResponse
RoleArn              : arn:aws:iam::012345678912:role/eks-iam-role
Status               : ACTIVE
Tags                 : {}
Version              : 1.14

En el siguiente ejemplo de código se muestra cómo usar Get-EKSClusterList.

Herramientas para PowerShell

Ejemplo 1: Este cmdlet muestra los EKS clústeres de Amazon de la Cuenta de AWS región especificada.

Get-EKSClusterList

Salida:

 PROD

En el siguiente ejemplo de código se muestra cómo usar Get-EKSFargateProfile.

Herramientas para PowerShell

Ejemplo 1: este cmdlet devuelve información descriptiva sobre un perfil de Fargate AWS .

Get-EKSFargateProfile -FargateProfileName "EKSFargate" -ClusterName "TEST"

Salida:

ClusterName         : TEST
CreatedAt           : 12/26/2019 12:34:47 PM
FargateProfileArn   : arn:aws:eks:us-east-2:012345678912:fargateprofile/TEST/EKSFargate/42b7a119-e16b-a279-ce97-bdf303adec92
FargateProfileName  : EKSFargate
PodExecutionRoleArn : arn:aws:iam::012345678912:role/AmazonEKSFargatePodExecutionRole
Selectors           : {Amazon.EKS.Model.FargateProfileSelector}
Status              : ACTIVE
Subnets             : {subnet-0cd976f08d5fbfaae, subnet-02f6ff500ff2067a0}
Tags                : {}

  • Para API obtener más información, consulte la referencia del DescribeFargateProfilecmdlet AWS Tools for PowerShell .

En el siguiente ejemplo de código se muestra cómo usar Get-EKSFargateProfileList.

Herramientas para PowerShell

Ejemplo 1: Este cmdlet muestra los perfiles de AWS Fargate asociados al clúster especificado en la región especificada. Cuenta de AWS 

Get-EKSFargateProfileList -ClusterName "TEST"

Salida:

EKSFargate
EKSFargateProfile

  • Para API obtener más información, consulte la referencia del ListFargateProfilescmdlet AWS Tools for PowerShell .

En el siguiente ejemplo de código se muestra cómo usar Get-EKSNodegroup.

Herramientas para PowerShell

Ejemplo 1: Este cmdlet devuelve información descriptiva sobre un grupo de EKS nodos de Amazon.

Get-EKSNodegroup -NodegroupName "ProdEKSNodeGroup" -ClusterName "PROD"

Salida:

AmiType        : AL2_x86_64
ClusterName    : PROD
CreatedAt      : 12/25/2019 10:16:45 AM
DiskSize       : 40
Health         : Amazon.EKS.Model.NodegroupHealth
InstanceTypes  : {t3.large}
Labels         : {}
ModifiedAt     : 12/25/2019 10:16:45 AM
NodegroupArn   : arn:aws:eks:us-west-2:012345678912:nodegroup/PROD/ProdEKSNodeGroup/7eb79e47-82b6-04d9-e984-95110db6fa85
NodegroupName  : ProdEKSNodeGroup
NodeRole       : arn:aws:iam::012345678912:role/NodeInstanceRole
ReleaseVersion : 1.14.7-20190927
RemoteAccess   :
Resources      :
ScalingConfig  : Amazon.EKS.Model.NodegroupScalingConfig
Status         : CREATING
Subnets        : {subnet-0d1a9fff35efa7691, subnet-0a3f4928edbc224d4}
Tags           : {}
Version        : 1.14

En el siguiente ejemplo de código se muestra cómo usar Get-EKSNodegroupList.

Herramientas para PowerShell

Ejemplo 1: Este cmdlet muestra los grupos de EKS nodos de Amazon asociados al clúster especificado Cuenta de AWS en la región especificada.

Get-EKSNodegroupList -ClusterName PROD

Salida:

 ProdEKSNodeGroup

En el siguiente ejemplo de código se muestra cómo usar Get-EKSResourceTag.

Herramientas para PowerShell

Ejemplo 1: este cmdlet muestra las etiquetas de un recurso de AmazonEKS.

Get-EKSResourceTag -ResourceArn "arn:aws:eks:us-west-2:012345678912:cluster/PROD"

Salida:

Key  Value
---  -----
Name EKSPRODCLUSTER

En el siguiente ejemplo de código se muestra cómo usar Get-EKSUpdate.

Herramientas para PowerShell

Ejemplo 1: Este cmdlet devuelve información descriptiva sobre una actualización de su EKS clúster de Amazon o grupo de nodos gestionados asociado.

Get-EKSUpdate -Name "PROD" -UpdateId "ee708232-7d2e-4ed7-9270-d0b5176f0726"

Salida:

CreatedAt : 12/25/2019 5:03:07 PM
Errors    : {}
Id        : ee708232-7d2e-4ed7-9270-d0b5176f0726
Params    : {Amazon.EKS.Model.UpdateParam}
Status    : Successful
Type      : LoggingUpdate

En el siguiente ejemplo de código se muestra cómo usar Get-EKSUpdateList.

Herramientas para PowerShell

Ejemplo 1: Este cmdlet muestra las actualizaciones asociadas a un EKS clúster de Amazon o a un grupo de nodos gestionado en su región Cuenta de AWS, en la región especificada.

Get-EKSUpdateList -Name "PROD"

Salida:

ee708232-7d2e-4ed7-9270-d0b5176f0726

En el siguiente ejemplo de código se muestra cómo usar New-EKSCluster.

Herramientas para PowerShell

Ejemplo 1: En este ejemplo se crea un nuevo clúster denominado «prod».

New-EKSCluster -Name prod -ResourcesVpcConfig @{SubnetIds=@("subnet-0a1b2c3d","subnet-3a2b1c0d");SecurityGroupIds="sg-6979fe18"} -RoleArn "arn:aws:iam::012345678901:role/eks-service-role"

Salida:

Arn                  : arn:aws:eks:us-west-2:012345678901:cluster/prod
CertificateAuthority : Amazon.EKS.Model.Certificate
ClientRequestToken   :
CreatedAt            : 12/10/2018 9:25:31 PM
Endpoint             :
Name                 : prod
PlatformVersion      : eks.3
ResourcesVpcConfig   : Amazon.EKS.Model.VpcConfigResponse
RoleArn              : arn:aws:iam::012345678901:role/eks-service-role
Status               : CREATING
Version              : 1.10

  • Para API obtener más información, consulte AWS Tools for PowerShell Cmdlet CreateClusterReference.

En el siguiente ejemplo de código se muestra cómo usar New-EKSFargateProfile.

Herramientas para PowerShell

Ejemplo 1: Este cmdlet crea un perfil de AWS Fargate para tu clúster de Amazon. EKS Debe tener al menos un perfil de Fargate en un clúster para poder programar pods en la infraestructura de Fargate.

New-EKSFargateProfile -FargateProfileName EKSFargateProfile -ClusterName TEST -Subnet "subnet-02f6ff500ff2067a0", "subnet-0cd976f08d5fbfaae" -PodExecutionRoleArn arn:aws:iam::012345678912:role/AmazonEKSFargatePodExecutionRole -Selector @{Namespace="default"}

Salida:

ClusterName         : TEST
CreatedAt           : 12/26/2019 12:38:21 PM
FargateProfileArn   : arn:aws:eks:us-east-2:012345678912:fargateprofile/TEST/EKSFargateProfile/20b7a11b-8292-41c1-bc56-ffa5e60f6224
FargateProfileName  : EKSFargateProfile
PodExecutionRoleArn : arn:aws:iam::012345678912:role/AmazonEKSFargatePodExecutionRole
Selectors           : {Amazon.EKS.Model.FargateProfileSelector}
Status              : CREATING
Subnets             : {subnet-0cd976f08d5fbfaae, subnet-02f6ff500ff2067a0}
Tags                : {}

En el siguiente ejemplo de código se muestra cómo usar New-EKSNodeGroup.

Herramientas para PowerShell

Ejemplo 1: este cmdlet crea un grupo de nodos de trabajo gestionado para un clúster de AmazonEKS. Solo puede crear un grupo de nodos para el clúster que sea igual a la versión actual de Kubernetes para el clúster. Todos los grupos de nodos se crean con la AMI versión más reciente de la versión secundaria de Kubernetes correspondiente del clúster.

New-EKSNodeGroup -NodeGroupName "ProdEKSNodeGroup" -AmiType "AL2_x86_64" -DiskSize 40 -ClusterName "PROD" -ScalingConfig_DesiredSize 2 -ScalingConfig_MinSize 2 -ScalingConfig_MaxSize 5 -InstanceType t3.large -NodeRole "arn:aws:iam::012345678912:role/NodeInstanceRole" -Subnet "subnet-0d1a9fff35efa7691","subnet-0a3f4928edbc224d4"

Salida:

AmiType        : AL2_x86_64
ClusterName    : PROD
CreatedAt      : 12/25/2019 10:16:45 AM
DiskSize       : 40
Health         : Amazon.EKS.Model.NodegroupHealth
InstanceTypes  : {t3.large}
Labels         : {}
ModifiedAt     : 12/25/2019 10:16:45 AM
NodegroupArn   : arn:aws:eks:us-west-2:012345678912:nodegroup/PROD/ProdEKSNodeGroup/7eb79e47-82b6-04d9-e984-95110db6fa85
NodegroupName  : ProdEKSNodeGroup
NodeRole       : arn:aws:iam::012345678912:role/NodeInstanceRole
ReleaseVersion : 1.14.7-20190927
RemoteAccess   :
Resources      :
ScalingConfig  : Amazon.EKS.Model.NodegroupScalingConfig
Status         : CREATING
Subnets        : {subnet-0d1a9fff35efa7691, subnet-0a3f4928edbc224d4}
Tags           : {}
Version        : 1.14

  • Para API obtener más información, consulte la referencia de CreateNodegroupcmdlets AWS Tools for PowerShell .

En el siguiente ejemplo de código se muestra cómo usar Remove-EKSCluster.

Herramientas para PowerShell

Ejemplo 1: Este cmdlet elimina el plano de control del EKS clúster de Amazon.

Remove-EKSCluster -Name "DEV-KUBE-CL"

Salida:

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-EKSCluster (DeleteCluster)" on target "DEV-KUBE-CL".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

Arn                  : arn:aws:eks:us-west-2:012345678912:cluster/DEV-KUBE-CL
CertificateAuthority : Amazon.EKS.Model.Certificate
ClientRequestToken   :
CreatedAt            : 12/25/2019 9:33:25 AM
Endpoint             : https://02E6D31E3E4F8C15D7BE7F58D527776A.yl4.us-west-2.eks.amazonaws.com
Identity             : Amazon.EKS.Model.Identity
Logging              : Amazon.EKS.Model.Logging
Name                 : DEV-KUBE-CL
PlatformVersion      : eks.7
ResourcesVpcConfig   : Amazon.EKS.Model.VpcConfigResponse
RoleArn              : arn:aws:iam::012345678912:role/eks-iam-role
Status               : DELETING
Tags                 : {}
Version              : 1.14

  • Para API obtener más información, consulte la referencia del DeleteClustercmdlet AWS Tools for PowerShell .

En el siguiente ejemplo de código se muestra cómo usar Remove-EKSFargateProfile.

Herramientas para PowerShell

Ejemplo 1: Este cmdlet elimina un perfil de AWS Fargate. Al eliminar un perfil de Fargate, se eliminan todos los pods que se ejecuten en Fargate y que se hayan creado con el perfil.

Remove-EKSFargateProfile -FargateProfileName "EKSFargate" -ClusterName "TEST"

Salida:

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-EKSFargateProfile (DeleteFargateProfile)" on target "EKSFargate".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

ClusterName         : TEST
CreatedAt           : 12/26/2019 12:34:47 PM
FargateProfileArn   : arn:aws:eks:us-east-2:012345678912:fargateprofile/TEST/EKSFargate/42b7a119-e16b-a279-ce97-bdf303adec92
FargateProfileName  : EKSFargate
PodExecutionRoleArn : arn:aws:iam::012345678912:role/AmazonEKSFargatePodExecutionRole
Selectors           : {Amazon.EKS.Model.FargateProfileSelector}
Status              : DELETING
Subnets             : {subnet-0cd976f08d5fbfaae, subnet-02f6ff500ff2067a0}
Tags                : {}

En el siguiente ejemplo de código se muestra cómo usar Remove-EKSNodegroup.

Herramientas para PowerShell

Ejemplo 1: Este cmdlet elimina un grupo de EKS nodos de Amazon de un clúster.

Remove-EKSNodegroup -NodegroupName "ProdEKSNodeGroup" -ClusterName "PROD"

Salida:

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-EKSNodegroup (DeleteNodegroup)" on target "ProdEKSNodeGroup".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

AmiType        : AL2_x86_64
ClusterName    : PROD
CreatedAt      : 12/25/2019 10:16:45 AM
DiskSize       : 40
Health         : Amazon.EKS.Model.NodegroupHealth
InstanceTypes  : {t3.large}
Labels         : {}
ModifiedAt     : 12/25/2019 11:01:16 AM
NodegroupArn   : arn:aws:eks:us-west-2:012345678912:nodegroup/PROD/ProdEKSNodeGroup/7eb79e47-82b6-04d9-e984-95110db6fa85
NodegroupName  : ProdEKSNodeGroup
NodeRole       : arn:aws:iam::012345678912:role/NodeInstanceRole
ReleaseVersion : 1.14.7-20190927
RemoteAccess   :
Resources      : Amazon.EKS.Model.NodegroupResources
ScalingConfig  : Amazon.EKS.Model.NodegroupScalingConfig
Status         : DELETING
Subnets        : {subnet-0d1a9fff35efa7691, subnet-0a3f4928edbc224d4}
Tags           : {}
Version        : 1.14

  • Para API obtener más información, consulte la referencia del DeleteNodegroupcmdlet AWS Tools for PowerShell .

En el siguiente ejemplo de código se muestra cómo usar Remove-EKSResourceTag.

Herramientas para PowerShell

Ejemplo 1: este cmdlet elimina las etiquetas especificadas de un recurso. EKS

Remove-EKSResourceTag -ResourceArn "arn:aws:eks:us-west-2:012345678912:cluster/PROD" -TagKey "Name"

Salida:

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-EKSResourceTag (UntagResource)" on target "arn:aws:eks:us-west-2:012345678912:cluster/PROD".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

  • Para API obtener más información, consulte la referencia del UntagResourcecmdlet AWS Tools for PowerShell .

En el siguiente ejemplo de código se muestra cómo usar Update-EKSClusterConfig.

Herramientas para PowerShell

Ejemplo 1: actualiza la configuración de un EKS clúster de Amazon. El clúster seguirá funcionando durante la actualización.

Update-EKSClusterConfig -Name "PROD" -Logging_ClusterLogging @{Types="api","audit","authenticator","controllerManager","scheduler",Enabled="True"}

Salida:

CreatedAt : 12/25/2019 5:03:07 PM
Errors    : {}
Id        : ee708232-7d2e-4ed7-9270-d0b5176f0726
Params    : {Amazon.EKS.Model.UpdateParam}
Status    : InProgress
Type      : LoggingUpdate

  • Para API obtener más información, consulte UpdateClusterConfigla referencia de AWS Tools for PowerShell cmdlets.

En el siguiente ejemplo de código se muestra cómo usar Update-EKSClusterVersion.

Herramientas para PowerShell

Ejemplo 1: Este cmdlet actualiza un EKS clúster de Amazon a la versión de Kubernetes especificada. El clúster seguirá funcionando durante la actualización.

Update-EKSClusterVersion -Name "PROD-KUBE-CL" -Version 1.14

Salida:

CreatedAt : 12/26/2019 9:50:37 AM
Errors    : {}
Id        : ef186eff-3b3a-4c25-bcfc-3dcdf9e898a8
Params    : {Amazon.EKS.Model.UpdateParam, Amazon.EKS.Model.UpdateParam}
Status    : InProgress
Type      : VersionUpdate

  • Para API obtener más información, consulte UpdateClusterVersionla referencia de AWS Tools for PowerShell cmdlets.