Ejemplos de Amazon ECS con las Herramientas para PowerShell V4 - Herramientas de AWS para PowerShell (versión 4)
Acciones

Se ha publicado la versión 5 (V5) de Herramientas de AWS para PowerShell.

Para empezar a utilizar la nueva versión de Tools para PowerShell, consulte la Guía del usuario de Herramientas de AWS para PowerShell (V5), especialmente el tema sobre la Migración a la V5.

Ejemplos de Amazon ECS con las Herramientas para PowerShell V4

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante Herramientas de AWS para PowerShell V4 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 PowerShell V4

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 información sobre la API, consulte DescribeClusters en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

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

Herramientas para PowerShell V4

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 información sobre la API, consulte ListClusters en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

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

Herramientas para PowerShell V4

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 información sobre la API, consulte ListServices en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

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

Herramientas para PowerShell V4

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 información sobre la API, consulte DescribeServices en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

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

Herramientas para PowerShell V4

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 información sobre la API, consulte CreateCluster en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

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

Herramientas para PowerShell V4

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 equilibrador de carga del 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

  • Para obtener información sobre la API, consulte CreateService en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

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

Herramientas para PowerShell V4

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 información sobre la API, consulte DeleteCluster en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

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

Herramientas para PowerShell V4

Ejemplo 1: Se elimina el servicio llamado “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: Se elimina el servicio llamado “my-http-service” del clúster designado.

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

  • Para obtener información sobre la API, consulte DeleteService en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

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

Herramientas para PowerShell V4

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 información sobre la API, consulte UpdateClusterSettings en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

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

Herramientas para PowerShell V4

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

  • Para obtener información sobre la API, consulte UpdateService en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).