Condividi tramite

Configurare l'interfaccia della riga di comando di App Web statiche di Azure

  • Articolo

L'interfaccia della riga di comando di App Web statiche di Azure (SWA) ottiene informazioni di configurazione per l'app Web statica in uno dei due modi seguenti:

  • Opzioni dell'interfaccia della riga di comando (passate in fase di esecuzione)
  • Un file di configurazione dell'interfaccia della riga di comando denominato swa-cli.config.json

Nota

Per impostazione predefinita, l'interfaccia della riga di comando di SWA cerca un file di configurazione denominato swa-cli.config.json nella directory corrente.

Il file di configurazione può contenere più configurazioni, ognuna identificata da un nome di configurazione univoco.

  • Se nel file di swa-cli.config.json è presente una sola configurazione, swa start la usa per impostazione predefinita.

  • Se le opzioni vengono caricate da un file di configurazione, le opzioni della riga di comando vengono ignorate.

File di configurazione di esempio

Il frammento di codice seguente mostra la forma del file di configurazione.

{
  "configurations": {
    "app": {
      "appDevserverUrl": "http://localhost:3000",
      "apiLocation": "api",
      "run": "npm run start",
      "swaConfigLocation": "./my-app-source"
    }
  }
}

Quando si dispone di una sola sezione di configurazione, come illustrato in questo esempio, il swa start comando usa automaticamente questi valori.

Inizializzare un file di configurazione

È possibile inizializzare il file di configurazione con il swa init comando . Se si esegue il comando su un progetto esistente, swa init tenta di indovinare automaticamente le impostazioni di configurazione.

Per impostazione predefinita, il processo crea queste impostazioni in un swa-cli.config.json nella directory di lavoro corrente del progetto. Questa directory è il nome e il percorso di file predefiniti usati da swa durante la ricerca dei valori di configurazione del progetto.

swa --config <PATH>

Se il file contiene una sola configurazione denominata, tale configurazione viene usata per impostazione predefinita. Se vengono definite più configurazioni, passare il nome di configurazione desiderato in come opzione.

swa --<CONFIG_NAME>

Quando viene usata l'opzione file di configurazione, le impostazioni vengono archiviate in formato JSON. Una volta creato, è possibile modificare manualmente il file per aggiornare le impostazioni o usare swa init per eseguire gli aggiornamenti.

Visualizzare la configurazione

L'interfaccia della riga di comando statica di Webs offre un'opzione --print-config che consente di esaminare la configurazione corrente.

Ecco un esempio dell'aspetto dell'output quando viene eseguito in un nuovo progetto con le impostazioni predefinite.

swa --print-config

Options:
 - port: 4280
 - host: localhost
 - apiPort: 7071
 - appLocation: .
 - apiLocation: <undefined>
 - outputLocation: .
 - swaConfigLocation: <undefined>
 - ssl: false
 - sslCert: <undefined>
 - sslKey: <undefined>
 - appBuildCommand: <undefined>
 - apiBuildCommand: <undefined>
 - run: <undefined>
 - verbose: log
 - serverTimeout: 60
 - open: false
 - githubActionWorkflowLocation: <undefined>
 - env: preview
 - appName: <undefined>
 - dryRun: false
 - subscriptionId: <undefined>
 - resourceGroupName: <undefined>
 - tenantId: <undefined>
 - clientId: <undefined>
 - clientSecret: <undefined>
 - useKeychain: true
 - clearCredentials: false
 - config: swa-cli.config.json
 - printConfig: true

L'esecuzione swa --print-config di fornisce le impostazioni predefinite di configurazione correnti.

Nota

Se il progetto non ha ancora definito un file di configurazione, viene attivato automaticamente il swa init flusso di lavoro per crearne uno.

Convalidare la configurazione

È possibile convalidare il file swa-cli.config.json con lo schema seguente: https://aka.ms/azure/static-web-apps-cli/schema