Exemplos do Amazon ECS que usam o Tools for PowerShell V4 - Ferramentas da AWS para PowerShell (versão 4)
Ações

A versão 5 (V5) do Ferramentas da AWS para PowerShell foi lançada!

Para começar a usar a nova versão do SDK, consulte o Guia do usuário do Ferramentas da AWS para PowerShell (V5), especialmente o tópico Migração para V5.

Exemplos do Amazon ECS que usam o Tools for PowerShell V4

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o Ferramentas da AWS para PowerShell V4 com o Amazon ECS.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

Tópicos

Ações

O código de exemplo a seguir mostra como usar Get-ECSClusterDetail.

Ferramentas para PowerShell V4

Exemplo 1: este cmdlet descreve um ou mais dos clusters do ECS.

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

Saída:

LoggedAt         : 12/27/2019 9:27:41 PM
Clusters         : {LAB-ECS-CL}
Failures         : {}
ResponseMetadata : Amazon.Runtime.ResponseMetadata
ContentLength    : 396
HttpStatusCode   : OK

  • Para obter detalhes da API, consulte DescribeClusters em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Get-ECSClusterList.

Ferramentas para PowerShell V4

Exemplo 1: este cmdlet retorna uma lista de clusters do ECS existentes.

Get-ECSClusterList

Saída:

arn:aws:ecs:us-west-2:012345678912:cluster/LAB-ECS-CL
arn:aws:ecs:us-west-2:012345678912:cluster/LAB-ECS

  • Para obter detalhes da API, consulte ListClusters em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Get-ECSClusterService.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo lista todos os serviços em execução no cluster padrão.

Get-ECSClusterService

Exemplo 2: este exemplo lista todos os serviços em execução no cluster especificado.

Get-ECSClusterService -Cluster myCluster

  • Para obter detalhes da API, consulte ListServices em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Get-ECSService.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo mostra como recuperar detalhes de um serviço específico do cluster padrão.

Get-ECSService -Service my-hhtp-service

Exemplo 2: este exemplo mostra como recuperar detalhes de um serviço específico em execução no cluster nomeado.

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

  • Para obter detalhes da API, consulte DescribeServices em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar New-ECSCluster.

Ferramentas para PowerShell V4

Exemplo 1: este cmdlet cria um cluster do Amazon ECS. 

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

Saída:

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

  • Para obter detalhes da API, consulte CreateCluster em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar New-ECSService.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo de comando cria um serviço no cluster padrão chamado “ecs-simple-service”. O serviço usa a definição da tarefa “ecs-demo” e mantém 10 instanciações dessa tarefa.

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

Exemplo 2: este exemplo de comando cria um serviço por trás de um balanceador de carga no cluster padrão chamado “ecs-simple-service”. O serviço usa a definição da tarefa “ecs-demo” e mantém 10 instanciações dessa tarefa.

$lb = @{
    LoadBalancerName = "EC2Contai-EcsElast-S06278JGSJCM"
    ContainerName = "simple-demo"
    ContainerPort = 80
}        
New-ECSService -ServiceName ecs-simple-service -TaskDefinition ecs-demo -DesiredCount 10 -LoadBalancer $lb

  • Para obter detalhes da API, consulte CreateService em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Remove-ECSCluster.

Ferramentas para PowerShell V4

Exemplo 1: este cmdlet exclui o cluster do ECS especificado. Você deve cancelar o registro de todas as instâncias de contêiner desse cluster antes de excluí-las. 

Remove-ECSCluster -Cluster "LAB-ECS"

Saída:

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

  • Para obter detalhes da API, consulte DeleteCluster em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Remove-ECSService.

Ferramentas para PowerShell V4

Exemplo 1: exclui o serviço chamado “my-http-service” no cluster padrão. O serviço deve ter uma contagem desejada e uma contagem contínua de 0 para que você possa excluí-lo. Você recebe um prompt de confirmação para o comando continuar. Para ignorar o prompt de confirmação, adicione a opção -Force.

Remove-ECSService -Service my-http-service

Exemplo 2: exclui o serviço chamado “my-http-service” no cluster nomeado.

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

  • Para obter detalhes da API, consulte DeleteService em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Update-ECSClusterSetting.

Ferramentas para PowerShell V4

Exemplo 1: este cmdlet modifica as configurações a serem usadas em um cluster do ECS.

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

Saída:

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

  • Para obter detalhes da API, consulte UpdateClusterSettings em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Update-ECSService.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo de comando atualiza o serviço “my-http-service” para usar a definição de tarefa “amazon-ecs-sample”.

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

Exemplo 2: este exemplo de comando atualiza a contagem desejada do serviço “my-http-service” para 10.

Update-ECSService -Service my-http-service -DesiredCount 10

  • Para obter detalhes da API, consulte UpdateService em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).