Attribution de nom personnalisée pour les ressources déployées dans
Automation Assembler
.

En tant qu'administrateur de cloud ou de projet, vous disposez d'une convention d'attribution de nom prédéfinie pour les ressources de votre environnement et vous souhaitez que les ressources déployées suivent ces conventions sans interaction avec les utilisateurs. Vous pouvez créer des modèles d'attribution de nom globale pour une partie ou l'intégralité des déploiements dans
Automation Assembler
.
Vous pouvez commencer par créer des noms personnalisés au niveau du projet ou des noms au niveau de l'organisation. Les noms personnalisés au niveau du projet sont prioritaires sur les noms au niveau de l'organisation. Cet exemple commence par un nom personnalisé d'organisation simple, puis ajoute un nom au niveau du projet.
Si vous disposez de modèles de cloud ou que vous utilisez l'API dans laquelle vous déployez 2 000 ressources ou plus en même temps par projet et où un nom personnalisé s'applique, vous pouvez rencontrer une erreur
Retries exhausted
lors du déploiement sur certaines de ces ressources. Si ce scénario est courant, vous ne devez pas appliquer le nouveau nom personnalisé aux projets ou aux organisations où cela se produit. Au lieu de cela, vous devez utiliser l'attribution de nom système par défaut, pas l'option d'attribution de nom personnalisée.

Par quoi commencer

Créer un modèle personnalisé au niveau de l'organisation

Lorsque vous souhaitez un modèle de nom personnalisé par défaut pour les déploiements qui ne disposent pas de modèles au niveau du projet, créez des modèles dont la portée se situe au niveau de l'organisation.
  1. Sélectionnez
    Infrastructure
    Administration
    Noms personnalisés
    et cliquez sur
    Nouveau nom personnalisé
    .
  2. Entrez un
    Nom
    .
    Cet exemple utilise
    Préfixe et horodatage pour l'organisation
    .
  3. Sélectionnez
    Organisation
    comme Portée.
  4. Cliquez sur
    Nouveau modèle d'attribution de nom
    et configurez les options suivantes.
    Option
    Exemple de valeur
    Type de ressource
    Machine
    Valider le nom de calcul pour l'unicité
    Cochez la case.
    L'utilisation de noms de ressources uniques vous permet de ne jamais vous tromper de ressource, même lorsque vous travaillez dans des environnements basés sur API.
    La configuration du nombre dans le format de modèle suivant augmente afin de garantir l'unicité.
    Format de modèle
    mcm-${timestamp}-${######}
    Valeur du compteur de début
    1
    Étape d'incrément
    1
    Avec cette configuration, tous les déploiements de tous les projets vont s'incrémenter à partir de ce point de départ.
    Dans cet exemple, où le compteur de départ est 1 et l'incrément est 1, le premier déploiement est numéroté 2. Si vous souhaitez que le déploiement démarre à 1, définissez le compteur de démarrage sur zéro et le pas d'incrémentation sur 1.
  5. Cliquez sur
    Ajouter
    .
  6. Continuez à ajouter des modèles pour d'autres types de ressources à l'aide des exemples suivants.
    Nom du type de ressource
    Format du modèle d'attribution de nom
    Machine
    mcm-${timestamp}-${##}
    Réseau
    ntw-${timestamp}-${##}
    Stockage
    stg-${timestamp}-${##}
    Équilibrage de charge
    ldb-${timestamp}-${##}
    Groupe de ressources
    rsg-${timestamp}-${##}
    Passerelle
    gtw-${timestamp}-${##}
    NAT
    nat-${timestamp}-${##}
    Groupe de sécurité
    scg-${timestamp}-${##}
  7. Cliquez sur
    Créer
    .
  8. Testez le modèle de nom en déployant des modèles qui incluent les types de ressources définis.
    Ressource déployée qui montre le nom personnalisé au niveau de l'organisation.

Créer un modèle personnalisé au niveau du projet avec une correspondance de modèle avancée

Vous pouvez créer un modèle de nom personnalisé unique que vous pouvez attribuer à différents projets. Vous utilisez l'option avancée pour définir différents points de départ de numérotation pour différents projets.
Cet exemple utilise la ressource de machine.
  1. Sélectionnez
    Infrastructure
    Administration
    Noms personnalisés
    et cliquez sur
    Nouveau nom personnalisé
    .
  2. Entrez un
    Nom
    .
    Cet exemple utilise
    Nom du projet avec numérotation avancée
    .
  3. Sélectionnez
    Projet
    comme Portée.
  4. Cliquez sur
    Nouveau modèle d'attribution de nom
    et configurez les options suivantes.
    Option
    Exemple de valeur
    Type de ressource
    Machine
    Format de modèle
    ${project.name}-${######}
    Valeur du compteur de début
    1
    Étape d'incrément
    1
    Avec cette configuration, les déploiements des projets attribués vont s'incrémenter à partir de ce point de départ.
    Dans cet exemple, où le compteur de départ est 1 et l'incrément est 1, le premier déploiement est numéroté 2. Si vous souhaitez que le déploiement démarre à 1, définissez le compteur de démarrage sur zéro et le pas d'incrémentation sur 1. Avec 1 comme valeur de départ, ProjectA démarre à 2 et ProjectB à 2, sauf si la valeur est remplacée par une valeur de modèle de correspondance avancé.
  5. Pour affiner le modèle d'attribution de nom d'organisation par défaut, cliquez sur
    Avancé
    , puis sur
    Ajouter un modèle correspondant
    .
    Vous pouvez définir différents modèles d'attribution de nom pour démarrer le compteur à des nombres différents ou réinitialiser le nombre à 1 pour chaque modèle. Par exemple, la numérotation du projet Ventes commence à 100 et la numérotation du projet Marketing commence à 200.
    1. Entrez le modèle du projet Ventes.
      Option
      Exemple de valeur
      Texte du modèle
      Ventes -
      Valeur du compteur de début
      100
    2. Entrez le modèle du projet marketing.
      Option
      Exemple de valeur
      Texte du modèle
      Marketing -
      Valeur du compteur de début
      200
  6. Cliquez sur
    Ajouter
    .
  7. Continuez à ajouter des modèles pour d'autres types de ressources, si nécessaire.
  8. Cliquez sur
    Attribuer des projets
    et ajoutez les projets Ventes et Marketing.
  9. Cliquez sur
    Créer
    .
  10. Testez le modèle de nom en déployant d'abord un modèle de cloud qui se trouve dans le projet Ventes, puis un modèle dans le projet Marketing.
    Ressource déployée qui montre le nom personnalisé au niveau du projet pour le projet Ventes.

Exemple de nom personnalisé avec des propriétés personnalisées et des valeurs spécifiques du projet

Outre les propriétés fournies dans les options de remplissage automatique du format de modèle, vous pouvez utiliser des propriétés personnalisées. Pour utiliser des propriétés personnalisées dans un nom personnalisé, vous devez les définir dans un groupe de propriétés.
Une valeur de propriété personnalisée dans le modèle de cloud est prioritaire sur la même valeur de propriété dans le nom personnalisé.
Cet exemple utilise costCenter comme propriété et SalesCost comme valeur pour le projet Ventes et MktCost comme valeur pour le projet Marketing.
  1. Créez un groupe de propriétés nommé costingPG.
    1. Sélectionnez
      Infrastructure
      Concevoir
      Groupes de propriétés
      et cliquez sur
      Nouveau groupe de propriétés
      .
    2. Cliquez sur
      Valeurs d'entrée
      .
    3. Entrez
      Nom
      costingPG
      .
    4. Pour
      Portée
      , sélectionnez
      Disponible pour n'importe quel projet
      .
    5. Cliquez sur
      Nouvelle propriété
      , configurez les valeurs suivantes et entrez le nom
      costCenter
      .
      Options
      Exemples de valeurs
      Nom
      costCenter
      Type
      Chaîne
      Valeur par défaut
      research
    6. Cliquez sur
      Créer
      .
    7. Cliquez sur
      Créer
      pour enregistrer le nouveau groupe de propriétés.
  2. Configurez des propriétés personnalisées pour le projet Ventes et le projet Marketing.
    Ces étapes illustrent le processus du projet Ventes. Vous pouvez répéter les étapes et utiliser les valeurs du projet marketing.
    • Nom de la propriété Ventes : costingPG.costCenter. Valeur : SalesCost.
    • Nom de la propriété marketing : costingPG.costCenter. Valeur : MktCost.
    1. Sélectionnez
      Infrastructure
      Administration
      Projets
      et ouvrez le projet Ventes.
    2. Cliquez sur l'onglet
      Provisionnement
      et localisez la section Propriétés personnalisées.
    3. Entrez
      costingPG.costCenter
      comme nom de propriété,
      SalesCost
      et la valeur.
      Valeur de la propriété personnalisée costingPG.costCenter et SalesCost dans la section Propriétés personnalisées de l'onglet Provisionnement du projet.
    4. Cliquez sur
      Enregistrer
      .
    5. Répétez le processus dans le projet Marketing en utilisant
      MktCost
      et la valeur de la propriété.
  3. Créez un nom personnalisé au niveau du projet.
    Cet exemple utilise les mêmes projets que les exemples d'utilisateurs avancés. Vous ne pouvez attribuer des noms personnalisés qu'à un seul projet à la fois. Pour tester les résultats de cet exemple, vous pouvez appliquer le nom personnalisé à de nouveaux projets ou supprimer les projets Ventes et Marketing du nom du projet dans l'exemple Numérotation avancée.
    Cet exemple part du principe que vous n'avez pas encore attribué les projets Ventes et Marketing.
    1. Sélectionnez
      Infrastructure
      Administration
      Noms personnalisés
      et cliquez sur
      Nouveau nom personnalisé
      .
    2. Entrez
      Nom du projet et costingPG
      en tant que
      Nom
      .
    3. Sélectionnez
      Projet
      comme Portée.
    4. Cliquez sur
      Nouveau modèle d'attribution de nom
      et configurez les options suivantes.
      Option
      Valeur
      Type de ressource
      Machine
      Format de modèle
      ${project.name}-${costingPG.costCenter}-${######}
      Valeur du compteur de début
      1
      Étape d'incrément
      1
    5. Cliquez sur
      Ajouter
      .
    6. Cliquez sur
      Attribuer des projets
      et ajoutez les projets Ventes et Marketing.
    7. Cliquez sur
      Créer
      .
  4. Testez le modèle de nom en déployant d'abord un modèle de cloud qui se trouve dans le projet Ventes, puis un modèle dans le projet Marketing.
    Nom de la ressource du projet de vente
    Détails du déploiement indiquant le nom de la ressource Sales-SalesCost-000002.
    Nom de la ressource du projet marketing
    Détails du déploiement indiquant le nom de la ressource Marketing-MktCost-000002.

Exemple d'un nom personnalisé avec des entrées utilisateur de groupe de propriétés et de modèle de cloud

Cet exemple vous montre comment créer un nom personnalisé basé sur les entrées utilisateur dans le modèle. Vous définissez deux des entrées utilisateur, le système d'exploitation et la taille, dans le modèle de cloud. L'une des entrées utilisateur, mktSite, utilise une propriété personnalisée site.siteCode qui accepte les entrées utilisateur et vous l'ajoutez au modèle de cloud.
  1. Définissez la propriété personnalisée pour le projet marketing.
    1. Sélectionnez
      Infrastructure
      Concevoir
      Groupes de propriétés
      et cliquez sur
      Nouveau groupe de propriétés
      .
    2. Cliquez sur
      Valeurs d'entrée
      .
    3. Nommez et décrivez le groupe de propriétés.
      Option
      Valeur
      Nom
      site
      Portée
      Disponible pour n'importe quel projet.
      Le groupe de propriétés doit être généralement disponible pour que la propriété soit disponible pour une utilisation au format de modèle de nom personnalisé.
    4. Cliquez sur
      Nouvelle propriété
      et configurez les valeurs suivantes.
      Option
      Valeur
      Nom
      siteCode
      Type
      Chaîne
      Valeur par défaut
      Ouest
      Plus d'options
      Valeur enum
      Entrez des valeurs séparées pour Est, Ouest, Nord et Sud.
      Ces valeurs représentent les codes de site possibles que vos utilisateurs peuvent sélectionner.
  2. Créez le modèle d'attribution de nom personnalisé.
    1. Sélectionnez
      Infrastructure
      Noms personnalisés
      Nouveau nom personnalisé
      .
    2. Entrez le
      Nom
      Site-OS-Size pour Marketing Project
      .
    3. Sélectionnez Projets.
      Projets est sélectionné et est l'unique option si vous disposez déjà d'un nom personnalisé étendu à l'organisation.
    4. Cliquez sur
      Nouveau modèle d'attribution de nom
      et configurez les options suivantes.
      Option
      Valeur
      Type de ressource
      Machine
      Format de modèle
      ${site.siteCode}-${resource.name}-${######}
      La propriété site.siteCode est celle que vous avez définie à l'étape précédente. La valeur resource.name est définie dans le modèle de cloud à l'étape suivante.
      Valeur du compteur de début
      1
      Étape d'incrément
      1
  3. Définissez les entrées utilisateur dans le modèle.
    Les entrées utilisateur incluses dans cet exemple incluent le système d'exploitation et la taille, ainsi qu'une entrée utilisateur basée sur la propriété personnalisée site.siteCode.
    Le modèle de cloud présenté dans cette étape est simple à des fins de démonstration. Vous pouvez appliquer l'exemple à l'un de vos modèles existants.
    1. Sélectionnez
      Conception
      Nouveau à partir de
      Canevas vide
      .
    2. Entrez le
      Nom
      Modèle marketing
      .
    3. Dans la liste
      Projet
      sélectionnez
      Marketing
      .
    4. Cliquez sur
      Créer
      .
    5. Entrez le code du modèle de cloud ou utilisez l'exemple de code ci-dessous.
      Notez que les entrées utilisateur concernent la taille et le système d'exploitation. Vous configurez les variables pour chaque entrée dans les propriétés de machine de type (
      ${input.size}
      ) et d'image (
      ${input.OS}
      ). Enfin, la propriété Nom est utilisée pour construire le nom de la ressource (
      ${input.OS}-${input.size}
      ) qui peut être utilisé dans le modèle d'attribution de nom personnalisé.
      formatVersion: 1 inputs:
      size: type: string enum: - small - medium OS: type: string enum: - centos - ubuntu
      resources: Cloud_vSphere_Network_1: type: Cloud.vSphere.Network properties: networkType: existing Cloud_Machine_1: type: Cloud.Machine properties: image:
      ${input.OS}
      flavor:
      ${input.size}
      name:
      ${input.OS}-${input.size}
      networks: - network: ${resource.Cloud_vSphere_Network_1.id}
    6. Pour ajouter la propriété personnalisée site.siteCode en tant qu'entrée utilisateur, cliquez sur l'onglet
      Entrée
      dans le volet de droite et configurez les options suivantes.
      Option
      Valeur
      Nom
      mktSite
      Nom complet
      Sélectionner un site
      Type
      Objet
      Sélectionner un type d'objet
      Groupes de propriétés
      Sélectionner parmi les groupes de propriétés existants
      site
    7. Dans l'onglet Code, notez l'entrée utilisateur mktSite ajoutée, puis mettez à jour le fichier YAML pour inclure la propriété personnalisée.
      Par exemple, ajoutez
      site.siteCode: ${input.mktSite.siteCode}
      au fichier YAML.
      formatVersion: 1 inputs: size: type: string title: Select the machine size enum: - small - medium OS: type: string title: Select an operating system enum: - centos - ubuntu
      mktSite: type: object $ref: /ref/property-groups/site title: Select a site
      resources: Cloud_vSphere_Network_1: type: Cloud.vSphere.Network properties: networkType: existing Cloud_Machine_1: type: Cloud.Machine properties: image: ${input.OS} flavor: ${input.size} name: ${input.OS}-${input.size} networks: - network: ${resource.Cloud_vSphere_Network_1.id}
      site.siteCode: ${input.mktSite.siteCode}
  4. Déployez le modèle et vérifiez le nom de la machine personnalisée.
    Comme West est la valeur par défaut, sélectionnez un site autre que West.
    Détails du déploiement cloud_machine indiquant le nom de la ressource East-centos-small-000011.

Priorité de dénomination des ressources au moment du déploiement

En fonction de la manière dont vous configurez l'attribution de nom personnalisé, les noms sont appliqués aux ressources déployées en fonction des règles suivantes.
Une pratique courante consiste à définir un modèle d'attribution de nom général au niveau de l'organisation, puis à créer un ou plusieurs modèles au niveau du projet, selon vos besoins de gestion de projet.
Scénario d'attribution de nom personnalisé
Priorité
Aucun nom personnalisé
  • Le système crée les noms des ressources de déploiement pour tous les composants de déploiement.
Nom au niveau de l'organisation
  • Applique les valeurs et chaînes de propriétés d'attribution de nom personnalisé à tous les déploiements.
  • Si le projet en cours de déploiement a un nom personnalisé au niveau du projet, le nom au niveau de l'organisation est remplacé.
  • Si aucun nom personnalisé au niveau de l'organisation n'est défini, le nom au niveau du projet est utilisé pour les projets attribués.
  • Si aucun nom personnalisé au niveau de l'organisation ou au niveau du projet n'est défini, le système crée les noms de ressources.
Noms au niveau du projet
  • Applique les valeurs et les chaînes de propriétés d'attribution de nom personnalisé au niveau du projet à tous les projets attribués.
  • S'il existe un nom au niveau de l'organisation, le nom au niveau du projet est prioritaire sur le nom de l'organisation.
  • Si aucun nom personnalisé au niveau de l'organisation n'est défini, le nom au niveau du projet est utilisé pour les projets attribués.
  • Si aucun nom personnalisé au niveau de l'organisation ou au niveau du projet n'est défini, le système crée les noms de ressources.

Utilisation des formats de modèle

Lors de la définition de votre format de modèle, vous pouvez utiliser des chaînes et des propriétés. L'avantage principal de l'utilisation des propriétés est que vous pouvez utiliser les mêmes propriétés que le format pour plusieurs projets, mais que le nom est dérivé des propriétés de valeur, qui peuvent varier selon le projet, le modèle de cloud, la plate-forme et d'autres propriétés.
Les propriétés de format de modèle incluent les propriétés fournies, décrites ici, ainsi que toutes les propriétés personnalisées que vous avez définies dans
Concevoir
Groupes de propriétés
.
  • Caractères valides
    • Les espaces ne sont pas autorisés.
    • Pour plus de lisibilité, vous pouvez utiliser des caractères spéciaux pour séparer les propriétés. Les caractères autorisés sont _ (trait de soulignement) et - (tiret).
  • Propriétés fournies
    Propriétés fournies
    Propriétés
    Description
    point de terminaison
    Informations sur le compte de cloud, telles que la description, entrez (AWS) ou le nom. Le point de terminaison s'applique uniquement aux machines.
    Exemples
    • ${endpoint.desc}
    • ${endpoint.endpointType}
    • ${endpoint.name}
    projet
    Information sur le projet.
    Exemple
    • ${project.desc}
    • ${project.name}
    type de ressource
    Inclut le nom de la ressource du modèle de cloud, les propriétés personnalisées qui se trouvent dans le modèle de cloud ou le projet.
    Exemple
    • ${resource.name}
    timestamp
    Date et heure du déploiement. La valeur numérique est aaaa mm jj hh mm ss, mais sans espaces. Par exemple, 20210825120345.
    Exemple
    • ${timestamp}
    utilisateur
    Exemple
    • ${user}
    nom d'utilisateur
    Exemple
    • ${userName}
    ######
    Propriété Number.
    La longueur maximale est de 19 chiffres.
    Si vous utilisez deux chiffres, ##, le nombre maximal déclenchant le recommencement de la numérotation est 99. Si vous utilisez ###, la numérotation redémarre après 999.
    Exemple
    • ${####}
      .
    Propriété personnalisée
    Les propriétés personnalisées doivent faire partie du groupe de propriétés. La propriété dans le nom personnalisé inclut le nom du groupe de propriétés et la propriété.
    Exemple
    • ${propertygroup.property}

Utilisation du compteur

Dans une instance à nœud unique de
VMware Aria Automation
, le compteur augmente en fonction des valeurs que vous définissez dans vos modèles d'attribution de nom personnalisée et à mesure qu'ils sont appliqués à l'organisation et aux projets cibles.
Dans un environnement à nœuds multiples, le compteur tente d'incrémenter en fonction des valeurs du modèle. S'il rencontre une contention, l'application du nombre est tentée trois fois. Il est possible qu'une demande échoue après la troisième tentative de résolution de la contention. Dans ce cas, vous pouvez voir un écart dans la numérotation.
Vous pouvez également rencontrer des écarts dans la numérotation pour d'autres raisons. Par exemple, vous déployez trois machines virtuelles. La deuxième machine échoue lors du provisionnement. Les compteurs des machines virtuelles déployées sont vm-01 et vm-03, avec vm-02 manquant.
Si vous n'utilisez pas l'attribution de nom personnalisée, préférant vous baser sur la stratégie d'attribution de nom par défaut, les pools de valeurs de compteur sont réservés aux nœuds comme suit :
  • Nœud 1 : 1-300
  • Nœud 2 : 301-600
  • Nœud 3 : 601-900
Cela signifie que dans un environnement à plusieurs nœuds, le nombre peut sembler inattendu. Le nombre dépend du nœud qui traite la demande.

Liste des types de ressources auxquels vous pouvez appliquer des noms personnalisés

Vous pouvez créer un nom personnalisé pour un seul type de ressource ou pour tous les types de ressources. Seuls les types de ressources portant des noms personnalisés utilisent le modèle. Toutes les autres ressources utilisent le modèle par défaut.
Par exemple, si vous créez un nom personnalisé au niveau du projet uniquement pour vos machines et que vous disposez de noms au niveau de l'organisation pour tous les autres types de ressources, la ressource de machine prend le nom du projet et toutes les autres ressources utilisent les noms d'organisation.
Exemple de liste de ressources
Types de ressources d'attribution de nom personnalisée
Types de ressources de déploiement
Machines
  • Cloud.Machine
  • Cloud.vSphere.Machine
  • Cloud.AWS.EC2.Instance
  • Cloud.GCP.Machine
  • Cloud.Azure.Machine
Réseaux
  • Cloud.Network
  • Cloud.vSphere.Network
  • Cloud.NSX.Network
Stockage
  • Cloud.Volume
  • Cloud.vSphere.Disk
  • Cloud.AWS.Volume
  • Cloud.GCP.Disk
  • Cloud.Azure.Disk
Équilibrages de charge
  • Cloud.LoadBalancer
  • Cloud.NSX.LoadBalancer
Groupes de ressources
  • Cloud.Azure.ResourceGroup
Passerelles
  • Cloud.NSX.Gateway
NAT
  • Cloud.NSX.NAT
Groupes de sécurité
  • Cloud.SecurityGroup
Générique
  • Ressources qui utilisent l'aide d'allocation d'attribution de nom personnalisée
    L'aide d'allocation d'attribution de nom personnalisée génère des noms personnalisés pour vos ressources pendant le processus d'allocation. Le type de ressource Générique recouvre toutes les ressources possibles et est exclusivement lié à l'aide d'allocation d'attribution de nom personnalisée.
    Pour en savoir plus sur le type de ressource Générique et l'aide d'allocation d'attribution de nom personnalisée, reportez-vous à la section Créer des noms personnalisés avec l'aide d'allocation d'attribution de nom personnalisée.

Suppression des modèles de nom personnalisés

La suppression d'un modèle n'affecte pas l'attribution de nom aux ressources actuellement déployées. Cependant, vous ne devez pas supprimer un modèle de nom personnalisé tant que vous n'avez pas vérifié l'impact sur tous les projets attribués.
Vous pouvez retirer un projet d'un modèle d'attribution de nom. Le modèle continue à fonctionner pour les autres projets.

Suppression de projets portant des noms personnalisés

Si un modèle d'attribution de nom personnalisée est appliqué à un projet, vous devez d'abord supprimer le projet du modèle avant de pouvoir supprimer le projet.