Ejemplos de Amazon ECS con Tools for PowerShell V5 - Herramientas de AWS para PowerShell (versión 5)
Acciones

¡Se Herramientas de AWS para PowerShell ha lanzado la versión 5 (V5) del!

Para obtener información sobre los cambios más importantes y la migración de sus aplicaciones, consulte el tema sobre migración.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Ejemplos de Amazon ECS con Tools for PowerShell V5

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar situaciones comunes mediante el uso de la Herramientas de AWS para PowerShell V5 con Amazon ECS.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar Get-ECSClusterDetail.

Herramientas para la PowerShell V5

Ejemplo 1: Este cmdlet describe uno o varios de los clústeres de ECS.

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

Salida:

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

  • Para obtener más información sobre la API, consulte DescribeClustersla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-ECSClusterList.

Herramientas para la versión 5 PowerShell

Ejemplo 1: Este cmdlet devuelve una lista de los clústeres de ECS existentes.

Get-ECSClusterList

Salida:

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

  • Para obtener más información sobre la API, consulte ListClustersla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-ECSClusterService.

Herramientas para la versión 5 PowerShell

Ejemplo 1: En este ejemplo se enumeran todos los servicios que se ejecutan en el clúster predeterminado.

Get-ECSClusterService

Ejemplo 2: En este ejemplo se enumeran todos los servicios que se ejecutan en el clúster especificado.

Get-ECSClusterService -Cluster myCluster

  • Para obtener más información sobre la API, consulte ListServicesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-ECSService.

Herramientas para la versión 5 PowerShell

Ejemplo 1: En este ejemplo se muestra cómo recuperar los detalles de un servicio específico del clúster predeterminado.

Get-ECSService -Service my-hhtp-service

Ejemplo 2: En este ejemplo se muestra cómo recuperar los detalles de un servicio específico que se está ejecutando en el clúster designado.

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

  • Para obtener más información sobre la API, consulte DescribeServicesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

En el siguiente ejemplo de código, se muestra cómo utilizar New-ECSCluster.

Herramientas para la versión 5 PowerShell

Ejemplo 1: Este cmdlet crea un nuevo clúster de Amazon ECS.

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

Salida:

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 obtener más información sobre la API, consulte CreateClusterla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

En el siguiente ejemplo de código, se muestra cómo utilizar New-ECSService.

Herramientas para la versión 5 PowerShell

Ejemplo 1: Este comando de ejemplo crea un servicio en el clúster predeterminado llamado `ecs-simple-service`. El servicio utiliza la definición de la tarea “ecs-demo” y mantiene 10 instancias de la tarea.

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

Ejemplo 2: Este comando de ejemplo crea un servicio detrás de un balanceador de carga en tu clúster predeterminado llamado `ecs-simple-service`. El servicio utiliza la definición de la tarea “ecs-demo” y mantiene 10 instancias de la tarea.

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

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-ECSCluster.

Herramientas para la versión 5 PowerShell

Ejemplo 1: Este cmdlet elimina el clúster de ECS especificado. Debe anular el registro de todas las instancias de contenedor de este clúster para poder eliminarlo.

Remove-ECSCluster -Cluster "LAB-ECS"

Salida:

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 obtener más información sobre la API, consulte DeleteClusterla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-ECSService.

Herramientas para la versión 5 PowerShell

Ejemplo 1: elimina el servicio denominado 'my-http-service' del clúster predeterminado. El servicio debe tener establecido el recuento deseado y el recuento de ejecución en 0 para poder eliminarlo. Se le solicitará confirmación antes de que se ejecute el comando. Para omitir la petición de confirmación, añada el modificador -Force al comando.

Remove-ECSService -Service my-http-service

Ejemplo 2: Elimina el servicio denominado 'my-http-service' del clúster nombrado.

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

En el siguiente ejemplo de código, se muestra cómo utilizar Update-ECSClusterSetting.

Herramientas para la versión 5 PowerShell

Ejemplo 1: Este cmdlet modifica la configuración que se usa para un clúster de ECS.

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

Salida:

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 obtener más información sobre la API, consulte UpdateClusterSettingsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

En el siguiente ejemplo de código, se muestra cómo utilizar Update-ECSService.

Herramientas para la versión 5 PowerShell

Ejemplo 1: Este comando de ejemplo actualiza el servicio `my-http-service` para usar la definición de tarea amazon-ecs-sample ``.

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

Ejemplo 2: Este comando de ejemplo actualiza el recuento deseado del servicio my-http-service `` a 10.

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