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.

Effectuer des mises à jour sécurisées de Canary

CloudWatch Synthetics Safe Canary Updates vous permet de tester les mises à jour sur vos canaris existants avant d'appliquer les modifications. Cette fonctionnalité vous permet de valider la compatibilité de Canary avec les nouveaux temps d'exécution et les autres modifications de configuration telles que les modifications du code ou de la mémoire. Cela permettra de minimiser les perturbations de surveillance potentielles causées par des mises à jour erronées.

En utilisant les mises à jour sécurisées de Canary pour les mises à jour des versions d'exécution, les modifications de configuration et les modifications de scripts de code, vous pouvez atténuer les risques, maintenir une surveillance ininterrompue, vérifier les modifications avant de les valider, les mettre à jour et réduire les temps d'arrêt.

Prérequis

Assurez-vous que les prérequis sont remplis.

Bonnes pratiques

Voici quelques bonnes pratiques à suivre lors de l'exécution d'un canari.

Tester Canary en utilisant un essai à sec

Vous pouvez tester la mise à jour de Canary en utilisant les options suivantes :

Utilisation du flux de travail AWS Management Console's Edit

Utilisation du AWS Management Console pour mettre à jour les canaris par lots

Utilisation de la AWS CLI ou du SDK

L'API lance l'exécution à sec pour le nom canari fourni MyCanary et met à jour la version d'exécution ensyn-nodejs-puppeteer-10.0.

aws synthetics start-canary-dry-run \
    --name MyCanary \
    --runtime-version syn-nodejs-puppeteer-10.0
      
      // Or if you wanted to update other configurations:

aws synthetics start-canary-dry-run \
    --name MyCanary \
    --execution-role-arn arn:aws:iam::123456789012:role/NewRole

L'API renverra l'DryRunIdintérieur duDryRunConfigOutput.

Appelez GetCanary avec le formulaire fourni DryRunId pour recevoir les configurations de cycle à sec du Canary et un champ supplémentaire DryRunConfig contenant l'état du cycle à sec répertorié commeLastDryRunExecutionStatus.

aws synthetics get-canary \
    --name MyCanary \
    --dry-run-id XXXX-XXXX-XXXX-XXXX

Pour plus de détails, utilisez GetCanaryRuns le code fourni DryRunId pour récupérer la course et des informations supplémentaires.

aws synthetics get-canary-runs \
    --name MyCanary \
    --dry-run-id XXXX-XXXX-XXXX-XXXX

Après un séchage réussi, vous pouvez ensuite l'utiliser UpdateCanary avec le logiciel fourni DryRunId afin de valider vos modifications.

aws synthetics update-canary \
    --name MyCanary \
    --dry-run-id XXXX-XXXX-XXXX-XXXX

En cas d'échec pour quelque raison que ce soit (le résultat de GetCanaryRuns contiendra les détails), l'emplacement du résultat GetCanaryRuns contient un artefact contenant les journaux à déboguer. En l'absence de journaux, le cycle à sec n'a pas pu être créé. Vous pouvez valider en utilisantGetCanary.

aws synthetics get-canary \
    --name MyCanary \
    --dry-run-id XXXX-XXXX-XXXX-XXXX

L'état StateReason, et StateReasonCodeaffiche l'état du cycle à sec.

En utilisant AWS CloudFormation

Dans votre modèle pour un Synthetics Canary, indiquez le DryRunAndUpdate champ qui accepte une valeur booléenne ou. true false

lorsque la valeur est égale à true chaque mise à jour, exécute un essai à sec pour valider les modifications avant de mettre automatiquement à jour le canari. Lorsque le dry run échoue, Canary ne se met pas à jour et échoue au déploiement et AWS CloudFormation au déploiement pour une raison valable. Pour résoudre ce problème, utilisez la console AWS Synthetics ou, si vous utilisez une API, procurez-vous l'API et téléchargez ArtifactS3Location les fichiers pour vérifier GetCanaryRuns la présence d'erreurs *-log.txt dans les exécutions de Canary Log. Après validation, modifiez le AWS CloudFormation modèle et réessayez le déploiement ou utilisez l'API ci-dessus pour valider.

Lorsque cette valeur est définiefalse, Synthetics n'exécutera pas de test pour valider les modifications et validera directement vos mises à jour.

Pour plus d'informations sur le dépannage d'un Canary défaillant, consultezDépannage d'un script Canary ayant échoué.

Exemple de modèle.

SyntheticsCanary:
    Type: 'AWS::Synthetics::Canary'
    Properties:
      Name: MyCanary
      RuntimeVersion: syn-nodejs-puppeteer-10.0
      Schedule: {Expression: 'rate(5 minutes)', DurationInSeconds: 3600}
      ...
      DryRunAndUpdate: true

Limites