Szerkesztés

Az Azure Static Web Apps alkalmazásbeállításainak konfigurálása

  • Használati útmutató

Az alkalmazásbeállítások olyan konfigurációs értékeket tartalmaznak, amelyek változhatnak, például adatbázis-kapcsolati sztring. Az alkalmazásbeállítások hozzáadásával anélkül módosíthatja az alkalmazás konfigurációs bemenetét, hogy módosítania kellene az alkalmazás kódját.

Alkalmazásbeállítások:

Fontos

A cikkben ismertetett alkalmazásbeállítások csak egy Azure Static Web App háttér API-jára vonatkoznak.

Az előtérbeli webalkalmazás létrehozásához szükséges környezeti változók konfigurálásához lásd a buildkonfigurációt.

Előfeltételek

API-alkalmazásbeállítások konfigurálása helyi fejlesztéshez

Az Azure Static Web Apps API-jait az Azure Functions működteti, amely lehetővé teszi az alkalmazásbeállítások megadását a local.settings.json fájlban az alkalmazás helyi futtatásakor. Ez a fájl a konfiguráció tulajdonságában definiálja az Values alkalmazásbeállításokat.

Feljegyzés

A local.settings.json fájl csak helyi fejlesztéshez használható. Az Azure Portal használatával konfigurálhatja az alkalmazásbeállításokat az éles környezethez.

Az alábbi local.settings.json minta bemutatja, hogyan adhat hozzá értéket a DATABASE_CONNECTION_STRING.

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "",
    "FUNCTIONS_WORKER_RUNTIME": "node",
    "DATABASE_CONNECTION_STRING": "<YOUR_DATABASE_CONNECTION_STRING>"
  }
}

Settings defined in the Values property can be referenced from code as environment variables. In Node.js functions, for example, they're available in the process.env object.

const connectionString = process.env.DATABASE_CONNECTION_STRING;

The local.settings.json file isn't tracked by the GitHub repository because sensitive information, like database connection strings, are often included in the file. Since the local settings remain on your machine, you need to manually configure your settings in Azure.

Generally, configuring your settings is done infrequently, and isn't required with every build.

Alkalmazásbeállítások konfigurálása

Az alkalmazásbeállításokat az Azure Portalon vagy az Azure CLI-vel konfigurálhatja.

Az Azure Portal használata

Az Azure Portal egy felületet biztosít az alkalmazásbeállítások létrehozásához, frissítéséhez és törléséhez.

  1. Nyissa meg az Azure Portalt.

  2. Nyissa meg a statikus webalkalmazást.

  3. Válassza a Konfiguráció lehetőséget az oldalsávon.

  4. Válassza ki azt a környezetet, amelyre alkalmazni szeretné az alkalmazásbeállításokat. Az alkalmazásbeállításokat környezetenként konfigurálhatja. Lekéréses kérelem létrehozásakor a rendszer automatikusan létrehozza az átmeneti környezeteket, majd a lekéréses kérelem egyesítésekor előlépteti az éles környezetbe.

  5. Új alkalmazásbeállítás hozzáadásához válassza a + Hozzáadás lehetőséget. Képernyőkép az Azure Static Web Apps konfigurációs nézetéről

  6. Adjon meg egy nevet és egy értéket.

  7. Kattintson az OK gombra.

  8. Válassza a Mentés lehetőséget.

Az Azure parancssori felületének használata

az staticwebapp appsettings A parancs használatával frissítheti a beállításokat az Azure-ban.

Terminálban vagy parancssorban hajtsa végre a következő parancsot egy olyan beállítás message hozzáadásához vagy frissítéséhez, amelynek értéke a következő Hello world. Ügyeljen arra, hogy a helyőrzőt <YOUR_APP_ID> cserélje le az értékére.

az staticwebapp appsettings set --name <YOUR_APP_ID> --setting-names "message=Hello world"

Tip

You can add or update multiple settings by passing multiple name-value pairs to --setting-names.

View application settings with the Azure CLI

In a terminal or command line, execute the following command. Make sure to replace the placeholder <YOUR_APP_ID> with your value.

az staticwebapp appsettings list --name <YOUR_APP_ID>

Delete application settings with the Azure CLI

In a terminal or command line, execute the following command to delete a setting named message. Make sure to replace the placeholder <YOUR_APP_ID> with your value.

az staticwebapp appsettings delete --name <YOUR_APP_ID> --setting-names "message"

Tip

Delete multiple settings by passing multiple setting names to --setting-names.

Kapcsolódó tartalom