Ejemplos de Amazon EKS con herramientas para la PowerShell versión 4 - AWS Ejemplos de código de SDK
Acciones

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

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.

Ejemplos de Amazon EKS con herramientas para la PowerShell versión 4

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso de la Herramientas de AWS para PowerShell versión 4 con Amazon EKS.

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 distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Acciones

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

Herramientas para la PowerShell versión 4

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

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

  • Para obtener información sobre la API, consulte la referencia del Herramientas de AWS para PowerShell cmdlet (TagResourceV4).

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

Herramientas para la versión 4 PowerShell

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

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

  • Para obtener más información sobre la API, consulte la referencia DescribeClusterde Herramientas de AWS para PowerShell cmdlets (V4).

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

Herramientas para la versión 4 PowerShell

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

Get-EKSClusterList

Salida:

 PROD

  • Para obtener más información sobre la API, consulte la referencia ListClustersde Herramientas de AWS para PowerShell cmdlets (V4).

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

Herramientas para la versión 4 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 obtener información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet DescribeFargateProfileReference (V4).

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

Herramientas para la versión 4 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 obtener más información sobre la API, consulte ListFargateProfilesla referencia del Herramientas de AWS para PowerShell cmdlet (V4).

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

Herramientas para la versión 4 PowerShell

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

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

  • Para obtener más información sobre la API, consulte DescribeNodegroupla referencia del Herramientas de AWS para PowerShell cmdlet (V4).

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

Herramientas para la versión 4 PowerShell

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

Get-EKSNodegroupList -ClusterName PROD

Salida:

 ProdEKSNodeGroup

  • Para obtener más información sobre la API, consulte ListNodegroupsla referencia del Herramientas de AWS para PowerShell cmdlet (V4).

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

Herramientas para la versión 4 PowerShell

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

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

Salida:

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

  • Para obtener más información sobre la API, consulte la referencia ListTagsForResourcede Herramientas de AWS para PowerShell cmdlets (V4).

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

Herramientas para la versión 4 PowerShell

Ejemplo 1: Este cmdlet devuelve información descriptiva sobre una actualización del clúster de Amazon EKS o del 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

  • Para obtener más información sobre la API, consulte DescribeUpdatela referencia del Herramientas de AWS para PowerShell cmdlet (V4).

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

Herramientas para la versión 4 PowerShell

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

Get-EKSUpdateList -Name "PROD"

Salida:

ee708232-7d2e-4ed7-9270-d0b5176f0726

  • Para obtener más información sobre la API, consulte la referencia ListUpdatesde Herramientas de AWS para PowerShell cmdlets (V4).

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

Herramientas para la versión 4 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

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

Herramientas para la versión 4 PowerShell

Ejemplo 1: Este cmdlet crea un perfil de AWS Fargate para su 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                : {}

  • Para obtener más información sobre la API, consulte la referencia CreateFargateProfilede Herramientas de AWS para PowerShell cmdlets (V4).

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

Herramientas para la versión 4 PowerShell

Ejemplo 1: este cmdlet crea un grupo de nodos de trabajo gestionado para un clúster de Amazon EKS. 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 última versión de la AMI para 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 obtener más información sobre la API, consulte CreateNodegroupla referencia de Herramientas de AWS para PowerShell cmdlets (V4).

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

Herramientas para la versión 4 PowerShell

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

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 obtener más información sobre la API, consulte DeleteClusterla referencia del Herramientas de AWS para PowerShell cmdlet (V4).

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

Herramientas para la versión 4 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                : {}

  • Para obtener más información sobre la API, consulte la referencia DeleteFargateProfilede Herramientas de AWS para PowerShell cmdlets (V4).

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

Herramientas para la versión 4 PowerShell

Ejemplo 1: Este cmdlet elimina un grupo de nodos de Amazon EKS 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 obtener más información sobre la API, consulte DeleteNodegroupla referencia del Herramientas de AWS para PowerShell cmdlet (V4).

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

Herramientas para la versión 4 PowerShell

Ejemplo 1: este cmdlet elimina las etiquetas especificadas de un recurso de 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 obtener información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet UntagResourceReference (V4).

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

Herramientas para la versión 4 PowerShell

Ejemplo 1: actualiza la configuración de un clúster de Amazon EKS. 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

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

Herramientas para la versión 4 PowerShell

Ejemplo 1: Este cmdlet actualiza un clúster de Amazon EKS 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