Há mais exemplos de AWS SDK disponíveis no 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á.
Exemplos do Amazon ECS usando ferramentas para PowerShell
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o Ferramentas da AWS para PowerShell 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
-
Exemplo 1: Esse cmdlet descreve um ou mais dos 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 da API, consulte DescribeClustersem Referência de Ferramentas da AWS para 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 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 ListClustersem Referência de Ferramentas da AWS para 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 seu 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 ListServicesem Referência de Ferramentas da AWS para 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 obter detalhes da API, consulte DescribeServicesem Referência de Ferramentas da AWS para 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 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 CreateClusterem Referência de Ferramentas da AWS para 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 obter detalhes da API, consulte CreateServiceem Referência de Ferramentas da AWS para PowerShell cmdlet.
-
O código de exemplo a seguir mostra como usar Remove-ECSCluster
.
- Ferramentas para PowerShell
-
Exemplo 1: Esse cmdlet exclui o cluster 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 DeleteClusterem Referência de Ferramentas da AWS para 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 obter detalhes da API, consulte DeleteServiceem Referência de Ferramentas da AWS para 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 obter detalhes da API, consulte UpdateClusterSettingsem Referência de Ferramentas da AWS para 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 obter detalhes da API, consulte UpdateServiceem Referência de Ferramentas da AWS para PowerShell cmdlet.
-