Tools forEKS を使用した Amazon PowerShell の例 - AWS SDKコードの例
アクション

Doc AWS SDK ExamplesWord リポジトリには、さらに多くの GitHub の例があります。 AWS SDK

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Tools forEKS を使用した Amazon PowerShell の例

次のコード例は、Amazon EKS AWS Tools for PowerShell で を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。

アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には、完全なソースコードへのリンクが含まれています。ここでは、コンテキストでコードを設定および実行する方法の手順を確認できます。

トピック

アクション

次の例は、Add-EKSResourceTag を使用する方法を説明しています。

ツール for PowerShell

例 1: このコマンドレットは、指定されたタグをリソースと指定された resourceArn に関連付けます。 

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

  • API の詳細については、「コマンドレットリファレンス」のTagResource」を参照してください。 AWS Tools for PowerShell

次の例は、Get-EKSCluster を使用する方法を説明しています。

ツール for PowerShell

例 1: このコマンドレットは、Amazon EKS クラスターに関する説明情報を返します。

Get-EKSCluster -Name "PROD"

出力:

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

  • APIの詳細については、「コマンドレットリファレンス」のDescribeCluster」を参照してください。 AWS Tools for PowerShell

次の例は、Get-EKSClusterList を使用する方法を説明しています。

ツール for PowerShell

例 1: このコマンドレットは、指定されたリージョンの AWS アカウント の Amazon EKS クラスターを一覧表示します。

Get-EKSClusterList

出力:

 PROD

  • API の詳細については、「コマンドレットリファレンス」のListClusters」を参照してください。 AWS Tools for PowerShell

次のコード例は、Get-EKSFargateProfile を使用する方法を示しています。

ツール for PowerShell

例 1: このコマンドレットは、 AWS Fargate プロファイルに関する説明的な情報を返します。

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

出力:

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

  • API の詳細については、「コマンドレットリファレンス」のDescribeFargateProfile」を参照してください。 AWS Tools for PowerShell

次のコード例は、Get-EKSFargateProfileList を使用する方法を示しています。

ツール for PowerShell

例 1: このコマンドレットには、指定したリージョン AWS アカウント の で指定したクラスターに関連付けられた AWS Fargate プロファイルが一覧表示されます。

Get-EKSFargateProfileList -ClusterName "TEST"

出力:

EKSFargate
EKSFargateProfile

  • API の詳細については、「コマンドレットリファレンス」のListFargateProfiles」を参照してください。 AWS Tools for PowerShell

次の例は、Get-EKSNodegroup を使用する方法を説明しています。

ツール for PowerShell

例 1: このコマンドレットは、Amazon EKS ノードグループに関する説明情報を返します。

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

出力:

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

  • API の詳細については、「コマンドレットリファレンス」のDescribeNodegroup」を参照してください。 AWS Tools for PowerShell

次の例は、Get-EKSNodegroupList を使用する方法を説明しています。

ツール for PowerShell

例 1: このコマンドレットには、指定したリージョン AWS アカウント の で指定したクラスターに関連付けられている Amazon EKS ノードグループが一覧表示されます。 

Get-EKSNodegroupList -ClusterName PROD

出力:

 ProdEKSNodeGroup

  • APIの詳細については、「コマンドレットリファレンス」のListNodegroups」を参照してください。 AWS Tools for PowerShell

次のコード例は、Get-EKSResourceTag を使用する方法を示しています。

ツール for PowerShell

例 1: このコマンドレットは、Amazon EKS リソースのタグを一覧表示します。 

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

出力:

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

  • APIの詳細については、「コマンドレットリファレンス」のListTagsForResource」を参照してください。 AWS Tools for PowerShell

次の例は、Get-EKSUpdate を使用する方法を説明しています。

ツール for PowerShell

例 1: このコマンドレットは、Amazon EKS クラスターまたは関連するマネージドノードグループに対する更新に関する説明的な情報を返します。 

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

出力:

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

  • API の詳細については、AWS Tools for PowerShell 「コマンドレットリファレンス」のDescribeUpdate」を参照してください。

次のコード例は、Get-EKSUpdateList を使用する方法を示しています。

ツール for PowerShell

例 1: このコマンドレットは AWS アカウント、指定したリージョンの 内の Amazon EKS クラスターまたはマネージドノードグループに関連付けられた更新を一覧表示します。

Get-EKSUpdateList -Name "PROD"

出力:

ee708232-7d2e-4ed7-9270-d0b5176f0726

  • APIの詳細については、「コマンドレットリファレンス」のListUpdates」を参照してください。 AWS Tools for PowerShell

次の例は、New-EKSCluster を使用する方法を説明しています。

ツール for PowerShell

例 1: この例では、「prod」という名前の新しいクラスターを作成します。

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

出力:

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

  • APIの詳細については、「コマンドレットリファレンス」のCreateCluster」を参照してください。 AWS Tools for PowerShell

次のコード例は、New-EKSFargateProfile を使用する方法を示しています。

ツール for PowerShell

例 1: このコマンドレットは、Amazon EKS クラスターの AWS Fargate プロファイルを作成します。Fargate インフラストラクチャでポッドをスケジュールするには、クラスターに少なくとも 1 つの Fargate プロファイルが必要です。 

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

出力:

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

  • APIの詳細については、「コマンドレットリファレンス」のCreateFargateProfile」を参照してください。 AWS Tools for PowerShell

次のコード例は、New-EKSNodeGroup を使用する方法を示しています。

ツール for PowerShell

例 1: このコマンドレットは、Amazon EKS クラスターのマネージドワーカーノードグループを作成します。クラスターの現在の Kubernetes バージョンと同じクラスター対してのみノードグループを作成できます。すべてのノードグループは、クラスターのそれぞれのマイナー Kubernetes バージョンの最新の AMI リリースバージョンで作成されます。 

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"

出力:

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

  • APIの詳細については、「コマンドレットリファレンス」のCreateNodegroup」を参照してください。 AWS Tools for PowerShell

次のコード例は、Remove-EKSCluster を使用する方法を示しています。

ツール for PowerShell

例 1: このコマンドレットは Amazon EKS クラスターコントロールプレーンを削除します。

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

出力:

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

  • API の詳細については、AWS Tools for PowerShell 「コマンドレットリファレンス」のDeleteCluster」を参照してください。

次の例は、Remove-EKSFargateProfile を使用する方法を説明しています。

ツール for PowerShell

例 1: このコマンドレットは AWS Fargate プロファイルを削除します。Fargate プロファイルを削除すると、そのプロファイルで作成された Fargate で実行されているポッドはすべて削除されます。 

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

出力:

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

  • API の詳細については、AWS Tools for PowerShell 「コマンドレットリファレンス」のDeleteFargateProfile」を参照してください。

次のコード例は、Remove-EKSNodegroup を使用する方法を示しています。

ツール for PowerShell

例 1: このコマンドレットは、クラスターの Amazon EKS ノードグループを削除します。

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

出力:

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

  • API の詳細については、「コマンドレットリファレンス」のDeleteNodegroup」を参照してください。 AWS Tools for PowerShell

次のコード例は、Remove-EKSResourceTag を使用する方法を示しています。

ツール for PowerShell

例 1: このコマンドレットは、EKS リソースから指定されたタグを削除します。

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

出力:

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

  • API の詳細については、「コマンドレットリファレンス」のUntagResource」を参照してください。 AWS Tools for PowerShell

次のコード例は、Update-EKSClusterConfig を使用する方法を示しています。

ツール for PowerShell

例 1: Amazon EKS クラスター設定を更新します。更新中、クラスターは引き続き機能します。

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

出力:

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

  • APIの詳細については、「コマンドレットリファレンス」のUpdateClusterConfig」を参照してください。 AWS Tools for PowerShell

次の例は、Update-EKSClusterVersion を使用する方法を説明しています。

ツール for PowerShell

例 1: このコマンドレットは、Amazon EKS クラスターを指定された Kubernetes バージョンに更新します。更新中、クラスターは引き続き機能します。

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

出力:

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

  • API の詳細については、「コマンドレットリファレンス」のUpdateClusterVersion」を参照してください。 AWS Tools for PowerShell