Quickstart: Implementar um modelo de catálogo de serviços usando a CLI

O Azure Enclave é um serviço de rede na cloud que permite às organizações com dados altamente sensíveis implementar e gerir rapidamente cargas de trabalho em nuvens comerciais e em nuvens Azure isoladas, em larga escala. Neste guia de início rápido, você irá:

  • Implemente um modelo de catálogo de serviços a partir do catálogo de serviços usando a CLI do Azure.

Note

Este exemplo de implementação é apenas para fins de demonstração e não representa todas as melhores práticas para administração de redes, sistemas ou aplicações.

Antes de começares

Implemente um modelo a partir do catálogo de serviços

Os modelos do catálogo de serviços estão disponíveis publicamente aqui no Azure Public:https://veservicecatalogprod.z22.web.core.windows.net/inventory.xml

Descarregue um modelo específico usando o nome encontrado no inventário acima (por exemplo, https://veservicecatalogprod.z22.web.core.windows.net/adminVM/deploy-adminVM-1.0.1.json)

  1. Liste os modelos disponíveis no catálogo de serviços:

    # 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 }
    

    Nomes das contas de armazenamento por ambiente

    • Azure: veservicecatalogprod.z22.web.core.windows.net
    • Azure Government: veservicecatalogfairfax.z2.web.core.usgovcloudapi.net
    • Azure Secret: veservicecatalogussec.z1.web.core.<SecretDomain>
    • Azure Top Secret: veservicecatalogusnat.z2.web.core.<TopSecretDomain>
  2. Descarregue cada modelo Continuando o script a partir do passo anterior

    # download all templates
    $urls | ForEach-Object {
        $url = $_.InnerText
        $fileName = Split-Path -Leaf $url
        Invoke-WebRequest -Uri $url -OutFile $fileName
    }
    
  3. Abre o modelo e determina para que parâmetros precisas de fornecer valores. Neste exemplo, usamos "storageAccount/deploy-storage-account-1.0.0.json"

    Note quais os parâmetros que são necessários e quais os parâmetros têm valores padrão.

    Crie um novo ficheiro params.json para fornecer os valores dos parâmetros:

    {
        "$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. Buscar os recursos do enclave para fornecer os seguintes valores de parâmetros

    • storageAccountName
    • virtualNetworkName
    • nome do grupo de recursos de rede
    • privateDnsZoneResourceGroupName
    • keyVaultName
    • keyVaultResourceGroupName
    • ID do objeto de identidade atribuída ao utilizador
    az rest --method get --uri "<enclave-resource-id>?api-version=2026-03-01-preview"
    

    Para mais operações e esquemas da API, consulte a referência da API do Azure Enclave e a fonte e especificações da API do Azure Enclave. Ainda terá de buscar os valores privateLinkSubnetName, keyName, userAssignedIdentityObject

  5. Liste as sub-redes na rede virtual (privateLinkSubnetName)

    az network vnet subnet list --resource-group <resource-group-name> --vnet-name <vnet-name> --query "[].name"
    
  6. Obter nome da chave CMK (keyName)

    az keyvault key list --vault-name <keyvault-name> --query "[].name"
    
  7. Obter a localização de userAssignedIdentityObject (userAssignedIdentityObject.location)

    az resource show --ids <user-assigned-identity-resource-id> --query location
    
  8. Obtenha o nome da subscrição

    az account show --subscription <subscription-id> --query name
    
  9. Implementar o modelo

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

    Este script serve para implementar um Template a partir do catálogo de serviços

    az storage blob list --account-name <storage-account-name> --container-name servicecatalog --query '[].{Name:name}'
    
    az storage blob download --account-name <storag-eaccount-name> --container-name servicecatalog --name <template-to-download-name> --file ./<template-downloaded-name>
    
    az rest --method get --uri "<enclave-resource-id>?api-version=2026-03-01-preview"
    
    az network vnet subnet list --resource-group <resource-group-name> --vnet-name <vnet-name> --query "[].name"
    
    az keyvault key list --vault-name <keyvault-name> --query "[].name"
    
    az resource show --ids <user-assigned-identity-resource-id> --query location
    
    az account show --subscription <subscription-id> --query name
    
    az deployment group create --resource-group <resource-group-name> --template-file ./<template-downloaded-name> --parameters ./<parameter-file-name>
    

Excluir a implantação

Se não planeia ficar com estes recursos, limpe os recursos desnecessários para evitar cobranças do Azure. Se não existirem outras implementações no grupo de recursos, todo o grupo pode ser eliminado.