Amazon EKS-Beispiele mit Tools für PowerShell V4

Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V4 mit Amazon EKS Aktionen ausführen und allgemeine Szenarien implementieren.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarios anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, in dem Sie Anweisungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Aktionen

Das folgende Codebeispiel zeigt die VerwendungAdd-EKSResourceTag.

Tools für PowerShell V4

Beispiel 1: Dieses Cmdlet ordnet die angegebenen Tags einer Ressource mit dem angegebenen ResourceArn zu.


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

Einzelheiten zur API finden Sie unter TagResource AWS -Tools für PowerShellCmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Get-EKSCluster

Tools für PowerShell V4

Beispiel 1: Dieses Cmdlet gibt beschreibende Informationen zu einem Amazon EKS-Cluster zurück.


Get-EKSCluster -Name "PROD"

Ausgabe:


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

Einzelheiten zur API finden Sie unter DescribeCluster AWS -Tools für PowerShellCmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Get-EKSClusterList

Tools für PowerShell V4

Beispiel 1: Dieses Cmdlet listet die Amazon EKS-Cluster in Ihrem AWS-Konto in der angegebenen Region auf.


Get-EKSClusterList

Ausgabe:


 PROD

Einzelheiten zur API finden Sie unter ListClusters AWS -Tools für PowerShellCmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Get-EKSFargateProfile

Tools für PowerShell V4

Beispiel 1: Dieses Cmdlet gibt beschreibende Informationen zu einem AWS Fargate-Profil zurück.


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

Ausgabe:


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

Einzelheiten zur API finden Sie unter AWS -Tools für PowerShell Cmdlet-Referenz (DescribeFargateProfileV4).

Das folgende Codebeispiel zeigt die Verwendung. Get-EKSFargateProfileList

Tools für PowerShell V4

Beispiel 1: Dieses Cmdlet listet die AWS Fargate-Profile auf, die dem angegebenen Cluster in Ihrem AWS-Konto in der angegebenen Region zugeordnet sind.


Get-EKSFargateProfileList -ClusterName "TEST"

Ausgabe:


EKSFargate
EKSFargateProfile

Einzelheiten zur API finden Sie unter ListFargateProfiles AWS -Tools für PowerShellCmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Get-EKSNodegroup

Tools für PowerShell V4

Beispiel 1: Dieses Cmdlet gibt beschreibende Informationen zu einer Amazon EKS-Knotengruppe zurück.


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

Ausgabe:


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

Einzelheiten zur API finden Sie unter DescribeNodegroup AWS -Tools für PowerShellCmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Get-EKSNodegroupList

Tools für PowerShell V4

Beispiel 1: Dieses Cmdlet listet die Amazon EKS-Knotengruppen auf, die dem angegebenen Cluster in Ihrem AWS-Konto in der angegebenen Region zugeordnet sind.


Get-EKSNodegroupList -ClusterName PROD

Ausgabe:


 ProdEKSNodeGroup

Einzelheiten zur API finden Sie unter ListNodegroups AWS -Tools für PowerShellCmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Get-EKSResourceTag

Tools für PowerShell V4

Beispiel 1: Dieses Cmdlet listet die Tags für eine Amazon EKS-Ressource auf.


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

Ausgabe:


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

Einzelheiten zur API finden Sie unter ListTagsForResource AWS -Tools für PowerShellCmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Get-EKSUpdate

Tools für PowerShell V4

Beispiel 1: Dieses Cmdlet gibt beschreibende Informationen zu einem Update für Ihren Amazon EKS-Cluster oder die zugehörige verwaltete Knotengruppe zurück.


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

Ausgabe:


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

Einzelheiten zur API finden Sie unter DescribeUpdate AWS -Tools für PowerShellCmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Get-EKSUpdateList

Tools für PowerShell V4

Beispiel 1: Dieses Cmdlet listet die Updates auf, die einem Amazon EKS-Cluster oder einer verwalteten Knotengruppe in Ihrer AWS-Konto Region zugeordnet sind.


Get-EKSUpdateList -Name "PROD"

Ausgabe:


ee708232-7d2e-4ed7-9270-d0b5176f0726

Einzelheiten zur API finden Sie unter ListUpdates AWS -Tools für PowerShellCmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. New-EKSCluster

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird ein neuer Cluster namens 'prod' erstellt.


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

Ausgabe:


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

Einzelheiten zur API finden Sie unter CreateCluster AWS -Tools für PowerShellCmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. New-EKSFargateProfile

Tools für PowerShell V4

Beispiel 1: Dieses Cmdlet erstellt ein AWS Fargate-Profil für Ihren Amazon EKS-Cluster. Sie müssen mindestens ein Fargate-Profil in einem Cluster haben, um Pods auf der Fargate-Infrastruktur planen zu können.


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

Ausgabe:


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

Einzelheiten zur API finden Sie unter CreateFargateProfile AWS -Tools für PowerShellCmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. New-EKSNodeGroup

Tools für PowerShell V4

Beispiel 1: Dieses Cmdlet erstellt eine verwaltete Worker-Knotengruppe für einen Amazon EKS-Cluster. Sie können nur eine Knotengruppe für Ihren Cluster erstellen, die der aktuellen Kubernetes-Version für den Cluster entspricht. Alle Knotengruppen werden mit der neuesten AMI-Release-Version für die jeweilige Kubernetes-Unterversion des Clusters erstellt.


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"

Ausgabe:


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

Einzelheiten zur API finden Sie unter CreateNodegroup AWS -Tools für PowerShellCmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Remove-EKSCluster

Tools für PowerShell V4

Beispiel 1: Dieses Cmdlet löscht die Amazon EKS-Cluster-Steuerebene.


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

Ausgabe:


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

Einzelheiten zur API finden Sie unter DeleteCluster AWS -Tools für PowerShellCmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Remove-EKSFargateProfile

Tools für PowerShell V4

Beispiel 1: Dieses Cmdlet löscht ein AWS Fargate-Profil. Wenn Sie ein Fargate-Profil löschen, werden alle Pods gelöscht, die auf Fargate laufen und mit dem Profil erstellt wurden.


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

Ausgabe:


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

Einzelheiten zur API finden Sie unter DeleteFargateProfile AWS -Tools für PowerShellCmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Remove-EKSNodegroup

Tools für PowerShell V4

Beispiel 1: Dieses Cmdlet löscht eine Amazon EKS-Knotengruppe für einen Cluster.


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

Ausgabe:


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

Einzelheiten zur API finden Sie unter DeleteNodegroup AWS -Tools für PowerShellCmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Remove-EKSResourceTag

Tools für PowerShell V4

Beispiel 1: Dieses Cmdlet löscht angegebene Tags aus einer EKS-Ressource.


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

Ausgabe:


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

Einzelheiten zur API finden Sie unter UntagResource AWS -Tools für PowerShellCmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Update-EKSClusterConfig

Tools für PowerShell V4

Beispiel 1: Aktualisiert eine Amazon EKS-Clusterkonfiguration. Ihr Cluster funktioniert während des Updates weiterhin.


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

Ausgabe:


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

Einzelheiten zur API finden Sie unter UpdateClusterConfig AWS -Tools für PowerShellCmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Update-EKSClusterVersion

Tools für PowerShell V4

Beispiel 1: Dieses Cmdlet aktualisiert einen Amazon EKS-Cluster auf die angegebene Kubernetes-Version. Ihr Cluster funktioniert während des Updates weiterhin.


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

Ausgabe:


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

Einzelheiten zur API finden Sie unter UpdateClusterVersion AWS -Tools für PowerShellCmdlet-Referenz (V4).

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Amazon EFS

Elastic Load Balancing — Version 1