Condividi tramite

Riferimento di Azure Functions Core Tools

  • Articolo

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

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

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

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

func init

Crea un nuovo progetto di Funzioni in un linguaggio specifico.

func init <PROJECT_FOLDER>

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

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

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

Nota

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

func logs

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

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

L'azione func logs supporta le opzioni seguenti:

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

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

func new

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

func new

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

L'azione func new supporta le opzioni seguenti:

Opzione Descrizione
--authlevel Consente di impostare il livello di autorizzazione per un trigger HTTP. I valori supportati sono: function, anonymous, admin. L'autorizzazione non viene applicata durante l'esecuzione in locale. Per altre informazioni, vedere 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.
--language, -l Il linguaggio di programmazione del modello, come C#, F# o JavaScript. Questa opzione è necessaria nella versione 1.x. Nella versione 2.x e successive non si usa questa opzione perché il linguaggio è definito dal runtime del ruolo di lavoro.
--name, -n Nome della funzione.
--template, -t Usare il comando func templates list per visualizzare l'elenco completo dei modelli disponibili per ogni linguaggio supportato.

Per altre informazioni, vedere Creare una funzione.

func run

Solo versione 1.x.

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

func run

L'azione func run supporta le opzioni seguenti:

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

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

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

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

func start supporta le opzioni seguenti:

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

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

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 vengono scaricate nel file local.settings.json per il progetto. I valori sullo schermo sono mascherati per la sicurezza. È possibile proteggere le impostazioni nel file local.settings.json abilitando la crittografia locale.

func azure functionapp list-functions

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

func azure functionapp list-functions <APP_NAME>

func azure functionapp logstream

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. È possibile modificare il timeout aggiungendo un'impostazione dell'app denominata SCM_LOGSTREAM_TIMEOUT, con un valore di timeout in secondi. Non ancora supportato per le app Linux nel piano a consumo. Per queste app, usare l'opzione --browser per visualizzare i log nel portale.

L'azione deploy supporta le opzioni seguenti:

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

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

func azure storage fetch-connection-string

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

func azure storage fetch-connection-string <STORAGE_ACCOUNT_NAME>

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

func azurecontainerapps deploy

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

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

Si applicano le opzioni di distribuzione seguenti:

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

Importante

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

func deploy

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

func durable delete-task-hub

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

func durable delete-task-hub

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

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

Per altre informazioni, vedere la documentazione di Durable Functions.

func durable get-history

Restituisce la cronologia dell'istanza di orchestrazione specificata.

func durable get-history --id <INSTANCE_ID>

L'azione get-history supporta le opzioni seguenti:

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

Per altre informazioni, vedere la documentazione di Durable Functions.

func durable get-instances

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

func durable get-instances

L'azione get-instances supporta le opzioni seguenti:

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

Per altre informazioni, vedere la documentazione di Durable Functions.

func durable get-runtime-status

Restituisce lo stato dell'istanza di orchestrazione specificata.

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

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

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

Per altre informazioni, vedere la documentazione di Durable Functions.

func durable purge-history

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

func durable purge-history

L'azione purge-history supporta le opzioni seguenti:

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

Per altre informazioni, vedere la documentazione di Durable Functions.

func durable raise-event

Genera un evento all'istanza di orchestrazione specificata.

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

L'azione raise-event supporta le opzioni seguenti:

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

Per altre informazioni, vedere la documentazione di Durable Functions.

func durable rewind

Riavvolge l'istanza di orchestrazione specificata.

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

L'azione rewind supporta le opzioni seguenti:

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

Per altre informazioni, vedere la documentazione di Durable Functions.

func durable start-new

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

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

L'azione start-new supporta le opzioni seguenti:

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

Per altre informazioni, vedere la documentazione di Durable Functions.

func durable terminate

Arresta l'istanza di orchestrazione specificata.

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

L'azione terminate supporta le opzioni seguenti:

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

Per altre informazioni, vedere la documentazione di Durable Functions.

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>

L'azione install supporta le opzioni seguenti:

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

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

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

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

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

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

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

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

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

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

func extensions sync

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

L'azione sync supporta le opzioni seguenti:

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

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

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 .

Sono disponibili le opzioni di distribuzione di Kubernetes seguenti:

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

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

Funzioni di Azure supporta l'hosting delle funzioni in contenitori in App Azure Container o in Funzioni di Azure. L'esecuzione dei contenitori direttamente in un cluster Kubernetes o in servizio Azure Kubernetes (AKS) non è ufficialmente supportata da Funzioni di Azure. Per altre informazioni, vedere Supporto dei contenitori Linux in Funzioni di Azure.

func kubernetes install

Installa KEDA in un cluster Kubernetes.

func kubernetes install

Installa KEDA nel cluster definito nel file di configurazione kubectl.

L'azione install supporta le opzioni seguenti:

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

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

func kubernetes remove

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

func kubernetes remove

Rimuove KEDA dal cluster definito nel file di configurazione kubectl.

L'azione remove supporta le opzioni seguenti:

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

Per altre informazioni, vedere Disinstallazione di KEDA da Kubernetes.

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 e <VALUE> con il valore dell'impostazione.

L'azione add supporta l'opzione seguente:

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

func settings decrypt

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

func settings decrypt

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

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.

L'azione delete supporta l'opzione seguente:

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

func settings list

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

func settings list

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

L'azione list supporta l'opzione seguente:

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

func templates list

Elenca i modelli di funzione (trigger) disponibili.

L'azione list supporta l'opzione seguente:

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