Aracılığıyla paylaş

Azure Static Web Apps CLI'sını yapılandırma

  • Makale

Azure Static Web Apps (SWA) CLI, statik web uygulamanız için yapılandırma bilgilerini iki yoldan biriyle alır:

  • CLI seçenekleri (çalışma zamanında geçirilir)
  • swa-cli.config.json adlı bir CLI yapılandırma dosyası

Not

Varsayılan olarak, SWA CLI geçerli dizinde swa-cli.config.json adlı bir yapılandırma dosyası arar.

Yapılandırma dosyası, her birinin benzersiz bir yapılandırma adıyla tanımlanan birden çok yapılandırma içerebilir.

  • swa-cli.config.json dosyasında yalnızca tek bir yapılandırma varsa, swa start varsayılan olarak bunu kullanır.

  • Seçenekler bir yapılandırma dosyasından yüklenirse, komut satırı seçenekleri yoksayılır.

Örnek yapılandırma dosyası

Aşağıdaki kod parçacığı yapılandırma dosyasının şeklini gösterir.

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

Bu örnekte gösterildiği gibi yalnızca bir yapılandırma bölümünüz olduğunda, swa start komut otomatik olarak bu değerleri kullanır.

Yapılandırma dosyasını başlatma

Yapılandırma dosyanızı komutuyla swa init başlatabilirsiniz. Mevcut bir projeye karşı komutunu çalıştırırsanız yapılandırma swa init ayarlarını sizin için tahmin etmeye çalışır.

Varsayılan olarak, işlem bu ayarları projenizin geçerli çalışma dizinindeki bir swa-cli.config.json oluşturur. Bu dizin, proje yapılandırma değerlerini ararken tarafından swa kullanılan varsayılan dosya adı ve konumudur.

swa --config <PATH>

Dosyada yalnızca bir adlandırılmış yapılandırma varsa, bu yapılandırma varsayılan olarak kullanılır. Birden çok yapılandırma tanımlanmışsa, istediğiniz yapılandırma adını bir seçenek olarak iletirsiniz.

swa --<CONFIG_NAME>

Yapılandırma dosyası seçeneği kullanıldığında, ayarlar JSON biçiminde depolanır. Oluşturulduktan sonra, ayarları güncelleştirmek için dosyayı el ile düzenleyebilir veya güncelleştirmeleri yapmak için kullanabilirsiniz swa init .

Yapılandırmayı görüntüleme

Statik Webler CLI'sı, geçerli yapılandırmanızı gözden geçirebilmeniz için bir --print-config seçenek sağlar.

Aşağıda, varsayılan ayarlara sahip yeni bir projede çalıştırıldığında bu çıkışın nasıl göründüğüne ilişkin bir örnek verilmişti.

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

Çalıştırma swa --print-config , geçerli yapılandırma varsayılanlarıdır.

Not

Proje henüz bir yapılandırma dosyası tanımlamadıysa, bu işlem bir yapılandırma dosyası oluşturmanıza yardımcı olması için iş akışını otomatik olarak tetikler swa init .

Yapılandırmayı doğrulama

swa-cli.config.json dosyasını aşağıdaki şemaya göre doğrulayabilirsiniz:https://aka.ms/azure/static-web-apps-cli/schema