CISCO crée des modèles pour automatiser le guide de l'utilisateur du logiciel de périphérique

Cisco DNA Center fournit un hub de modèles interactif pour créer des modèles CLI. Vous pouvez facilement concevoir des modèles avec une configuration prédéfinie en utilisant des éléments ou des variables paramétrés. Après avoir créé un modèle, vous pouvez l'utiliser pour déployer vos appareils sur un ou plusieurs sites configurés n'importe où sur votre réseau.
Avec Template Hub, vous pouvez :

View la liste des modèles disponibles.

Créez, modifiez, clonez, importez, exportez et supprimez un modèle.
Filtrez le modèle en fonction du nom du projet, du type de modèle, de la langue du modèle, de la catégorie, de la famille de périphériques, de la série de périphériques, de l'état de validation et de l'état de mise à disposition.

View les attributs suivants du modèle dans la fenêtre Template Hub, sous le tableau Modèles :
- Nom : nom du modèle CLI.
- Projet : projet sous lequel le modèle CLI est créé.
Type : Type de modèle CLI (régulier ou composite).

Version : nombre de versions du modèle CLI.
État de validation : indique si la dernière version du modèle est validée. Tu peux view les informations suivantes dans la colonne État de validation :
- Le plus tempsamp de la dernière date engagée.
- Une icône d'avertissement signifie que le modèle est modifié mais non validé.
- Une icône de coche signifie que la dernière version du modèle est validée.

Note
La dernière version du modèle doit être validée pour provisionner le modèle sur les appareils.

Statut de mise à disposition : vous pouvez view les informations suivantes dans la colonne État de la mise à disposition :
- Nombre d'appareils sur lesquels le modèle est provisionné.
- Une icône de coche affiche le nombre de périphériques pour lesquels le modèle CLI a été provisionné sans aucun échec.
- Une icône d'avertissement affiche le nombre d'appareils pour lesquels la dernière version du modèle CLI n'est pas encore provisionnée.
- Une icône en forme de croix affiche le nombre de périphériques pour lesquels le déploiement du modèle CLI a échoué.
Conflits de conception potentiels : affiche les conflits potentiels dans le modèle CLI.

Réseau Profiles : Affiche le nombre de pro du réseaufiles auxquels un modèle CLI est attaché. Utilisez le lien sous Network ProfileColonne s pour joindre un modèle CLI à Network Profiles.
Actions : cliquez sur les points de suspension sous la colonne Actions pour cloner, valider, supprimer ou modifier un modèle ; modifier un projet ; ou joignez un modèle à un professionnel du réseaufile.

Joindre des modèles à Network Profiles. Pour plus d'informations, consultez Joindre un modèle CLI au Network Pro.files, à la page 10.
View le nombre de réseau profiles auxquels un modèle CLI est attaché.

Ajoutez des commandes interactives.
Enregistrez automatiquement les commandes CLI.

Contrôlez la version des modèles à des fins de suivi.
Tu peux view les versions d’un modèle CLI. Dans la fenêtre Template Hub, cliquez sur le nom du modèle, puis sur l'onglet Historique des modèles pour view la version modèle.
Détectez les erreurs dans les modèles.

Simulez des modèles.
Définir des variables.
Détectez les conflits de conception et d’exécution potentiels.

Note
Veillez à ce que votre modèle n'écrase pas une configuration d'intention réseau poussée par Cisco DNA Center.

Créer des projets

Étape 1 Cliquez sur l'icône de menu () et choisissez Outils> Template Hub.
Étape 2 Cliquez sur Ajouter dans le coin supérieur droit de la fenêtre et choisissez Nouveau projet dans la liste déroulante. Le volet coulissant Ajouter un nouveau projet s'affiche.
Étape 3 Entrez un nom unique dans le champ Nom du projet.
Étape 4 (Facultatif) Saisissez une description du projet dans le champ Description du projet.
Étape 5 Cliquez sur Continuer.
Le projet est créé et apparaît dans le volet de gauche.

Que faire ensuite
Ajoutez un nouveau modèle au projet. Pour plus d'informations, consultez Créer un modèle standard, à la page 3 et Créer un modèle composite, à la page 5.

Créer des modèles

Les modèles fournissent une méthode permettant de prédéfinir facilement des configurations à l'aide d'éléments de paramètres et de variables.
Les modèles permettent à un administrateur de définir une configuration de commandes CLI pouvant être utilisées pour configurer de manière cohérente plusieurs périphériques réseau, réduisant ainsi le temps de déploiement. Les variables du modèle permettent de personnaliser des paramètres spécifiques par appareil.

Créer un modèle régulier

Étape 1 Cliquez sur l'icône de menu () et choisissez Outils> Template Hub.
Note Par défaut, le projet Onboarding Configuration est disponible pour créer des modèles jour 0. Vous pouvez créer vos propres projets personnalisés. Les modèles créés dans des projets personnalisés sont classés comme modèles jour N.
Étape 2 Dans le volet de gauche, cliquez sur Nom du projet et sélectionnez le projet sous lequel vous créez des modèles.
Étape 3 Cliquez sur Ajouter en haut à droite de la fenêtre et choisissez Nouveau modèle dans la liste déroulante.
Note Le modèle que vous créez pour le jour 0 peut également être appliqué pour le jour N.
Étape 4 Dans le volet coulissant Ajouter un nouveau modèle, configurez les paramètres du modèle standard.
Dans la zone Détails du modèle, procédez comme suit :
un. Entrez un nom unique dans le champ Nom du modèle.
b. Choisissez le nom du projet dans la liste déroulante.
c. Type de modèle : cliquez sur le bouton radio Modèle standard.
d. Langue du modèle : choisissez la langue Velocity ou Jinja à utiliser pour le contenu du modèle.

Velocity : utilisez le langage de modèle Velocity (VTL). Pour plus d'informations, voir http://velocity.apache.org/engine/devel/vtl-reference.html.
Le framework de modèles Velocity restreint l'utilisation de variables commençant par un nombre. Assurez-vous que le nom de la variable commence par une lettre et non par un chiffre.
Note N'utilisez pas le signe dollar ($) lorsque vous utilisez les modèles de vélocité. Si vous avez utilisé le signe dollar ($), toute valeur derrière celui-ci est traitée comme une variable. Par exempleample, si un mot de passe est configuré comme « $a123$q1ups1$va112 », alors le Template Hub le traite comme des variables « a123 », « q1ups » et « va112 ».
Pour contourner ce problème, utilisez le style de shell Linux pour le traitement de texte avec les modèles Velocity.
Note Utilisez le signe dollar ($) dans les modèles de vitesse uniquement lors de la déclaration d'une variable.
Jinja : Utilisez la langue Jinja. Pour plus d'informations, voir https://www.palletsprojects.com/p/jinja/.

e. Choisissez le type de logiciel dans la liste déroulante.
Note Vous pouvez sélectionner le type de logiciel spécifique (tel que IOS-XE ou IOS-XR) s'il existe des commandes spécifiques à ces types de logiciels. Si vous sélectionnez IOS comme type de logiciel, les commandes s'appliquent à tous les types de logiciels, y compris IOS-XE et IOS-XR. Cette valeur est utilisée lors du provisionnement pour vérifier si le périphérique sélectionné confirme la sélection dans le modèle.

Dans la zone Détails du type de périphérique, procédez comme suit :
un. Cliquez sur le lien Ajouter des détails sur le périphérique.
b. Choisissez Famille d'appareils dans la liste déroulante.
c. Cliquez sur l'onglet Série de périphériques et cochez la case en regard de la série de périphériques préférée.
d. Cliquez sur l'onglet Modèles d'appareil et cochez la case en regard du modèle d'appareil préféré.
e. Cliquez sur Ajouter.

Dans la zone Détails supplémentaires, procédez comme suit :
un. Choisissez l'appareil Tags dans la liste déroulante.
Note
Tags sont comme des mots-clés qui vous aident à localiser plus facilement votre modèle.
Si vous utilisez tags pour filtrer les modèles, vous devez appliquer la même chose tags au périphérique auquel vous souhaitez appliquer les modèles. Sinon, vous obtenez l'erreur suivante lors du provisionnement :
Impossible de sélectionner le périphérique. Non compatible avec le modèle
b. Saisissez la version du logiciel dans le champ Version du logiciel.
Note
Lors du provisionnement, Cisco DNA Center vérifie si le périphérique sélectionné dispose de la version du logiciel répertoriée dans le modèle. En cas de non-concordance, le modèle n'est pas provisionné.
c. Entrez la description du modèle.

Étape 5 Cliquez sur Continuer.
Le modèle est créé et apparaît sous le tableau Modèles.
Étape 6 Vous pouvez modifier le contenu du modèle en sélectionnant le modèle que vous avez créé, en cliquant sur les points de suspension sous la colonne Actions et en choisissant Modifier le modèle. Pour plus d'informations sur la modification du contenu du modèle, voir Modifier les modèles, à la page 7.

Commandes de liste bloquée
Les commandes de liste bloquée sont des commandes qui ne peuvent pas être ajoutées à un modèle ou provisionnées via un modèle.
Si vous utilisez des commandes de liste bloquée dans vos modèles, un avertissement s'affiche dans le modèle indiquant qu'il peut potentiellement entrer en conflit avec certaines applications de provisionnement de Cisco DNA Center.
Les commandes suivantes sont bloquées dans cette version :

zézaiement du routeur

nom d'hôte

Samples modèles

Référez-vous à ces samples modèles pour les commutateurs lors de la création de variables pour votre modèle.

Configurer le nom d'hôte
nom d'hôte$nom

Configurer l'interface
interface $nominterface
description $description

Configurer NTP sur les contrôleurs sans fil Cisco
temps de configuration intervalle ntp $intervalle

Créer un modèle composite
Deux modèles réguliers ou plus sont regroupés dans un modèle de séquence composite. Vous pouvez créer un modèle séquentiel composite pour un ensemble de modèles appliqués collectivement aux appareils. Par exempleample, lorsque vous déployez une branche, vous devez spécifier les configurations minimales pour le routeur de branche. Les modèles que vous créez peuvent être ajoutés à un seul modèle composite, qui regroupe tous les modèles individuels dont vous avez besoin pour le routeur de succursale. Vous devez spécifier l'ordre dans lequel les modèles contenus dans le modèle composite sont déployés sur les appareils.

Note
Vous pouvez ajouter uniquement un modèle validé à un modèle composite.

Étape 1 Cliquez sur l'icône de menu () et choisissez Outils> Template Hub.
Étape 2 Dans le volet de gauche, cliquez sur Nom du projet et sélectionnez le projet sous lequel vous créez des modèles.
Étape 3 Cliquez sur Ajouter en haut à droite de la fenêtre et choisissez Nouveau modèle dans la liste déroulante.
Le volet coulissant Ajouter un nouveau modèle s'affiche.
Étape 4 Dans le volet coulissant Ajouter un nouveau modèle, configurez les paramètres du modèle composite.
Dans la zone Détails du modèle, procédez comme suit :
a) Entrez un nom unique dans le champ Nom du modèle.
b) Choisissez le nom du projet dans la liste déroulante.
c) Type de modèle : choisissez le bouton radio Séquence composite.
d) Choisissez le type de logiciel dans la liste déroulante.
Note
Vous pouvez sélectionner le type de logiciel spécifique (tel que IOS-XE ou IOS-XR) s'il existe des commandes spécifiques à ces types de logiciels. Si vous sélectionnez IOS comme type de logiciel, les commandes s'appliquent à tous les types de logiciels, y compris IOS-XE et IOS-XR. Cette valeur est utilisée lors du provisionnement pour vérifier si le périphérique sélectionné confirme la sélection dans le modèle.

Étape 5 Cliquez sur Continuer.
La fenêtre du modèle composite s'affiche, affichant la liste des modèles applicables.
Étape 6 Cliquez sur le lien Ajouter des modèles et cliquez sur + pour ajouter les modèles et cliquez sur Terminé.
Le modèle composite est créé.
Étape 7 Cochez la case en regard du modèle composite que vous avez créé, cliquez sur les points de suspension sous la colonne Actions et choisissez Valider pour valider le contenu du modèle.

Modifier les modèles

Après avoir créé un modèle, vous pouvez le modifier pour inclure du contenu.

Étape 1 Cliquez sur l'icône de menu () et choisissez Outils> Template Hub.
Étape 2 Dans le volet de gauche, choisissez le nom du projet et sélectionnez le modèle que vous souhaitez modifier.
Le modèle choisi s'affiche.
Étape 3 Entrez le contenu du modèle. Vous pouvez avoir un modèle avec une configuration sur une seule ligne ou une configuration à sélection multiple.
Étape 4 Cliquez sur Propriétés à côté du nom du modèle en haut de la fenêtre pour modifier les détails du modèle, les détails du périphérique et les détails supplémentaires. Cliquez sur Modifier à côté de la zone correspondante.
Étape 5 Le modèle est automatiquement enregistré. Vous pouvez également choisir de modifier l'intervalle de temps de la sauvegarde automatique, en cliquant sur la récurrence temporelle à côté de Sauvegarde automatique.
Étape 6 Cliquez sur Historique des modèles pour view les versions du modèle. Vous pouvez également cliquer sur Comparer avec view la différence dans les versions de modèles.
Étape 7 Cliquez sur l'onglet Variables pour view les variables du modèle CLI.
Étape 8 Cliquez sur le bouton bascule Afficher les conflits de conception pour view erreurs potentielles dans le modèle.
Cisco DNA Center vous permet de view, erreurs potentielles et d’exécution. Pour plus d'informations, consultez Détection de conflits de conception potentiels entre le modèle CLI et l'intention de provisionnement du service, à la page 21 et Détecter les conflits d'exécution du modèle CLI, à la page 21.
Étape 9 Cliquez sur Enregistrer en bas de la fenêtre.
Après avoir enregistré le modèle, Cisco DNA Center recherche toute erreur dans le modèle. S'il existe des erreurs de syntaxe, le contenu du modèle n'est pas enregistré et toutes les variables d'entrée définies dans le modèle sont automatiquement identifiées lors du processus d'enregistrement. Les variables locales (variables utilisées dans les boucles for, affectées via un ensemble, etc.) sont ignorées.
Étape 10 Cliquez sur Valider pour valider le modèle.
Note Vous pouvez associer uniquement un modèle engagé à un pro du réseaufile.
Étape 11 Cliquez sur Attacher à Network Profile lien, pour joindre le modèle créé à un réseau profile.

Simulation de modèle
La simulation de modèle interactive vous permet de simuler la génération CLI de modèles en spécifiant les données de test pour les variables avant de les envoyer aux appareils. Vous pouvez enregistrer les résultats de simulation de test et les utiliser ultérieurement, si nécessaire.

Étape 1 Cliquez sur l'icône de menu () et choisissez Outils> Template Hub.
Étape 2 Dans le volet de gauche, choisissez un projet et cliquez sur un modèle pour lequel vous souhaitez exécuter une simulation.
Le modèle s'affiche.
Étape 3 Cliquez sur l'onglet Simulation.
Étape 4 Cliquez sur Créer une simulation.
Le volet coulissant Créer une simulation s'affiche.
Étape 5 Entrez un nom unique dans le champ Nom de la simulation.

Note
Si votre modèle contient des variables implicites, sélectionnez un appareil dans la liste déroulante Appareil pour exécuter la simulation sur des appareils réels en fonction de vos liaisons.

Étape 6 Cliquez sur Importer les paramètres du modèle pour importer les paramètres du modèle ou cliquez sur Exporter les paramètres du modèle pour exporter les paramètres du modèle.
Étape 7 Pour utiliser les variables du dernier provisionnement de périphérique, cliquez sur Utiliser les valeurs de variable du lien Dernier provisionnement. Les nouvelles variables doivent être ajoutées manuellement.
Étape 8 Choisissez les valeurs des variables, en cliquant sur le lien et cliquez sur Exécuter.

Modèle(s) d'exportation

Vous pouvez exporter un ou plusieurs modèles vers un seul file, au format JSON.

Étape 1 Cliquez sur l'icône de menu () et choisissez Outils> Template Hub.
Étape 2 Cochez une ou plusieurs cases à côté du nom du modèle pour sélectionner un ou plusieurs modèles que vous souhaitez exporter.
Étape 3 Dans la liste déroulante Exporter, choisissez Exporter le modèle.
Étape 4 (Facultatif) Vous pouvez filtrer les modèles en fonction des catégories dans le volet de gauche.
Étape 5 La dernière version du modèle est exportée.
Pour exporter une version antérieure du modèle, procédez comme suit :
un. Cliquez sur le nom du modèle pour ouvrir le modèle.
b. Cliquez sur l'onglet Historique des modèles.
Le volet coulissant Historique des modèles s'affiche.
c. Choisissez la version préférée.
ré. Cliquez sur View bouton sous la version.
Le modèle CLI de cette version s'affiche.
e. Cliquez sur Exporter en haut du modèle.

Le format JSON du modèle est exporté.

Importer des modèles

Vous pouvez importer un ou plusieurs modèles dans un projet.

Note
Vous pouvez importer des modèles uniquement d'une version antérieure de Cisco DNA Center vers une version plus récente. Toutefois, l’inverse n’est pas autorisé.

Étape 1 Cliquez sur l'icône de menu () et choisissez Outils> Template Hub.
Étape 2 Dans le volet de gauche, choisissez le projet pour lequel vous souhaitez importer des modèles, sous Nom du projet et choisissez Importer > Importer un modèle.
Étape 3 Le volet coulissant Importer des modèles s’affiche.
un. Choisissez le nom du projet dans la liste déroulante.
b. Téléchargez le JSON file en effectuant l'une des actions suivantes :

Faites glisser et déposez le file dans la zone glisser-déposer.
Cliquez, choisissez un file, accédez à l'emplacement du JSON file, et cliquez sur Ouvrir.

File la taille ne doit pas dépasser 10 Mo.
c. Cochez la case pour créer une nouvelle version du modèle importé, si un modèle portant le même nom existe déjà dans la hiérarchie.
d. Cliquez sur Importer.
Le modèle CLI est importé avec succès dans le projet choisi.

Cloner un modèle

Vous pouvez faire une copie d'un modèle pour en réutiliser des parties.

Étape 1 Cliquez sur l'icône de menu () et choisissez Outils> Template Hub.
Étape 2 Cliquez sur les points de suspension sous la colonne Action et choisissez Cloner.
Étape 3 Le volet coulissant Cloner un modèle s'affiche.
Procédez comme suit :
un. Entrez un nom unique dans le champ Nom du modèle.
b. Choisissez le nom du projet dans la liste déroulante.
Étape 4 Cliquez sur Cloner.
La dernière version du modèle est clonée.
Étape 5 (Facultatif) Vous pouvez également cloner le modèle en cliquant sur le nom du modèle. Le modèle s'affiche. Cliquez sur
Clonez au-dessus du modèle.
Étape 6 Pour cloner une version antérieure du modèle, procédez comme suit :
un. Sélectionnez le modèle en cliquant sur le nom du modèle.
b. Cliquez sur l'onglet Historique des modèles.
Le volet coulissant Historique des modèles s'affiche.
c. Cliquez sur la version préférée.
Le modèle CLI choisi s'affiche.
d. Cliquez sur Cloner au-dessus du modèle.

Joindre un modèle CLI au Network Profiles

Pour provisionner un modèle CLI, il doit être attaché à un réseau professionnelfile. Utilisez cette procédure pour attacher un modèle CLI à un professionnel du réseaufile ou plusieurs réseaux profiles.

Étape 1 Cliquez sur l'icône de menu () et choisissez Outils> Template Hub.
La fenêtre Template Hub s'affiche.
Étape 2 Cliquez sur Attacher, sous Network Profile colonne, pour joindre le modèle a au réseau profile.
Note
Vous pouvez également cliquer sur les points de suspension sous la colonne Actions et choisir Attacher à Pro.file ou vous pouvez joindre un modèle à network profile depuis Conception> Réseau Profiles. Pour plus d'informations, consultez Associer des modèles à Network Pro.files, à la page 19.
Attacher à Network Profile Le volet coulissant s’affiche.
Étape 3 Cochez la case à côté du réseau profile nom et cliquez sur Enregistrer.
Le modèle CLI est attaché au Network Pro choisifile.
Étape 4 Un numéro s'affiche sous Network Profile colonne, qui indique le nombre de professionnels du réseaufiles auxquels un modèle CLI est attaché. Cliquez sur le numéro pour view le pro du réseaufile détails.
Étape 5 Pour connecter plus de réseau profiles vers un modèle CLI, procédez comme suit :
un. Cliquez sur le numéro sous Network Profile colonne.
Vous pouvez également cliquer sur les points de suspension sous la colonne Actions et choisir Attacher à Pro.file.
Le pro du réseaufileLe volet coulissant s'affiche.
b. Cliquez sur Attacher à Network Profile lien en haut à droite du volet coulissant et cochez la case à côté de Network Profile nom et cliquez sur Joindre.

Mettre à disposition des modèles CLI

Étape 1 Cliquez sur l'icône de menu () et choisissez Outils> Template Hub.
Étape 2 Cochez la case en regard du modèle que vous souhaitez provisionner et cliquez sur Provisionner les modèles en haut du tableau.
Vous pouvez choisir de provisionner plusieurs modèles.
Vous êtes redirigé vers le workflow Modèle de mise à disposition.
Étape 3 Dans la fenêtre Prise en main, saisissez un nom unique dans le champ Nom de la tâche.
Étape 4 Dans la fenêtre Sélectionner les appareils, choisissez les appareils dans la liste des appareils applicables, en fonction des détails de l'appareil définis dans le modèle, puis cliquez sur Suivant.
Étape 5 Dans le Réview Fenêtre Modèles applicables, review les appareils et les modèles qui y sont attachés. Si nécessaire, vous pouvez supprimer les modèles que vous ne souhaitez pas voir provisionnés sur l'appareil.
Étape 6 Configurez les variables de modèle pour chaque périphérique, dans la fenêtre Configurer les variables de modèle.
Étape 7 Sélectionnez l'appareil à pré-alimenterview la configuration étant provisionnée sur l'appareil, en préview Fenêtre de configuration.
Étape 8 Dans la fenêtre Planifier une tâche, indiquez si vous souhaitez provisionner le modèle maintenant ou planifier la mise à disposition ultérieurement, puis cliquez sur Suivant.
Étape 9 Dans la fenêtre Résumé, review les configurations de modèle pour vos appareils, cliquez sur Modifier pour apporter des modifications ; sinon, cliquez sur Soumettre.
Vos appareils seront dotés du modèle.

Projet(s) d'exportation

Vous pouvez exporter un ou plusieurs projets, y compris leurs modèles, vers un seul file au format JSON.

Étape 1 Cliquez sur l'icône de menu () et choisissez Outils> Template Hub.
Étape 2 Dans le volet de gauche, sélectionnez un ou plusieurs projets que vous souhaitez exporter sous Nom du projet.
Étape 3 Dans la liste déroulante Exporter, choisissez Exporter le projet.
Étape 4 Cliquez sur Enregistrer, si vous y êtes invité.

Importer des projets

Vous pouvez importer un ou plusieurs projets avec leurs modèles dans le Cisco DNA Center Template Hub.

Note
Vous pouvez importer des projets uniquement d'une version antérieure de Cisco DNA Center vers une version plus récente. Toutefois, l’inverse n’est pas autorisé.

Étape 1 Cliquez sur l'icône de menu () et choisissez Outils> Template Hub.
Étape 2 Dans la liste déroulante Importer, choisissez Importer le projet.
Étape 3 Le volet coulissant Importer des projets s'affiche.
un. Téléchargez le JSON file en effectuant l'une des actions suivantes :

Faites glisser et déposez le file dans la zone glisser-déposer.

Cliquez sur Choisir un file, accédez à l'emplacement du JSON file, et cliquez sur Ouvrir.

File la taille ne doit pas dépasser 10 Mo.
b. Cochez la case pour créer une nouvelle version du modèle, dans le projet existant, si le projet du même nom existe déjà dans la hiérarchie.
c. Cliquez sur Importer.
Le projet est importé avec succès.

Variables de modèle

Les variables de modèle sont utilisées pour ajouter des informations de métadonnées supplémentaires aux variables de modèle dans le modèle. Vous pouvez également utiliser les variables pour fournir des validations pour des variables telles que la longueur maximale, la plage, etc.

Étape 1 Cliquez sur l'icône de menu () et choisissez Outils> Template Hub.
Étape 2 Dans le volet de gauche, choisissez un projet et cliquez sur un modèle.
Le modèle s'affiche.
Étape 3 Cliquez sur l'onglet Variables.
Il vous permet d'ajouter des métadonnées aux variables du modèle. Toutes les variables identifiées dans le modèle sont affichées.
Vous pouvez configurer les métadonnées suivantes :

Choisissez la variable dans le volet de gauche et cliquez sur le bouton bascule Variable si vous souhaitez que la chaîne soit considérée comme une variable.
Note
Par défaut la chaîne considérée comme une variable. Cliquez sur le bouton bascule si vous ne souhaitez pas que la chaîne soit considérée comme une variable.
Cochez la case Variable obligatoire s'il s'agit d'une variable obligatoire lors du provisionnement. Par défaut, toutes les variables sont marquées comme obligatoires, ce qui signifie que vous devez saisir la valeur de cette variable au moment du provisionnement. Si le paramètre n'est pas marqué comme variable obligatoire et si vous ne transmettez aucune valeur au paramètre, il remplace une chaîne vide au moment de l'exécution. L'absence d'une variable peut entraîner l'échec d'une commande, qui peut ne pas être syntaxiquement correcte.
Si vous souhaitez rendre une commande entière facultative basée sur une variable non marquée comme variable obligatoire, utilisez le bloc if-else dans le modèle.

Entrez le nom du champ dans le champ Nom du champ. Il s'agit de l'étiquette utilisée pour le widget d'interface utilisateur de chaque variable lors du provisionnement.
Dans la zone Valeur des données variables, choisissez la source de données variable en cliquant sur le bouton radio. Vous pouvez choisir une valeur définie par l'utilisateur ou une valeur liée à la source pour conserver une valeur spécifique.

Procédez comme suit, si vous choisissez la valeur définie par l'utilisateur :
un. Choisissez le type de variable dans la liste déroulante : chaîne, entier, adresse IP ou adresse Mac.
b. Choisissez le type de saisie de données dans la liste déroulante : champ de texte, sélection unique ou sélection multiple.
c. Entrez la valeur de variable par défaut dans le champ Valeur de variable par défaut.
d. Cochez la case Valeur sensible pour la valeur sensible.
e. Entrez le nombre de caractères autorisés dans le champ Nombre maximum de caractères. Ceci s’applique uniquement au type de données chaîne.
F. Saisissez le texte de l'indice dans le champ Texte de l'indice.
g. Entrez toute information supplémentaire dans la zone de texte Informations supplémentaires.
Procédez comme suit, si vous choisissez la valeur Lié à la source :
un. Choisissez le type de saisie de données dans la liste déroulante : champ de texte, sélection unique ou sélection multiple.
b. Choisissez la source dans la liste déroulante : Network Profile, Paramètres communs, Cloud Connect et Inventaire.
c. Choisissez l'entité dans la liste déroulante.
d. Choisissez l'attribut dans la liste déroulante.
e. Entrez le nombre de caractères autorisés dans le champ Nombre maximum de caractères. Ceci s’applique uniquement au type de données chaîne.
F. Saisissez le texte de l'indice dans le champ Texte de l'indice.
g. Entrez toute information supplémentaire dans la zone de texte Informations supplémentaires.
Pour plus de détails sur la valeur Lié à la source, voir Liaison de variable, à la page 13.

Étape 4 Après avoir configuré les informations de métadonnées, cliquez sur Review Formulaire à review les informations variables.
Étape 5 Cliquez sur Enregistrer.
Étape 6 Pour valider le modèle, choisissez Valider. La fenêtre Valider s'affiche. Vous pouvez saisir une note de validation dans la zone de texte Note de validation.

Liaison variable
Lors de la création d'un modèle, vous pouvez spécifier des variables substituées contextuellement. Beaucoup de ces variables sont disponibles dans le Template Hub.

Template Hub fournit une option pour lier ou utiliser des variables dans le modèle avec les valeurs de l'objet source lors de l'édition ou via les améliorations du formulaire de saisie ; par exempleample serveur DHCP, le serveur DNS et le serveur Syslog.
Certaines variables sont toujours liées à leur source correspondante et leur comportement ne peut pas être modifié. À view la liste des variables implicites, cliquez sur le modèle et cliquez sur l'onglet Variables.
Les valeurs d'objet prédéfinies peuvent être l'une des suivantes :

Réseau Profile
• SSID
• Politique professionnellefile
• Groupe AP
• Groupe flexible
• Flex profile
• Site tag
• Politique tag
Paramètres communs
• Serveur DHCP
• Serveur Syslog
• Récepteur d'interruptions SNMP
• Serveur NTP
• Site de fuseau horaire
• Bannière de l'appareil
• Serveur dns
• Collecteur NetFlow
• Serveur réseau AAA
• Serveur de point de terminaison AAA
• Réseau panoramique de serveurs AAA
• Point de terminaison panoramique du serveur AAA
• Informations WLAN
• Professionnel RFfile informations
Cloud Connect
• IP du tunnel du routeur cloud 1
• IP du tunnel du routeur cloud 2
• IP de bouclage du routeur cloud 1
• IP de bouclage du routeur cloud 2
• IP du tunnel du routeur de branche 1
• IP du tunnel du routeur de branche 2
• IP publique du routeur cloud 1
• IP publique du routeur cloud 2
• IP du routeur de branche 1
• IP du routeur de branche 2
• IP du sous-réseau privé 1
• IP du sous-réseau privé 2
• Masque IP de sous-réseau privé 1
• Masque IP de sous-réseau privé 2

Inventaire
• Dispositif
• Interfaces
• Groupe AP
• Groupe flexible
• Wi-Fi
• Politique professionnellefile
• Flex profile
• Webcarte des paramètres d'authentification
• Site tag
• Politique tag
• Professionnel RFfile

• Paramètres communs : Paramètres disponibles sous Conception> Paramètres réseau> Réseau. La liaison de variables de paramètres communs résout les valeurs basées sur le site auquel appartient l’appareil.

Étape 1 Cliquez sur l'icône de menu () et choisissez Outils> Template Hub.
Étape 2 Choisissez le modèle et cliquez sur l'onglet Variables pour lier les variables du modèle aux paramètres réseau.
Étape 3 Sélectionnez les variables dans le volet de gauche et cochez la case Variable obligatoire pour lier les variables aux paramètres réseau.
Étape 4 Pour lier des variables aux paramètres réseau, sélectionnez chaque variable dans le volet de gauche, puis choisissez le bouton radio Lié à la source, sous Source de données variable et procédez comme suit :
un. Dans la liste déroulante Type de saisie de données, choisissez le type de widget d'interface utilisateur à créer au moment du provisionnement : Champ de texte, Sélection unique ou Sélection multiple.
b. Choisissez la source, l'entité et l'attribut dans les listes déroulantes respectives.
c. Pour le type de source CommonSettings, choisissez l'une de ces entités : dhcp.server, syslog.server, snmp.trap.receiver, ntp.server, timezone.site, device.banner, dns.server, netflow.collector, aaa.network. serveur, aaa.endpoint.server, aaa.server.pan.network, aaa.server.pan.endpoint, wlan.info ou rfprofile.info.
Vous pouvez appliquer un filtre sur les attributs dns.server ou netflow.collector pour afficher uniquement la liste pertinente des variables de liaison lors du provisionnement des appareils. Pour appliquer un filtre sur un attribut, sélectionnez un attribut dans la liste déroulante Filtrer par. Dans la liste déroulante Condition, sélectionnez une condition correspondant à la valeur.
d. Pour le type de source NetworkProfile, choisissez SSID comme type d'entité. L'entité SSID renseignée est définie sous Design> Network Profile. La liaison génère un nom SSID convivial, qui est une combinaison du nom SSID, du site et de la catégorie SSID. Dans la liste déroulante Attributs, choisissez wlanid ou wlanProfileNom. Cet attribut est utilisé lors des configurations CLI avancées au moment du provisionnement du modèle.
e. Pour le type de source Inventaire, choisissez l'une de ces entités : Appareil, Interface, Groupe AP, Groupe Flex, Wlan, Policy Pro.file, FlexProfile, WebCarte des paramètres d'authentification, site Tag, Politique Tag, ou RF Profile. Pour le type d'entité Périphérique et Interface, la liste déroulante Attribut affiche les attributs du périphérique ou de l'interface. La variable est résolue en nom de groupe AP et de groupe Flex configurés sur le périphérique auquel le modèle est appliqué.
Vous pouvez appliquer un filtre sur les attributs Périphérique, Interface ou Wlan pour afficher uniquement la liste pertinente des variables de liaison lors du provisionnement des appareils. Pour appliquer un filtre sur un attribut, sélectionnez un attribut dans la liste déroulante Filtrer par. Dans la liste déroulante Condition, sélectionnez une condition correspondant à la valeur.

Après avoir lié des variables à un paramètre commun, lorsque vous attribuez des modèles à un professionnel du sans filfile et provisionnez le modèle, les paramètres réseau que vous avez définis sous Paramètres réseau > Réseau apparaissent dans la liste déroulante. Vous devez définir ces attributs sous Paramètres réseau > Réseau au moment de la conception de votre réseau.

Étape 5
Si le modèle contient des liaisons de variables qui se lient à des attributs spécifiques et que le code du modèle accède directement à ces attributs, vous devez effectuer l'une des opérations suivantes :

Modifiez la liaison vers l'objet plutôt que vers les attributs.

Mettez à jour le code du modèle pour ne pas accéder directement aux attributs.

Par exempleample, si le code du modèle est le suivant, où $interfaces se lie à des attributs spécifiques, vous devez mettre à jour le code comme indiqué dans l'exemple suivantample, ou modifiez la liaison à l’objet plutôt qu’aux attributs.
Vieux sample code :

#foreach ( $interface dans $interfaces )
$interface.portName
description "quelque chose"
#fin

Nouvellesample code :

#foreach ( $interface dans $interfaces )
interface $interface
description "quelque chose"
#fin

Mots-clés spéciaux

Toutes les commandes exécutées via des modèles sont toujours en mode configuration. Par conséquent, vous n’avez pas besoin de spécifier explicitement les commandes activate ou configt dans le modèle.
Les modèles Day-0 ne prennent pas en charge les mots-clés spéciaux.

Activer les commandes de mode
Spécifiez la commande #MODE_ENABLE si vous souhaitez exécuter des commandes en dehors de la commande configt.

Utilisez cette syntaxe pour ajouter des commandes de mode d'activation à vos modèles CLI :
#MODE_ENABLE
< >
#MODE_END_ENABLE

Commandes interactives
Spécifiez #INTERACTIVE si vous souhaitez exécuter une commande où une entrée utilisateur est requise.
Une commande interactive contient l'entrée que vous devez saisir suite à l'exécution d'une commande. Pour saisir une commande interactive dans la zone Contenu CLI, utilisez la syntaxe suivante :

Commande CLI question interactive 1 réponse à la commande 1 question interactive 2 réponse à la commande 2
Où et tags évaluez le texte fourni par rapport à ce qui est visible sur l'appareil.
La question interactive utilise des expressions régulières pour valider si le texte reçu de l'appareil est similaire au texte saisi. Si les expressions régulières saisies dans le tags sont trouvés, puis la question interactive passe et une partie du texte de sortie apparaît. Cela signifie que vous devez saisir une partie de la question et non la totalité de la question. Saisir Oui ou Non entre les et tags est suffisant mais vous devez vous assurer que le texte Oui ou Non apparaît dans la question émise par l'appareil. La meilleure façon de procéder est d’exécuter la commande sur l’appareil et d’observer le résultat. De plus, vous devez vous assurer que tous les métacaractères d’expression régulière ou nouvelles lignes saisis sont utilisés de manière appropriée ou complètement évités. Les métacaractères courants des expressions régulières sont . ( ) [ ] { } | *+? \ $^ : &.

Par exempleample, la commande suivante a une sortie qui inclut des métacaractères et des nouvelles lignes.

Switch(config)# pas de point de confiance crypto pki DNAC-CA
% La suppression d'un point de confiance inscrit détruira tous les certificats reçus de l'autorité de certification associée.
Es-tu sûr de vouloir faire ça? [Oui Non]:

Pour saisir cela dans un modèle, vous devez sélectionner une partie qui ne contient ni métacaractères ni nouvelles lignes.
Voici quelques exemplesampmoins de ce qui pourrait être utilisé.

#INTERACTIF
pas de point de confiance crypto pki DNAC-CA Oui Non Oui
#ENDS_INTERACTIVE

#INTERACTIF
pas de point de confiance crypto pki DNAC-CA Supprimer un inscrit Oui
#ENDS_INTERACTIVE

#INTERACTIF
pas de point de confiance crypto pki DNAC-CA Es-tu sûr de vouloir faire ça Oui
#ENDS_INTERACTIVE

#INTERACTIF
la clé de chiffrement génère des clés générales rsa Oui Non Non
#ENDS_INTERACTIVE

Où et tags sont sensibles à la casse et doivent être saisis en majuscules.

Note
En réponse à la question interactive après avoir fourni une réponse, si le caractère de nouvelle ligne n'est pas requis, vous devez saisir le tag. Incluez un espace avant le tag. Lorsque vous entrez dans le tag, le tag apparaît automatiquement. Vous pouvez supprimer le tag parce que ce n'est pas nécessaire.

Par exempleample:
#INTERACTIF
configurer les minuteries avancées ap-fast-heartbeat local activer 20 Postuler (o/n) ? oui
#ENDS_INTERACTIVE

Combinaison des commandes du mode d'activation interactif
Utilisez cette syntaxe pour combiner les commandes interactives du mode d'activation :

#MODE_ENABLE
#INTERACTIF
commandes question interactive réponse
#ENDS_INTERACTIVE
#MODE_END_ENABLE

#MODE_ENABLE
#INTERACTIF
mkdir Créer le répertoire xyz
#ENDS_INTERACTIVE
#MODE_END_ENABLE

Commandes multilignes
Si vous souhaitez que plusieurs lignes du modèle CLI soient renvoyées à la ligne, utilisez le MLTCMD tags. Sinon, la commande est envoyée ligne par ligne à l'appareil. Pour saisir des commandes multilignes dans la zone Contenu CLI, utilisez la syntaxe suivante :

première ligne de commande multiligne
deuxième ligne de commande multiligne
…
…
dernière ligne de commande multiligne

Où et sont sensibles à la casse et doivent être en majuscules.

Les commandes multilignes doivent être insérées entre les et tags.
Le tags ne peut pas commencer par un espace.
Le et tags ne peut pas être utilisé sur une seule ligne.

Associer des modèles à Network Profiles

Avant de commencer
Avant de provisionner un modèle, assurez-vous que le modèle est associé à un professionnel du réseau.file et le profile est affecté à un site.
Lors du provisionnement, lorsque les appareils sont attribués à des sites spécifiques, les modèles associés au site via le réseau profile apparaissent dans la configuration avancée.

Étape 1

Cliquez sur l'icône de menu () et choisissez Conception> Réseau Profiles, puis cliquez sur Ajouter Profile.
Les types de professionnels suivantsfiles sont disponibles :

Assurance : cliquez ici pour créer un professionnel de l'assurancefile.
Pare-feu : cliquez ici pour créer un pare-feu professionnelfile.
Routage : cliquez ici pour créer un pro du routagefile.

Commutation : cliquez ici pour créer un pro de la commutationfile.
• Cliquez sur les modèles d'intégration ou les modèles Day-N, selon vos besoins.
• Dans le Profile Champ Nom, entrez le profile nom.
• Cliquez sur +Ajouter un modèle et choisissez le type de périphérique, tag, et le modèle du type de périphérique, Tag Listes déroulantes Nom et Modèle.
Si vous ne voyez pas le modèle dont vous avez besoin, créez un nouveau modèle dans Template Hub. Voir Créer un modèle standard, à la page 3.
• Cliquez sur Enregistrer.
Appareil de télémétrie : cliquez ici pour créer un appareil de télémétrie de trafic Cisco DNA profile.
Sans fil : cliquez ici pour créer un professionnel du sans filfile. Avant d'attribuer un réseau sans fil à un professionnelfile à un modèle, assurez-vous d'avoir créé des SSID sans fil.
• Dans le Profile Champ Nom, entrez le profile nom.
• Cliquez sur + Ajouter SSID. Les SSID créés sous Paramètres réseau > Sans fil sont renseignés.
• Sous Joindre un ou plusieurs modèles, dans la liste déroulante Modèle, choisissez le modèle que vous souhaitez mettre à disposition.
• Cliquez sur Enregistrer.

Note
Tu peux view le pro de la commutation et du sans filfiles dans les cartes et la table view.

Étape 2 Le pro du réseaufileLa fenêtre de la liste répertorie les éléments suivants :

Profile Nom

Taper
Version
Créé par

Sites : cliquez sur Attribuer un site pour ajouter des sites au professionnel sélectionné.file.

Étape 3
Pour le provisionnement Jour-N, choisissez Provisionnement > Périphériques réseau > Inventaire et procédez comme suit :
a) Cochez la case en regard du nom de l'appareil que vous souhaitez provisionner.
b) Dans la liste déroulante Actions, choisissez Provisionner.
c) Dans la fenêtre Attribuer un site, attribuez un site auquel le profiles sont attachés.
d) Dans le champ Choisir un site, saisissez le nom du site auquel vous souhaitez associer le contrôleur, ou faites votre choix dans la liste déroulante Choisir un site.
e) Cliquez sur Suivant.
f) La fenêtre Configuration apparaît. Dans le champ Emplacements AP gérés, entrez les emplacements AP gérés par le contrôleur. Vous pouvez modifier, supprimer ou réattribuer le site. Ceci s'applique uniquement aux professionnels sans fil.files.
g) Cliquez sur Suivant.
h) La fenêtre Configuration avancée apparaît. Les modèles associés au site via le réseau profile apparaissent dans la configuration avancée.

Cochez la case Provisionner ces modèles même s'ils ont été déployés auparavant si vous avez remplacé des configurations à partir de l'intention dans le modèle et que vous souhaitez que vos modifications soient remplacées. (Cette option est désactivée par défaut.)

L'option Copier la configuration en cours dans la configuration de démarrage est activée par défaut, ce qui signifie qu'après le déploiement de la configuration du modèle, l'écriture de la mémoire sera appliquée. Si vous ne souhaitez pas appliquer la configuration en cours à la configuration de démarrage, vous devez décocher cette case.
Utilisez la fonction Rechercher pour rechercher rapidement l'appareil en saisissant le nom de l'appareil, ou développez le dossier des modèles et sélectionnez le modèle dans le volet de gauche. Dans le volet de droite, sélectionnez les valeurs des attributs liés à la source.
Pour exporter les variables du modèle dans un CSV file lors du déploiement du modèle, cliquez sur Exporter dans le volet de droite.
Vous pouvez utiliser le CSV file pour apporter les modifications nécessaires à la configuration de la variable et l'importer ultérieurement dans Cisco DNA Center en cliquant sur Importer dans le volet de droite.

i) Cliquez sur Suivant pour déployer le modèle.
j) Choisissez si vous souhaitez déployer le modèle maintenant ou le planifier pour plus tard.
La colonne État de la fenêtre Inventaire des appareils affiche SUCCÈS une fois le déploiement réussi.

Étape 4 Cliquez sur Exporter le déploiement CSV pour exporter les variables de modèle de tous les modèles en un seul. file.
Étape 5 Cliquez sur Importer un déploiement CSV pour importer les variables de modèle de tous les modèles en un seul. file.
Étape 6 Pour le provisionnement au jour 0, choisissez Provision> Plug and Play et procédez comme suit :
a) Choisissez un appareil dans la liste déroulante Actions, puis choisissez Réclamation.
b) Cliquez sur Suivant et dans la fenêtre Attribution de site, choisissez un site dans la liste déroulante Site.
c) Cliquez sur Suivant et dans la fenêtre Configuration, choisissez l'image et le modèle Day-0.
d) Cliquez sur Suivant et dans la fenêtre Configuration avancée, entrez l'emplacement.
e) Cliquez sur Suivant pour view les détails de l'appareil, les détails de l'image, la configuration préalable du jour 0viewet modèle CLI préview.

Détecter les conflits dans un modèle CLI

Cisco DNA Center vous permet de détecter les conflits dans un modèle CLI. Tu peux view conflits de conception potentiels et conflits d'exécution pour la commutation, SD-Access ou la structure.

Détection de conflits de conception potentiels entre le modèle CLI et l'intention de fourniture de services

Les conflits de conception potentiels identifient les commandes d'intention dans le modèle CLI et les signalent si la même commande est poussée par commutation, SD-Access ou Fabric. L'utilisation des commandes d'intention n'est pas recommandée, car elles sont réservées à être transmises au périphérique par Cisco DNA Center.

Étape 1 Cliquez sur l'icône de menu () et choisissez Outils> Template Hub.
La fenêtre Template Hub s'affiche.
Étape 2 Dans le volet de gauche, cliquez sur le nom du projet dans la liste déroulante pour view les modèles CLI du projet préféré.
À view uniquement les modèles présentant des conflits, dans le volet de gauche, sous Conflits de conception potentiels, cochez la case
Note
Case à cocher Conflits.
Étape 3 Cliquez sur le nom du modèle.
Vous pouvez également cliquer sur l'icône d'avertissement sous la colonne Conflits de conception potentiels. Le nombre total de conflits s'affiche.
Le modèle CLI s'affiche.
Étape 4 Dans le modèle, les commandes CLI présentant des conflits sont signalées par une icône d'avertissement. Passez la souris sur l'icône d'avertissement pour view les détails du conflit.
Pour les nouveaux modèles, les conflits sont détectés après l'enregistrement du modèle.
Étape 5 (Facultatif) Pour afficher ou masquer les conflits, cliquez sur le bouton Afficher les conflits de conception.
Étape 6 Cliquez sur l'icône de menu () et choisissez Provision> Inventaire pour view le nombre de modèles CLI avec des conflits. Dans la fenêtre Inventaire, un message avec une icône d'avertissement s'affiche, indiquant le nombre de conflits dans le modèle CLI nouvellement configuré. Cliquez sur le lien Mettre à jour les modèles CLI pour view les conflits.

Détecter les conflits d'exécution du modèle CLI

Cisco DNA Center vous permet de détecter les conflits d'exécution pour la commutation, SD-Access ou Fabric.

Avant de commencer
Vous devez configurer le modèle CLI via Cisco DNA Center pour détecter les conflits d'exécution.

Étape 1 Cliquez sur l'icône de menu () et choisissez Provision> Inventaire.
La fenêtre Inventaire s'affiche.
Étape 2 View l'état de provisionnement des modèles des appareils dans la colonne Statut de provisionnement des modèles, qui indique le nombre de modèles provisionnés pour l'appareil. Les modèles correctement provisionnés sont affichés avec une icône de coche.
Les modèles présentant des conflits sont affichés avec une icône d'avertissement.
Étape 3 Cliquez sur le lien sous la colonne État de mise à disposition du modèle pour ouvrir le volet coulissant État du modèle.

Tu peux view les informations suivantes dans le tableau :

Nom du modèle
Nom du projet
État de mise à disposition : affiche Modèle provisionné si le modèle a été provisionné avec succès ou Modèle désynchronisé s'il existe des conflits dans le modèle.
État du conflit : affiche le nombre de conflits dans le modèle CLI.
Actions : cliquez sur View Configuration pour view le modèle CLI. Les commandes présentant des conflits sont signalées par une icône d'avertissement.

Étape 4 (Facultatif) View le nombre de conflits dans un modèle CLI sous la colonne État des conflits de modèles dans la fenêtre Inventaire.
Étape 5 Identifiez les conflits d'exécution en générant un pré-configurationview:
a) Cochez la case à côté du nom de l'appareil.
b) Dans la liste déroulante Actions, choisissez Provisionner le périphérique.
c) Dans la fenêtre Attribuer un site, cliquez sur Suivant. Dans la fenêtre Configuration avancée, apportez les modifications nécessaires et cliquez sur Suivant. Dans la fenêtre Résumé, cliquez sur Déployer.
d) Dans le volet coulissant Provisionner le périphérique, cliquez sur le bouton Générer une configuration préalable.view bouton radio et cliquez sur Appliquer.
e) Cliquez sur le lien Éléments de travail pour view la configuration générée préview. Vous pouvez également cliquer sur l'icône de menu () et choisissez Activités > Éléments de travail à view la configuration générée préview.
f) Si l'activité est toujours en cours de chargement, cliquez sur Actualiser.
g) Cliquez sur le préview lien pour ouvrir le pré-configurationview volet coulissant. Tu peux view les commandes CLI avec des conflits d'exécution signalés par des icônes d'avertissement.

Documents / Ressources

	CISCO crée des modèles pour automatiser les logiciels des appareils [pdf] Guide de l'utilisateur Créer des modèles pour automatiser le logiciel de l'appareil, des modèles pour automatiser le logiciel de l'appareil, automatiser le logiciel de l'appareil, le logiciel de l'appareil, le logiciel
	CISCO crée des modèles pour automatiser les appareils [pdf] Guide de l'utilisateur Créer des modèles pour automatiser un appareil, Modèles pour automatiser un appareil, Automatiser un appareil, Appareil

Références

Manuel d'utilisation

Créer des modèles pour automatiser le logiciel de l'appareil

À propos du centre de modèles