Runtime locale e riferimento agli strumenti di Funzioni di Azure

Questo articolo fornisce documentazione di riferimento per l'runtime locale e gli strumenti che supportano Funzioni di Azure. Usa questi strumenti per sviluppare, gestire ed eseguire progetti Funzioni di Azure dal tuo computer locale. Il nome binario è func (o func.exe su Windows).

Sono disponibili due versioni della CLI. Usa il selettore di versione per scegliere quale versione visualizzare.

Importante

La CLI di Funzioni di Azure (v5) è attualmente in anteprima. Questa versione di anteprima non supporta ancora Java e PowerShell. Per lavorare con linguaggi attualmente non supportati, continua a usare Funzioni di Azure Core Tools v4.

Esistono due versioni di func.exe usate per lo sviluppo di Funzioni di Azure locali:

v4 v5
Nome API Funzioni di Azure Core Tools interfaccia della riga di comando Funzioni di Azure
Livello di supporto Disponibilità generale (GA) Preview
Installare il footprint Binario completo che include tutti i comandi e le funzionalità per tutti i linguaggi nativi. Installazione di base di piccole dimensioni, oltre a carichi di lavoro per linguaggio e altre funzionalità aggiunte in base alle esigenze. L'host viene fornito come proprio carico di lavoro, quindi si ottiene la versione host più recente senza scaricare nuovamente l'interfaccia della riga di comando.
Da usare per È necessario il supporto generale completo per tutti i flussi di lavoro di sviluppo. Si vuole un'esperienza leggera basata sul carico di lavoro con nuove funzionalità, ad esempio modelli di avvio rapido e profili che mantengono l'ambiente locale sincronizzato con la configurazione del piano di hosting Azure.

Per altre informazioni sull'uso di Core Tools, vedere Work con 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 per creare ed eseguire funzioni nel computer locale.
func azure Comandi da usare con Azure risorse, inclusa la pubblicazione.
func azurecontainerapps Comandi per distribuire un'app per le funzioni in contenitori in App contenitore di Azure.
func bundles Comandi per gestire i bundle di estensioni.
func durable Comandi da usare con Durable Functions.
func extensions Comandi per installare e gestire le estensioni.
func kubernetes Comandi da usare con Kubernetes e Funzioni di Azure.
func settings Comandi per gestire le 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, installare Core Tools.

Importante

La CLI di Funzioni di Azure (v5) è attualmente in anteprima. Questa versione di anteprima non supporta ancora Java e PowerShell. Per lavorare con linguaggi attualmente non supportati, continua a usare Funzioni di Azure Core Tools v4.

Per saperne di più sull'uso della CLI, inclusi installazioni e carichi di lavoro, consulta Sviluppa Funzioni di Azure localmente usando la Funzioni di Azure CLI.

I seguenti comandi integrati sono forniti con l'installazione base del CLI:

Command Descrizione
func init Inizializzare un nuovo progetto Funzioni di Azure.
func new Crea una nuova funzione da un template.
func run Avvia localmente l'runtime host di Funzioni di Azure. func start è un alias retrocompatibile.
func quickstart Naviga e scorre con impalcatture complete le app di funzionalità dal catalogo di modelli di avvio rapido.
func profile Ispezionare e gestire i profili CLI di Funzioni di Azure.
func setup Prepara dipendenze CLI locali di Funzioni di Azure (runtime host, worker del linguaggio, extension bundles).
func workload Gestire i carichi di lavoro della CLI installati.

I carichi di lavoro potrebbero contribuire con comandi aggiuntivi di alto livello. Questi comandi appaiono solo dopo aver installato il carico di lavoro che contribuisce al lavoro.

func init

Crea un nuovo progetto di Funzioni in un linguaggio specifico.

func init [<PROJECT_FOLDER>]

Quando fornisci <PROJECT_FOLDER>, il comando crea il progetto in una nuova cartella con questo nome. Altrimenti, usa la cartella corrente.

Il func init comando supporta queste opzioni, che dipendono dalla versione:

Opzione Descrizione
--bundles-channel, -c Canale di rilascio del bundle di estensione. I valori supportati sono: GA (impostazione predefinita), Previewe Experimental. Applicabile solo per i progetti non .NET.
--configuration-profile Inizializza un progetto con un profilo di configurazione host. L'opzione --configuration-profile è attualmente in anteprima. Per altre informazioni, vedere Profili di configurazione.
--csx Crea .NET funziona come script C#. Valido solo con --worker-runtime dotnet.
--docker Crea un Dockerfile per un contenitore utilizzando un'immagine base basata sul file 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 Inizializza il progetto anche quando ci sono file esistenti nel progetto. Questa impostazione sovrascrive i file esistenti con lo stesso nome. Gli altri file nella cartella del progetto non sono interessati.
--language, -l 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, -m Imposta il modello di programmazione per un linguaggio di destinazione quando sono disponibili più modelli. Le opzioni supportate sono V1 e V2 per Python e V3 e V4 per Node.js. Per altre informazioni, vedere la guida per sviluppatori Python e la guida per sviluppatori Node.js.
--no-bundle Non configurare il bundle di estensione in host.json. Applicabile solo per i progetti non .NET.
--no-docs Ignora la generazione dei file di documentazione "Introduzione". Applicabile per i progetti Python.
--skip-npm-install Ignorare l'esecuzione npm install dopo la creazione del progetto. Applicabile per i progetti 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, dotnetdotnet-isolated, , 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: net10.0 (anteprima), net9.0, net8.0 (impostazione predefinita), net6.0 e net48 (.NET Framework 4.8).

Nota

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

Profili di configurazione

Importante

Il supporto per i profili di configurazione è attualmente in anteprima.

Quando usi questa --configuration-profile opzione, crei un set predefinito di configurazioni e impostazioni del progetto. Quando si specifica un profilo di configurazione, l'inizializzazione potrebbe ignorare tutti gli altri passaggi di inizializzazione.

Valore del profilo Descrizione Azioni specifiche
mcp-custom-handler Crea un progetto che usa gestori personalizzati per ospitare un server MCP (Model Context Protocol) a cui possono connettersi gli agenti di intelligenza artificiale e altri client MCP. • Configura l'elemento "configurationProfile": "mcp-custom-handler" nel file host.json con impostazioni specifiche del gestore personalizzato.
• Imposta MCP_EXTENSION_ENABLED su true in local.settings.json.		 
func init [<PATH>] [options]

Quando fornisci <PATH>, il progetto viene creato in quella cartella. In caso contrario, viene utilizzata la cartella corrente.

Il func init comando supporta queste opzioni integrate:

Opzione Descrizione
--stack, -s Lo stack da usare per il progetto (ad esempio, python, node, dotnet, go). Corri func workload list a vedere gli stack contribuiti dai carichi di lavoro installati.
--name, -n Il nome del progetto di app funzionale.
--language, -l Il linguaggio di programmazione (ad esempio, C#, F#, JavaScript, TypeScript, Python). Utilizzato quando uno stack supporta più di una lingua. I valori supportati vengono calcolati dai carichi di lavoro dello stack installati.
--force Riavvisala anche quando la cartella di destinazione non è vuota. Svuota la cartella (tranne .git) prima di fare il spill.

I carichi di lavoro contribuiscono con opzioni aggiuntive che sono raggruppate sotto il nome del carico di lavoro in func init --help. Consulta le opzioni specifiche per carico di lavoro per le opzioni per stack.

Se nessun carico di lavoro fornisce lo stack richiesto, la CLI stampa un suggerimento che punta e func workload install esce con un codice di uscita diverso da zero.

Opzioni specifiche per carico di lavoro

Il init comando si espande quando installi uno o più di questi carichi di lavoro:

Opzione Descrizione
--target-framework, -tfm L'obiettivo .NET framework per il progetto (ad esempio, net10.0). Impostazione predefinita: net10.0.

L'inizializzatore .NET non scrive un blocco di extension bundle, quindi --no-bundles e --bundles-channel non sono applicabili.

Quando più di un carico di lavoro installato contribuisce con la stessa opzione, l'opzione appare una volta in func init --help.

Opzioni condivise

Attualmente, le opzioni condivise sono --no-bundles e --bundles-channel. L'ID predefinito del bundle di estensioni su cui scrivi host.json dipende dal canale selezionato:

Canale ID del bundle
GA (impostazione predefinita) Microsoft.Azure.Functions.ExtensionBundle
Preview Microsoft.Azure.Functions.ExtensionBundle.Preview
Experimental Microsoft.Azure.Functions.ExtensionBundle.Experimental

L'intervallo di versioni predefinito è [4.*, 5.0.0).

func new

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

func new

Il func new comando supporta queste opzioni, che dipendono dalla versione:

Opzione Descrizione
--authlevel, -a Imposta 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 maggiori informazioni, vedere Livello di autorizzazione.
--csx Genera gli stessi template di script C# (.csx) usati nella versione 1 e nel portale.
--file, -f File di destinazione per la nuova funzione. Per Python progetti v2, specifica il file a cui aggiungere la funzione (per impostazione predefinita function_app.py). Per Node.js progetti v4, specifica il nome del file di output nella src/functions cartella . Non applicabile per i progetti .NET compilati.
--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 new [<PATH>] [options]

Importante

func new Attualmente è una voce di anteprima. Stampa un suggerimento per installazione del carico di lavoro e esce con un codice di uscita diverso da zero finché il carico di lavoro del template non viene installato e collegato via cabla. Le opzioni specifiche per il template sono idratate dinamicamente dai metadati del template, quindi aggiungere una nuova opzione template non richiede una release della CLI.

Il func new comando supporta queste opzioni integrate:

Opzione Descrizione
--name, -n Nome della funzione.
--template, -t Il nome del modello di funzione. I template disponibili provengono dal carico di lavoro installato <stack>-templates per lo stack del progetto.
--force Sovrascrivere i file esistenti.

Opzioni aggiuntive vengono fornite dinamicamente dal template selezionato. Corri func new --template <name> --help a vedere le opzioni per un template specifico.

Se non viene installato alcun carico di lavoro template per il progetto corrente, la CLI stampa un suggerimento che punta a func workload install.

func logs

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

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

Il func logs comando supporta queste opzioni:

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

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

func pack

Crea un pacchetto di distribuzione che contiene il codice del progetto in uno stato eseguibile. Usa questo metodo quando devi creare manualmente un pacchetto di distribuzione per la tua app nel computer locale all'esterno del func azure functionapp publish comando. Per impostazione predefinita, func pack compila il progetto quando necessario.

Per le app con funzioni Go, func pack costruisce un pacchetto di distribuzione Linux x64 che puoi distribuire usando il comando interfaccia della riga di comando di Azure az functionapp deployment source config-zip.

func pack [<FOLDER_PATH>]

Per impostazione predefinita, func pack crea un pacchetto della directory corrente e il file di output .zip ha lo stesso nome della cartella radice del progetto. Eseguire func pack nella directory contenente il file di progetto host.json . Se è necessario eseguire func pack in un'altra directory, impostare <FOLDER_PATH> come percorso alla radice del progetto, ad esempio func pack ./myprojectroot. Se il file di .zip specifico esiste già, viene prima eliminato e quindi sostituito con una versione aggiornata.

Il func pack comando supporta queste opzioni:

Opzione Descrizione
--output, -o Imposta il percorso del percorso in cui viene creata la distribuzione .zip file del pacchetto.
--no-build Project non è costruito prima della compressione. Per le app C#, usare solo quando sono già stati generati i file binari. Per le app Node.js, sia npm install che npm run build vengono ignorate. Per le app Go, usa solo quando bin/app contiene già un binario Linux x64.
--skip-install Ignora l'esecuzione npm install durante la compressione Node.js'app per le funzioni basata su . Usato per evitare di sovrascrivere moduli npm personalizzati.
--build-native-deps Installa Python dipendenze in locale usando un'immagine corrispondente all'ambiente usato in Azure. Quando abilitato, Core Tools avvia un contenitore Docker, compila l'app all'interno di tale contenitore e crea un file .zip con tutte le dipendenze ripristinate in .python_packages. Usare questa opzione durante l'esecuzione in Windows per evitare potenziali problemi di libreria quando si esegue la distribuzione in Linux in Azure.

func run (solo v1)

Nota

Questo comando si applica solo alla versione 1 di Core Tools ed è deprecato. Per la versione 4, usa func start e chiama direttamente l'endpoint della funzione.

Invoca direttamente una funzione, simile a eseguire una funzione usando la scheda Test nel portale Azure.

func run

Il func run comando supporta queste opzioni:

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 questo comando:

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

func start

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

Il comando specifico dipende dalla versione di runtime.

func start

Il func start comando supporta queste opzioni:

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 Consente richieste autenticate tra le origini che usano cookie e l'intestazione Di autenticazione.
--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 Abilita la pipeline di gestione dell'autenticazione completa con i requisiti di autorizzazione.
--functions Elenco delimitato da spazi di funzioni da caricare.
--json-output-file Se specificato, un percorso del file usato per scrivere l'output quando si usa --enable-json-output.
--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 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, -p La porta locale su cui ascoltare. Valore predefinito: 7071.
--runtime Imposta la versione dell'host da avviare. I valori consentiti sono: inproc6, inproc8e default (che esegue l'host out-of-process).
--timeout, -t 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.
--user-log-level Imposta il livello di log minimo per i log utente. I valori validi sono: Trace, Debug, InformationWarning, Error, Critical, e None. Questa impostazione non influisce sui log di sistema. Per .NET progetti isolati, impostare anche il livello minimo in Program.cs usando builder.Logging.SetMinimumLevel(LogLevel.Debug) per rendere effettiva questa opzione.

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

func run

Avvia l'runtime host delle funzioni e carica il progetto nella cartella corrente.

func run [<PATH>] [options]

func start viene preservato come alias retrocompatibile e accetta gli stessi argomenti e opzioni.

Il func run comando supporta queste opzioni:

Opzione Descrizione
--port, -p La porta locale su cui ascoltare. Impostazione predefinita: 7071.
--cors Un elenco delimitato dalla virgola di origini CORS, senza spazi.
--cors-credentials Consentire richieste autenticate cross-origin che utilizzano i cookie e l'intestazione Authentication (header).
--functions Elenco delimitato da spazi di funzioni da caricare.
--no-build Non costruire il progetto prima di correre.
--enable-auth Abilita l'intera pipeline di gestione dell'autenticazione, inclusi i requisiti di autorizzazione.
--host-version, -v La versione runtime host da utilizzare (ad esempio, 4.1049.0).
--profile Il profilo Funzioni di Azure da applicare durante la risoluzione delle versioni host, worker e bundle. Vedete func profile.
--offline Usa solo carichi di lavoro installati localmente e salta le installazioni di rete.
--output Modalità di output: compact (TUI interattiva), plain (CI / non-TTY), o json (NDJSON per consumatori programmatici e agenti IA). Di default imposta il rilevamento automatico in base al terminale.
--no-tui Alias per --output=plain. Disabilita la TUI interattiva.
--log-file Specchia tutti gli eventi host nel file di log specificato.
--no-azurite Disabilita l'Azurite gestita. L'host inizia senza sondare o avviare un emulatore locale.

Quando il progetto è in esecuzione, chiama direttamente gli endpoint delle funzioni per verificare il comportamento.

Azurite gestita

Quando il tuo progetto usa lo storage locale (ad esempio, AzureWebJobsStorage=UseDevelopmentStorage=true), func run controlla automaticamente se un emulatore di Azurite è in esecuzione e ne avvia uno se non ne trova uno. L'emulatore si ferma quando func run esce. Pass --no-azurite per rinunciare e gestire Azurite da solo.

Modalità di output

func run seleziona automaticamente una modalità di uscita basata sul terminale:

Condition Modalità
Terminale interattivo (TTY) compact
Stdout non interattivo, output reindirizzato o CI set di variabili ambientali plain
Esplicito --output=json json

La CLI non seleziona jsonmai automaticamente . Se compact viene richiesto ma lo stdout non è un TTY, la CLI passa a un downgrade e plain scrive un avviso di una riga allo stderr. La json modalità emette JSON delimitato da nuove linee (NDJSON), un oggetto per linea, con un schema_version .1

func quickstart

Naviga e fa scaffolding completano le app di funzionalità dal catalogo di modelli quickstart di Funzioni di Azure. I template di avvio rapido sono app campioni complete, come un'API HTTP, un worker attivato dalla coda o un'orchestrazione Durable Functions. I carichi di lavoro dello stack contribuiscono con i resolver specifici per linguaggio. Il catalogo viene recuperato al momento dell'invocazione del comando.

func quickstart [<PATH>] [options]

Quando fornisci <PATH>, il progetto viene creato in quella cartella. In caso contrario, viene utilizzata la cartella corrente.

Il func quickstart comando supporta queste opzioni:

Opzione Descrizione
--stack, -s Lo stack da usare, come python, node, o dotnet.
--language, -l Il linguaggio di programmazione. I valori supportati provengono da fornitori di quickstart installati.
--template, -t ID modello dal catalogo, come http-trigger-python-azd. Salta tutti i prompt interattivi.
--resource, -r Filtra per risorsa di trigger o di lego, come http, timer, blob, eventhub, servicebus, cosmos, sql, mcp, , o durable.
--iac Filtra per tipo di infrastruttura come codice, come bicep, terraform, o none.
--search Filtro sottostringa insensibile alla maiuscola e minuscole applicato ai nomi e alle descrizioni del template.
--fetch Strategia di recupero del catalogo: auto (predefinita), git, oppure http. auto sonda per git e torna a HTTP.
--force Fai il supporto anche quando la cartella di destinazione non è vuota. Svuota la cartella (tranne .git) prima di fare il spill.

Sottocomandi:

Subcommand Descrizione
func quickstart list Elenca i modelli disponibili nel catalogo.
func quickstart info Mostra i dettagli su un modello specifico.

func quickstart list

Elenca i modelli disponibili dal catalogo, opzionalmente filtrati.

func quickstart list [options]
Opzione Descrizione
--stack, -s Lo stack da usare, come python, node, o dotnet.
--language, -l Il linguaggio di programmazione. I valori supportati provengono da fornitori di quickstart installati.
--resource, -r Filtra per risorsa di trigger o di lego.
--iac Filtra per tipo di infrastruttura come codice.
--search Le sottostringhe insensibili alla maiuscola corrispondono a ID, nomi di template, tipo di risorsa, tipo di infrastruttura come codice e descrizioni.
--json Emetti JSON leggibile da macchina invece di una tabella.

func quickstart info

Mostra informazioni dettagliate su un modello specifico.

func quickstart info <ID> [options]

<ID> è l'ID modello dal catalogo. Usare func quickstart list per scoprire i documenti disponibili.

Opzione Descrizione
--json Emette JSON leggibile da macchina invece di output formattato.

func profile

Ispeziona e gestisce i profili CLI di Funzioni di Azure. I profili codificano vincoli di versione, come l'intervallo di versioni host, l'intervallo di versioni del bundle di estensione e gli intervalli di versioni di lavoro. Definiscono anche l'eredità da altri profili. Le fonti dei profili includono project local (.func/profiles/), user-global (~/.azure-functions/profiles/) e profili integrati. Usa l'opzione func run --profile <name> per selezionare quali vincoli del profilo si applicano al lancio dell'host.

func profile <subcommand>

Sottocomandi:

Subcommand Descrizione
func profile list Elenco dei profili disponibili da progetti, utenti e fonti integrate.
func profile show Mostra i dettagli per un profilo.
func profile set Imposta il profilo predefinito per un progetto.

func profile list

Elenca i profili disponibili da fonti di progetto, utente e integrate. Visualizza una tabella con nome, sorgente, versione host, bundle di estensioni e stato.

func profile list [<PATH>] [options]
Opzione Descrizione
--source Elenco di fonti separati da virgole per includere: project, user, built-in. Ricorre a tutte le fonti.
--json Emetti JSON leggibile da macchina invece di una tabella.

func profile show

Mostra i dettagli per un singolo profilo, sia risolto (con i valori ereditati applicati) sia grezzi (definizione così come scritta, senza espansione di eredità).

func profile show <NAME> [<PATH>] [options]
Opzione Descrizione
--raw Mostra la definizione grezze del profilo senza i valori ereditati.

func profile set

Imposta il profilo predefinito per un progetto Functions scrivendo il nome del profilo nel .func/config.jsonfile . Se il profilo non è già nella lista profili del progetto, aggiungilo.

func profile set <NAME> [<PATH>]

func setup

Prepara la macchina locale per l'esecuzione di progetti Funzioni di Azure. Installa o verifica l'runtime host, i language work, i pacchetti di estensione e i template per gli stack che specifichi. Supporta vincoli di versione basati su profilo, selezione prerelease, modalità CI non interattiva e modalità solo controllo.

func setup [<PATH>] [options]

--features Seleziona cosa installare o verificare. Le funzionalità e i carichi di lavoro che ciascuno risolve sono:

Feature Carichi di lavoro installati
node host, bundles, node, node-workernode-templates
python host, bundles, python, python-workerpython-templates
go host, bundles, gogo-worker
dotnet host, dotnet, dotnet-templates
runtime host, bundles
host Solo host

--features è ripetibile e accetta valori separati da virgole, quindi puoi combinare le caratteristiche in una singola chiamata (ad esempio, func setup --features node,python). dotnet-isolated è accettato come alias per dotnet.

Opzione Descrizione
--features Componenti da installare o verificare. Ripetibile o separato da virgola. Consulta la tabella sopra per i carichi di lavoro che ogni funzionalità installa.
--profile Profilo Funzioni di Azure da usare per i vincoli di versione. Ripetibile. Fuso con --profiles.
--profiles Elenco separato da virgole dei profili Funzioni di Azure da utilizzare per i vincoli di versione.
--install-policy Policy di installazione: latest-compatible (predefinita) oppure if-needed.
--source Sorgente di pacchetto NuGet da utilizzare per la risoluzione e installazione del carico di lavoro.
--prerelease Consenti le versioni prerelease del carico di lavoro quando si risolve dal catalogo. Predefinito: abilitato mentre i carichi di lavoro sono in anteprima.
--non-interactive Non chiedere input.
--yes, -y Rispondi sì ai prompt di impostazione.
--check Verifica se le dipendenze selezionate sono installate, senza apportare modifiche.
--output Modalità di uscita: plain (predefinita) o json (NDJSON).

func workload

Gestisce i carichi di lavoro installati per la CLI di Funzioni di Azure.

func workload <subcommand>

Sottocomandi:

Subcommand Descrizione
func workload list Elenca i carichi di lavoro installati.
func workload search Cerca nel catalogo del carico di lavoro.
func workload install Installa un carico di lavoro.
func workload update Aggiorna un carico di lavoro installato in posizione.
func workload uninstall Disinstalla un carico di lavoro.
func workload prune Rimuovi le installazioni di carichi di lavoro inattive affiancate.

func workload list

Elenca i carichi di lavoro installati. Di default, il comando mostra solo la versione caricata (highest-installed-semver) di ogni carico di lavoro. Lo usano --all-versions per vedere ogni installazione affiancata.

func workload list [options]
Opzione Descrizione
--all-versions, -a Elenca ogni versione installata di ogni carico di lavoro. Predefinito: solo versione caricata.
--json Emetti JSON leggibile da macchina invece di una tabella.

Cerca nel catalogo dei carichi di lavoro configurati i pacchetti di carichi di lavoro disponibili.

func workload search [<QUERY>] [options]

Quando ometti <QUERY>, il comando elenca tutti i carichi di lavoro nel catalogo.

Opzione Descrizione
--source URL sorgente del catalogo per la ricerca. Di default si basa sul catalogo configurato.
--prerelease Includi le versioni prerelease nei risultati. Predefinito: abilitato mentre i carichi di lavoro sono in anteprima.
--json Emetti JSON leggibile da macchina invece di una tabella.

func workload install

Risolve un ID di pacchetto di carico di lavoro (o alias) attraverso il catalogo configurato e lo installa.

func workload install <ID> [options]

<ID> può essere un ID di pacchetto di carico di lavoro, un alias (ad esempio, python), o un percorso verso un file di pacchetto di carico di lavoro locale.

Opzione Descrizione
--version, -v Versione specifica da installare. Predefinito: l'ultima versione stabile del catalogo.
--source URL sorgente del catalogo o directory locale da cui risolvere. Predefinito: il catalogo configurato.
--prerelease Consentite le versioni prerelease quando risolvete dal catalogo. Predefinito: abilitato mentre i carichi di lavoro sono in anteprima.
--force, -f Sovrascrivi un'installazione esistente con lo stesso ID e versione. Inoltre salta il prompt "usa aggiorna invece".
--exact, -e Disabilita il matching degli alias. <ID> deve essere l'ID del pacco letterale.

Se una versione del carico di lavoro è già installata, la CLI ti invita a usarla func workload update invece. I contesti non interattivi trattano il prompt come un declino.

func workload update

Effettua uno swap di versione atomica in loco per un carico di lavoro installato. Gli aggiornamenti non sono affiancati; per installazioni affiancate usa func workload install --force.

func workload update [<ID>] [options]

Passa un <ID> aggiornamento di un singolo carico di lavoro, o --all per aggiornare ogni carico di lavoro installato. Specifica esattamente una di queste due opzioni.

Opzione Descrizione
--version, -v Versione installata per sostituire. Predefinito: la versione più installata.
--all Aggiorna ogni carico di lavoro installato. Si escludono con <ID> a vicenda.
--major Consentire di attraversare un confine di versione maggiore. Predefinito: solo la stessa specializzazione.
--source URL sorgente del catalogo o directory locale da cui risolvere. Predefinito: il catalogo configurato.
--prerelease Consentite le versioni prerelease quando risolvete dal catalogo. Predefinito: abilitato mentre i carichi di lavoro sono in anteprima.
--exact, -e Disabilita il matching degli alias. <ID> deve essere l'ID del pacco letterale.

func workload uninstall

Rimuove una o tutte le versioni installate di un carico di lavoro.

func workload uninstall <ID> [options]
Opzione Descrizione
--version, -v Versione specifica da disinstallare. Predefinito: l'unica versione installata.
--all-versions, -a Disinstalla ogni versione installata del carico di lavoro. Si escludono con --version a vicenda.
--exact, -e Disabilita il matching degli alias. <ID> deve essere l'ID del pacco letterale.

func workload prune

Rimuove le installazioni di carico di lavoro inattive affiancate. Per ogni ID package in-scope, il comando mantiene la versione più alta installata e disinstalla le versioni precedenti. Questo comando è solo locale e non tocca mai il catalogo.

func workload prune [<ID>] [options]

Quando ometti <ID>, il comando elimina ogni carico di lavoro installato.

Opzione Descrizione
--exact, -e Disabilita il matching degli alias. <ID> deve essere l'ID del pacco letterale.

func azure functionapp

Il func azure functionapp contesto contiene i comandi seguenti:

Tutti i func azure functionapp comandi supportano queste opzioni:

Opzione Descrizione
--slot È destinato a uno slot di distribuzione denominato specifico, se configurato.
--access-token Fornisce un token di accesso, diverso dal token predefinito, da usare per eseguire azioni autenticate in Azure.
--access-token-stdin Legge un token di accesso specifico dall'input standard. Usare questa opzione quando si legge il token direttamente da un comando precedente, ad esempio az account get-access-token.
--management-url Imposta l'URL di gestione per il cloud Azure, che per impostazione predefinita viene impostato su https://management.azure.com. Usare questa opzione quando l'app per le funzioni viene eseguita in un cloud sovrano.
--subscription Imposta la sottoscrizione Azure predefinita.

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.

Il comando scarica le impostazioni nel filelocal.settings.json del progetto. I valori sullo schermo sono mascherati per la sicurezza. Puoi proteggere le impostazioni nel filelocal.settings.jsonabilitando la crittografia locale.

func azure functionapp list-functions

Elenca le funzioni nell'app per le funzioni specificata.

func azure functionapp list-functions <APP_NAME>

Il func azure functionapp list-functions comando supporta questa opzione:

Opzione Descrizione
--show-keys Includere i valori della chiave di accesso a livello di funzione negli URL dell'endpoint della funzione restituiti.

func azure functionapp logstream

Connette il prompt dei comandi locale ai log di streaming per l'app per le funzioni in Azure.

func azure functionapp logstream <APP_NAME>

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

Il func azure functionapp logstream comando supporta questa opzione:

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

Per altre informazioni, vedere Enable streaming execution logs 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:

Opzione Descrizione
--additional-packages Elenco di pacchetti da installare durante la creazione di dipendenze native. Ad esempio: python3-dev libevent-dev.
--build, -b Esegue un'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 .wheels quando si pubblicano Python app per le funzioni.
--csx Pubblica un progetto di script C# (file con estensione csx).
--dotnet-cli-params Quando si pubblicano funzioni C# (con estensione csproj) compilate, gli strumenti di base chiamano dotnet build --output bin/publish. Tutti i parametri passati a questa opzione vengono aggiunti alla riga di comando.
--dotnet-version Per le applicazioni dotnet-isolated, specifica la versione .NET di destinazione, ad esempio 8.0).
--force Ignora la verifica di prepubblicazione in determinati scenari.
--list-ignored-files Visualizza un elenco di file ignorati durante la pubblicazione, in base al file con estensione funcignore .
--list-included-files Visualizza un elenco di file pubblicati, basato sul file con estensione funcignore .
--no-build Project non viene compilato durante la pubblicazione. Per Python, pip install non viene eseguito.
--nozip Disattiva la modalità Run-From-Package predefinita. Estrae i file nella wwwroot cartella nel server anziché eseguirli direttamente dal pacchetto di distribuzione.
--overwrite-settings, -y Elimina la richiesta di sovrascrivere le impostazioni dell'app quando si usa --publish-local-settings -i.
--publish-local-settings, -i Pubblica le impostazioni in local.settings.json in Azure, richiedendo di sovrascrivere se l'impostazione esiste già. Se si usa un emulatore di archiviazione locale, modificare prima l'impostazione dell'app su una connessione di archiviazione effettiva.
--publish-settings-only, -o Pubblica solo le impostazioni e ignora il contenuto. Viene suggerito il valore predefinito.
--show-keys Aggiunge le chiavi di funzione agli URL visualizzati nei log.

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 download di una risorsa di archiviazione stringa di connessione.

func azurecontainerapps deploy

Distribuisce un'app per le funzioni in contenitori in un ambiente App contenitore di Azure. L'account di archiviazione host predefinito, l'app di funzione e l'ambiente devono già esistere. Per altre informazioni, vedere App contenitore di Azure hosting 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
--environment Nome di un ambiente app contenitore esistente.
--image-build Impostare su true per ignorare la build Docker locale.
--image-name Nome di un'immagine del contenitore esistente in un registro contenitori, incluso il nome del tag.
--location Area per la distribuzione. Idealmente, questa area è la stessa delle risorse dell'ambiente e dell'account di archiviazione.
--name Nome usato per la distribuzione dell'app per le funzioni nell'ambiente App contenitore. Questo nome viene visualizzato 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 viene eseguito il push dell'immagine nel Registro di sistema impostato in --registry. Non è possibile usare --registry con --image-name. Per Docker Hub, usare anche --registry-username.
--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.
--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, dotnetIsolatednode, python, powershell, e custom (per i gestori personalizzati).

Importante

Le stringhe di connessione di archiviazione e altre credenziali del servizio sono segreti importanti. 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.

func deploy

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

func bundles add

Aggiunge la configurazione del bundle di estensione al file host.json .

func bundles add

Il func bundles add comando supporta queste opzioni:

Opzione Descrizione
--force, -f Sovrascrive la configurazione del bundle di estensione esistente, se presente.
--channel, -c Canale di rilascio del bundle di estensione. I valori supportati sono: GA (impostazione predefinita), Previewe Experimental.

func bundles download

Scarica il bundle di estensione configurato in host.json.

func bundles download

Il func bundles download comando supporta queste opzioni:

Opzione Descrizione
--force, -f Forza un nuovo download del bundle di estensione anche se è già presente.

func bundles list

Elenca i bundle di estensioni scaricati.

func bundles list

func bundles path

Ottiene il percorso del bundle di estensione scaricato.

func bundles path

func durable delete-task-hub

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

func durable delete-task-hub

Il func durable delete-task-hub comando supporta queste opzioni:

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

Per altre informazioni, vedere la documentazione Durable Functions.

func durable get-history

Restituisce la cronologia di un'istanza di orchestrazione specificata.

func durable get-history --id <INSTANCE_ID>

Il func durable get-history comando supporta queste opzioni:

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

Per altre informazioni, vedere la documentazione Durable Functions.

func durable get-instances

Restituisce lo stato di tutte le istanze di orchestrazione. Questo comando supporta il paging utilizzando il parametro top .

func durable get-instances

Il func durable get-instances comando supporta queste opzioni:

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

Per altre informazioni, vedere Durable Functions documentazione.

func durable get-runtime-status

Restituisce lo stato di un'istanza di orchestrazione specificata.

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

Il func durable get-runtime-status comando supporta queste opzioni:

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

Per altre informazioni, vedere Durable Functions documentazione.

func durable purge-history

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

func durable purge-history

Il func durable purge-history comando supporta queste opzioni:

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

Per altre informazioni, vedere la documentazione 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>

Il func durable raise-event comando supporta queste opzioni:

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

Per altre informazioni, vedere Durable Functions documentazione.

func durable rewind

Riavvolge l'istanza di orchestrazione specificata.

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

Il func durable rewind comando supporta queste opzioni:

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

Per altre informazioni, vedere Durable Functions documentazione.

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>

Il func durable start-new comando supporta queste opzioni:

Opzione Descrizione
--connection-string-setting Nome 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. (obbligatorio).
--input Input per la funzione dell'agente di orchestrazione, inline o da un file JSON. Per i file, anteporre il percorso al file con una e commerciale (@), ad esempio @path/to/file.json. (obbligatorio).
--task-hub-name Nome dell'hub attività Durable Functions da usare.

Per altre informazioni, vedere Durable Functions documentazione.

func durable terminate

Termina l'istanza di orchestrazione specificata.

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

Il func durable terminate comando supporta queste opzioni:

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

Per altre informazioni, vedere la documentazione Durable Functions.

func extensions install

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>

Il func extensions install comando supporta queste opzioni:

Opzione Descrizione
--configPath, -c Percorso della directory contenente il file extensions.csproj.
--csx Supportare progetti di scripting C# (con estensione csx).
--force, -f Aggiornare le versioni delle estensioni esistenti.
--output, -o Percorso di output per le estensioni.
--package, -p 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, -s Origine feed NuGet quando non si usa NuGet.org.
--version, -v 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

Queste considerazioni si applicano quando si usa func extensions install:

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

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

  • Quando possibile, è consigliabile usare invece bundle di estensioni. Ecco 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 dihost.json che definisce il bundle. Non viene eseguita alcuna azione quando un bundle di estensione è già impostato nel file dihost.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#.

func extensions sync

Installa tutte le estensioni richieste dalla tua app di funzione.

Il func extensions sync comando supporta queste opzioni:

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

Rigenera un file mancante extensions.csproj . Non agisce quando un bundle di estensioni è definito nel tuo host.json file.

func kubernetes deploy

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 --docker con il func init comando .

Il func kubernetes deploy comando supporta queste opzioni:

Opzione Descrizione
--dry-run Visualizza il modello di distribuzione, senza esecuzione.
--config-map-name Nome 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 Continuare 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 Impostare 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.
--max-replicas Impostare il numero massimo di repliche su cui viene ridimensionato l'HPA (Horizontal Pod Autoscaler).
--min-replicas Impostare il numero minimo di repliche al di sotto del quale HPA non verrà ridimensionato.
--mount-funckeys-as-containervolume Montare le chiavi di accesso come volume del contenitore.
--name Nome usato per la distribuzione e altri artefatti in Kubernetes.
--namespace Impostare lo spazio dei nomi Kubernetes su cui eseguire la distribuzione. Il valore predefinito è lo spazio dei nomi predefinito.
--no-docker Leggere le funzioni dalla directory corrente anziché da un'immagine. Richiede il montaggio del file system di immagini.
--registry Quando impostata, viene eseguita una compilazione Docker e l'immagine viene inserita 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 con 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 Visualizzare gli URL dei trigger HTTP con il nome di dominio completo kubernetes anziché il comportamento predefinito dell'uso di un indirizzo IP.
--service-type Impostare 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.
--use-git-hash-version Usare l'hash Git come versione per l'immagine del contenitore.
--write-configs Generare l'output delle configurazioni kubernetes come file YAML anziché come distribuzione.
--config-file Percorso del file di output quando si usa --write-configs. Impostazione predefinita: functions.yaml.
--hash-files File da hash per determinare la versione dell'immagine.
--image-build Se impostato su false, ignora la compilazione Docker.
--key-secret-annotations Annotazioni da aggiungere al segreto delle chiavi, in key1=val1,key2=val2 formato .

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.

Funzioni di Azure supporta l'hosting delle funzioni in contenitori in App contenitore di Azure o in Funzioni di Azure. Funzioni di Azure non supporta ufficialmente l'esecuzione dei contenitori direttamente in un cluster Kubernetes o in Servizio Azure Kubernetes (AKS). Per altre informazioni, vedere supporto dei contenitori Linux in Funzioni di Azure.

func kubernetes delete

Elimina una distribuzione di Funzioni da un cluster Kubernetes.

func kubernetes delete --name <APP_NAME>

Il func kubernetes delete comando supporta queste opzioni:

Opzione Descrizione
--name Nome della distribuzione e di altri artefatti in Kubernetes. (obbligatorio).
--namespace Impostare lo spazio dei nomi Kubernetes. Il valore predefinito è lo spazio dei default nomi .
--registry Nome del registro contenitori.
--image-name Immagine da usare per la distribuzione dei pod.
--keda-version Impostare la versione di KEDA. Le opzioni valide sono v1 e v2 (impostazione predefinita).

func kubernetes install

Installa KEDA in un cluster Kubernetes

func kubernetes install

Installa KEDA nel cluster definito nel file di configurazione kubectl.

Il func kubernetes install comando supporta queste opzioni:

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 Viene installato 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 kubectl file di configurazione.

func kubernetes remove

Rimuove KEDA dal cluster definito nel kubectl file di configurazione.

Il func kubernetes remove comando supporta questa opzione:

Opzione Descrizione
--namespace Disinstalla 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.

func settings add

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.

Il func settings add comando supporta questa opzione:

Opzione Descrizione
--connectionString Aggiunge la coppia nome-valore alla ConnectionStrings raccolta anziché alla Values raccolta. Usare la ConnectionStrings raccolta solo quando alcuni framework lo richiedono. Per altre informazioni, vedere local.settings.json file.

func settings decrypt

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

func settings decrypt

Questo comando decrittografa anche i valori stringa di connessione nella raccolta ConnectionStrings. In local.settings.json, il comando imposta IsEncrypted a false. Cripta le impostazioni locali per ridurre il rischio di esporre informazioni sensibili provenienti dalocal.settings.json. In Azure le impostazioni dell'applicazione vengono sempre archiviate crittografate.

func settings delete

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.

Il func settings delete comando supporta questa opzione:

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

func settings encrypt

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

func settings encrypt

Il comando crittografa anche i valori della stringa di connessione nella ConnectionStrings raccolta. In local.settings.json, il comando imposta IsEncrypted a true, che specifica che il runtime locale decripta le impostazioni prima di utilizzarle. Cripta le impostazioni locali per ridurre il rischio di esporre informazioni sensibili provenienti dalocal.settings.json. In Azure le impostazioni dell'applicazione vengono sempre archiviate come crittografate.

func settings list

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

func settings list

L'output include anche stringhe di connessione dalla ConnectionStrings raccolta. Di default, il comando maschera i valori per motivi di sicurezza. Usare l'opzione --showValue per visualizzare il valore effettivo.

Il func settings list comando supporta questa opzione:

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

func templates list

Elenca i modelli di funzione (trigger) disponibili.

Il func templates list comando supporta questa opzione:

Opzione Descrizione
--language, -l Lingua per cui filtrare i modelli restituiti. Restituisce tutte le lingue per impostazione predefinita.

Opzioni globali

La maggior parte dei comandi Core Tools supporta queste opzioni:

Opzione Descrizione
--script-root Imposta la directory radice dell'app per le funzioni e modifica la directory di lavoro per il comando.
--verbose Abilita l'output dettagliato per la registrazione dettagliata. Non tutti i comandi supportano questa opzione.
--offline Viene eseguito in modalità offline, senza effettuare chiamate di rete esterne. I func startcomandi , func init, e func new supportano questa opzione. Puoi anche impostarlo tramite la FUNCTIONS_CORE_TOOLS_OFFLINE variabile ambiente.
--version, -v Visualizza la versione di Funzioni di Azure Core Tools.
--help, -h Visualizza le informazioni della Guida.
--pause-on-error Sospende l'input aggiuntivo prima di uscire dal processo. Questa opzione è utile quando si avviano Core Tools da un ambiente di sviluppo integrato (IDE).

La maggior parte dei comandi supporta queste opzioni:

Opzione Descrizione
--help, -h Mostra aiuto per il comando.
--version Visualizza la versione CLI di Funzioni di Azure. Usa --verbose insieme --version per informazioni dettagliate sulla costruzione.
--verbose Abilitare l'output dettagliato. Si propaga a tutti i sottocomandi. Quando viene passato alla radice senza sottocomando, stampa informazioni dettagliate di build, runtime, sistema operativo e architettura.

Carichi di lavoro disponibili

Corri func workload search a vedere il catalogo attuale. I seguenti carichi di lavoro sono attualmente disponibili:

Name Descrizione
host Il runtime Funzioni di Azure host utilizzato da func run.
bundles Installa i bundle di estensioni, che abiliteranno tutte le estensioni di binding. Usa questo carico di lavoro per qualsiasi stack non .NET. I progetti .NET non utilizzano questo carico di lavoro. Invece, fanno riferimento direttamente alle estensioni nei loro progetti.
dotnet Strumenti CLI di Funzioni di Azure per progetti .NET (C#, F#). Contribuisce inoltre con template per func quickstart. .NET non richiede un carico di lavoro separato per il workwork, perché il worker fa parte del progetto compilato stesso.
dotnet-templates Modelli di impalcatura funzione per progetti worker isolati .NET.
python Strumenti CLI di Funzioni di Azure per progetti Python. Contribuisce inoltre con template per func quickstart.
python-worker Il worker del linguaggio Python utilizzato dall'host delle funzioni.
python-templates Modelli di scaffolding funzionali per Python (modelli di programmazione v1 e v2).
node Funzioni di Azure strumenti CLI per Node.js progetti (JavaScript, TypeScript). Contribuisce inoltre con template per func quickstart.
node-worker Il worker Node.js linguaggio utilizzato dall'host delle funzioni.
node-templates Modelli di impalcatura funzionale per Node.js (JavaScript, TypeScript).
go Strumenti CLI di Funzioni di Azure per progetti Go. Contribuisce inoltre con template per func quickstart.
go-worker Il worker del linguaggio Go usato dall'host delle funzioni.

Nota

Non tutti gli stack di linguaggio Functions sono attualmente disponibili come carichi di lavoro. Gli stack Java e PowerShell attualmente non sono supportati nella CLI di Funzioni di Azure.

  • Last updated on