Utilisation des groupes de placement

Pour créer un groupe de placement à l'aide du AWS CLI

Utilisez la commande create-placement-group. L’exemple suivant crée un groupe de placement nommé my-cluster qui utilise la stratégie de placement cluster et applique une balise avec une clé purpose et une valeur production.

aws ec2 create-placement-group \
    --group-name my-cluster \
    --strategy cluster \
    --tag-specifications 'ResourceType=placement-group,Tags={Key=purpose,Value=production}'

Pour créer un groupe de placement de partitions à l'aide du AWS CLI

Utilisez la commande create-placement-group. Spécifiez le paramètre --strategy avec la valeur partition et le paramètre --partition-count avec le nombre de partitions souhaité. Dans cet exemple, le groupe de placement par partition est nommé HDFS-Group-A et créé avec cinq partitions.

aws ec2 create-placement-group \
    --group-name HDFS-Group-A \
    --strategy partition \
    --partition-count 5

Pour créer un groupe de placement à l'aide du AWS Tools for Windows PowerShell

Utilisez la commande New-EC2PlacementGroup.

Pour décrire tous vos groupes de placement

Utilisez la describe-placement-groups AWS CLI commande.

aws ec2 describe-placement-groups

Exemple de réponse

{
    "PlacementGroups": [
        {
            "GroupName": "my-cluster-pg",
            "State": "available",
            "Strategy": "cluster",
            "GroupId": "pg-0123456789example",
            "GroupArn": "arn:aws:ec2:eu-west-1:111111111111:placement-group/my-cluster-pg"
        },
            ...
     ]
}

Pour décrire un groupe de placement spécifié

Utilisez la describe-placement-groups AWS CLI commande. Vous pouvez spécifier le --group-id ou le --group-name paramètre.

Spécifiez l'ID du groupe de placement :

aws ec2 describe-placement-groups --group-id pg-0123456789example

Spécifiez le nom du groupe de placement :

aws ec2 describe-placement-groups --group-name my-cluster-pg

Exemple de réponse

{
    "PlacementGroups": [
        {
            "GroupName": "my-cluster-pg",
            "State": "available",
            "Strategy": "cluster",
            "GroupId": "pg-0123456789example",
            "GroupArn": "arn:aws:ec2:eu-west-1:111111111111:placement-group/my-cluster-pg"
        }
    ]
}

Pour afficher les balises des groupe de placement

Utilisez la commande describe-tags pour afficher les balises de la ressource spécifiée. Dans l’exemple suivant, vous décrivez les balises de tous vos groupes de placement.

aws ec2 describe-tags \
    --filters Name=resource-type,Values=placement-group			

{
    "Tags": [
        {
            "Key": "Environment",
            "ResourceId": "pg-0123456789EXAMPLE",
            "ResourceType": "placement-group",
            "Value": "Production"
        },
        {
            "Key": "Environment",
            "ResourceId": "pg-9876543210EXAMPLE",
            "ResourceType": "placement-group",
            "Value": "Production"
        }
    ]
}		

Vous pouvez également utiliser la commande describe-tags pour afficher les balises d’un groupe de placement en spécifiant son ID. Dans l’exemple suivant, vous décrivez les balises pour pg-0123456789EXAMPLE.

aws ec2 describe-tags \

    --filters Name=resource-id,Values=pg-0123456789EXAMPLE

{
    "Tags": [
        {
            "Key": "Environment",
            "ResourceId": "pg-0123456789EXAMPLE",
            "ResourceType": "placement-group",
            "Value": "Production"
        }
    ]
}

Vous pouvez également afficher les balises d’un groupe de placement en décrivant le groupe de placement.

Utilisez la describe-placement-groupscommande pour afficher la configuration du groupe de placement spécifié, qui inclut toutes les balises spécifiées pour le groupe de placement.

aws ec2 describe-placement-groups \
    --group-name my-cluster

{
    "PlacementGroups": [
        {
            "GroupName": "my-cluster",
            "State": "available",
            "Strategy": "cluster",
            "GroupId": "pg-0123456789EXAMPLE",
            "Tags": [
                {
                    "Key": "Environment",
                    "Value": "Production"
                }
            ]
        }
    ]
}			

Pour étiqueter un groupe de placement existant à l'aide du AWS CLI

Utilisez la commande create-tags pour baliser les ressources existantes. Dans l’exemple suivant, le groupe de placement existant est étiqueté avec Key=Cost-Center et Value=CC-123.

aws ec2 create-tags \
    --resources pg-0123456789EXAMPLE \
    --tags Key=Cost-Center,Value=CC-123

Pour supprimer une étiquette d'un groupe de placement à l'aide du AWS CLI

Vous pouvez utiliser la commande delete-tags pour supprimer des balises de ressources existantes. Pour obtenir des exemples, reportez-vous à la section Exemples dans le document AWS CLI Références des commandes.

Pour afficher les balises des groupe de placement

Utilisez la commande Get-EC2Tag.

Pour décrire les balises d’un groupe de placement spécifique

Utilisez la commande Get-EC2PlacementGroup.

Pour baliser un groupe de placement existant

Utilisez la commande New-EC2Tag.

Pour supprimer une balise d’un groupe de placement

Utilisez la commande Remove-EC2Tag.

Lancement d’instances dans un groupe de placement

Utilisez la commande run-instances et spécifiez le nom du groupe de placement à l’aide du paramètre --placement "GroupName = my-cluster". Dans cet exemple, le groupe de placement est nommé my-cluster.

aws ec2 run-instances --placement "GroupName = my-cluster"

Pour lancer des instances dans une partition spécifique d'un groupe de placement de partitions à l'aide du AWS CLI

Utilisez la commande run-instances et spécifiez le nom du groupe de placement et la partition à l’aide du paramètre --placement "GroupName = HDFS-Group-A, PartitionNumber = 3". Dans cet exemple, le groupe de placement est nommé HDFS-Group-A et il contient 3 partitions.

aws ec2 run-instances --placement "GroupName = HDFS-Group-A, PartitionNumber = 3"

Pour lancer les instances dans un groupe de placement à l’aide d’ AWS Tools for Windows PowerShell

Utilisez la New-EC2Instancecommande et spécifiez le nom du groupe de placement à l'aide du -Placement_GroupName paramètre.

Affichage du nombre de partitions d’une instance dans un groupe de placement de partitions

Utilisez la commande describe-instances et spécifiez le paramètre --instance-id.

aws ec2 describe-instances --instance-id i-0123a456700123456

La réponse inclut les informations sur le placement, notamment le nom du groupe de placement et le nombre de partitions correspondant à l’instance.

"Placement": {
     "AvailabilityZone": "us-east-1c",
     "GroupName": "HDFS-Group-A",
     "PartitionNumber": 3,
     "Tenancy": "default"
}

Filtrage des instances pour un groupe de placement de partitions et un nombre de partitions

Utilisez la commande describe-instances et spécifiez le paramètre --filters avec les filtres placement-group-name et placement-partition-number. Dans cet exemple, le groupe de placement est nommé HDFS-Group-A et il contient 7 partitions.

aws ec2 describe-instances --filters "Name = placement-group-name, Values = HDFS-Group-A" "Name = placement-partition-number, Values = 7"

La réponse répertorie toutes les instances qui figurent dans la partition désignée au sein du groupe de placement spécifié. Voici un exemple de sortie présentant uniquement l’ID et le type d’instance ainsi que les informations sur le placement pour les instances retournées.

"Instances": [
                {   
                    "InstanceId": "i-0a1bc23d4567e8f90",
                    "InstanceType": "r4.large",
                    },
                  
                    "Placement": {
                        "AvailabilityZone": "us-east-1c",
                        "GroupName": "HDFS-Group-A",
                        "PartitionNumber": 7,
                        "Tenancy": "default"
                    }

                {   
                    "InstanceId": "i-0a9b876cd5d4ef321",
                    "InstanceType": "r4.large",
                    },

                    "Placement": {
                        "AvailabilityZone": "us-east-1c",
                        "GroupName": "HDFS-Group-A",
                        "PartitionNumber": 7,
                        "Tenancy": "default"
                    }
              ],      

Suppression d’un groupe de placement

Utilisez la delete-placement-groupcommande et spécifiez le nom du groupe de placement pour supprimer le groupe de placement. Dans cet exemple, le nom du groupe de placement est my-cluster.

aws ec2 delete-placement-group --group-name my-cluster

Pour supprimer un groupe de placement à l'aide du AWS Tools for Windows PowerShell

Utilisez la Remove-EC2PlacementGroupcommande pour supprimer le groupe de placement.