Gelişmiş işlem hattı özellikleri ve yapılandırmaları

Komutunu, aşağıdaki bölümlerde açıklandığı gibi gelişmiş senaryoları ve özel gereksinimleri destekleyecek şekilde genişletebilirsiniz azd pipeline config .

Özel gizli bilgiler ve değişkenler

Varsayılan olarak, azd işlem hattınız için temel değişkenleri ve gizli dizileri ayarlar. Örneğin, komutunu çalıştırdığınızda azd pipeline config, subscription idve environment namegibi regiondeğişkenler oluşturur. İşlem hattı tanımınızda bu değişkenlere başvurulur:

env:
   AZURE_CLIENT_ID: ${{ vars.AZURE_CLIENT_ID }}
   AZURE_TENANT_ID: ${{ vars.AZURE_TENANT_ID }}
   AZURE_SUBSCRIPTION_ID: ${{ vars.AZURE_SUBSCRIPTION_ID }}
   AZURE_ENV_NAME: ${{ vars.AZURE_ENV_NAME }}
   AZURE_LOCATION: ${{ vars.AZURE_LOCATION }}

İşlem hattı çalıştırıldığında, azd bu değerleri ortamdan alır ve bunları işlem hattı değişkenleri ve gizli dizileriyle eşler. Şablonunuz bağlı olarak, ortam değişkenlerini kullanarak ek ayarları denetlemek isteyebilirsiniz. Örneğin, altyapınızdaki bir KEY_VAULT_NAME Key Vault kaynağının adını tanımlamak için bir ortam değişkeni ayarlayabilirsiniz.

Özel değişkenleri ve gizli dizileri desteklemek için bunları şablonunuzun azure.yaml dosyasında tanımlayın. Örneğin:

pipeline:
  variables:
    - KEY_VAULT_NAME
    - STORAGE_NAME
  secrets:
    - CONNECTION_STRING

Bu yapılandırmayla, azd listelenen değişkenlerden veya gizli dizilerden herhangi birinin ortamda bir değeri olup olmadığını denetler. Ardından ortam değerini kullanarak işlem hattında karşılık gelen değişkeni veya gizliyi oluşturur.

İşlem hattı tanımınızda azure-dev.yaml şu değişkenlere ve gizli dizilere başvurabilirsiniz:

- name: Provision Infrastructure
   run: azd provision --no-prompt
   env:
      KEY_VAULT_NAME: ${{ variables.KEY_VAULT_NAME }}
      STORAGE_NAME: ${{ variables.STORAGE_NAME }}
      CONNECTION_STRING: ${{ secrets.CONNECTION_STRING }}

Uyarı

içindeki azure.yamlgizli dizilerin veya değişkenlerin listesini güncelleştirdikten sonra işlem hattı değerlerini güncelleştirmek için yeniden çalıştırın azd pipeline config .

Altyapı parametreleri

Aşağıdaki Bicep örneğini göz önünde bulundurun:

@secure()
param BlobStorageConnection string

Parametrenin BlobStorageConnection varsayılan değeri yoksa, azd kurulum sırasında sizden bir değer ister. Ancak, CI/CD çalıştırmaları sırasında etkileşimli bir komut istemi yoktur. Bunun yerine, azd komutunu çalıştırdığınızda azd pipeline config değerini talep eder, değeri boru hattı sırrı olarak kaydeder ve işlem hattı çalıştırıldığında otomatik olarak alır.

azd, gerekli parametre değerlerini depolamak ve sağlamak için AZD_INITIAL_ENVIRONMENT_CONFIG adlı bir işlem hattı gizli dizisi kullanır. İşlem hattı tanımınızda bu gizliye referans alın.

- name: Provision Infrastructure
   run: azd provision --no-prompt
   env:
      AZD_INITIAL_ENVIRONMENT_CONFIG: ${{ secrets.AZD_INITIAL_ENVIRONMENT_CONFIG }}

İşlem hattı çalıştırıldığında, azd, gizli anahtar kullanarak, parametre değerlerini sağlamak için etkileşimli istemlere duyulan ihtiyacı ortadan kaldırır.

Uyarı

Yeni bir parametre eklerseniz işlem hattı yapılandırmasını güncelleştirmek için yeniden çalıştırın azd pipeline config .