Procédure pas-à-pas de mise en service de l'ordinateur virtuel Azure

Cet exemple vous guide à travers les composants de Cloud Provisioning and Governance impliqués dans la mise en service d'un ordinateur virtuel dans un centre de données Azure. Les rubriques couvertes incluent les plans, les blocs de ressources, l'API dans le cloud (CAPI) et les script includes de Serveur MID.

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Cette procédure pas-à-pas commence par un ordinateur virtuel Linux qu'un utilisateur a déjà mis en service dans Azure. Puis, il vous guide à travers le plan avec l'ordinateur virtuel, les blocs de ressources, et les appels CAPI spécifiés à partir des blocs de ressources. Enfin, la procédure pas-à-pas vous montre comment un script include de Serveur MID, à travers plusieurs appels de CAPI, réalise les appels REST réels à l'API Azure.

Cet exemple utilise des blocs de ressources par défaut et des script includes qui sont disponibles dans votre instance. Par conséquent, bien que vous n'activiez peut-être pas d'ordinateur virtuel mis en service sur votre instance, vous pouvez toujours suivre ces étapes et afficher les composants utilisés dans cet exemple pour comprendre comment fonctionnent les composants.

Pour obtenir un exemple d'ordinateur virtuel dans AWS, consultez Procédure pas-à-pas de mise en service de l'ordinateur virtuel AWS.

Remarque :

Les termes ordinateur virtuel, VM et serveur virtuel sont utilisés de façon interchangeable dans cet exemple.

Procédure

1. Examinez un ordinateur virtuel mis en service dans le portail de l'utilisateur dans le cloud et concentrez-vous sur certains détails relatifs à l'ordinateur virtuel :
   1. Dans l’interface de l’instance système de base , ouvrez le portail de l'utilisateur dans le cloud (Portail de l'utilisateur dans le cloud).
   2. Sur le portail de l'utilisateur dans le cloud, affichez un ordinateur virtuel mis en service dans une pile, tel que cet ordinateur virtuel, en cliquant sur Piles, puis en cliquant sur le nom de la pile.

      Dans cet exemple, la pile est nommée MyAzureVM.

   3. Sous Ressources, cliquez sur l'ordinateur virtuel dans la pile.

      

   4. Affichez les propriétés de l'ordinateur virtuel et notez qu'il se trouve dans un centre de données Azure de la région eastus.

      

2. Regardez le plan sur lequel l'ordinateur virtuel est basé :
   1. Accédez à la Conception > Plans, puis ouvrez un plan avec un serveur virtuel dans le centre de données Azure. L’onglet Modèle de déploiement s’affiche par défaut et vous montre les différents composants du plan.

      Cet exemple de plan contient trois composants : le conteneur, le serveur virtuel, qui est l'ordinateur virtuel lui-même mis en service, et le centre de données Azure.

      

   2. Cliquez sur l'onglet Opérations en bas, puis sur Mettre en service.

      

      L'opération Mettre en service est celle que le système a déclenchée lors de la création de l'ordinateur virtuel. D'autres opérations par défaut sont disponibles, mais cet exemple se concentre sur l'opération Mettre en service.

   3. Cliquez sur le bloc Mettre en service pour Blueprint Container Resource (Ressources de conteneur du plan).

      

   4. Sur la droite, vous pouvez voir que l'un des paramètres de la liste Entrées est Emplacement.
      Ce paramètre contient la valeur eastus, qui est l'endroit où l'ordinateur virtuel se trouve dans le centre de données.

      

      Les entrées peuvent être spécifiées sur le conteneur, comme dans cet exemple, ou sur n'importe quel autre bloc de ressources. Par défaut, le paramètre Location est déjà spécifié pour vous dans le bloc de ressources Blueprint Container (Conteneur du plan), afin que vous puissiez l'utiliser dans chaque plan comme celui-ci. Si vous basculez le plan sur Brouillon, vous pouvez ajouter d'autres paramètres au bloc de ressources Blueprint Container (Conteneur du plan). Vous ne pouvez pas ajouter de paramètres au bloc de ressources Serveur virtuel. Pour cette procédure pas à pas, aucun paramètre supplémentaire n'est nécessaire.

3. Affichez les blocs de ressources Serveur virtuel et Centre de données utilisés dans ce plan :
   1. Dans , portail d'administration du cloudaccédez à Conception > Blocs de ressources.
   2. Recherchez le bloc de ressources Serveur Virtuel et ouvrez-le. Celui-ci est fourni par défaut avec Cloud Provisioning and Governance.

      

   3. Dans le formulaire Bloc de ressources, cliquez sur la liste connexe Ressource hôte pour afficher la liste des blocs de ressources hôtes pris en charge.
   4. Vous pouvez voir que l'interface hôte et la ressource hôte sont déjà spécifiées :

      

      • Le champ Interface hôte spécifie l'interface qui doit correspondre à l'interface d'invité dans le bloc de ressources qui héberge cet ordinateur virtuel. Dans ce cas, l'interface hôte est l'interface Calcul, qui est également l'interface d'invité sur le bloc de ressources Centre de données Azure. Par défaut, les blocs de ressources de centres de données fournissent plusieurs interfaces d'invité que les autres blocs de ressources comme le stockage virtuel peuvent utiliser pour se connecter au centre de données.
      • La colonne HostResource de la liste connexe Ressource hôte spécifie déjà Centre de données Azure, ce qui signifie que le bloc de ressources Centre de données Azure est un hôte valide pour cet ordinateur virtuel.
   5. Cliquez sur l'onglet Opérations, puis sur le sous-onglet Étapes.

      

   6. Sélectionnez Mettre en service dans la liste Opération.

      

      Rappelez-vous que l'opération Mettre en service est celle que le système a utilisée pour créer l'ordinateur virtuel. D'autres opérations par défaut sont disponibles, mais cet exemple se concentre sur l'opération Mettre en service.

   7. Prenez connaissance de l'étape qui apparaît dans la liste et de la description complète de l'étape qui apparaît au-dessus des paramètres d'entrée :

      

      • Opération de ressource hôte : indique que cette étape appelle une opération sur la ressource hôte (le centre de données Azure dans cet exemple).
      • L'interface de calcul est l'interface d'invité du centre de données Azure que cette étape utilise.
      • ConnectAndCreateVirtualMachine est l'opération du centre de données Azure appelée par cette étape.

      Remarque :

      Dans ce cas, l'étape appelle une opération à partir d'un autre bloc de ressources : le centre de données Azure. Les étapes peuvent également appeler la CAPI directement, puis la CAPI peut exécuter des appels REST vers l'API du fournisseur dans le cloud. Vous pouvez voir cela lorsque vous examinez le bloc de ressources du centre de données Azure.
   8. Revenir à Conception > Blocs de ressources.
   9. Ouvrez le bloc de ressources Centre de données Azure, qui est le bloc de ressources hôte auquel le serveur virtuel est connecté.
   10. Remarquez les interfaces d'invités prises en charge dans la liste connexe Interface d'invité :

       

       Ces interfaces d'invités sont les interfaces que le centre de données Azure met à la disposition d'autres blocs de ressources. L'interface de calcul est fournie afin que le bloc de ressources du serveur virtuel, qui spécifie l'interface de calcul comme interface hôte, puisse se connecter au centre de données.

   11. Cliquez sur l'onglet Opérations, puis sur le sous-onglet Étapes.

       

   12. Dans la liste Interface, sélectionnez Interface de calcul si elle n'est pas déjà sélectionnée.

       

       N'oubliez pas que cette interface est spécifiée dans le bloc de ressources du serveur virtuel.

   13. Dans la liste Opération, recherchez et sélectionnez ConnectAndCreateVirtualMachine.

       

       N'oubliez pas que cette opération est spécifiée dans le bloc de ressources du serveur virtuel.

   14. Remarquez l'appel CAPI utilisé dans la seule étape pour l'opération ConnectAndCreateVirtualMachine :

       

       • API dans le cloud : indique que cette étape appelle la CAPI, afin que la CAPI puisse exécuter un appel REST au fournisseur dans le cloud qui est, dans ce cas, Azure.
       • L'interface de calcul spécifie l'interface de CAPI appelée par cette étape.
       • CreateNode indique la méthode exécutée. Comme son nom l'indique, cette méthode indique au fournisseur dans le cloud de créer l'ordinateur virtuel.
   15. Pour ouvrir la configuration de l'étape : avec le bloc de ressources à l'état Brouillon, pointez sur l'étape en surbrillance (bleue), puis cliquez sur l'icône Modifier l'étape qui apparaît.

       

   16. Prenez connaissance de la configuration de l'étape et notez les paramètres qui s'intègrent à la CAPI :

       

       Champ	Description
       Type d'opération	Appeler l'API dans le cloud indique que cette étape doit appeler la CAPI via le fournisseur, l'interface et la méthode indiqués.
       Fournisseur d'API (qui est en fait le produit)	Microsoft.Compute est un produit (et non un fournisseur réel) qui appartient au fournisseur Azure tel que défini dans la CAPI.
       Interface d'API	L'interface de calcul est un produit qui appartient au fournisseur Azure tel que défini dans la CAPI.
       Méthode API	CreateNode est la méthode qui appelle Azure pour créer l'ordinateur virtuel.

       Remarque :

       La définition de l'API CAPI relie le fournisseur (Azure), le produit (Microsoft.Compute), l'interface (interface de calcul) et la méthode (CreateNode).
   17. Fermer la fenêtre.
   18. Avec l'étape Compute Interface.CreateNode sélectionnez, cliquez sur l'onglet Processeur de réponses, et examinez le script Create_Virtual_Server_Response_Processor.

       

       Le script est le processeur de réponses qui met à jour la CMDB dans votre instance une fois que l'ordinateur virtuel est créé.

   19. Consultez une explication du script et l’exemple qui fait partie de la rubrique dans Créer un processeur de réponse.
       Lorsque vous avez fini de lire la rubrique, revenez à celle-ci.
4. Regardez les composants CAPI qui s'associent pour mettre en service l'ordinateur virtuel :
   1. Dans le portail d’administration du cloud, accédez à Conception > API dans le cloud.
   2. Cliquez sur l'onglet API, puis recherchez une API de calcul Azure ouverte.
   3. Examinez comment cette API CAPI relie une interface et un produit :

      

      Champ	Description
      Interface de l'API dans le cloud	L'interface de calcul est la même interface que celle que vous pouvez voir spécifiée dans le bloc de ressources. L'interface contient la définition des méthodes, y compris la méthode CreateStack.
      Connecteur	Le connecteur de script indique que cette CAPI fournit un Serveur MID script include de pour chaque opération. Le script include appelle l'API. Vous pouvez modifier le script include, voire en créer un nouveau.
      Version	1.0 indique la version de l'API. Vous pouvez avoir plusieurs versions de cette API avec des numéros de version différents. N'oubliez pas qu'à l'étape du bloc de ressources du centre de données qui crée l'ordinateur virtuel, un champ Version est fourni. Bien qu'il soit vide dans cet exemple, car il n'existe qu'une seule version de cette API, vous pouvez spécifier un numéro de version différent.
      Produit	Microsoft.Compute est le produit qui appartient au fournisseur dans la CAPI. Ce produit est fourni par défaut avec Cloud Provisioning and Governance, et est l'un des produits les plus couramment utilisés pour la création d'ordinateurs virtuels sur Azure.

   4. Dans la liste connexe Mappeurs de méthodes CAPI, cliquez sur l'icône d'aperçu de l'enregistrement pour l'enregistrement CreateNode, puis cliquez sur Ouvrir l'enregistrement.

      

   5. Examinez le mappeur de méthode CreateNode :

      

      Notez que l'opération de point de terminaison est Exécuter le script, ce qui indique qu'un script include personnalisable est utilisé pour appeler des fonctions dans la CAPI, qui effectue, en fin de compte, les appels REST vers Azure. Le script include de azure-compute-1.0-CreateNode Serveur MID est spécifié dans le champ Script de demande.

      Ce graphique illustre comment les composants, du bloc de ressources au script include, sont reliés :

      

   6. Cliquez sur l'icône d'enregistrement ( ) pour le script de demande.

      Le script include de azure-compute-1.0-CreateNode Serveur MID s'ouvre.

   7. Examinez le contenu du script.

      
      createNode();
      function createNode(){
         var acp = new AzureComputeVirtualMachine(this.parameters, this.headers);
         var vm = acp.createVirtualMachine();
      
         return vm;
      }
      

      Le script appelle la fonction createVirtualMachine dans la classe AzureComputeVirtualMachine. Il renvoie l'ordinateur virtuel qui est créé. La classe AzureComputeVirtualMachine étend AzureCloudAPIBase, qui est l'une des API de base dans Cloud Provisioning and Governance.

   8. Pour afficher la AzureComputeVirtualMachine classe, qui est un Serveur MID include de script, ouvrez l’interface de l’instance système de base (et non la portail d'administration du cloud), puis accédez à Serveur MID > Includes de script.
   9. Recherchez et ouvrez AzureComputeVirtualMachine.

      

   10. Examinez la fonction CreateVirtualMachine :

       La fonction définit de nombreuses variables requises pour créer un ordinateur virtuel, y compris Location (centre de données) et le nom de l'ordinateur virtuel, et ainsi de suite.

        
       var location = this.parameters.get('Location');  
       var vmName = this.parameters.get('NodeName');
       ...
       

       Cette ligne de code appelle la fonction _performVMOperation dans ce même script include et passe dans les paramètres nécessaires. Notez qu'une valeur vide " est transmise pour le paramètre action :

       var response = this._performVMOperation(subscriptionId, resourceGroup, vmName, '', 'PUT', jsonObj.encode(params));

       La fonction _performVMOperation appelle la fonction _invokeRequest, qui se trouve dans la classe AzureCloudAPIBase :

       return this._invokeRequest(this.pathDefault, param, method, requestBody);

       La méthode PUT pour l'appel REST est spécifiée dans le paramètre method.

       Examinez le script include AzureCloudAPIBase Serveur MID. La fonction _invokeRequest appelle d'abord la fonction _getEndpoint pour obtenir le point de terminaison et la fonction _getAPIInvoker pour identifier la classe AzureAPIInvoker comme la classe qui invoque l'appel PUT réel :

       var apiInvoker = this._getAPIInvoker(apiEndpoint, this.apiVersion);

       AzureAPIInvoker est étendu à partir de CloudRESTAPIInvoker, qui fournit les fonctions de base pour tous les demandeurs. Une fois que la classe de demandeur appropriée est identifiée, une variable response est créée pour contenir la valeur renvoyée par la fonction invokePut dans le CloudRESTAPIInvoker :

       response = apiInvoker.invokePut(requestBody);

       Examinez le CloudRESTAPIInvoker, qui est la classe de base pour tous les appelants. La fonction invokePut spécifie la méthode PUT et appelle getRequest, puis elle renvoie la réponse de la fonction getResponse, qui obtient un code d'état et la réponse d'Azure. Cette classe de demandeur est l'endroit où la connexion à Azure est effectuée.

       Retournez au script include AzureComputeVirtualMachine Serveur MID et recherchez ces lignes :

       
       var response = this._performVMOperation(subscriptionId, resourceGroup, vmName, '', 'PUT', jsonObj.encode(params));  
       this._compareVMState(response.id, 'PowerState/running');  
       var nodeResponse = this.getVirtualMachine(response.id);
       

       N'oubliez pas que la variable response est renvoyée de l'appel à _performVMOperation, qui a la réponse du demandeur d'API qui a déclenché la méthode PUT. La variable nodeResponse contient la réponse de la fonction getVirtualMachine, qui est transmise à l'ID de l'ordinateur virtuel qui se trouve dans la réponse. La fonction getVirtualMachine appelle _getVMInfo, qui appelle la même fonction _invokeRequest déjà appelée précédemment. Cet appel est une autre connexion au demandeur, qui effectue les appels REST réels. Dans ce cas, l'appel REST est un appel GET REST à Azure pour obtenir l'identificateur de l'ordinateur virtuel.

       La ligne return nodeResponse; renvoie nodeResponse dans la fonction createVirtualMachine, qui a été appelée à partir du script include de Serveur MID sur l'opération createNode.

       Ce graphique illustre les classes impliquées :

       

   11. Revenez au formulaire API de calcul Azure.
   12. Cliquez sur la liste connexe Remplacements de configuration d'API et examinez les éléments requis pour l'authentification.

       Paramètre de configuration et valeur de remplacement	Description
       ClientID $(CloudCredential.client_id)	L'ID client est nécessaire pour identifier l'application dans Azure.
       EndpointURL $(CloudCredential.URL)	L'URL du point de terminaison est l'entrée d'autorisation dans Azure.
       SecretKey $(CloudCredential.secret_key)	La clé secrète est utilisée pour autoriser le client.
       TenantID $(CloudCredential.tenant_id)	L'ID de locataire est l'identificateur unique global de votre locataire.
       EnrollmentNumber $(CloudCredential.sn_cmp_ea_credential.enrollment_number) EnrollmentToken $(CloudCredential.sn_cmp_ea_credential.access_key)	Numéro d'inscription Azure et jeton permettant d'accéder au compte d'inscription.

       Voir Stocker les informations d'identification principales de Azure dans l'instance pour plus d'informations sur les informations Azure utilisées dans ces remplacements.

   13. Revenir à Conception > API dans le cloud, puis cliquez sur l’onglet Interface .
   14. Recherchez et ouvrez l'interface de calcul.
   15. Examinez le contenu de l'interface.
       Notez que l'interface fournit des structures de réponse REST pour des méthodes telles que CreateNode. Vous n'avez généralement pas besoin de modifier les interfaces existantes.

       

       Notez la catégorie de service et les opérations :

       Champ ou liste connexe	Description
       Catégorie de service	La catégorie de service classe l'interface. La catégorie de l'interface de calcul est également Calcul.
       Exploitations de l'interface CAPI	Les opérations d'interface définissent la structure JSON de l'appel REST et les paramètres requis pour l'interface.

   16. Cliquez sur l'opération d'interface CAPI CreateNode.
       Cette opération fournit le cadre de travail pour la création du serveur virtuel EC2.
   17. Passez en revue les composants de l'opération :

       Champ ou liste connexe	Description
       Structure de la réponse	La structure de réponse est le cadre de travail JSON pour l'appel d'API REST. Il fournit une liste d'attributs que le fournisseur peut utiliser pour créer la ressource virtuelle avec des valeurs vides.
       Paramètres d'exploitation d'interface	Ces paramètres sont également les paramètres dont l'interface CAPI a besoin afin de pouvoir la transmettre dans l'appel REST au fournisseur dans le cloud.

       

   18. Revenir à Conception > API dans le cloud , puis cliquez sur l’onglet Fournisseur .
   19. Ouvrez le fournisseur Azure.

       Le fournisseur Azure Cloud s'ouvre et vous montre que ce fournisseur est basé sur une classe CMDB existante : centre de données Azure [cmdb_ci_azure_datacenter].

   20. Cliquez sur la liste connexe Produits dans le cloud, puis triez la liste à partir de la colonne Nom.

       Notez que plusieurs produits Azure sont disponibles par défaut. L'un des produits Azure les plus couramment utilisés créés à partir de modèles est Microsoft.Compute.

       

   21. Cliquez sur Microsoft.Compute dans la colonne Nom.
       Notez que le produit spécifie de nombreux types de ressources, chacun d'eux étant mappé à une classe CI.

       

       Ces types de ressources indiquent certains CI, pas tous, associés à l'ordinateur virtuel. Le processeur de réponse dans le bloc de ressources remplit les CI avec des données lorsque le fournisseur dans le cloud met en service l'ordinateur virtuel.

5. Pour afficher les CI importants associés à l'ordinateur virtuel :
   1. Sur le portail de l'utilisateur dans le cloud, cliquez sur Piles, puis ouvrez la pile contenant l'ordinateur virtuel.
   2. Cliquez sur l'icône Afficher la dépendance.

      

      La carte des dépendances affiche le CI de la pile en haut, l'ordinateur virtuel au milieu et les différents CI associés, tels que l'image, en bas.

      

   3. Pour afficher le formulaire de l'ordinateur virtuel dans la CMDB, cliquez avec le bouton droit sur la flèche à côté de n'importe quel CI.

      

   4. Dans le menu, sélectionnez Afficher le formulaire.

      

      Le formulaire CI s'ouvre et vous montre qu'une grande partie des informations est déjà disponible sur le portail de l'utilisateur dans le cloud lorsque vous affichez les propriétés de l'ordinateur virtuel.

      Formulaire CI de l'ordinateur virtuel	Propriétés de l'ordinateur virtuel dans le portail de l'utilisateur dans le cloud