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.

Cas d'utilisation de Resource Tagger dans AMS Accelerate

Cette section répertorie les actions fréquemment effectuées avec Resource Tagger.

Afficher les balises appliquées par Resource Tagger

Toutes les balises appliquées par Resource Tagger ont le préfixe de clé ams:rt :. Par exemple, la définition de balise suivante génère une balise avec la clé AMS:RT:SampleKey et la valeur SampleValue. Toutes les balises portant ce préfixe sont considérées comme faisant partie de Resource Tagger.

{
	"Key": "sampleKey",
	"Value": "sampleValue"
}

Utilisation de Resource Tagger pour créer des balises

Le tagger de ressources AMS Accelerate est un composant qui est déployé dans votre compte lors de l'intégration d'AMS Accelerate. Resource Tagger dispose d'un ensemble de règles configurables qui définissent la manière dont vos ressources doivent être étiquetées, puis il applique ces règles, en ajoutant et en supprimant automatiquement des balises sur les ressources pour garantir leur conformité à vos règles.

Si vous souhaitez utiliser le Resource Tagger pour étiqueter vos ressources, consultezAccélérez Resource Tagger.

Voici un exemple d'extrait de configuration de Resource Tagger qui ajoute la balise ams:rt:ams-managed avec la valeur true à toutes les instances Amazon. EC2 La balise ams:rt:ams-managed vous permet de faire surveiller vos ressources par AMS Accelerate.

{
    "AWS::EC2::Instance": {
        "SampleConfigurationBlock": {
            "Enabled": true,
            "Filter": {
                "Platform": "*"
            },
            "Tags": [
                {
                    "Key": "ams:rt:ams-managed",
                    "Value": "true"
                }
            ]
        }
    }
}

Empêcher le Resource Tagger de modifier les ressources

Le Resource Tagger peut être configuré sur un mode lecture seule qui l'empêche d'ajouter ou de supprimer des balises sur vos ressources. Cela est utile si vous souhaitez fournir votre propre mécanisme de balisage.

En mode lecture seule, Resource Tagger examine toujours les règles de balisage spécifiées dans les profils de configuration gérés et clients, et recherche les ressources qui ne respectent pas ces règles de balisage. Toutes les ressources non conformes sont signalées. AWS Config Celui AWS Config Rules que vous pouvez rechercher a le AMSResourceTagger- préfixe. Par exemple, la AMSResourceTagger-EC2Instance AWS Config règle évalue si des balises appropriées sont créées pour les AWS::EC2::Instance ressources en fonction du profil de configuration.

Resource Tagger s'arrête à ce stade et n'apporte aucune modification à vos ressources (il n'ajoute ni ne supprime de balises).

Vous pouvez activer le mode lecture seule en modifiant le profil de configuration client pour inclure la ReadOnlyclé dans le bloc Options. Par exemple, l'extrait de profil de configuration suivant montre à quoi cela pourrait ressembler :

{
    "Options": {
        "ReadOnly": true
    },
    "AWS::EC2::Instance": {
        [... the rest of your configuration ...]
    }
}

Resource Tagger réagira à cette nouvelle configuration dès la fin du déploiement et cessera d'ajouter et de supprimer des balises sur les ressources.

Pour en savoir plus sur le paramètre OptionsSyntaxe et structure, reportez-vous à la section suivante.

Exemple de profil de configuration

L'exemple de document de profil suivant indique que toutes les EC2 instances Windows faisant partie d'une CloudFormation pile stack-* doivent être gérées par AMS Accelerate ; il exclut toutefois explicitement une EC2 instance particulière portant l'ID i-00000000000000001.

{
    "AWS::EC2::Instance": {
        "AMSMonitoringWindows": {
            "Enabled": true,
            "Filter": {  
                "Fn::AND": [
                    {
                        "Platform": "Windows"
                    },
                    {
                        "Tag": {
                            "Key": "aws:cloudformation:stack-name",
                            "Value": "stack-*"
                        }
                    },
                    {
                        "Fn::NOT": {
                            "InstanceId": "i-00000000000000001"
                        }
                    }
                ]
            },
            "Tags": [
                {
                    "Key": "ams:rt:ams-managed",
                    "Value": "true"
                }
            ]
        }
    }
}

Fusion de la configuration par défaut

Le profil de configuration par défaut est fourni par AMS Accelerate au moment de l'enregistrement du compte. Ce profil fournit des règles par défaut qui sont déployées dans votre compte.

Bien que vous ne puissiez pas modifier le profil de configuration par défaut, vous pouvez remplacer les paramètres par défaut en spécifiant un bloc de configuration dans votre profil de configuration personnalisé avec le même identifiant de configuration que le bloc de configuration par défaut. Dans ce cas, votre bloc de configuration remplace le bloc de configuration par défaut.

Par exemple, considérez le document de configuration par défaut suivant :

{
	"AWS::EC2::Instance": {
		"AMSManagedBlock1": {
			"Enabled": true,
			"Filter": {
				"Platform": "Windows"
			},
			"Tags": [{
				"Key": "my-tag",
				"Value": "SampleValueA"
			}]
		}
	}
}

Pour modifier la valeur de balise appliquée ici de SampleValueA à SampleValueB et appliquer la balise à toutes les instances, et pas uniquement aux instances Windows, vous devez fournir le profil de configuration de personnalisation suivant :

{
	"AWS::EC2::Instance": {
		"AMSManagedBlock1": {
			"Enabled": true,
			"Filter": {
				"Platform": "*"
			},
			"Tags": [{
				"Key": "my-tag",
				"Value": "SampleValueB"
			}]
		}
	}
}

Désactivation de la configuration par défaut

Vous pouvez désactiver une règle de configuration par défaut en ajoutant un bloc de configuration avec le même identifiant de configuration à votre profil de configuration personnalisé et en attribuant au champ Enabled la valeur false.

Par exemple, si la configuration suivante était présente dans le profil de configuration par défaut :

{
	"AWS::EC2::Instance": {
		"AMSManagedBlock1": {
			"Enabled": true,
			"Filter": {
				"Platform": "Windows"
			},
			"Tags": [{
				"Key": "my-tag",
				"Value": "SampleValueA"
			}]
		}
	}
}

Vous pouvez désactiver cette règle de balisage en incluant les éléments suivants dans votre profil de configuration de personnalisation :

{
	"AWS::EC2::Instance": {
		"AMSManagedBlock1": {
			"Enabled": false
		}
	}
}

Suppression des balises appliquées par Resource Tagger

Toutes les balises préfixées par ams:rt sont supprimées par Resource Tagger si elles n'existent pas dans les profils de configuration ou, si elles existent, si le filtre ne correspond pas. Cela signifie que vous pouvez supprimer les balises appliquées par Resource Tagger en effectuant l'une des opérations suivantes :

Par exemple : si une instance Linux possède les balises suivantes :

"Tags": [{
    "Key": "ams:rt:MyOwnTag",
    "Value": true
},{
    "Key": "myTag",
    "Value": true
}]

Et vous déployez le profil de configuration de Resource Tagger suivant :

{
    "AWS::EC2::Instance": {
        "AMSMonitoringWindows": {
            "Enabled": true,
            "Filter": {
                "Platform": "Windows"
            },
            "Tags": [{
                "Key": "ams:rt:ams-managed",
                "Value": "true"
            }]
        }
    }
}

Resource Tagger réagit aux nouvelles modifications de configuration et la seule balise de l'instance devient :

 "Tags": [{
     "Key": "myTag",
     "Value": true
 }]

Afficher ou modifier la configuration du Resource Tagger

Les deux profils de configuration JSON, AMSManagedTags et CustomerManagedTags, déployés sur votre compte dans AWS AppConfig lors de l'intégration et du stockage dans l'application AMSResource Tagger, ainsi que dans l'AMSInfrastructureenvironnement, peuvent être consultés via AppConfig l'GetConfigurationAPI.

Voici un exemple de cet GetConfiguration appel :

aws appconfig get-configuration 
 --application AMSResourceTagger 
 --environment AMSInfrastructure 
 --configuration AMSManagedTags 
 --client-id ANY_STRING
 outfile.json 

Application : unité AppConfig logique fournissant des fonctionnalités, pour le Resource Tagger, il s'agit de AMSResource Tagger.

Les définitions des alarmes peuvent ensuite être consultées dans le fichier de sortie spécifié, dans ce cas, outfile.json.

Vous pouvez voir quelle version de configuration est déployée sur votre compte en consultant les déploiements antérieurs dans l'AMSInfrastructureenvironnement.

Pour contourner les règles relatives aux balises, procédez comme suit :

Toutes les règles de balise existantes peuvent être remplacées en mettant à jour le profil de personnalisation avec AWS CloudFormation Déploiement d'un profil de configuration avec AWS CloudFormation for Accelerate ou directement à l'aide de l'API AppConfig d'CreateHostedConfigurationVersionutilisation. L'utilisation du même identifiant de configuration comme règle de balise de configuration par défaut remplace la règle par défaut et applique la règle personnalisée à sa place.

Pour déployer les modifications apportées au CustomerManagedTagsdocument :

Après avoir apporté des modifications au profil de configuration de personnalisation, vous devez déployer les modifications correspondantes. Pour déployer les nouvelles modifications, AppConfig l'StartDeploymentAPI doit être exécutée à l'aide de la AWS AppConfig console ou de la CLI.

Déploiement des modifications de configuration

Une fois la personnalisation terminée, ces modifications doivent être déployées via l' AWS AppConfig StartDeploymentAPI. Les instructions suivantes indiquent comment effectuer un déploiement à l'aide du AWS CLI. Vous pouvez également utiliser le AWS Management Console pour effectuer ces modifications. Pour plus d'informations, voir Étape 5 : Déploiement d'une configuration.

aws appconfig start-deployment
--application-id <application_id>
--environment-id <environment_id>
--deployment-strategy-id <deployment_strategy_id>
--configuration-profile-id <configuration_profile_id>
--configuration-version 1

Limitez l'accès au déploiement StartDeploymentet aux actions de l'StopDeploymentAPI aux utilisateurs de confiance qui comprennent les responsabilités et les conséquences du déploiement d'une nouvelle configuration sur vos cibles.

Pour en savoir plus sur l'utilisation AWS AppConfig des fonctionnalités pour créer et déployer une configuration, consultez la documentation sur Travailler avec AWS AppConfig.

Configuration de Terraform pour ignorer les balises Resource Tagger

Si vous utilisez Terraform pour approvisionner vos ressources et que vous souhaitez utiliser Resource Tagger pour étiqueter vos ressources, les balises Resource Tagger peuvent être identifiées comme dérivées par Terraform.

Vous pouvez configurer Terraform pour ignorer toutes les balises Resource Tagger à l'aide du bloc de configuration du cycle de vie ou du bloc de configuration global ignore_tags. Pour plus d'informations, consultez la documentation Terraform sur le balisage des ressources lors du balisage des ressources.

L'exemple suivant montre comment créer une configuration globale pour ignorer toutes les balises commençant par le préfixe ams:rt: de balise Resource Tagger :

provider "aws" {
  # ... potentially other configuration ...

  ignore_tags {
    key_prefixes = ["ams:rt:"]
  }
}

Afficher le nombre de ressources gérées par Resource Tagger

Resource Tagger envoie des métriques toutes les heures à Amazon CloudWatch, dans l'espace de AMS/ResourceTagger noms. Les métriques sont émises uniquement pour les types de ressources pris en charge par Resource Tagger.

Ces statistiques sont également consultables sous forme de graphiques, dans le tableau de bord AMS-Resource-Tagger-Reporting-Dashboard. Pour voir le tableau de bord, depuis la console de CloudWatch gestion Amazon, sélectionnez AMS-Resource-Tagger-Reporting-Dashboard. Par défaut, les graphiques de ce tableau de bord affichent les données de la période de 12 heures précédente.

AMS Accelerate déploie des CloudWatch alarmes sur votre compte pour détecter les augmentations significatives du nombre de ressources non gérées, par exemple les ressources exclues de la gestion par AMS Resource Tagger. AMS Operations étudiera les augmentations des ressources non gérées qui dépassent : soit trois ressources du même type, soit une augmentation de 50 % par rapport à toutes les ressources du même type. Si le changement ne semble pas être délibéré, AMS Operations peut vous contacter pour examiner le changement.