Riferimento di Azure Functions Core Tools
Questo articolo fornisce la documentazione di riferimento per gli strumenti di base Funzioni di Azure, che consente di sviluppare, gestire e distribuire progetti Funzioni di Azure dal computer locale. Per altre informazioni sull'uso di Core Tools, vedere Usare Funzioni di Azure Core Tools.
I comandi di Core Tools sono organizzati nei contesti seguenti, ognuno dei quali fornisce un set univoco di azioni.
Contesto del comando | Descrizione |
---|---|
func |
Comandi usati per creare ed eseguire funzioni nel computer locale. |
func azure |
Comandi per l'uso delle risorse di Azure, inclusa la pubblicazione. |
func azurecontainerapps |
Distribuire un'app per le funzioni in contenitori in App Azure Container. |
func durable |
Comandi per l'uso di Durable Functions. |
func extensions |
Comandi per l'installazione e la gestione delle estensioni. |
func kubernetes |
Comandi per l'uso di Kubernetes e Funzioni di Azure. |
func settings |
Comandi per la gestione delle impostazioni di ambiente per l'host funzioni locale. |
func templates |
Comandi per elencare i modelli di funzione disponibili. |
Prima di usare i comandi in questo articolo, è necessario installare Core Tools.
func init
Crea un nuovo progetto di Funzioni in un linguaggio specifico.
func init <PROJECT_FOLDER>
Quando si specifica <PROJECT_FOLDER>
, il progetto viene creato in una nuova cartella con questo nome. In caso contrario, viene utilizzata la cartella corrente.
func init
supporta le opzioni seguenti, che non supportano la versione 1.x, se non diversamente specificato:
Opzione | Descrizione |
---|---|
--csx |
Crea funzioni .NET come script C#, ovvero il comportamento della versione 1.x. Valido solo con --worker-runtime dotnet . |
--docker |
Crea un Dockerfile per un contenitore usando un'immagine di base basata sull'oggetto scelto --worker-runtime . Usare questa opzione quando si prevede di distribuire un'app per le funzioni in contenitori. |
--docker-only |
Aggiunge un Dockerfile a un progetto esistente. Richiede il runtime di lavoro se non specificato o impostato in local.settings.json. Usare questa opzione quando si prevede di distribuire un'app per le funzioni in contenitori e il progetto esiste già. |
--force |
Inizializzare il progetto anche se contiene file esistenti. Questa impostazione sovrascrive i file esistenti con lo stesso nome. Gli altri file nella cartella del progetto non sono interessati. |
--language |
Inizializza un progetto specifico del linguaggio. Attualmente supportato quando --worker-runtime è impostato su node . Le opzioni sono typescript e javascript . È anche possibile usare --worker-runtime javascript o --worker-runtime typescript . |
--managed-dependencies |
Installa le dipendenze gestite. Attualmente, solo il runtime del ruolo di lavoro di PowerShell supporta questa funzionalità. |
--model |
Imposta il modello di programmazione desiderato per un linguaggio di destinazione quando sono disponibili più modelli. Le opzioni supportate sono V1 e V2 per Python e 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-isolated dotnet , , javascript ,node (JavaScript), powershell , python e 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.0 e 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-token ad 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-token ad 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-username anche . |
--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 , node dotnetIsolated , 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 , completed e 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 , terminated canceled , 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 , NodePort e 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. |