View a markdown version of this page

Gérez les calendriers à l'aide de l'infrastructure en tant que code (IaC) - Planificateur d'instances sur AWS

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.

Gérez les calendriers à l'aide de l'infrastructure en tant que code (IaC)

Important

Déployez les planifications à l'aide d'un modèle distinct une fois le déploiement de la pile de hubs terminé.

Instance Scheduler sur AWS fournit une ressource personnalisée (ServiceInstanceSchedule) que vous pouvez utiliser pour configurer et gérer les plannings via AWS CloudFormation. La ressource personnalisée utilise des PascalCase clés pour les mêmes données que la table de configuration du planificateur d'instances dans Amazon DynamoDB (voir le modèle ci-dessous pour des exemples). Pour plus d'informations sur les champs relatifs aux horaires, reportez-vous à la section Définitions des horaires. Pour plus d'informations sur les champs relatifs aux périodes, reportez-vous à la section Définitions des périodes.

Lorsque vous utilisez la ressource personnalisée pour créer une planification, le nom de cette planification est le nom de ressource logique de la ressource personnalisée par défaut. Pour spécifier un autre nom, utilisez la propriété Name de la ressource personnalisée. La solution ajoute également le nom de la pile au nom de la planification en tant que préfixe par défaut. Si vous ne souhaitez pas ajouter le nom de la pile en tant que préfixe, utilisez la NoStackPrefix propriété.

Lorsque vous utilisez le nom et les NoStackPrefix propriétés, assurez-vous de choisir des noms de planification uniques. Si un calendrier portant le même nom existe déjà, la ressource ne sera ni créée ni mise à jour.

Pour commencer à gérer les horaires à l'aide d'IaC, copiez et collez l'exemple de modèle suivant et personnalisez autant ou aussi peu de programmes que vous le souhaitez. Enregistrez le fichier en tant que fichier .template (par exemple :my-schedules.template), puis déployez votre nouveau modèle à l'aide d'AWS CloudFormation. Pour des exemples de modèles de calendrier complétés, reportez-vous à la section Exemples de calendriers.

AWSTemplateFormatVersion: 2010-09-09
Parameters:
  ServiceInstanceScheduleServiceTokenARN:
    Type: String
    Description: (Required) service token arn taken from InstanceScheduler outputs
Metadata:
  'AWS::CloudFormation::Designer': {}
Resources:
  SampleSchedule1:
    Type: 'Custom::ServiceInstanceSchedule'
    Properties:
      ServiceToken: !Ref ServiceInstanceScheduleServiceTokenARN #do not edit this line
      NoStackPrefix: 'False'
      Name: my-renamed-sample-schedule
      Description: a full sample template for creating cfn schedules showing all possible values
      Timezone: America/New_York
      Enforced: 'True'
      Hibernate: 'True'
      RetainRunning: 'True'
      StopNewInstances: 'True'
      UseMaintenanceWindow: 'True'
      SsmMaintenanceWindow: 'my_window_name'
      Periods:
      - Description: run from 9-5 on the first 3 days of March
        BeginTime: '9:00'
        EndTime: '17:00'
        InstanceType: 't2.micro'
        MonthDays: '1-3'
        Months: '3'
      - Description: run from 2pm-5pm on the weekends
        BeginTime: '14:00'
        EndTime: '17:00'
        InstanceType: 't2.micro'
        WeekDays: 'Sat-Sun'

  SampleSchedule2:
    Type: 'Custom::ServiceInstanceSchedule'
    Properties:
      ServiceToken: !Ref ServiceInstanceScheduleServiceTokenARN #do not edit this line
      NoStackPrefix: 'True'
      Description: a sample template for creating simple cfn schedules
      Timezone: Europe/Amsterdam
      Periods:
      - Description: stop at 5pm every day
        EndTime: '17:00'

Lors du déploiement du modèle, vous devez fournir un ServiceToken ARN pour votre déploiement d'Instance Scheduler sur AWS. Cet ARN peut être trouvé à l'intérieur CloudFormation en accédant à votre pile de planificateurs d'instances déployée, en sélectionnant Sorties et en recherchant ServiceInstanceScheduleServiceToken.

Important

N'utilisez pas la console DynamoDB ou l'interface de ligne de commande du planificateur pour supprimer ou modifier des programmes et des périodes configurés à l'aide de la ressource personnalisée. Si vous le faites, vous allez créer un conflit entre les paramètres stockés dans la pile et les valeurs du tableau. N'utilisez pas non plus de périodes configurées à l'aide de la ressource personnalisée dans les planifications créées à l'aide de la console DynamoDB ou de l'interface de ligne de commande du planificateur.

Avant de supprimer la pile Instance Scheduler principale, vous devez supprimer toutes les piles supplémentaires qui contiennent des planifications et des périodes créées à l'aide de la ressource personnalisée, car les piles de ressources personnalisées contiennent des dépendances par rapport à la table DynamoDB de la pile principale.

Dans la table de configuration DynamoDB, les horaires et les périodes qui ont été configurés avec la ressource personnalisée peuvent être identifiés par l'attribut configured_in_stack. L'attribut contient le nom de ressource Amazon de la pile qui a été utilisée pour créer l'article.