View a markdown version of this page

Ejemplos de Amazon ECS que utilizan Tools for V4 PowerShell - AWS Ejemplos de código de SDK
Acciones

Hay más ejemplos de AWS SDK disponibles en el repositorio de ejemplos de AWS Doc SDK. GitHub

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 que utilizan Tools for V4 PowerShell

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso de la 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 la 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 más información sobre la API, consulte DescribeClusters Herramientas de AWS para PowerShell Cmdlet Reference (V4).

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

Herramientas para la V4 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 ListClusters Herramientas de AWS para PowerShell Cmdlet Reference (V4).

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

Herramientas para la V4 PowerShell

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

Get-ECSClusterService

Ejemplo 2: En este ejemplo se muestran 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 ListServices Herramientas de AWS para PowerShell Cmdlet Reference (V4).

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

Herramientas para la V4 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 DescribeServices Herramientas de AWS para PowerShell Cmdlet Reference (V4).

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

Herramientas para la V4 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 CreateCluster Herramientas de AWS para PowerShell Cmdlet Reference (V4).

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

Herramientas para la V4 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 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 más información sobre la API, consulte CreateService Herramientas de AWS para PowerShell Cmdlet Reference (V4).

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

Herramientas para la V4 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 DeleteCluster Herramientas de AWS para PowerShell Cmdlet Reference (V4).

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

Herramientas para la V4 PowerShell

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

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

  • Para obtener más información sobre la API, consulte DeleteService Herramientas de AWS para PowerShell Cmdlet Reference (V4).

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

Herramientas para la V4 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 UpdateClusterSettings Herramientas de AWS para PowerShell Cmdlet Reference (V4).

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

Herramientas para la V4 PowerShell

Ejemplo 1: En este ejemplo se 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 más información sobre la API, consulte UpdateService Herramientas de AWS para PowerShell Cmdlet Reference (V4).