Exemples d'Amazon ECS utilisant Tools for PowerShell V4 - AWS Exemples de code SDK
Actions

D'autres exemples de AWS SDK sont disponibles dans le référentiel AWS Doc SDK Examples GitHub .

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Exemples d'Amazon ECS utilisant Tools for PowerShell V4

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec Amazon ECS.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utiliserGet-ECSClusterDetail.

Outils pour PowerShell V4

Exemple 1 : cette applet de commande décrit un ou plusieurs de vos clusters ECS.

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

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous DescribeClustersà la section Référence des Outils AWS pour PowerShell applets de commande (V4).

L'exemple de code suivant montre comment utiliserGet-ECSClusterList.

Outils pour PowerShell V4

Exemple 1 : cette applet de commande renvoie une liste des clusters ECS existants.

Get-ECSClusterList

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous ListClustersà la section Référence des Outils AWS pour PowerShell applets de commande (V4).

L'exemple de code suivant montre comment utiliserGet-ECSClusterService.

Outils pour PowerShell V4

Exemple 1 : Cet exemple répertorie tous les services exécutés dans votre cluster par défaut.

Get-ECSClusterService

Exemple 2 : Cet exemple répertorie tous les services exécutés dans le cluster spécifié.

Get-ECSClusterService -Cluster myCluster

  • Pour plus de détails sur l'API, reportez-vous ListServicesà la section Référence des Outils AWS pour PowerShell applets de commande (V4).

L'exemple de code suivant montre comment utiliserGet-ECSService.

Outils pour PowerShell V4

Exemple 1 : Cet exemple montre comment récupérer les détails d'un service spécifique à partir de votre cluster par défaut.

Get-ECSService -Service my-hhtp-service

Exemple 2 : Cet exemple montre comment récupérer les détails d'un service spécifique exécuté dans le cluster nommé.

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

  • Pour plus de détails sur l'API, reportez-vous DescribeServicesà la section Référence des Outils AWS pour PowerShell applets de commande (V4).

L'exemple de code suivant montre comment utiliserNew-ECSCluster.

Outils pour PowerShell V4

Exemple 1 : Cette applet de commande crée un nouveau cluster Amazon ECS.

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

Sortie :

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                              : {}

  • Pour plus de détails sur l'API, reportez-vous CreateClusterà la section Référence des Outils AWS pour PowerShell applets de commande (V4).

L'exemple de code suivant montre comment utiliserNew-ECSService.

Outils pour PowerShell V4

Exemple 1 : Cet exemple de commande crée un service dans votre cluster par défaut appelé `ecs-simple-service`. Le service utilise la définition de tâche `ecs-demo` et il gère 10 instanciations de cette tâche.

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

Exemple 2 : Cet exemple de commande crée un service derrière un équilibreur de charge dans votre cluster par défaut appelé `ecs-simple-service`. Le service utilise la définition de tâche `ecs-demo` et il gère 10 instanciations de cette tâche.

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

  • Pour plus de détails sur l'API, reportez-vous CreateServiceà la section Référence des Outils AWS pour PowerShell applets de commande (V4).

L'exemple de code suivant montre comment utiliserRemove-ECSCluster.

Outils pour PowerShell V4

Exemple 1 : cette applet de commande supprime le cluster ECS spécifié. Vous devez désenregistrer toutes les instances de conteneur de ce cluster avant de pouvoir le supprimer.

Remove-ECSCluster -Cluster "LAB-ECS"

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous DeleteClusterà la section Référence des Outils AWS pour PowerShell applets de commande (V4).

L'exemple de code suivant montre comment utiliserRemove-ECSService.

Outils pour PowerShell V4

Exemple 1 : Supprime le service nommé « my-http-service » dans le cluster par défaut. Le service doit avoir le nombre souhaité et le nombre de points courants de 0 pour que vous puissiez le supprimer. Vous êtes invité à confirmer avant que la commande ne soit exécutée. Pour contourner l'invite de confirmation, ajoutez le commutateur -Force.

Remove-ECSService -Service my-http-service

Exemple 2 : Supprime le service nommé « my-http-service » dans le cluster nommé.

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

  • Pour plus de détails sur l'API, reportez-vous DeleteServiceà la section Référence des Outils AWS pour PowerShell applets de commande (V4).

L'exemple de code suivant montre comment utiliserUpdate-ECSClusterSetting.

Outils pour PowerShell V4

Exemple 1 : cette applet de commande modifie les paramètres à utiliser pour un cluster ECS.

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

Sortie :

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                              : {}

  • Pour plus de détails sur l'API, reportez-vous UpdateClusterSettingsà la section Référence des Outils AWS pour PowerShell applets de commande (V4).

L'exemple de code suivant montre comment utiliserUpdate-ECSService.

Outils pour PowerShell V4

Exemple 1 : Cet exemple de commande met à jour le service my-http-service `` pour utiliser la définition de tâche amazon-ecs-sample ``.

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

Exemple 2 : Cet exemple de commande met à jour le nombre souhaité du service my-http-service `` à 10.

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

  • Pour plus de détails sur l'API, reportez-vous UpdateServiceà la section Référence des Outils AWS pour PowerShell applets de commande (V4).