Quickstart: Implemente 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 usando comandos 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

Prerequisites

Antes de começar, reveja os pré-requisitos especificados pelo modelo de catálogo de serviços que planeia implementar. Implementa/instala quaisquer recursos pré-requisitos necessários que ainda não estejam disponíveis e confirma que tens permissão para os usar.

Depois recolhe os nomes dos recursos, IDs de recursos e outros valores de parâmetros exigidos por esse modelo. Os pré-requisitos, parâmetros obrigatórios e valores padrão podem variar consoante o modelo e a versão. Não presuma que cada modelo requer os recursos usados no exemplo seguinte.

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

Pode encontrar os modelos de catálogo de serviços no Azure Public no inventory.xml ficheiro de inventário.

Descarregue um modelo específico usando o nome que encontrar no inventário (por exemplo, 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 }

    A conta de armazenamento do catálogo de serviços varia consoante o ambiente:

    • 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. Descarregue cada modelo. Continue o script PowerShell do passo anterior. Para descarregar apenas um modelo, substitua o filtro pelo URL do modelo que selecionou.

    # download all templates
$urls | ForEach-Object {
    $url = $_.InnerText
    $fileName = Split-Path -Leaf $url
    Invoke-WebRequest -Uri $url -OutFile $fileName
}

  3. Abra o modelo e determine quais os parâmetros que precisa de fornecer. Neste exemplo, use 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 params.json ficheiro 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. Obtenha os recursos do enclave para fornecer os seguintes valores de parâmetro:

    • 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>"

    Use uma versão da API atualmente suportada Microsoft.Mission da referência da API do Azure Enclave (por exemplo, 2026-04-01).

    Use a resposta e as propriedades do recurso do Azure para preencher os valores em params.json. 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. Também deve identificar privateLinkSubnetName e keyName.

  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>

Validar a implementação

  1. Verifica o estado da implantação.

    az deployment group show --resource-group <resource-group-name> --name <deployment-name> --query properties.provisioningState

  2. Confirme que os recursos criados pelo modelo estão presentes.

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

Excluir a implantação

Se não planeia manter estes recursos, elimine apenas os recursos criados por esta implementação para evitar cobranças no Azure. Elimina o grupo de recursos apenas quando estiver dedicado a esta implantação e confirmares que não contém recursos que precises de manter.

Conteúdo relacionado

  • Última atualização a