View a markdown version of this page

Exemplos do Amazon ECS usando ferramentas para PowerShell V5 - AWS Exemplos de código SDK
Ações

Há mais exemplos de AWS SDK disponíveis no repositório AWS Doc SDK Examples GitHub .

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Exemplos do Amazon ECS usando ferramentas para PowerShell V5

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando a Ferramentas da AWS para PowerShell V5 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 V5

Exemplo 1: esse cmdlet descreve um ou mais de seus 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 sobre a API, consulte DescribeClusters Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

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

Ferramentas para PowerShell V5

Exemplo 1: esse 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 sobre a API, consulte ListClusters Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

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

Ferramentas para PowerShell V5

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

Get-ECSClusterService

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

Get-ECSClusterService -Cluster myCluster

  • Para obter detalhes sobre a API, consulte ListServices Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

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

Ferramentas para PowerShell V5

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

Get-ECSService -Service my-hhtp-service

Exemplo 2: esse 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 sobre a API, consulte DescribeServices Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

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

Ferramentas para PowerShell V5

Exemplo 1: esse 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 sobre a API, consulte CreateCluster Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

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

Ferramentas para PowerShell V5

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

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

Exemplo 2: esse 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 de 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 sobre a API, consulte CreateService Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

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

Ferramentas para PowerShell V5

Exemplo 1: esse cmdlet exclui o cluster do ECS especificado. Cancele 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 sobre a API, consulte DeleteCluster Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

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

Ferramentas para PowerShell V5

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 antes que você possa excluí-lo. A confirmação será solicitada antes que o comando continue. Para ignorar a solicitação 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 sobre a API, consulte DeleteService Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

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

Ferramentas para PowerShell V5

Exemplo 1: esse 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 sobre a API, consulte UpdateClusterSettings Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

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

Ferramentas para PowerShell V5

Exemplo 1: esse 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: esse 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 sobre a API, consulte UpdateService Ferramentas da AWS para PowerShell Cmdlet Reference (V5).