ECSExemplos da Amazon usando ferramentas para PowerShell - AWS SDKExemplos de código
Ações

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

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á.

ECSExemplos da Amazon usando ferramentas para PowerShell

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Tools for PowerShell com a AmazonECS.

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

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

Tópicos

Ações

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

Ferramentas para PowerShell

Exemplo 1: Esse cmdlet descreve um ou mais dos seus ECS clusters.

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 API obter detalhes, consulte DescribeClustersem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

Exemplo 1: Esse cmdlet retorna uma lista de clusters existentesECS.

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 API obter detalhes, consulte ListClustersem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

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 API obter detalhes, consulte ListServicesem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

Exemplo 1: Esse exemplo mostra como recuperar detalhes de um serviço específico do seu 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 API obter detalhes, consulte DescribeServicesem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

Exemplo 1: Esse cmdlet cria um novo cluster da AmazonECS.

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 API obter detalhes, consulte CreateClusterem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

Exemplo 1: Esse exemplo de comando cria um serviço em seu 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 em seu 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 API obter detalhes, consulte CreateServiceem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

Exemplo 1: Esse cmdlet exclui o cluster especificado. ECS 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 API obter detalhes, consulte DeleteClusterem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

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. Você será solicitado a confirmar antes que o comando continue. 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 API obter detalhes, consulte DeleteServiceem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

Exemplo 1: Esse cmdlet modifica as configurações a serem usadas em um cluster. 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 API obter detalhes, consulte UpdateClusterSettingsem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

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: 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 API obter detalhes, consulte UpdateServiceem Referência de AWS Tools for PowerShell cmdlet.