Esegue il mapping di un dominio personalizzato a un'app per le funzioniMap a custom domain to a function app

Questo script di esempio crea un'app per le funzioni con le relative risorse e quindi esegue il mapping di www.<yourdomain> a essa.This sample script creates a function app with related resources, and then maps www.<yourdomain> to it. Per eseguire il mapping a un dominio personalizzato, è necessario creare l'app per le funzioni in un piano di servizio app e non in un piano a consumo.To map to a custom domain, your function app must be created in an App Service plan and not in a consumption plan. Funzioni di Azure supporta il mapping di un dominio personalizzato solo usando un record A.Azure Functions only supports mapping a custom domain using an A record.

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don't have an Azure subscription, create a free account before you begin.

Avviare Azure Cloud ShellLaunch Azure Cloud Shell

Azure Cloud Shell è una shell interattiva gratuita che può essere usata per eseguire la procedura di questo articolo.The Azure Cloud Shell is a free interactive shell that you can use to run the steps in this article. Include strumenti comuni di Azure preinstallati e configurati per l'uso con l'account.It has common Azure tools preinstalled and configured to use with your account. È sufficiente fare clic su Copia per copiare il codice, incollarlo in Cloud Shell e quindi premere INVIO per eseguirlo.Just click the Copy to copy the code, paste it into the Cloud Shell, and then press enter to run it. Esistono alcuni modi per avviare Cloud Shell:There are a few ways to launch the Cloud Shell:

Fare clic su Prova nell'angolo superiore destro di un blocco di codice.Click Try It in the upper right corner of a code block. Cloud Shell in questo articolo
Aprire Cloud Shell nel browser.Open Cloud Shell in your browser. https://shell.azure.com/bashhttps://shell.azure.com/bash
Fare clic sul pulsante Cloud Shell nel menu in alto a destra nel portale di Azure.Click the Cloud Shell button on the menu in the upper right of the Azure portal. Cloud Shell nel portale

Se si sceglie di installare e usare l'interfaccia della riga di comando in locale, è necessario usare la versione 2.0 o successiva dell'interfaccia della riga di comando di Azure.If you choose to install and use the CLI locally, you must use the Azure CLI version 2.0 or a later version. Per trovare la versione, eseguire az --version.To find the version, run az --version. Se è necessario eseguire l'installazione o l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure 2.0.If you need to install or upgrade, see Install Azure CLI 2.0.

Script di esempioSample script

#!/bin/bash

fqdn=<Replace with www.{yourdomain}>
storageName=myfuncdomainstore
functionAppName=myfuncdomain

# Create a resource resourceGroupName
az group create \
  --name myResourceGroup \
  --location westeurope

# Create an azure storage account
az storage account create \
  --name $storageName \
  --location westeurope \
  --resource-group myResourceGroup

# Create an App Service plan in Basic tier (minimum required by custom domains).
az appservice plan create \
  --name FunctionAppWithAppServicePlan \
  --resource-group myResourceGroup \
  --location westeurope \
  --sku B1

# Create a Function App
az functionapp create \
  --name $functionAppName \
  --storage-account $storageName \
  --plan FunctionAppWithAppServicePlan \
  --resource-group myResourceGroup

echo "Configure an A record that maps $fqdn to $functionAppName.azurewebsites.net"
read -p "Press [Enter] key when ready ..."

# Before continuing, go to your DNS configuration UI for your custom domain and follow the 
# instructions at https://aka.ms/appservicecustomdns to configure an A record 
# and point it your web app's default domain name.

# Map your prepared custom domain name to the function app.
az appservice web config hostname add \
  --webapp $functionAppName \
  --resource-group myResourceGroup \
  --name $fqdn

echo "You can now browse to http://$fqdn"

Pulire la distribuzioneClean up deployment

Dopo l'esecuzione dello script di esempio, è possibile usare il comando seguente per rimuovere il gruppo di risorse e tutte le risorse ad esso associate.After the sample script has been run, the following command can be used to remove the resource group and all resources associated with it.

az group delete --name myResourceGroup

Spiegazione dello scriptScript explanation

Lo script usa i seguenti comandi: ogni comando della tabella include collegamenti alla documentazione specifica del comando.This script uses the following commands: Each command in the table links to command specific documentation.

ComandoCommand NoteNotes
az group createaz group create Consente di creare un gruppo di risorse in cui sono archiviate tutte le risorse.Creates a resource group in which all resources are stored.
az storage account createaz storage account create Crea un account di archiviazione necessario per l'app per le funzioni.Creates a storage account required by the function app.
az appservice plan createaz appservice plan create Crea un piano di servizio app necessario per eseguire il mapping di un dominio personalizzato.Creates an App Service plan required to map a custom domain.
az functionapp createaz functionapp create Creare un'app per le funzioni.Creates a function app.
az appservice web config hostname addaz appservice web config hostname add Esegue il mapping di un dominio personalizzato a un'app per le funzioni.Maps a custom domain to a function app.

Passaggi successiviNext steps

Per altre informazioni sull'interfaccia della riga di comando di Azure, vedere la documentazione sull'interfaccia della riga di comando di Azure.For more information on the Azure CLI, see Azure CLI documentation.

Altri esempi di script dell'interfaccia della riga di comando di Funzioni di Azure sono disponibili nella documentazione di Funzioni di Azure.Additional Functions CLI script samples can be found in the Azure Functions documentation.