Informazioni di riferimento su Funzioni di Azure Core Tools

Questo articolo fornisce la documentazione di riferimento per gli strumenti di base Funzioni di Azure, che consente di sviluppare, gestire e distribuire progetti Funzioni di Azure dal computer locale. Per altre informazioni sull'uso di Core Tools, vedere Usare Funzioni di Azure Core Tools.

I comandi di Core Tools sono organizzati nei contesti seguenti, ognuno dei quali fornisce un set univoco di azioni.

Contesto del comando	Descrizione
func	Comandi usati per creare ed eseguire funzioni nel computer locale.
func azure	Comandi per l'uso delle risorse di Azure, inclusa la pubblicazione.
func azurecontainerapps	Distribuire un'app per le funzioni in contenitori in App Azure Container.
func durable	Comandi per l'uso di Durable Functions.
func extensions	Comandi per l'installazione e la gestione delle estensioni.
func kubernetes	Comandi per l'uso di Kubernetes e Funzioni di Azure.
func settings	Comandi per la gestione delle impostazioni di ambiente per l'host funzioni locale.
func templates	Comandi per elencare i modelli di funzione disponibili.

Prima di usare i comandi in questo articolo, è necessario installare Core Tools.

func init

Crea un nuovo progetto di Funzioni in un linguaggio specifico.

func init <PROJECT_FOLDER>

Quando si specifica <PROJECT_FOLDER>, il progetto viene creato in una nuova cartella con questo nome. In caso contrario, viene utilizzata la cartella corrente.

func init supporta le opzioni seguenti, che non supportano la versione 1.x, se non diversamente specificato:

Opzione	Descrizione
--csx	Crea funzioni .NET come script C#, ovvero il comportamento della versione 1.x. Valido solo con --worker-runtime dotnet.
--docker	Crea un Dockerfile per un contenitore usando un'immagine di base basata sull'oggetto scelto --worker-runtime. Usare questa opzione quando si prevede di distribuire un'app per le funzioni in contenitori.
--docker-only	Aggiunge un Dockerfile a un progetto esistente. Richiede il runtime di lavoro se non specificato o impostato in local.settings.json. Usare questa opzione quando si prevede di distribuire un'app per le funzioni in contenitori e il progetto esiste già.
--force	Inizializzare il progetto anche se contiene file esistenti. Questa impostazione sovrascrive i file esistenti con lo stesso nome. Gli altri file nella cartella del progetto non sono interessati.
--language	Inizializza un progetto specifico del linguaggio. Attualmente supportato quando --worker-runtime è impostato su node. Le opzioni sono typescript e javascript. È anche possibile usare --worker-runtime javascript o --worker-runtime typescript.
--managed-dependencies	Installa le dipendenze gestite. Attualmente, solo il runtime del ruolo di lavoro di PowerShell supporta questa funzionalità.
--model	Imposta il modello di programmazione desiderato per un linguaggio di destinazione quando sono disponibili più modelli. Le opzioni supportate sono V1 e V2 per Python e V4V3 per Node.js. Per altre informazioni, vedere rispettivamente la guida per sviluppatori Python e la guida per sviluppatori Node.js.
--source-control	Controlla se viene creato un repository GIT. Per impostazione predefinita, non viene creato un repository. Quando è true viene creato un repository.
--worker-runtime	Imposta il runtime del linguaggio per il progetto. I valori supportati sono: csharp, dotnet-isolateddotnet, , javascript,node (JavaScript), powershell, pythone typescript. Per Java usare Maven. Per generare un progetto indipendente dal linguaggio con solo i file di progetto, usare custom. Quando non è impostato, viene richiesto di scegliere il runtime durante l'inizializzazione.
--target-framework	Imposta il framework di destinazione per il progetto dell'app per le funzioni. Valido solo con --worker-runtime dotnet-isolated. I valori supportati sono: net6.0 (impostazione predefinita), net7.0, net8.0e net48 (.NET Framework 4.8).

Nota

Quando si usano o --docker--dockerfile opzioni, Core Tools crea automaticamente il Dockerfile per le funzioni C#, JavaScript, Python e PowerShell. Per le funzioni Java, è necessario creare manualmente il Dockerfile. Per altre informazioni, vedere Creazione di app per le funzioni in contenitori.

log func

Ottiene i log per le funzioni in esecuzione in un cluster Kubernetes.

func logs --platform kubernetes --name <APP_NAME>

L'azione func logs supporta le opzioni seguenti:

Opzione	Descrizione
--platform	Piattaforma di hosting per le app per le funzioni. Opzioni supportate: kubernetes.
--name	Nome dell'app per le funzioni in Azure.

Per altre informazioni, vedere Funzioni di Azure in Kubernetes con KEDA.

func new

Crea una nuova funzione nel progetto corrente in base a un modello.

func new

Quando si esegue func new senza l'opzione --template , viene richiesto di scegliere un modello. Nella versione 1.x è necessario anche scegliere la lingua.

L'azione func new supporta le opzioni seguenti:

Opzione	Descrizione
--authlevel	Consente di impostare il livello di autorizzazione per un trigger HTTP. I valori supportati sono: function, anonymous, admin. L'autorizzazione non viene applicata durante l'esecuzione in locale. Per altre informazioni, vedere l'articolo sul binding HTTP.
--csx	(Versione 2.x e versioni successive). Genera gli stessi modelli di script C# (con estensione csx) usati nella versione 1.x e nel portale.
--language, -l	Il linguaggio di programmazione del modello, come C#, F# o JavaScript. Questa opzione è necessaria nella versione 1.x. Nella versione 2.x e successive non si usa questa opzione perché il linguaggio è definito dal runtime del ruolo di lavoro.
--name, -n	Nome della funzione.
--template, -t	Usare il comando func templates list per visualizzare l'elenco completo dei modelli disponibili per ogni linguaggio supportato.

Per altre informazioni, vedere Creare una funzione.

func run

Solo versione 1.x.

Consente di richiamare direttamente una funzione, simile all'esecuzione di una funzione usando la scheda Test nella portale di Azure. Questa azione è supportata solo nella versione 1.x. Per le versioni successive, usare func start e chiamare direttamente l'endpoint della funzione.

func run

L'azione func run supporta le opzioni seguenti:

Opzione	Descrizione
--content	Contenuto inline passato alla funzione.
--debug	Associare un debugger al processo host prima di eseguire la funzione.
--file	Il nome del file da usare come contenuto.
--no-interactive	Non richiede input, utile per gli scenari di automazione.
--timeout	Tempo di attesa (in secondi) fino a quando l'host locale di Funzioni è pronto.

Ad esempio, per chiamare una funzione attivata da HTTP e passare il corpo del contenuto, eseguire il comando seguente:

func run MyHttpTrigger --content '{\"name\": \"Azure\"}'

inizio func

Avvia l'host di runtime locale e carica il progetto di funzione nella cartella corrente.

Il comando specifico dipende dalla versione di runtime.

v2.x+

func start

func start supporta le opzioni seguenti:

Opzione	Descrizione
--cert	Il percorso in un file con estensione pfx che contiene una chiave privata. Supportato solo con --useHttps.
--cors	Un elenco delimitato dalla virgola di origini CORS, senza spazi.
--cors-credentials	Consentire le richieste autenticate tra le origini usando i cookie e l'intestazione Authentication.
--dotnet-isolated-debug	Se impostato su true, sospende il processo di lavoro .NET fino a quando non viene collegato un debugger dal progetto isolato .NET sottoposto a debug.
--enable-json-output	Genera i log della console come JSON, quando possibile.
--enableAuth	Abilitare la pipeline di gestione dell'autenticazione completa, con i requisiti di autorizzazione.
--functions	Elenco delimitato da spazi di funzioni da caricare.
--language-worker	Argomenti per configurare il ruolo di lavoro del linguaggio. Ad esempio, è possibile abilitare il debug per il ruolo di lavoro del linguaggio fornendo la porta di debug e altri argomenti obbligatori.
--no-build	Non compilare il progetto corrente prima dell'esecuzione. Solo per i progetti di classe .NET. Il valore predefinito è false.
--password	La password o un file che contiene la password per un file con estensione pfx. Usati solo con --cert.
--port	La porta locale su cui ascoltare. Valore predefinito: 7071.
--timeout	Il timeout per l'host di Funzioni da avviare, in secondi. Impostazione predefinita: 20 secondi.
--useHttps	Eseguire l'associazione a https://localhost:{port} anziché a http://localhost:{port}. Per impostazione predefinita, questa opzione crea un certificato attendibile nel computer in uso.

Con il progetto in esecuzione, è possibile verificare i singoli endpoint di funzione.

v1.x

func host start

func start supporta le opzioni seguenti:

Opzione	Descrizione
--cors	Un elenco delimitato dalla virgola di origini CORS, senza spazi.
--port	La porta locale su cui ascoltare. Valore predefinito: 7071.
--pause-on-error	Sospendere l'input prima di uscire dal processo. Viene usato quando si avvia Core Tools da un ambiente di sviluppo integrato (IDE).
--script-root	Viene usato per specificare il percorso della radice dell'app per le funzioni da eseguire o distribuire. Viene usato per progetti compilati che generano file di progetto in una sottocartella. Ad esempio, quando si crea un progetto di libreria di classi C#, i file host.json, local.settings.json e function.json vengono generati in una sottocartella radice con un percorso simile a MyProject/bin/Debug/netstandard2.0. In questo caso, impostare il prefisso come --script-root MyProject/bin/Debug/netstandard2.0. Questa è la radice dell'app per le funzioni durante l'esecuzione in Azure.
--timeout	Il timeout per l'host di Funzioni da avviare, in secondi. Impostazione predefinita: 20 secondi.
--useHttps	Eseguire l'associazione a https://localhost:{port} anziché a http://localhost:{port}. Per impostazione predefinita, questa opzione crea un certificato attendibile nel computer in uso.

Nella versione 1.x è anche possibile usare il func run comando per eseguire una funzione specifica e passare i dati di test.

func azure functionapp fetch-app-settings

Ottiene le impostazioni da un'app per le funzioni specifica.

func azure functionapp fetch-app-settings <APP_NAME> 

Per altre informazioni, vedere Scaricare le impostazioni dell'applicazione.

Impostazioni vengono scaricati nel file local.settings.json per il progetto. I valori sullo schermo sono mascherati per la sicurezza. È possibile proteggere le impostazioni nel file local.settings.json abilitando la crittografia locale.

func azure functionapp list-functions

Restituisce un elenco delle funzioni nell'app per le funzioni specificata.

func azure functionapp list-functions <APP_NAME>

func azure functionapp logstream

Connessione il prompt dei comandi locale per trasmettere i log per l'app per le funzioni in Azure.

func azure functionapp logstream <APP_NAME>

Il timeout predefinito per la connessione è di 2 ore. È possibile modificare il timeout aggiungendo un'impostazione dell'app denominata SCM_LOGSTREAM_TIMEOUT, con un valore di timeout in secondi. Non ancora supportato per le app Linux nel piano a consumo. Per queste app, usare l'opzione --browser per visualizzare i log nel portale.

L'azione deploy supporta le opzioni seguenti:

Opzione	Descrizione
--browser	Aprire app Azure lication Insights Live Stream per l'app per le funzioni nel browser predefinito.

Per altre informazioni, vedere Abilitare i log di esecuzione del flusso in Funzioni di Azure.

func azure functionapp publish

Distribuisce un progetto di Funzioni in una risorsa dell'app per le funzioni esistente in Azure.

func azure functionapp publish <APP_NAME>

Per altre informazioni, vedere Distribuire i file di progetto.

Si applicano le opzioni di pubblicazione seguenti, in base alla versione:

v2.x+

Opzione	Descrizione
--access-token	Consente di usare un token di accesso specifico quando si eseguono azioni di Azure autenticate.
--access-token-stdin	Legge un token di accesso specifico da un input standard. Usare questa opzione quando si legge il token direttamente da un comando precedente, az account get-access-tokenad esempio .
--additional-packages	Elenco di pacchetti da installare durante la creazione di dipendenze native. Ad esempio: python3-dev libevent-dev.
--build, -b	Esegue l'azione di compilazione durante la distribuzione in un'app per le funzioni Linux. Accetta: remote e local.
--build-native-deps	Ignora la generazione della cartella durante la .wheels pubblicazione di app per le funzioni Python.
--csx	Pubblica un progetto di script C# (file con estensione csx).
--dotnet-cli-params	Quando si pubblicano funzioni C# compilate (con estensione csproj), gli strumenti di base chiamano dotnet build --output bin/publish. Tutti i parametri passati a questo vengono aggiunti alla riga di comando.
--force	Ignorare la verifica di prepubblicazione in determinati scenari.
--list-ignored-files	Visualizza un elenco di file ignorati durante la .funcignore pubblicazione, che si basa sul file.
--list-included-files	Visualizza un elenco di file pubblicati, che si basa sul .funcignore file.
--management-url	Imposta l'URL di gestione per il cloud. Usare questa opzione durante l'esecuzione in un cloud sovrano.
--no-build	Il progetto non viene compilato durante la pubblicazione. Per Python pip install , non viene eseguito.
--nozip	Disattiva la modalità Run-From-Package predefinita.
--overwrite-settings -y	Eliminare il prompt per sovrascrivere le impostazioni dell'app quando si usa --publish-local-settings -i.
--publish-local-settings -i	Pubblicare le impostazioni di local.settings.json in Azure, suggerendo di sovrascrivere eventuali impostazioni esistenti. Se si usa un emulatore di archiviazione locale, modificare prima l'impostazione dell'app su una connessione di archiviazione effettiva.
--publish-settings-only, -o	Pubblicare solo le impostazioni e ignorare il contenuto. Viene suggerito il valore predefinito.
--slot	Nome facoltativo di uno slot specifico in cui pubblicare.
--subscription	Imposta la sottoscrizione predefinita da usare.

v1.x

Opzione	Descrizione
--overwrite-settings -y	Eliminare il prompt per sovrascrivere le impostazioni dell'app quando si usa --publish-local-settings -i.
--publish-local-settings -i	Pubblicare le impostazioni di local.settings.json in Azure, suggerendo di sovrascrivere eventuali impostazioni esistenti. Se si usa l'emulatore di Archiviazione di Microsoft Azure, modificare prima l'impostazione dell'app su una connessione di archiviazione effettiva.

func azure storage fetch-connection-string

Ottiene il stringa di connessione per l'account Archiviazione di Azure specificato.

func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>

Per altre informazioni, vedere Scaricare un stringa di connessione di archiviazione.

func azurecontainerapps deploy

Distribuisce un'app per le funzioni in contenitori in un ambiente app Azure Container. Sia l'account di archiviazione usato dall'app per le funzioni che l'ambiente deve già esistere. Per altre informazioni, vedere Hosting di app azure Container di Funzioni di Azure.

func azurecontainerapps deploy --name <APP_NAME> --environment <ENVIRONMENT_NAME> --storage-account <STORAGE_CONNECTION> --resource-group <RESOURCE_GROUP> --image-name <IMAGE_NAME> --registry-server <REGISTRY_SERVER> --registry-username <USERNAME> --registry-password <PASSWORD>

Si applicano le opzioni di distribuzione seguenti:

Opzione	Descrizione
--access-token	Consente di usare un token di accesso specifico quando si eseguono azioni di Azure autenticate.
--access-token-stdin	Legge un token di accesso specifico da un input standard. Usare questa opzione quando si legge il token direttamente da un comando precedente, az account get-access-tokenad esempio .
--environment	Nome di un ambiente app contenitore esistente.
--image-build	Se impostato su true, ignora la compilazione Docker locale.
--image-name	Nome dell'immagine di un contenitore esistente in un registro contenitori. Il nome dell'immagine include il nome del tag.
--location	Area per la distribuzione. Idealmente, si tratta della stessa area delle risorse dell'ambiente e dell'account di archiviazione.
--management-url	Imposta l'URL di gestione per il cloud. Usare questa opzione durante l'esecuzione nel cloud sovrano.
--name	Nome usato per la distribuzione dell'app per le funzioni nell'ambiente App contenitore. Questo stesso nome viene usato anche quando si gestisce l'app per le funzioni nel portale. Il nome deve essere univoco nell'ambiente.
--registry	Quando impostata, viene eseguita una compilazione Docker e l'immagine viene inserita nel registro impostato in --registry. Non è possibile usare --registry con --image-name. Per l'hub Docker, usare --registry-usernameanche .
--registry-password	Password o token usati per recuperare l'immagine da un registro privato.
--registry-username	Nome utente usato per recuperare l'immagine da un registro privato.
--resource-group	Gruppo di risorse in cui creare le risorse correlate alle funzioni.
--storage-account	Il stringa di connessione per l'account di archiviazione da usare dall'app per le funzioni.
--subscription	Imposta la sottoscrizione predefinita da usare.
--worker-runtime	Imposta il linguaggio di runtime dell'app per le funzioni. Questo parametro viene usato solo con --image-name e --image-build. In caso contrario, la lingua viene determinata durante la compilazione locale. I valori supportati sono: dotnet, nodedotnetIsolated, python, powershell, e custom (per i gestori dei clienti).

Importante

Archiviazione stringa di connessione e altre credenziali del servizio sono segreti importanti. Assicurarsi di archiviare in modo sicuro tutti i file di script che usano func azurecontainerapps deploy e non archiviarli in alcun controllo del codice sorgente accessibile pubblicamente.

distribuzione func

Il func deploy comando è deprecato. Usare invece func kubernetes deploy.

func durable delete-task-hub

Elimina tutti gli artefatti di archiviazione nell'hub attività Durable Functions.

func durable delete-task-hub

L'azione delete-task-hub supporta le opzioni seguenti:

Opzione	Descrizione
--connection-string-setting	Nome facoltativo dell'impostazione contenente il stringa di connessione di archiviazione da usare.
--task-hub-name	Nome facoltativo dell'hub attività durevole da usare.

Per altre informazioni, vedere la documentazione di Durable Functions.

func durable get-history

Restituisce la cronologia dell'istanza di orchestrazione specificata.

func durable get-history --id <INSTANCE_ID>

L'azione get-history supporta le opzioni seguenti:

Opzione	Descrizione
--id	Specifica l'ID di un'istanza di orchestrazione (obbligatoria).
--connection-string-setting	Nome facoltativo dell'impostazione contenente il stringa di connessione di archiviazione da usare.
--task-hub-name	Nome facoltativo dell'hub attività durevole da usare.

Per altre informazioni, vedere la documentazione di Durable Functions.

func durable get-instances

Restituisce lo stato di tutte le istanze di orchestrazione. Supporta il paging usando il top parametro .

func durable get-instances

L'azione get-instances supporta le opzioni seguenti:

Opzione	Descrizione
--continuation-token	Token facoltativo che indica una pagina/sezione specifica delle richieste da restituire.
--connection-string-setting	Nome facoltativo dell'impostazione dell'app che contiene il stringa di connessione di archiviazione da usare.
--created-after	Facoltativamente, ottenere le istanze create dopo questa data/ora (UTC). Vengono accettate tutte le datetime formattate ISO 8601.
--created-before	Facoltativamente, ottenere le istanze create prima di una data/ora specifica (UTC). Vengono accettate tutte le datetime formattate ISO 8601.
--runtime-status	Facoltativamente, ottenere le istanze il cui stato corrisponde a uno stato specifico, tra cui running, completede failed. È possibile fornire una o più statue separate da spazi.
--top	Facoltativamente, limitare il numero di record restituiti in una determinata richiesta.
--task-hub-name	Nome facoltativo dell'hub attività di Durable Functions da usare.

Per altre informazioni, vedere la documentazione di Durable Functions.

func durable get-runtime-status

Restituisce lo stato dell'istanza di orchestrazione specificata.

func durable get-runtime-status --id <INSTANCE_ID>

L'azione get-runtime-status supporta le opzioni seguenti:

Opzione	Descrizione
--connection-string-setting	Nome facoltativo dell'impostazione contenente il stringa di connessione di archiviazione da usare.
--id	Specifica l'ID di un'istanza di orchestrazione (obbligatoria).
--show-input	Se impostata, la risposta contiene l'input della funzione.
--show-output	Se impostata, la risposta contiene la cronologia di esecuzione.
--task-hub-name	Nome facoltativo dell'hub attività di Durable Functions da usare.

Per altre informazioni, vedere la documentazione di Durable Functions.

func durable purge-history

Eliminare lo stato, la cronologia e l'archiviazione BLOB dell'istanza di orchestrazione per orchestrazioni precedenti alla soglia specificata.

func durable purge-history

L'azione purge-history supporta le opzioni seguenti:

Opzione	Descrizione
--connection-string-setting	Nome facoltativo dell'impostazione contenente il stringa di connessione di archiviazione da usare.
--created-after	Facoltativamente, eliminare la cronologia delle istanze create dopo questa data/ora (UTC). Vengono accettati tutti i valori datetime formattati ISO 8601.
--created-before	Facoltativamente, eliminare la cronologia delle istanze create prima di questa data/ora (UTC). Vengono accettati tutti i valori datetime formattati ISO 8601.
--runtime-status	Facoltativamente, eliminare la cronologia delle istanze il cui stato corrisponde a uno stato specifico, tra cui completd, terminatedcanceled, e failed. È possibile fornire una o più statue separate da spazi. Se non si include --runtime-status, la cronologia delle istanze viene eliminata indipendentemente dallo stato.
--task-hub-name	Nome facoltativo dell'hub attività di Durable Functions da usare.

Per altre informazioni, vedere la documentazione di Durable Functions.

func durable raise-event

Genera un evento all'istanza di orchestrazione specificata.

func durable raise-event --event-name <EVENT_NAME> --event-data <DATA>

L'azione raise-event supporta le opzioni seguenti:

Opzione	Descrizione
--connection-string-setting	Nome facoltativo dell'impostazione contenente il stringa di connessione di archiviazione da usare.
--event-data	Dati da passare all'evento, inline o da un file JSON (obbligatorio). Per i file, anteporre il percorso al file con un e commerciale (@), ad esempio @path/to/file.json.
--event-name	Nome dell'evento da generare (obbligatorio).
--id	Specifica l'ID di un'istanza di orchestrazione (obbligatoria).
--task-hub-name	Nome facoltativo dell'hub attività di Durable Functions da usare.

Per altre informazioni, vedere la documentazione di Durable Functions.

rewind durevole func

Riavvolge l'istanza di orchestrazione specificata.

func durable rewind --id <INSTANCE_ID> --reason <REASON>

L'azione rewind supporta le opzioni seguenti:

Opzione	Descrizione
--connection-string-setting	Nome facoltativo dell'impostazione contenente il stringa di connessione di archiviazione da usare.
--id	Specifica l'ID di un'istanza di orchestrazione (obbligatoria).
--reason	Motivo della riavvolgimento dell'orchestrazione (obbligatorio).
--task-hub-name	Nome facoltativo dell'hub attività di Durable Functions da usare.

Per altre informazioni, vedere la documentazione di Durable Functions.

func durable start-new

Avvia una nuova istanza della funzione dell'agente di orchestrazione specificata.

func durable start-new --id <INSTANCE_ID> --function-name <FUNCTION_NAME> --input <INPUT>

L'azione start-new supporta le opzioni seguenti:

Opzione	Descrizione
--connection-string-setting	Nome facoltativo dell'impostazione contenente il stringa di connessione di archiviazione da usare.
--function-name	Nome della funzione dell'agente di orchestrazione da avviare (obbligatorio).
--id	Specifica l'ID di un'istanza di orchestrazione (obbligatoria).
--input	Input per la funzione dell'agente di orchestrazione, inline o da un file JSON (obbligatorio). Per i file, anteporre il percorso al file con un e commerciale (@), ad esempio @path/to/file.json.
--task-hub-name	Nome facoltativo dell'hub attività di Durable Functions da usare.

Per altre informazioni, vedere la documentazione di Durable Functions.

func durable terminate

Arresta l'istanza di orchestrazione specificata.

func durable terminate --id <INSTANCE_ID> --reason <REASON>

L'azione terminate supporta le opzioni seguenti:

Opzione	Descrizione
--connection-string-setting	Nome facoltativo dell'impostazione contenente il stringa di connessione di archiviazione da usare.
--id	Specifica l'ID di un'istanza di orchestrazione (obbligatoria).
--reason	Motivo dell'arresto dell'orchestrazione (obbligatorio).
--task-hub-name	Nome facoltativo dell'hub attività di Durable Functions da usare.

Per altre informazioni, vedere la documentazione di Durable Functions.

installazione delle estensioni func

Installa manualmente le estensioni di Funzioni in un progetto non-.NET o in un progetto script C#.

func extensions install --package Microsoft.Azure.WebJobs.Extensions.<EXTENSION> --version <VERSION>

L'azione install supporta le opzioni seguenti:

Opzione	Descrizione
--configPath	Percorso della directory contenente il file extensions.csproj.
--csx	Supporta i progetti di scripting C# (con estensione csx).
--force	Aggiornare le versioni delle estensioni esistenti.
--output	Percorso di output per le estensioni.
--package	Identificatore per un pacchetto di estensione specifico. Se non specificato, vengono installate tutte le estensioni a cui si fa riferimento, come con func extensions sync.
--source	Origine feed NuGet quando non si usa NuGet.org.
--version	Versione del pacchetto di estensione.

L'esempio seguente installa la versione 5.0.1 dell'estensione Hub eventi nel progetto locale:

func extensions install --package Microsoft.Azure.WebJobs.Extensions.EventHubs --version 5.0.1

Quando si usa func extensions install, si applicano le considerazioni seguenti:

• Per i progetti C# compilati (sia in-process che processo di lavoro isolato), usare invece metodi di installazione del pacchetto NuGet standard, ad esempio dotnet add package.

• Per installare manualmente le estensioni con Core Tools, è necessario che sia installato .NET 6.0 SDK .

• Quando possibile, è consigliabile usare invece bundle di estensioni. Di seguito sono riportati alcuni motivi per cui potrebbe essere necessario installare manualmente le estensioni:

  • È necessario accedere a una versione specifica di un'estensione non disponibile in un bundle.
  • È necessario accedere a un'estensione personalizzata non disponibile in un bundle.
  • È necessario accedere a una combinazione specifica di estensioni non disponibili in un singolo bundle.

• Prima di poter installare manualmente le estensioni, è necessario rimuovere l'oggetto extensionBundle dal file host.json che definisce il bundle. Non viene eseguita alcuna azione quando un bundle di estensione è già impostato nel file host.json.

• La prima volta che si installa in modo esplicito un'estensione, viene aggiunto un file di progetto .NET denominato extensions.csproj alla radice del progetto dell'app. Questo file definisce il set di pacchetti NuGet richiesti dalle funzioni. Sebbene sia possibile usare i riferimenti al pacchetto NuGet in questo file, Core Tools consente di installare le estensioni senza dover modificare manualmente questo file di progetto C#.

sincronizzazione delle estensioni func

Installa tutte le estensioni aggiunte all'app per le funzioni.

L'azione sync supporta le opzioni seguenti:

Opzione	Descrizione
--configPath	Percorso della directory contenente il file extensions.csproj.
--csx	Supporta i progetti di scripting C# (con estensione csx).
--output	Percorso di output per le estensioni.

Rigenera un file extensions.csproj mancante. Non viene eseguita alcuna azione quando un bundle di estensione viene definito nel file host.json.

distribuzione di func kubernetes

Distribuisce un progetto di Funzioni come contenitore Docker personalizzato in un cluster Kubernetes.

func kubernetes deploy 

Questo comando compila il progetto come contenitore personalizzato e lo pubblica in un cluster Kubernetes. I contenitori personalizzati devono disporre di un Dockerfile. Per creare un'app con un Dockerfile, usare l'opzione --dockerfile con il func init comando .

Sono disponibili le opzioni di distribuzione di Kubernetes seguenti:

Opzione	Descrizione
--dry-run	Facoltativamente, visualizza il modello di distribuzione, senza esecuzione.
--config-map-name	Nome facoltativo di una mappa di configurazione esistente con le impostazioni dell'app per le funzioni da usare nella distribuzione. Richiede --use-config-map. Il comportamento predefinito consiste nel creare impostazioni in base all'oggetto Values nel file local.settings.json.
--cooldown-period	Periodo di raffreddamento (in secondi) dopo che tutti i trigger non sono più attivi prima che la distribuzione ridosca fino a zero, con un valore predefinito di 300 s.
--ignore-errors	Continua la distribuzione dopo che una risorsa restituisce un errore. Il comportamento predefinito è arrestare il processo in caso di errore.
--image-name	Nome dell'immagine da usare per la distribuzione dei pod e da cui leggere le funzioni.
--keda-version	Imposta la versione di KEDA da installare. Le opzioni valide sono: v1 e v2 (impostazione predefinita).
--keys-secret-name	Nome di una raccolta di segreti Kubernetes da usare per l'archiviazione delle chiavi di accesso alle funzioni.
--max-replicas	Imposta il numero massimo di repliche per il quale viene ridimensionata la scalabilità automatica orizzontale dei pod .
--min-replicas	Imposta il numero minimo di repliche al di sotto del quale HPA non verrà ridimensionato.
--mount-funckeys-as-containervolume	Monta i tasti di scelta della funzione come volume del contenitore.
--name	Nome usato per la distribuzione e altri artefatti in Kubernetes.
--namespace	Imposta lo spazio dei nomi Kubernetes su cui eseguire la distribuzione, che per impostazione predefinita viene impostato sullo spazio dei nomi predefinito.
--no-docker	Le funzioni vengono lette dalla directory corrente anziché da un'immagine. Richiede il montaggio del file system di immagini.
--registry	Quando impostata, viene eseguita una compilazione Docker e viene eseguito il push dell'immagine in un registro di tale nome. Non è possibile usare --registry con --image-name. Per Docker, usare il nome utente.
--polling-interval	Intervallo di polling (in secondi) per il controllo dei trigger non HTTP, con un valore predefinito di 30 secondi.
--pull-secret	Segreto utilizzato per accedere alle credenziali del Registro di sistema privato.
--secret-name	Nome di una raccolta di segreti Kubernetes esistente che contiene le impostazioni dell'app per le funzioni da usare nella distribuzione. Il comportamento predefinito consiste nel creare impostazioni in base all'oggetto Values nel file local.settings.json.
--show-service-fqdn	Visualizza gli URL dei trigger HTTP con il nome di dominio completo kubernetes anziché il comportamento predefinito dell'uso di un indirizzo IP.
--service-type	Imposta il tipo di servizio Kubernetes. I valori supportati sono: ClusterIP, NodePorte LoadBalancer (impostazione predefinita).
--use-config-map	Usare un ConfigMap oggetto (v1) anziché un Secret oggetto (v1) per configurare le impostazioni dell'app per le funzioni. Il nome della mappa viene impostato usando --config-map-name.

Core Tools usa l'interfaccia della riga di comando docker locale per compilare e pubblicare l'immagine. Assicurarsi che Docker sia già installato in locale. Eseguire il docker login comando per connettersi all'account.

Per altre informazioni, vedere Distribuzione di un'app per le funzioni in Kubernetes.

installazione di func kubernetes

Installa KEDA in un cluster Kubernetes.

func kubernetes install 

Installa KEDA nel cluster definito nel file di configurazione kubectl.

L'azione install supporta le opzioni seguenti:

Opzione	Descrizione
--dry-run	Visualizza il modello di distribuzione, senza esecuzione.
--keda-version	Imposta la versione di KEDA da installare. Le opzioni valide sono: v1 e v2 (impostazione predefinita).
--namespace	Supporta l'installazione in uno spazio dei nomi Kubernetes specifico. Se non è impostato, viene usato lo spazio dei nomi predefinito.

Per altre informazioni, vedere Gestione di KEDA e funzioni in Kubernetes.

func kubernetes remove

Rimuove KEDA dal cluster Kubernetes definito nel file di configurazione kubectl.

func kubernetes remove 

Rimuove KEDA dal cluster definito nel file di configurazione kubectl.

L'azione remove supporta le opzioni seguenti:

Opzione	Descrizione
--namespace	Supporta la disinstallazione da uno spazio dei nomi Kubernetes specifico. Se non è impostato, viene usato lo spazio dei nomi predefinito.

Per altre informazioni, vedere Disinstallazione di KEDA da Kubernetes.

Aggiungere impostazioni func

Aggiunge una nuova impostazione alla Values raccolta nel file local.settings.json.

func settings add <SETTING_NAME> <VALUE>

Sostituire <SETTING_NAME> con il nome dell'impostazione dell'app e <VALUE> con il valore dell'impostazione.

L'azione add supporta l'opzione seguente:

Opzione	Descrizione
--connectionString	Aggiunge la coppia nome-valore alla ConnectionStrings raccolta anziché alla Values raccolta. Utilizzare la ConnectionStrings raccolta solo quando richiesto da determinati framework. Per altre informazioni, vedere file local.settings.json.

decrittografare le impostazioni func

Decrittografa i valori crittografati in precedenza nella Values raccolta nel file local.settings.json.

func settings decrypt

Connessione anche i valori stringa dell'insieme ConnectionStrings vengono decrittografati. In local.settings.json IsEncrypted è impostato anche su false. Crittografare le impostazioni locali per ridurre il rischio di perdita di informazioni preziose da local.settings.json. In Azure le impostazioni dell'applicazione vengono sempre archiviate crittografate.

eliminazione delle impostazioni func

Rimuove un'impostazione esistente dalla Values raccolta nel file local.settings.json.

func settings delete <SETTING_NAME>

Sostituire <SETTING_NAME> con il nome dell'impostazione dell'app e <VALUE> con il valore dell'impostazione.

L'azione delete supporta l'opzione seguente:

Opzione	Descrizione
--connectionString	Rimuove la coppia nome-valore dalla ConnectionStrings raccolta anziché dalla Values raccolta.

crittografa le impostazioni func

Crittografa i valori dei singoli elementi nella Values raccolta nel file local.settings.json.

func settings encrypt

vengono crittografati anche i valori stringa Connessione ion nella ConnectionStrings raccolta. In local.settings.json IsEncrypted è impostato anche su true, che specifica che il runtime locale decrittografa le impostazioni prima di usarle. Crittografare le impostazioni locali per ridurre il rischio di perdita di informazioni preziose da local.settings.json. In Azure le impostazioni dell'applicazione vengono sempre archiviate crittografate.

elenco delle impostazioni func

Restituisce un elenco di impostazioni nella Values raccolta nel file local.settings.json.

func settings list

vengono restituite anche le stringhe di Connessione ion della ConnectionStrings raccolta. Per impostazione predefinita, i valori vengono mascherati per la sicurezza. È possibile usare l'opzione --showValue per visualizzare il valore effettivo.

L'azione list supporta l'opzione seguente:

Opzione	Descrizione
--showValue	Mostra i valori non mascherati effettivi nell'output.

elenco dei modelli func

Elenca i modelli di funzione (trigger) disponibili.

L'azione list supporta l'opzione seguente:

Opzione	Descrizione
--language	Lingua per cui filtrare i modelli restituiti. Il valore predefinito è restituire tutte le lingue.