prise en main d’Azure Automation – State Configuration

Remarque

Avant d’activer Automation State Configuration, sachez qu’une version plus récente de DSC est désormais en disponibilité générale, managée par une fonctionnalité d’Azure Policy nommée configuration Invité. Le service de configuration invité combine les fonctionnalités d’Extension DSC, d’Azure Automation State Configuration, ainsi que les fonctionnalités les plus couramment demandées par les commentaires des clients. La configuration invité comprend également une prise en charge d’ordinateur hybride via des serveurs avec Arc.

Cet article fournit un guide pas à pas pour l’exécution des tâches les plus courantes avec Azure Automation State Configuration, comme la création, l’importation et la compilation de configurations, l’habilitation d’ordinateurs pour la gestion, et la consultation de rapports. Pour une vue d’ensemble de State Configuration, consultez Vue d’ensemble de State Configuration. Pour accéder à une documentation de Desired State Configuration (DSC), consultez l’article Vue d’ensemble de la fonctionnalité Desired State Configuration de Windows PowerShell.

Si vous souhaitez obtenir un exemple d’environnement préconfiguré sans avoir à suivre les étapes décrites dans cet article, vous pouvez utiliser le modèle Azure Automation Managed Node. Ce modèle configure un environnement State Configuration (DSC) complet, incluant une machine virtuelle Azure gérée par State Configuration (DSC).

Prérequis

Pour exécuter les exemples de cet article, vous devez disposer des éléments suivants :

Création d’une configuration DSC

Vous créez une configuration DSC simple qui garantit la présence ou l’absence de la fonctionnalité Windows Serveur web (IIS), selon le mode d’attribution des nœuds.

Les noms de configuration dans Azure Automation doivent être limités à 100 caractères.

  1. Démarrez VSCode (ou n’importe quel éditeur de texte).

  2. Saisissez le texte suivant :

    configuration TestConfig
    {
        Node IsWebServer
        {
            WindowsFeature IIS
            {
                Ensure               = 'Present'
                Name                 = 'Web-Server'
                IncludeAllSubFeature = $true
            }
        }
    
        Node NotWebServer
        {
            WindowsFeature IIS
            {
                Ensure               = 'Absent'
                Name                 = 'Web-Server'
            }
        }
    }
    
  3. Enregistrez le fichier sous le nom TestConfig.ps1.

Cette configuration appelle une ressource dans chaque bloc de nœuds, la ressource WindowsFeature. Cette ressource garantit la présence ou l'absence de la fonctionnalité Web-Server.

Importer une configuration dans Azure Automation

Ensuite, vous importez la configuration dans le compte Automation.

  1. Connectez-vous au portail Azure.

  2. Sur la gauche, cliquez sur Toutes les ressources, puis sur le nom de votre compte Automation.

  3. Sur la page Compte Automation, sélectionnez State Configuration (DSC) sous Gestion de la configuration.

  4. Sur la page State Configuration (DSC), cliquez sur l'onglet Configurations, puis sur Ajouter.

  5. Sur le volet Importer la configuration, recherchez le fichier TestConfig.ps1 sur votre ordinateur.

    Screenshot of the Import Configuration blade

  6. Cliquez sur OK.

Afficher une configuration dans Azure Automation

Après avoir importé une configuration, vous pouvez l’afficher dans le portail Azure.

  1. Connectez-vous au portail Azure.

  2. Sur la gauche, cliquez sur Toutes les ressources, puis sur le nom de votre compte Automation.

  3. Sur la page Compte Automation, sélectionnez State Configuration (DSC) sous Gestion de la configuration.

  4. Sur la page State Configuration (DSC), cliquez sur l'onglet Configurations, puis sur TestConfig. Il s'agit du nom de la configuration que vous avez importée dans la procédure précédente.

  5. Sur le volet Configuration de TestConfig, cliquez sur Afficher la source de configuration.

    Screenshot of the TestConfig configuration blade

    Le volet source Configuration de TestConfig s'ouvre, affichant le code PowerShell de la configuration.

Compiler une configuration dans Azure Automation

Avant de pouvoir appliquer un état souhaité à un nœud, vous devez compiler une configuration DSC définissant cet état dans une ou plusieurs configurations de nœuds (documents MOF) et la placer sur le serveur Pull Automation DSC. Pour obtenir une description plus détaillée de la compilation des configurations dans State Configuration (DSC), consultez Compiler des configurations dans Azure Automation State Configuration. Pour plus d’informations sur la compilation des configurations, consultez Configurations DSC.

  1. Connectez-vous au portail Azure.

  2. Sur la gauche, cliquez sur Toutes les ressources, puis sur le nom de votre compte Automation.

  3. Sur la page Compte Automation, cliquez sur State Configuration (DSC) sous Gestion de la configuration.

  4. Sur la page State Configuration (DSC), cliquez sur l'onglet Configurations, puis sur TestConfig. Il s'agit du nom de la configuration précédemment importée.

  5. Sur le volet Configuration de TestConfig, cliquez sur Compiler, puis sur Oui. Une tâche de compilation démarre.

    Screenshot of the TestConfig configuration page highlighting compile button

Remarque

Lorsque vous compilez une configuration dans Azure Automation, tous les fichiers MOF de configuration de nœud créés sont automatiquement déployés sur le serveur Pull.

Afficher une tâche de compilation

Après avoir démarré une compilation, vous pouvez l'afficher sur la mosaïque Travaux de compilation de la page Configuration. La mosaïque Tâches de compilation affiche les tâches en cours d’exécution, terminées et en échec. Lorsque vous ouvrez le volet d'une tâche de compilation, vous obtenez des informations sur cette tâche, notamment les erreurs ou les avertissements rencontrés, les paramètres d'entrée utilisés dans la configuration et les journaux de compilation.

  1. Connectez-vous au portail Azure.

  2. Sur la gauche, cliquez sur Toutes les ressources, puis sur le nom de votre compte Automation.

  3. Sur la page Compte Automation, cliquez sur State Configuration (DSC) sous Gestion de la configuration.

  4. Sur la page State Configuration (DSC), cliquez sur l'onglet Configurations, puis sur TestConfig. Il s'agit du nom de la configuration précédemment importée.

  5. Sous Tâches de compilation, sélectionnez la tâche de compilation à afficher. Un volet Tâche de compilation s'ouvre en indiquant la date de démarrage de la tâche.

    Screenshot of the Compilation Job page

  6. Cliquez sur n'importe quelle mosaïque du volet Tâche de compilation pour afficher des détails supplémentaires sur la tâche.

Afficher des configurations de nœud

La réussite d’une tâche de compilation a pour effet de créer une ou plusieurs configurations de nœud. Une configuration de nœud est un document MOF déployé sur le serveur Pull et prêt à être extrait et appliqué par un ou plusieurs nœuds. Vous pouvez afficher les configurations de nœuds de votre compte Automation sur la page State Configuration (DSC). Le nom d'une configuration de nœud se présente sous la forme ConfigurationName.NodeName.

  1. Connectez-vous au portail Azure.

  2. Sur la gauche, cliquez sur Toutes les ressources, puis sur le nom de votre compte Automation.

  3. Sur la page Compte Automation, cliquez sur State Configuration (DSC) sous Gestion de la configuration.

  4. Sur la page State Configuration (DSC), cliquez sur l'onglet Configurations compilées.

    Screenshot of the Compiled Configurations tab

Activer une machine virtuelle Azure Resource Manager pour la gestion avec State Configuration

State Configuration vous permet de gérer vos machines virtuelles Azure (par le biais des modèles de déploiement classique et Resource Manager), vos machines virtuelles locales, vos machines Linux, vos machines virtuelles AWS et vos ordinateurs physiques locaux. Cet article explique comment n’intégrer que des machines virtuelles Azure Resource Manager. Pour plus d’informations sur l’intégration d’autres types de machines, consultez Activer la gestion des machines par Azure Automation State Configuration.

  1. Connectez-vous au portail Azure.

  2. Sur la gauche, cliquez sur Toutes les ressources, puis sur le nom de votre compte Automation.

  3. Sur la page Compte Automation, cliquez sur State Configuration (DSC) sous Gestion de la configuration.

  4. Sur la page State Configuration (DSC), sélectionnez l'onglet Nœuds, puis cliquez sur + Ajouter.

    Screenshot of the DSC Nodes page highlighting the Add Azure VM button

  5. Sur le volet Machines virtuelles, sélectionnez votre machine virtuelle.

  6. Sur le volet d'informations de la machine virtuelle, cliquez sur + Connecter.

    Important

    Il doit s'agir d'une machine virtuelle Azure Resource Manager exécutant un système d'exploitation pris en charge.

  7. Sur la page Inscription, sélectionnez le nom de la configuration de nœud à appliquer à la machine virtuelle dans la zone Nom de la configuration de nœud. Vous n’êtes pas obligé de fournir un nom à ce stade. Vous pouvez modifier la configuration de nœud assignée une fois le nœud activé.

  8. Cochez la case Redémarrer le nœud si nécessaire, puis cliquez sur OK.

    Screenshot of the Registration blade

    La configuration de nœud que vous avez spécifiée est appliquée à la machine virtuelle aux intervalles spécifiés par la valeur fournie pour le paramètre Fréquence du mode de configuration. La machine virtuelle recherche les mises à jour de la configuration de nœud aux intervalles spécifiés par la valeur du paramètre Fréquence d'actualisation. Pour plus d’informations sur la façon dont ces valeurs sont utilisées, consultez Configuration du Gestionnaire de configuration local.

Azure lance le processus d’activation de la machine virtuelle. Au terme de ce processus, la machine virtuelle apparaît dans l'onglet Nœuds de la page State Configuration (DSC) du compte Automation.

Afficher la liste des nœuds gérés

Vous pouvez afficher la liste de tous les ordinateurs habilités à gérer dans votre compte Automation sous l'onglet Nœuds de la page State Configuration (DSC).

  1. Connectez-vous au portail Azure.
  2. Sur la gauche, cliquez sur Toutes les ressources, puis sur le nom de votre compte Automation.
  3. Sur la page Compte Automation, cliquez sur State Configuration (DSC) sous Gestion de la configuration.
  4. Sur la page State Configuration (DSC), cliquez sur l'onglet Nœuds.

Valeurs d’état des nœuds DSC

Le nœud DSC peut prendre l’une des six valeurs suivantes, comme suit :

  • Échec : cet état s’affiche lorsqu’une erreur se produit lors de l’application d’une ou de plusieurs configurations sur un nœud.
  • Non conforme : cet état s’affiche lorsqu’une dérive se produit sur un nœud et nécessite une révision approfondie si elle est systématique.
  • Ne répond pas : cet état s’affiche lorsqu’un nœud n’a pas été archivé depuis plus de 24 heures.
  • En attente : cet état s’affiche lorsqu’un nœud a une nouvelle configuration à appliquer et que le serveur Pull attend l’archivage du nœud.
  • En cours : cet état s’affiche lorsqu’un nœud applique la configuration et que le serveur Pull attend l’état.
  • Conforme : cet état s’affiche lorsqu’un nœud a une configuration valide et qu’aucune dérive ne se produit actuellement.

Remarque

  • RefreshFrequencyMins : définit la fréquence à laquelle le nœud contacte le service d’agent et peut être fourni dans le cadre de l’intégration à DSC. La valeur maximale est de 10080 minutes.
  • Le nœud est marqué comme Ne répond pas si le nœud ne contacte pas le service d’agent pendant 1440 minutes (1 jour). Nous vous recommandons d’utiliser une valeur de RefreshFrequencyMins< 1440 minutes, sinon le nœud s’affiche dans un faux état Ne répond pas.

Afficher des rapports pour des nœuds gérés

Chaque fois que State Configuration effectue une vérification de cohérence sur un nœud géré, le nœud renvoie un rapport d’état au serveur Pull. Vous pouvez consulter ces rapports sur la page correspondant à ce nœud.

  1. Connectez-vous au portail Azure.

  2. Sur la gauche, cliquez sur Toutes les ressources, puis sur le nom de votre compte Automation.

  3. Sur la page Compte Automation, cliquez sur State Configuration (DSC) sous Gestion de la configuration.

  4. Sur la page State Configuration (DSC), cliquez sur l'onglet Nœuds. Ici, vous pouvez voir la vue d’ensemble de l’état de la configuration et les détails de chaque nœud.

    Screenshot of Node page

  5. Sur l’onglet Nœuds, cliquez sur l’enregistrement de nœud pour ouvrir les rapports. Cliquez sur le rapport pour lequel vous souhaitez afficher des détails supplémentaires.

    Screenshot of the Report blade

Le panneau d’un rapport vous permet d’accéder aux informations d’état suivantes pour vous permettre d’effectuer la vérification de cohérence correspondante :

  • L'état du rapport. Les valeurs possibles sont les suivantes :
    • Conforme : le nœud est conforme à la vérification.
    • Échec : la vérification de la configuration a échoué.
    • Non conforme : le nœud est en mode ApplyandMonitor et la machine n'est pas à l'état souhaité.
  • L’heure de début de la vérification de cohérence.
  • Le temps total d’exécution de la vérification de cohérence.
  • Le type de vérification de cohérence.
  • Toute erreur rencontrée, avec code d’erreur et message d’erreur.
  • Toutes les ressources DSC utilisées dans la configuration, ainsi que l'état de chaque ressource (si le nœud est à l'état souhaité pour cette ressource). Vous pouvez cliquer sur chaque ressource pour obtenir des informations plus détaillées sur celle-ci.
  • Le nom, l’adresse IP et le mode de configuration du nœud.

Vous pouvez également cliquer sur Afficher le rapport brut pour afficher les données que le nœud envoie effectivement au serveur. Pour plus d’informations sur l’utilisation de ces données, consultez la page Utilisation d’un serveur de rapports DSC.

Il peut s'écouler un certain temps après l'activation d'un nœud avant que le premier rapport soit disponible. Vous devrez peut-être attendre le premier rapport jusqu'à 30 minutes après l’activation d’un nœud.

Réaffecter un nœud à une configuration de nœud différente

Vous pouvez attribuer un nœud à une configuration de nœud différente de celle qui lui a été initialement affectée.

  1. Connectez-vous au portail Azure.

  2. Sur la gauche, cliquez sur Toutes les ressources, puis sur le nom de votre compte Automation.

  3. Sur la page Compte Automation, cliquez sur State Configuration (DSC) sous Gestion de la configuration.

  4. Sur la page State Configuration (DSC), cliquez sur l'onglet Nœuds.

  5. Sous l’onglet Nœuds, cliquez sur le nom du nœud que vous souhaitez réaffecter.

  6. Sur la page de ce nœud, cliquez sur Attribuer une configuration de nœuds.

    Screenshot of the Node details page highlighting the Assign node configuration button

  7. Sur la page Attribuer une configuration de nœud, sélectionnez la configuration de nœud à laquelle vous souhaitez attribuer le nœud, puis cliquez sur OK.

    Screenshot of the Assign Node Configuration page

Désinscrire un nœud

Si vous ne souhaitez plus qu’un nœud soit géré par Azure Automation DSC, vous pouvez le désinscrire. Consultez Supprimer une configuration et un nœud de State Configuration dans Automation.

Étapes suivantes