Tools forECS を使用した Amazon PowerShell の例 - AWS SDKコードの例

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

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

Tools forECS を使用した Amazon PowerShell の例

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

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

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

トピック

アクション

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

ツール for PowerShell

例 1: このコマンドレットでは、1 つ以上の ECS クラスターについて説明します。

Get-ECSClusterDetail -Cluster "LAB-ECS-CL" -Include SETTINGS | Select-Object *

出力:

LoggedAt : 12/27/2019 9:27:41 PM Clusters : {LAB-ECS-CL} Failures : {} ResponseMetadata : Amazon.Runtime.ResponseMetadata ContentLength : 396 HttpStatusCode : OK
  • API の詳細については、「コマンドレットリファレンス」のDescribeClusters」を参照してください。 AWS Tools for PowerShell

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

ツール for PowerShell

例 1: このコマンドレットは、既存の ECS クラスターのリストを返します。

Get-ECSClusterList

出力:

arn:aws:ecs:us-west-2:012345678912:cluster/LAB-ECS-CL arn:aws:ecs:us-west-2:012345678912:cluster/LAB-ECS
  • API の詳細については、「コマンドレットリファレンス」のListClusters」を参照してください。 AWS Tools for PowerShell

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

ツール for PowerShell

例 1: この例では、デフォルトのクラスターで実行されているすべてのサービスを一覧表示します。

Get-ECSClusterService

例 2: この例では、指定されたクラスターで実行されているすべてのサービスを一覧表示します。

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

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

ツール for PowerShell

例 1: この例では、デフォルトのクラスターから特定のサービスの詳細を取得する方法を示しています。

Get-ECSService -Service my-hhtp-service

例 2: この例では、名前付きクラスターで実行されている特定のサービスの詳細を取得する方法を示しています。

Get-ECSService -Cluster myCluster -Service my-hhtp-service
  • API の詳細については、「コマンドレットリファレンス」のDescribeServices」を参照してください。 AWS Tools for PowerShell

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

ツール for PowerShell

例 1: このコマンドレットは、新しい Amazon ECS クラスターを作成します。

New-ECSCluster -ClusterName "LAB-ECS-CL" -Setting @{Name="containerInsights"; Value="enabled"}

出力:

ActiveServicesCount : 0 Attachments : {} AttachmentsStatus : CapacityProviders : {} ClusterArn : arn:aws:ecs:us-west-2:012345678912:cluster/LAB-ECS-CL ClusterName : LAB-ECS-CL DefaultCapacityProviderStrategy : {} PendingTasksCount : 0 RegisteredContainerInstancesCount : 0 RunningTasksCount : 0 Settings : {containerInsights} Statistics : {} Status : ACTIVE Tags : {}
  • API の詳細については、「コマンドレットリファレンス」のCreateCluster」を参照してください。 AWS Tools for PowerShell

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

ツール for PowerShell

例 1: このコマンド例では、デフォルトのクラスターにecs-simple-service」というサービスを作成します。サービスは「ecs-demo」タスク定義を使用し、そのタスクのインスタンス化を 10 回維持します。

New-ECSService -ServiceName ecs-simple-service -TaskDefinition ecs-demo -DesiredCount 10

例 2: このコマンド例では、ecs-simple-service」という名前のデフォルトクラスターでロードバランサーの背後にあるサービスを作成します。サービスは「ecs-demo」タスク定義を使用し、そのタスクのインスタンス化を 10 回維持します。

$lb = @{ LoadBalancerName = "EC2Contai-EcsElast-S06278JGSJCM" ContainerName = "simple-demo" ContainerPort = 80 } New-ECSService -ServiceName ecs-simple-service -TaskDefinition ecs-demo -DesiredCount 10 -LoadBalancer $lb
  • API の詳細については、「コマンドレットリファレンス」のCreateService」を参照してください。 AWS Tools for PowerShell

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

ツール for PowerShell

例 1: このコマンドレットは、指定された ECS クラスターを削除します。削除する前に、このクラスターからすべてのコンテナインスタンスの登録を解除する必要があります。

Remove-ECSCluster -Cluster "LAB-ECS"

出力:

Confirm Are you sure you want to perform this action? Performing the operation "Remove-ECSCluster (DeleteCluster)" on target "LAB-ECS". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
  • API の詳細については、AWS Tools for PowerShell 「コマンドレットリファレンス」のDeleteCluster」を参照してください。

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

ツール for PowerShell

例 1: デフォルトのクラスターでmy-http-service」という名前のサービスを削除します。サービスを削除する前に、サービスに必要なカウントと実行中のカウントが 0 である必要があります。コマンドが進む前に、確認を求められます。確認プロンプトをバイパスするには、-Force スイッチを追加します。

Remove-ECSService -Service my-http-service

例 2: 名前付きクラスターで Word my-http-serviceという名前のサービスを削除します。

Remove-ECSService -Cluster myCluster -Service my-http-service
  • API の詳細については、AWS Tools for PowerShell 「コマンドレットリファレンス」のDeleteService」を参照してください。

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

ツール for PowerShell

例 1: このコマンドレットは、ECS クラスターに使用する設定を変更します。

Update-ECSClusterSetting -Cluster "LAB-ECS-CL" -Setting @{Name="containerInsights"; Value="disabled"}

出力:

ActiveServicesCount : 0 Attachments : {} AttachmentsStatus : CapacityProviders : {} ClusterArn : arn:aws:ecs:us-west-2:012345678912:cluster/LAB-ECS-CL ClusterName : LAB-ECS-CL DefaultCapacityProviderStrategy : {} PendingTasksCount : 0 RegisteredContainerInstancesCount : 0 RunningTasksCount : 0 Settings : {containerInsights} Statistics : {} Status : ACTIVE Tags : {}
  • APIの詳細については、「コマンドレットリファレンス」のUpdateClusterSettings」を参照してください。 AWS Tools for PowerShell

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

ツール for PowerShell

例 1: このコマンド例では、my-http-service」サービスを更新してamazon-ecs-sample」タスク定義を使用します。

Update-ECSService -Service my-http-service -TaskDefinition amazon-ecs-sample

例 2: このコマンド例では、my-http-service` サービスの必要な数を 10 に更新します。

Update-ECSService -Service my-http-service -DesiredCount 10
  • API の詳細については、「コマンドレットリファレンス」のUpdateService」を参照してください。 AWS Tools for PowerShell