Démarrage rapide : déployez un modèle de catalogue de services en utilisant la CLI

Azure Enclave est un service de réseau cloud qui permet aux organisations traitant des données hautement sensibles de déployer et de gérer rapidement des charges de travail à grande échelle sur les clouds Azure commerciaux et isolés du réseau. Dans ce guide de démarrage rapide, vous :

  • Déploie un modèle de catalogue de services en utilisant des commandes Azure CLI.

Note

Cet exemple de déploiement est uniquement à des fins de démonstration et ne représente pas toutes les meilleures pratiques pour l’administration du réseau, des systèmes ou des applications.

Avant de commencer

Prerequisites

Avant de commencer, examinez les prérequis spécifiés par le modèle de catalogue de service que vous envisagez de déployer. Déployez toutes les ressources préalables requises qui ne sont pas déjà disponibles, et confirmez que vous avez la permission de les utiliser.

Ensuite, rassemblez les noms des ressources, les identifiants de ressources et les autres valeurs de paramètres requises par ce gabarit. Les prérequis, paramètres requis et valeurs par défaut peuvent varier selon le gabarit et la version. Ne supposez pas que chaque modèle nécessite les ressources utilisées dans l’exemple suivant.

Déployer un modèle à partir du catalogue de services

Vous pouvez trouver les modèles de catalogue de services dans Azure Public dans le inventory.xml fichier d’inventaire.

Téléchargez un modèle spécifique en utilisant le nom que vous trouvez dans l’inventaire (par exemple, deploy-adminVM-1.0.1.json).

  1. Répertoriez les modèles disponibles dans le catalogue de services :

    # Download the XML file
    $xmlUrl = "https://veservicecatalogprod.z22.web.core.windows.net/inventory.xml"
    $xmlContent = Invoke-WebRequest -Uri $xmlUrl -UseBasicParsing
    
    # Load the XML content
    [xml]$xml = $xmlContent.Content
    
    # Extract URLs from the XML file
    $urls = $xml.SelectNodes("//EnumerationResults/Blobs/Blob/Url")
    
    # List the URLs
    $urls | ForEach-Object { $_.InnerText }
    

    Le compte de stockage du catalogue de services varie selon l’environnement :

    • Azure : veservicecatalogprod.z22.web.core.windows.net
    • Azure Government : veservicecatalogfairfax.z2.web.core.usgovcloudapi.net
    • Azure Secret :veservicecatalogussec.z1.web.core.<AzureSecretDomain>
    • Azure Top Secret :veservicecatalogusnat.z2.web.core.<AzureTopSecretDomain>
  2. Téléchargez chaque modèle. Poursuivez le script PowerShell de l’étape précédente. Pour télécharger un seul modèle, remplacez le filtre par l’URL du modèle que vous avez sélectionnée.

    # download all templates
    $urls | ForEach-Object {
        $url = $_.InnerText
        $fileName = Split-Path -Leaf $url
        Invoke-WebRequest -Uri $url -OutFile $fileName
    }
    
  3. Ouvrez le modèle et déterminez quels paramètres vous devez fournir. Dans cet exemple, utilisez storageAccount/deploy-storage-account-1.0.0.json.

    Notez quels paramètres sont requis et quels paramètres ont des valeurs par défaut.

    Créez un params.json fichier pour fournir les valeurs des paramètres :

    {
        "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
        "contentVersion": "1.0.0.0",
        "parameters": {
            "storageAccountName": {
                "value": ""
            },
            "virtualNetworkName": {
                "value": ""
            },
            "networkResourceGroupName": {
                "value": ""
            },
            "privateLinkSubnetName": {
                "value": ""
            },
            "privateDnsZoneResourceGroupName": {
                "value": ""
            },
            "keyVaultName": {
                "value": ""
            },
            "keyName": {
                "value": ""
            },
            "keyVaultResourceGroupName": {
                "value": ""
            },
            "userAssignedIdentityObject": {
                "value": {
                    "name":"",
                    "id":"",
                    "location":"",
                    "subscriptionName":""
                }
            }
        }
    }
    
  4. Récupérez les ressources de l’enclave pour fournir les valeurs de paramètres suivantes :

    • storageAccountName
    • virtualNetworkName
    • networkResourceGroupName
    • privateDnsZoneResourceGroupName
    • keyVaultName
    • keyVaultResourceGroupName
    • userAssignedIdentityObject.name
    • userAssignedIdentityObject.id
    • userAssignedIdentityObject.location
    • userAssignedIdentityObject.subscriptionName
    az rest --method get --uri "<enclave-resource-id>?api-version=<api-version>"
    

    Utilisez une version d’API actuellement prise en Microsoft.Mission charge à partir de la référence API Azure Enclave (par exemple, 2026-04-01).

    Utilisez la réponse et les propriétés de ressource Azure pour remplir les valeurs dans params.json. Pour plus d’opérations et de schémas API, consultez la référence API Azure Enclave et la source et spécifications API Azure Enclave. Vous devez également identifier privateLinkSubnetName et keyName.

  5. Répertorier les sous-réseaux du réseau virtuel (privateLinkSubnetName)

    az network vnet subnet list --resource-group <resource-group-name> --vnet-name <vnet-name> --query "[].name"
    
  6. Récupérer le nom de la clé CMK (keyName)

    az keyvault key list --vault-name <keyvault-name> --query "[].name"
    
  7. Obtenir l’emplacement de userAssignedIdentityObject (userAssignedIdentityObject.location)

    az resource show --ids <user-assigned-identity-resource-id> --query location
    
  8. Obtenir le nom de l’abonnement

    az account show --subscription <subscription-id> --query name
    
  9. Déployer le modèle

    az deployment group create --resource-group <resource-group-name> --template-file ./<template-downloaded-name> --parameters @./<parameter-file-name>
    

Valider le déploiement

  1. Vérifiez le statut du déploiement.

    az deployment group show --resource-group <resource-group-name> --name <deployment-name> --query properties.provisioningState
    
  2. Vérifiez que les ressources créées par le modèle sont présentes.

    az resource list --resource-group <resource-group-name> --output table
    

Supprimer le déploiement

Si vous ne prévoyez pas de garder ces ressources, supprimez uniquement celles créées par ce déploiement pour éviter les frais Azure. Supprimez le groupe de ressources uniquement lorsqu’il est dédié à ce déploiement et que vous avez confirmé qu’il ne contient aucune ressource à conserver.