Düzenle

Azure Static Web Apps için uygulama ayarlarını yapılandırma

  • Nasıl yapılır

Uygulama ayarları, veritabanı bağlantı dizesi gibi değişebilecek yapılandırma değerlerini tutar. Uygulama ayarlarını eklemek, uygulama kodunu değiştirmek zorunda kalmadan uygulamanıza yapılandırma girişini değiştirmenize olanak tanır.

Uygulama ayarları:

  • Statik web uygulamasının arka uç API'sinde ortam değişkenleri olarak kullanılabilir
  • Kimlik doğrulama yapılandırmasında kullanılan gizli dizileri depolamak için kullanılabilir
  • Bekleme sırasında şifrelenir
  • Hazırlama ve üretim ortamlarına kopyalanır
  • Yalnızca alfasayısal karakterler, .ve olabilir _

Önemli

Bu makalede açıklanan uygulama ayarları yalnızca azure statik web uygulamasının arka uç API'sine uygulanır.

Ön uç web uygulamanızı derlemek için gereken ortam değişkenlerini yapılandırmak için bkz . Derleme yapılandırması.

Önkoşullar

Yerel geliştirme için API uygulama ayarlarını yapılandırma

Azure Static Web Apps'teki API'ler, uygulamayı yerel olarak çalıştırdığınızda local.settings.json dosyasında uygulama ayarlarını tanımlamanızı sağlayan Azure İşlevleri tarafından desteklenir. Bu dosya, yapılandırma özelliğinde Values uygulama ayarlarını tanımlar.

Not

local.settings.json dosyası yalnızca yerel geliştirme için kullanılır. Üretim için uygulama ayarlarını yapılandırmak için Azure portalını kullanın.

Aşağıdaki örnek local.settings.json için bir değerin nasıl ekleneceği gösterilmektedir 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.

Uygulama ayarlarını yapılandırma

Uygulama ayarlarını Azure portalı üzerinden veya Azure CLI ile yapılandırabilirsiniz.

Azure portal’ı kullanma

Azure portalı uygulama ayarlarını oluşturmak, güncelleştirmek ve silmek için bir arabirim sağlar.

  1. Azure portalına gidin.

  2. Statik web uygulamanızı açın.

  3. Kenar çubuğunda Yapılandırma'ya tıklayın.

  4. Uygulama ayarlarını uygulamak istediğiniz ortamı seçin. Ortam başına uygulama ayarlarını yapılandırabilirsiniz. Çekme isteği oluşturduğunuzda hazırlama ortamları otomatik olarak oluşturulur ve çekme isteğini birleştirdiğinizde üretime yükseltilir.

  5. Yeni bir uygulama ayarı eklemek için + Ekle'yi seçin. Azure Static Web Apps yapılandırma görünümünün ekran görüntüsü

  6. Ad ve Değer girin.

  7. Tamam'ı seçin.

  8. Kaydet'i seçin.

Azure CLI'yi kullanma

Azure'da az staticwebapp appsettings ayarlarınızı güncelleştirmek için komutunu kullanın.

Terminalde veya komut satırında aşağıdaki komutu yürüterek adlı message ayarı değeriyle ekleyin veya güncelleştirin Hello world. Yer tutucuyu <YOUR_APP_ID> değerinizle değiştirdiğinden emin olun.

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.

İlgili içerik