Snabbstart: Distribuera en tjänstekatalogmall med hjälp av CLI

Azure Enclave är en molnnätverkstjänst som ger organisationer med mycket känsliga data möjlighet att snabbt driftsätta och hantera arbetsbelastningar i kommersiella och isolerade Azure-moln i stor skala. I den här snabbstarten kommer du att göra följande:

  • Distribuera en tjänstekatalogmall genom att använda Azure CLI-kommandon.

Note

Den här exempeldistributionen är bara i demosyfte och representerar inte alla metodtips för administration av nätverk, system eller program.

Innan du börjar

Prerequisites

Innan du börjar, granska de förutsättningar som anges i den tjänstekatalogmall du planerar att distribuera. Distribuera alla nödvändiga resurser som inte redan finns tillgängliga och bekräfta att du har tillstånd att använda dem.

Samla sedan in resursnamn, resurs-ID och andra parametervärden som krävs för den mallen. Förutsättningarna, de nödvändiga parametrarna och standardvärdena kan variera beroende på mall och version. Anta inte att varje mall kräver de resurser som används i följande exempel.

Distribuera en mall från tjänstkatalogen

Du kan hitta tjänstekatalogmallarna i Azure Public i inventeringsinventory.xmlfilen.

Ladda ner en specifik mall genom att använda namnet du hittar i inventariet (till exempel, deploy-adminVM-1.0.1.json).

  1. Visa en lista över tillgängliga mallar i tjänstkatalogen:

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

    Tjänstekatalogens lagringskonto varierar beroende på miljö:

    • 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. Ladda ner alla mallar. Fortsätt med PowerShell-skriptet från föregående steg. För att ladda ner endast en mall, ersätt filtret med mall-URL:en du valt.

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

  3. Öppna mallen och bestäm vilka parametrar du behöver ange där. I det här exemplet använder du storageAccount/deploy-storage-account-1.0.0.json.

    Observera vilka parametrar som krävs och vilka parametrar som har standardvärden.

    Skapa en params.json fil för att ange parametervärdena:

    {
    "$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. Hämta enklavens resurser för att tillhandahålla följande parametervärden:

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

    Använd en för närvarande stödd Microsoft.Mission API-version från Azure Enclave API-referensen (till exempel, 2026-04-01).

    Använd svaret och Azure resource properties för att fylla i värdena i params.json. För fler API-operationer och scheman, se Azure Enclave API-referensen och Azure Enclave API-källkod och specifikationer. Du måste också identifiera privateLinkSubnetName och keyName.

  5. Visa en lista över undernäten i det virtuella nätverket (privateLinkSubnetName)

    az network vnet subnet list --resource-group <resource-group-name> --vnet-name <vnet-name> --query "[].name"

  6. Hämta CMK-nyckelns namn (keyName)

    az keyvault key list --vault-name <keyvault-name> --query "[].name"

  7. Hämta platsen för userAssignedIdentityObject (userAssignedIdentityObject.location)

    az resource show --ids <user-assigned-identity-resource-id> --query location

  8. Hämta prenumerationsnamnet

    az account show --subscription <subscription-id> --query name

  9. Använd mallen

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

Verifiera utplaceringen

  1. Kontrollera driftsättningsstatusen.

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

  2. Bekräfta att resurserna som skapas av mallen finns där.

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

Ta bort distributionen

Om du inte planerar att behålla dessa resurser, radera endast de resurser som skapats av den här distributionen för att undvika Azure-kostnader. Ta bort resursgruppen endast när den är dedikerad till den här distributionen och du har bekräftat att den inte innehåller några resurser som du behöver behålla.

Relaterat innehåll

  • Uppdaterades senast