Ayarları Azure Pipelines ile uygulama yapılandırmasına gönderme

Azure uygulama yapılandırma gönderim görevi, anahtar değerlerini bir yapılandırma dosyasından uygulama yapılandırma deponuza gönderir. Bu görev, artık uygulama yapılandırma deposundaki ayarları ve uygulama yapılandırma deposuna gönderme ayarlarını çektiğinizde, işlem hattı içinde tam daire işlevlerini sağlar.

Önkoşullar

• Azure aboneliği- ücretsiz olarak bir tane oluşturun
• Uygulama yapılandırma kaynağı- Azure Portalücretsiz olarak bir tane oluşturun.
• Azure DevOps projesi- ücretsiz bir tane oluşturun
• Azure uygulama yapılandırma gönderim görevi- Visual Studio market'ten ücretsiz indirin.
• Düğüm 10 -görevi kendi kendine barındırılan aracılarda çalıştıran kullanıcılar için.

Hizmet bağlantısı oluşturma

Hizmet bağlantısı , Azure DevOps projenizden Azure aboneliğinizdeki kaynaklara erişmenizi sağlar.

1. Azure DevOps 'da, hedef işlem hattınızı içeren projeye gidin. Sol alt köşede proje ayarları' nı seçin.

2. İşlem hatları'nın altında Hizmet bağlantıları'nı seçin. Sağ üst köşede yeni hizmet bağlantısı' nı seçin.

3. Yeni hizmet bağlantısı' nda Azure Resource Manager' yi seçin.

   

4. Yeni bir hizmet sorumlusu oluşturmak için kimlik doğrulama yöntemi Iletişim kutusunda hizmet sorumlusu (otomatik) seçeneğini belirleyin veya mevcut bir hizmet sorumlusunu kullanmakiçin hizmet sorumlusu (el ile) seçeneğini belirleyin.

5. Aboneliğinizi ve kaynağı ve hizmet bağlantınız için bir ad girin.

Yeni bir hizmet sorumlusu oluşturduysanız, hizmet bağlantısına atanan hizmet sorumlusunun adını bulun. Sonraki adımda bu hizmet sorumlusuna yeni bir rol ataması ekleyeceksiniz.

1. Proje ayarları > hizmet bağlantıları' na gidin.

2. Yeni hizmet bağlantısını seçin.

3. Hizmet sorumlusunu Yönet' i seçin.

4. Görünen ad içindeki değeri aklınızda edin.

   

Rol ataması ekle

Görevin uygulama yapılandırma deposuna erişebilmesi için görev içinde kullanılan kimlik bilgilerine uygun uygulama yapılandırma rolü atamalarını atayın.

1. Hedef uygulama yapılandırma deponuza gidin.

2. Sol menüde erişim denetimi (IAM) seçeneğini belirleyin.

3. Sağ bölmede rol atamaları Ekle' yi seçin.

   

4. Rol Için uygulama yapılandırma veri sahibi' nı seçin. Bu rol, görevin uygulama yapılandırma deposundan okuma ve yazma yapmasına izin verir.

5. Önceki bölümde oluşturduğunuz hizmet bağlantısıyla ilişkili hizmet sorumlusunu seçin.

   

Derlemelerde kullan

bu bölümde, Azure DevOps derleme işlem hattında Azure uygulama yapılandırma gönderim görevinin nasıl kullanılacağı ele alınmaktadır.

1. Pipelines pipelines ' ye tıklayarak derleme ardışık düzeni sayfasına gidin > . Derleme işlem hatları için belgeler buradabulunabilir.
   • Yeni bir derleme işlem hattı oluşturuyorsanız, işlemin son adımında, Gözden geçirme sekmesinde, işlem hattının sağ tarafında bulunan yardımcıyı göster ' i seçin.
   • Varolan bir yapı ardışık düzeni kullanıyorsanız, sağ üst köşedeki Düzenle düğmesine tıklayın.
2. Azure uygulama yapılandırma gönderme görevini arayın.
3. Yapılandırma dosyasından uygulama yapılandırma deposuna anahtar değerlerini göndermek için gereken parametreleri yapılandırın. Parametrelerin açıklamaları aşağıdaki Parametreler bölümünde ve her parametrenin yanındaki araç ipuçlarında kullanılabilir.
4. Bir derlemeyi kaydedin ve kuyruğa alın. Yapı günlüğünde, görevin yürütülmesi sırasında oluşan tüm arızalar görüntülenir.

Sürümlerde kullan

bu bölümde, Azure uygulama yapılandırma gönderim görevinin Azure DevOps bir yayın işlem hatlarında nasıl kullanılacağı ele alınmaktadır.

1. Pipelines sürümler ' i seçerek yayın ardışık düzeni sayfasına gidin > . Yayın işlem hatlarına yönelik belgeler buradabulunabilir.
2. Mevcut bir yayın işlem hattını seçin. Yoksa, yeni bir tane oluşturmak için + Yeni ' yi seçin.
3. Yayın işlem hattını düzenlemek için sağ üst köşedeki Düzenle düğmesini seçin.
4. Görevler açılan menüsünde, görevi eklemek istediğiniz aşamayı seçin. Aşamalar hakkında daha fazla bilgiyi buradabulabilirsiniz.
5. + Yeni bir görev eklemek Istediğiniz işin ileri ' ye tıklayın.
6. Görev Ekle iletişim kutusunda, arama kutusuna Azure Uygulama yapılandırması gönderme yazın ve seçin.
7. Anahtar değerlerinizi yapılandırma dosyanızdaki uygulama yapılandırma deponuza göndermek için görev içinde gerekli parametreleri yapılandırın. Parametrelerin açıklamaları aşağıdaki Parametreler bölümünde ve her parametrenin yanındaki araç ipuçlarında kullanılabilir.
8. Bir yayını kaydedin ve kuyruğa alın. Yayın günlüğünde, görevin yürütülmesi sırasında karşılaşılan tüm arızalar görüntülenir.

Parametreler

Aşağıdaki parametreler uygulama yapılandırma gönderme görevi tarafından kullanılır:

• Azure aboneliği: kullanılabilir Azure hizmeti bağlantılarınızı içeren bir açılır liste. Kullanılabilir Azure hizmeti bağlantıları listenizi güncelleştirmek ve yenilemek için, TextBox 'ın sağ tarafındaki Azure aboneliğini yenile düğmesine basın.
• Uygulama yapılandırma adı: seçili abonelik altında kullanılabilir yapılandırma depolarınızı yükleyen bir açılan liste. Kullanılabilir yapılandırma depoları listenizi güncelleştirmek ve yenilemek için, TextBox 'ın sağ tarafındaki uygulama yapılandırma adını Yenile düğmesine basın.
• Yapılandırma dosyası yolu: yapılandırma dosyanızın yolu. Yapılandırma dosyası yolu parametresi dosya deposunun kökünde başlar. Yapılandırma dosyası seçmek için yapı yapıtına göz atabilirsiniz. ( ... TextBox 'ın sağ tarafındaki düğme). Desteklenen dosya biçimleri şunlardır: YAML, JSON, Özellikler. JSON biçiminde örnek bir yapılandırma dosyası aşağıda verilmiştir.

  {
      "TestApp:Settings:BackgroundColor":"#FFF",
      "TestApp:Settings:FontColor":"#000",
      "TestApp:Settings:FontSize":"24",
      "TestApp:Settings:Message": "Message data"
  }
  

• Ayırıcı:. JSON ve. yml dosyalarını düzleştirmek için kullanılan ayırıcı.
• Derinlik:. JSON ve. yml dosyalarının ne kadar düzleştirilmesini sağlayacak derinlik.
• Ön ek: uygulama yapılandırma deposuna gönderilen her bir anahtarın başlangıcına eklenen bir dize.
• Etiket: uygulama yapılandırma deposundaki etiket olarak her anahtar değerine eklenen bir dize.
• Içerik türü: uygulama yapılandırma deposu içindeki içerik türü olarak her anahtar değerine eklenen bir dize.
• Etiketler: {"tag1":"val1", "tag2":"val2"} uygulama yapılandırma deponuza gönderilen her anahtar değerine eklenen etiketleri TANıMLAYAN biçiminde bir JSON nesnesi.
• Depodaki tüm diğer Key-Values Belirtilen önek ve etiketle Sil: varsayılan değer işaretli değildir.
  • Checked: yapılandırma dosyasından yeni anahtar değerleri göndermeden önce belirtilen önek ve etiketle eşleşen uygulama yapılandırma deposundaki tüm anahtar değerlerini kaldırır.
  • İşaretlenmemiş: yapılandırma dosyasındaki tüm anahtar değerlerini uygulama yapılandırma deposuna gönderir ve uygulama yapılandırma deposundaki diğer her şeyi bozulmadan bırakır.

Sorun giderme

Beklenmeyen bir hata oluşursa, işlem hattı değişkeni olarak ayarlanarak hata ayıklama günlükleri etkinleştirilebilir system.debug true .

SSS

Birden çok yapılandırma dosyasını nasıl karşıya yükleyebilirim?

Birden çok yapılandırma dosyasını uygulama yapılandırma deposuna göndermek için aynı işlem hattı içinde Azure uygulama yapılandırma gönderim görevinin birden fazla örneğini oluşturun.

Bu görevi kullanarak Key Vault başvuruları nasıl oluşturabilirim?

Key Vault başvurular oluşturmak için, "Içerik türü" parametresini Application/vnd. Microsoft. appconfig. keyvaultref + JSON; charset = UTF-8 olarak ayarlayın. Bir yapılandırma dosyasındaki tüm anahtar değerleri Key Vault başvurulardır, Key Vault başvuruları ve normal anahtar değerlerini ayrı yapılandırma dosyalarına yerleştirip ayrı ayrı gönderin.

Anahtar değerlerini yapılandırma depoma göndermeye çalışırken neden 409 hatası alıyorum?

Görev, uygulama yapılandırma deposunda kilitlenen bir anahtar değerini kaldırmaya veya üzerine yazmaya çalışırsa bir 409 çakışma hata iletisi oluşur.