Améliorez les performances opérationnelles en activant Amazon DevOps Guru sur plusieurs régions, comptes et unités d'organisation AWS avec le kit AWS CDK

Configurez les profils nommés AWS.

Configurez vos profils nommés AWS comme suit pour déployer des stacks dans un environnement multi-comptes.

Pour le compte administrateur :

$aws configure --profile administrator
AWS Access Key ID [****]: <your-administrator-access-key-ID>
AWS Secret Access Key [****]: <your-administrator-secret-access-key>
Default region name [None]: <your-administrator-region>
Default output format [None]: json

Pour le compte cible :

$aws configure --profile target
AWS Access Key ID [****: <your-target-access-key-ID>
AWS Secret Access Key [****]: <your-target-secret-access-key>
Default region name [None]: <your-target-region>
Default output format [None]: json

Pour plus d'informations, consultez la section Utilisation de profils nommés dans la documentation de l'AWS CLI.

Vérifiez les configurations des profils AWS.

(Facultatif) Vous pouvez vérifier les configurations de votre profil AWS dans les config fichiers credentials et en suivant les instructions de la section Définir et afficher les paramètres de configuration dans la documentation de l'AWS CLI.

Vérifiez la version du kit AWS CDK.

Vérifiez la version du kit d'outils AWS CDK en exécutant la commande suivante :

$cdk --version

Ce modèle nécessite la version 1.107.0 ou ultérieure. Si vous disposez d'une version antérieure du CDK AWS, suivez les instructions de la documentation du CDK AWS pour la mettre à jour.

Clonez le code du projet.

Clonez le GitHub référentiel pour ce modèle à l'aide de la commande :

$git clone https://github.com/aws-samples/amazon-devopsguru-cdk-samples.git

Installez les dépendances du package et compilez les TypeScript fichiers.

Installez les dépendances du package et compilez les TypeScript fichiers en exécutant les commandes suivantes :

$cd amazon-devopsguru-cdk-samples
$npm install
$npm fund

Ces commandes installent tous les packages du référentiel d'échantillons.

Important : Si vous recevez des erreurs concernant des packages manquants, utilisez l'une des commandes suivantes :

$npm ci

—ou—

$npm install -g @aws-cdk/<package-name>

Vous trouverez la liste des noms et des versions des packages dans la Dependencies section du /amazon-devopsguru-cdk-samples/package.json fichier. Pour plus d'informations, consultez npm ci et npm install dans la documentation de npm.

Configurez une adresse e-mail pour les notifications Amazon SNS.

Suivez ces étapes pour fournir une adresse e-mail pour les notifications Amazon SNS :

Créez le code du projet.

Créez le code du projet et synthétisez les piles en exécutant la commande suivante :

npm run build && cdk synth 

Vous devez voir des résultats similaires à ce qui suit : 

$npm run build && cdk synth
> cdk-devopsguru@0.1.0 build
> tsc
Successfully synthesized to ~/amazon-devopsguru-cdk-samples/cdk.out
Supply a stack id (CdkDevopsGuruStackMultiAccReg,CdkDevopsGuruStackMultiAccRegSpecStacks, CdkDevopsguruStackOrgUnit, CdkInfrastructureStack, CdkStackSetAdminRole, CdkStackSetExecRole) to display its template.

Pour plus d'informations et pour connaître les étapes à suivre, consultez Votre première application AWS CDK dans la documentation AWS CDK.

Répertoriez les piles AWS CDK.

Exécutez la commande suivante pour répertorier toutes les piles AWS CDK :

$cdk list

La commande affiche la liste suivante :

CdkDevopsGuruStackMultiAccReg
CdkDevopsGuruStackMultiAccRegSpecStacks
CdkDevopsguruStackOrgUnit
CdkInfrastructureStack
CdkStackSetAdminRole
CdkStackSetExecRole

Déployez les piles AWS CDK pour créer des rôles IAM.

Ce modèle utilise AWS CloudFormation StackSets pour effectuer des opérations de stack sur plusieurs comptes. Si vous créez votre premier stack set, vous devez créer les rôles IAM suivants pour obtenir les autorisations requises configurées dans vos comptes AWS :

Remarque : Les rôles doivent porter ces noms exacts.

Pour plus d'informations, consultez la section Accorder des autorisations autogérées dans la CloudFormation documentation AWS.

Déployez la pile AWS CDK pour activer DevOps Guru sur plusieurs comptes.

La CdkDevopsGuruStackMultiAccReg pile AWS CDK crée des ensembles de piles pour déployer des instances de pile sur plusieurs comptes et régions. Pour déployer la pile, exécutez la commande CLI suivante avec les paramètres spécifiés :

$cdk deploy CdkDevopsGuruStackMultiAccReg \
  --profile administrator \
  --parameters AdministratorAccountId=<administrator-account-ID> \
  --parameters TargetAccountId=<target-account-ID> \
  --parameters RegionIds="<region-1>,<region-2>"

Amazon DevOps Guru est actuellement disponible dans les régions AWS répertoriées dans la FAQ DevOps Guru.

Extrayez les identifiants UO.

Sur la console AWS Organizations, identifiez les ID des unités organisationnelles dans lesquelles vous souhaitez activer DevOps Guru.

Activez les autorisations gérées par les services pour les unités d'organisation.

Si vous utilisez AWS Organizations pour la gestion de votre compte, vous devez accorder des autorisations gérées par le service pour activer DevOps Guru. Au lieu de créer les rôles IAM manuellement, utilisez un accès sécurisé et des rôles liés à un service (SLR) basés sur l'organisation.

Déployez la pile AWS CDK pour activer DevOps Guru dans toutes les unités d'organisation.

La CdkDevopsguruStackOrgUnit pile AWS CDK active le service DevOps Guru dans toutes les unités d'organisation. Pour déployer la pile, exécutez la commande suivante avec les paramètres spécifiés :

$cdk deploy CdkDevopsguruStackOrgUnit \
  --profile administrator \ 
  --parameters RegionIds="<region-1>,<region-2>" \
  --parameters OrganizationalUnitIds="<OU-1>,<OU-2>"

Déployez les piles AWS CDK pour créer des rôles IAM.

Si vous n'avez pas encore créé les rôles IAM requis indiqués dans la première option, faites-le d'abord :

Pour plus d'informations, consultez la section Accorder des autorisations autogérées dans la CloudFormation documentation AWS.

Supprimez les piles existantes.

Si vous avez déjà utilisé la première option pour activer DevOps Guru pour toutes les ressources de la pile, vous pouvez supprimer l'ancienne pile en utilisant la commande suivante :

$cdk destroy CdkDevopsGuruStackMultiAccReg --profile administrator 

Vous pouvez également modifier le  RegionIds paramètre lorsque vous redéployez la pile pour éviter une erreur Stacks already exist.

Mettez à jour la pile AWS CDK avec une liste de piles.

Déployez la pile AWS CDK pour permettre à DevOps Guru d'accéder à des ressources de pile spécifiques sur plusieurs comptes.

La CdkDevopsGuruStackMultiAccRegSpecStacks pile AWS CDK permet à DevOps Guru d'accéder à des ressources de pile spécifiques sur plusieurs comptes. Pour déployer la pile, exécutez la commande suivante :

$cdk deploy CdkDevopsGuruStackMultiAccRegSpecStacks \
  --profile administrator  \
  --parameters AdministratorAccountId=<administrator-account-ID> \
  --parameters TargetAccountId=<target-account-ID> \
  --parameters RegionIds="<region-1>,<region-2>"

Remarque : Si vous avez déjà déployé cette pile pour l'option 1, modifiez le RegionIds paramètre (en veillant à choisir parmi les régions disponibles) pour éviter une erreur Stacks already exist.

Déployez l'exemple de pile d'infrastructure sans serveur.

La CdkInfrastructureStack pile AWS CDK déploie des composants sans serveur tels qu'API Gateway, Lambda et une table DynamoDB pour illustrer les connaissances de Guru. DevOps Pour déployer la pile, exécutez la commande suivante : 

$cdk deploy CdkInfrastructureStack --profile administrator

Insérez des exemples d'enregistrements dans DynamoDB.

Exécutez la commande suivante pour remplir la table DynamoDB avec des exemples d'enregistrements. Indiquez le chemin correct pour le populate-shops-dynamodb-table.json script.

$aws dynamodb batch-write-item \
  --request-items file://scripts/populate-shops-dynamodb-table.json \
  --profile administrator

La commande affiche la sortie suivante :

{
    "UnprocessedItems": {}
}

Vérifiez les enregistrements insérés dans DynamoDB.

Pour vérifier que la table DynamoDB inclut les exemples d'enregistrements du fichier, accédez à populate-shops-dynamodb-table.json l'URL de ListRestApiEndpointMonitorOperator l'API, qui est publiée en tant que sortie de la pile AWS CDK. Vous pouvez également trouver cette URL dans l'onglet Outputs de la CloudFormation console AWS pour la CdkInfrastructureStack pile. La sortie du AWS CDK ressemblerait à ce qui suit :

CdkInfrastructureStack.CreateRestApiMonitorOperatorEndpointD1D00045 = https://oure17c5vob.execute-api.<your-region>.amazonaws.com/prod/

CdkInfrastructureStack.ListRestApiMonitorOperatorEndpointABBDB8D8 = https://cdff8icfrn4.execute-api.<your-region>.amazonaws.com/prod/

Attendez que les ressources aient terminé la définition de base.

Cette pile sans serveur dispose de quelques ressources. Nous vous recommandons d'attendre 2 heures avant de passer aux étapes suivantes. Si vous avez déployé cette pile dans un environnement de production, l'établissement de la base de référence peut prendre jusqu'à 24 heures, en fonction du nombre de ressources que vous avez sélectionné pour surveiller dans DevOps Guru.

Mettez à jour la pile d'infrastructure AWS CDK.

Pour essayer DevOps Guru Insights, vous pouvez apporter des modifications de configuration afin de reproduire un problème de fonctionnement typique.

Injectez des requêtes HTTP sur l'API.

Injectez du trafic entrant sous forme de requêtes HTTP sur l'ListRestApiMonitorOperatorEndpointxxxxAPI :

Passez en revue DevOps Guru Insights.

Dans des conditions standard, le tableau de bord DevOps Guru affiche zéro dans le compteur d'informations continues. S'il détecte une anomalie, il déclenche une alerte sous forme d'aperçu. Dans le volet de navigation, choisissez Insights pour voir les détails de l'anomalie, notamment une vue d'ensemble, des mesures agrégées, des événements pertinents et des recommandations. Pour plus d'informations sur l'examen des informations, consultez le billet de blog Obtenir des informations opérationnelles grâce à l'AIOps à l'aide d'Amazon DevOps Guru.

Nettoyez et supprimez les ressources.

Après avoir suivi ce schéma, vous devez supprimer les ressources que vous avez créées pour éviter d'encourir des frais supplémentaires. Exécutez les commandes suivantes :

$cdk destroy CdkDevopsGuruStackMultiAccReg --profile administrator
$cdk destroy CdkDevopsguruStackOrgUnit --profile administrator
$cdk destroy CdkDevopsGuruStackMultiAccRegSpecStacks --profile administrator
$cdk destroy CdkInfrastructureStack --profile administrator
$cdk destroy CdkStackSetAdminRole --profile administrator
$cdk destroy CdkStackSetExecRole --profile administrator
$cdk destroy CdkStackSetExecRole --profile target