Exemples Amazon EKS utilisant Tools for PowerShell V5

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de la Outils AWS pour PowerShell V5 avec Amazon EKS.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

Actions

L'exemple de code suivant montre comment utiliserAdd-EKSResourceTag.

Outils pour PowerShell V5

Exemple 1 : cette applet de commande associe les balises spécifiées à la resourceArn spécifiée.


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

Pour plus de détails sur l'API, consultez TagResource la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserGet-EKSCluster.

Outils pour PowerShell V5

Exemple 1 : cette applet de commande renvoie des informations descriptives sur un cluster Amazon EKS.


Get-EKSCluster -Name "PROD"

Sortie :


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

Pour plus de détails sur l'API, consultez DescribeCluster la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserGet-EKSClusterList.

Outils pour PowerShell V5

Exemple 1 : Cette applet de commande répertorie les clusters Amazon EKS de votre Compte AWS région spécifiée.


Get-EKSClusterList

Sortie :


 PROD

Pour plus de détails sur l'API, consultez ListClusters la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserGet-EKSFargateProfile.

Outils pour PowerShell V5

Exemple 1 : Cette applet de commande renvoie des informations descriptives sur un profil AWS Fargate.


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

Sortie :


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                : {}

Pour plus de détails sur l'API, consultez DescribeFargateProfile la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserGet-EKSFargateProfileList.

Outils pour PowerShell V5

Exemple 1 : Cette applet de commande répertorie les profils AWS Fargate associés au cluster spécifié Compte AWS dans votre région spécifiée.


Get-EKSFargateProfileList -ClusterName "TEST"

Sortie :


EKSFargate
EKSFargateProfile

Pour plus de détails sur l'API, consultez ListFargateProfiles la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserGet-EKSNodegroup.

Outils pour PowerShell V5

Exemple 1 : cette applet de commande renvoie des informations descriptives sur un groupe de nœuds Amazon EKS.


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

Sortie :


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

Pour plus de détails sur l'API, consultez DescribeNodegroup la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserGet-EKSNodegroupList.

Outils pour PowerShell V5

Exemple 1 : Cette applet de commande répertorie les groupes de nœuds Amazon EKS associés au cluster spécifié Compte AWS dans votre région spécifiée.


Get-EKSNodegroupList -ClusterName PROD

Sortie :


 ProdEKSNodeGroup

Pour plus de détails sur l'API, consultez ListNodegroups la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserGet-EKSResourceTag.

Outils pour PowerShell V5

Exemple 1 : cette applet de commande répertorie les balises d’une ressource Amazon EKS.


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

Sortie :


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

Pour plus de détails sur l'API, consultez ListTagsForResource la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserGet-EKSUpdate.

Outils pour PowerShell V5

Exemple 1 : cette applet de commande renvoie des informations descriptives relatives à une mise à jour concernant votre cluster Amazon EKS ou le groupe de nœuds gérés associé.


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

Sortie :


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

Pour plus de détails sur l'API, consultez DescribeUpdate la section Référence des Outils AWS pour PowerShell applets de commande (V5).

L'exemple de code suivant montre comment utiliserGet-EKSUpdateList.

Outils pour PowerShell V5

Exemple 1 : Cette applet de commande répertorie les mises à jour associées à un cluster Amazon EKS ou à un groupe de nœuds géré dans votre Compte AWS région spécifiée.


Get-EKSUpdateList -Name "PROD"

Sortie :


ee708232-7d2e-4ed7-9270-d0b5176f0726

Pour plus de détails sur l'API, consultez ListUpdates la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserNew-EKSCluster.

Outils pour PowerShell V5

Exemple 1 : cet exemple crée un nouveau cluster appelé « prod ».


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

Sortie :


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

Pour plus de détails sur l'API, consultez CreateCluster la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserNew-EKSFargateProfile.

Outils pour PowerShell V5

Exemple 1 : Cette applet de commande crée un profil AWS Fargate pour votre cluster Amazon EKS. Vous devez avoir au moins un profil Fargate dans un cluster pour pouvoir planifier des pods sur une infrastructure Fargate.


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

Sortie :


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                : {}

Pour plus de détails sur l'API, consultez CreateFargateProfile la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserNew-EKSNodeGroup.

Outils pour PowerShell V5

Exemple 1 : cette applet de commande crée un groupe de composants master gérés pour un cluster Amazon EKS. Vous pouvez uniquement créer un groupe de nœuds pour votre cluster qui soit égal à la version Kubernetes actuelle du cluster. Tous les groupes de nœuds sont créés avec la dernière version de l’AMI pour la version Kubernetes mineure correspondante du cluster.


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"

Sortie :


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

Pour plus de détails sur l'API, consultez CreateNodegroup la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserRemove-EKSCluster.

Outils pour PowerShell V5

Exemple 1 : cette applet de commande supprime le plan de contrôle du cluster Amazon EKS.


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

Sortie :


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

Pour plus de détails sur l'API, consultez DeleteCluster la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserRemove-EKSFargateProfile.

Outils pour PowerShell V5

Exemple 1 : Cette applet de commande supprime un AWS profil Fargate. Lorsque vous supprimez un profil Fargate, tous les pods s’exécutant sur Fargate qui étaient créées avec le profil sont supprimés.


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

Sortie :


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                : {}

Pour plus de détails sur l'API, consultez DeleteFargateProfile la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserRemove-EKSNodegroup.

Outils pour PowerShell V5

Exemple 1 : cette applet de commande supprime un groupe de nœuds Amazon EKS pour un cluster.


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

Sortie :


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

Pour plus de détails sur l'API, consultez DeleteNodegroup la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserRemove-EKSResourceTag.

Outils pour PowerShell V5

Exemple 1 : cette applet de commande supprime les balises spécifiées d’une ressource EKS.


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

Sortie :


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

Pour plus de détails sur l'API, consultez UntagResource la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserUpdate-EKSClusterConfig.

Outils pour PowerShell V5

Exemple 1 : met à jour la configuration d’un cluster Amazon EKS. Votre cluster continue de fonctionner pendant la mise à jour.


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

Sortie :


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

Pour plus de détails sur l'API, consultez UpdateClusterConfig la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L'exemple de code suivant montre comment utiliserUpdate-EKSClusterVersion.

Outils pour PowerShell V5

Exemple 1 : cette applet de commande met à jour un cluster Amazon EKS vers la version Kubernetes spécifiée. Votre cluster continue de fonctionner pendant la mise à jour.


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

Sortie :


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

Pour plus de détails sur l'API, consultez UpdateClusterVersion la section Outils AWS pour PowerShell Cmdlet Reference (V5).

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Amazon EFS

Elastic Load Balancing – version 1