Condividi tramite

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 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.

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.

Il func init comando supporta queste opzioni, che non sono supportate nella versione 1.x, a meno che non diversamente specificato:

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 funzioni 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, -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, 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: 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 si usa l'opzione --configuration-profile , viene creato 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 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 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 è anche necessario scegliere la lingua.

Il func new comando supporta queste opzioni:

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 (Versione 2.x e versioni successive). Genera gli stessi modelli di script C# (con estensione csx) usati nella versione 1.x 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.
--language, -l Linguaggio di programmazione modello, ad esempio C# o JavaScript. Questa opzione è necessaria nella versione 1.x. Nella versione 2.x e successive non usare 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 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.

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.
--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 versione 1.x.

Consente di richiamare direttamente una funzione, simile all'esecuzione di una funzione usando la scheda Test nel 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

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, WarningInformation, 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 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.

Le impostazioni si scaricano 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

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 usato dall'app per le funzioni e dall'ambiente deve 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, nodedotnetIsolated, 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 con il top parametro .

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 aggiunte all'app per le funzioni.

Il func extensions sync comando supporta queste opzioni:

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

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

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 --dockerfile 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 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.

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

Anche i valori della stringa di connessione nella ConnectionStrings raccolta vengono crittografati. 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 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. Per impostazione predefinita, i valori vengono mascherati per la sicurezza. È possibile 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

Queste opzioni sono disponibili per la maggior parte dei comandi di Core Tools:

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 supportato da tutti i comandi.
--offline Viene eseguito in modalità offline, senza effettuare chiamate di rete esterne. Supportato da func start, func inite func new. Può essere impostata anche tramite la FUNCTIONS_CORE_TOOLS_OFFLINE variabile di 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. Utile quando si avvia Core Tools da un ambiente di sviluppo integrato (IDE).
  • Last updated on