使用 Tools forECS 的 Amazon PowerShell 範例 - AWS SDK 程式碼範例
動作

文件 AWS SDK AWS 範例 SDK 儲存庫中有更多可用的 GitHub 範例。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 Tools forECS 的 Amazon PowerShell 範例

下列程式碼範例示範如何搭配 Amazon ECS AWS Tools for PowerShell 使用 來執行動作和實作常見案例。

Actions 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會示範如何呼叫個別服務函數，但您可以在相關案例中查看內容中的動作。

每個範例都包含完整原始程式碼的連結，您可以在其中找到如何在內容中設定和執行程式碼的指示。

主題

動作

下列程式碼範例示範如何使用 Get-ECSClusterDetail。

for PowerShell 工具

範例 1：此 cmdlet 說明一或多個 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 詳細資訊，請參閱 AWS Tools for PowerShell Cmdlet 參考中的 DescribeClusters。

下列程式碼範例示範如何使用 Get-ECSClusterList。

for PowerShell 工具

範例 1：此 cmdlet 會傳回現有 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 詳細資訊，請參閱 AWS Tools for PowerShell Cmdlet 參考中的 ListClusters。

下列程式碼範例示範如何使用 Get-ECSClusterService。

for PowerShell 工具

範例 1：此範例列出在預設叢集中執行的所有服務。

Get-ECSClusterService

範例 2：此範例列出在指定叢集中執行的所有服務。

Get-ECSClusterService -Cluster myCluster

  • 如需 API 詳細資訊，請參閱 AWS Tools for PowerShell Cmdlet 參考中的 ListServices。

下列程式碼範例示範如何使用 Get-ECSService。

for PowerShell 工具

範例 1：此範例示範如何從預設叢集擷取特定服務的詳細資訊。

Get-ECSService -Service my-hhtp-service

範例 2：此範例示範如何擷取在具名叢集中執行的特定服務的詳細資訊。

Get-ECSService -Cluster myCluster -Service my-hhtp-service

  • 如需 API 詳細資訊，請參閱 AWS Tools for PowerShell Cmdlet 參考中的 DescribeServices。

下列程式碼範例示範如何使用 New-ECSCluster。

for PowerShell 工具

範例 1：此 cmdlet 會建立新的 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 詳細資訊，請參閱 AWS Tools for PowerShell Cmdlet 參考中的 CreateCluster。

下列程式碼範例示範如何使用 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 詳細資訊，請參閱 AWS Tools for PowerShell Cmdlet 參考中的 CreateService。

下列程式碼範例示範如何使用 Remove-ECSCluster。

for PowerShell 工具

範例 1：此 cmdlet 會刪除指定的 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 Cmdlet 參考中的 DeleteCluster。

下列程式碼範例示範如何使用 Remove-ECSService。

for PowerShell 工具

範例 1：刪除預設叢集中名為 'my-http-service' 的服務。服務必須具有所需的計數並執行 0 計數，您才能將其刪除。在命令繼續之前，系統會提示您進行確認。若要略過確認提示，請新增 -Force 開關。

Remove-ECSService -Service my-http-service

範例 2：刪除具名叢集中名為 'my-http-service' 的服務。

Remove-ECSService -Cluster myCluster -Service my-http-service

  • 如需 API 詳細資訊，請參閱 AWS Tools for PowerShell Cmdlet 參考中的 DeleteService。

下列程式碼範例示範如何使用 Update-ECSClusterSetting。

for PowerShell 工具

範例 1：此 cmdlet 會修改 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 詳細資訊，請參閱 AWS Tools for PowerShell Cmdlet 參考中的 UpdateClusterSettings。

下列程式碼範例示範如何使用 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 詳細資訊，請參閱 AWS Tools for PowerShell Cmdlet 參考中的 UpdateService。