Azure Pipelines ile Uygulama Yapılandırması'Azure Pipelines

Bu Azure Uygulama Yapılandırması, anahtar-değerleri Uygulama Yapılandırma depodan çeker ve bunları sonraki görevler tarafından 4.000'den fazla azure işlem hattı değişkeni olarak ayarlar. Bu görev, Azure Uygulama Yapılandırması değerlerini bir yapılandırma dosyasından Uygulama Yapılandırma deponıza ileten anında itme görevini tamamlar. Daha fazla bilgi için bkz. Azure Pipelines ile Uygulama Yapılandırmasına Azure Pipelines.

Önkoşullar

• Azure aboneliği - ücretsiz bir abonelik oluşturun
• Uygulama Yapılandırma deposu - uygulamanın içinde ücretsiz Azure portal.
• Azure DevOps proje - ücretsiz bir proje oluşturun
• Azure Uygulama Yapılandırması görevi - marketten ücretsiz Visual Studio indirin.
• Düğüm 10 - Kendi kendine barındırılan aracılarda görevi ç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 kullanma

Bu bölümde, derleme işlem hattında Azure Uygulama Yapılandırması görevi Azure DevOps açıklandı.

1. Pipelines Pipelines' seçeneğine tıklayarak derleme işlem > hattı sayfasına gidin. Derleme işlem hattı belgeleri için bkz. İlk işlem hattınızı oluşturma.
   • Yeni bir derleme işlem hattı oluşturuyorsanız, sürecin son adımlarında Gözden Geçir sekmesinde işlem hattının sağ tarafındaki Yardımcıyı göster'i seçin.
   • Mevcut bir derleme işlem hattı kullanıyorsanız sağ üst sırada yer alan Düzenle düğmesine tıklayın.
2. Azure Uygulama Yapılandırması Için Arama.
3. Görevin Uygulama Yapılandırma mağazasından anahtar-değerleri çekmesi için gerekli parametreleri yapılandırma. Parametrelerin açıklamaları aşağıdaki Parametreler bölümünde ve her parametrenin yanındaki araç ipucunda kullanılabilir.
   • Azure abonelik parametresini önceki adımda oluşturduğunuz hizmet bağlantısının adı olarak ayarlayın.
   • Uygulama Yapılandırması adını Uygulama Yapılandırma mağazanıza kaynak adı olarak ayarlayın.
   • Kalan parametreler için varsayılan değerleri bırakın.
4. Derlemeyi kaydetme ve kuyruğa kaydetme. Derleme günlüğü, görevin yürütülmesi sırasında meydana gelen hataları görüntüler.

Sürümlerde kullanma

Bu bölümde, bir yayın işlem hattında Azure Uygulama Yapılandırması görev Azure DevOps açık bir şekilde açıklandı.

1. Yayın yayınlarını seçerek yayın işlem hattı Pipelines > gidin. Yayın işlem hattı belgeleri için bkz. Yayın işlem hatları.
2. Mevcut bir yayın işlem hattını seçin. Bir işlem hattına sahip değilsanız Yeni işlem hattı'ya tıklar ve yeni işlem hattı oluşturun.
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 listesinde, görevi eklemek istediğiniz Aşamayı seçin. Aşamalar hakkında daha fazla bilgi için buraya bakın.
5. Yeni + görev eklemek istediğiniz işin yanındaki öğesini tıklatın.
6. Azure Uygulama Yapılandırması Için Arama.
7. Görev içindeki gerekli parametreleri, anahtar-değerlerinizi Uygulama Yapılandırma depodan çekmek için yapılandırma. Parametrelerin açıklamaları aşağıdaki Parametreler bölümünde ve her parametrenin yanındaki araç ipucunda kullanılabilir.
   • Azure abonelik parametresini önceki adımda oluşturduğunuz hizmet bağlantısının adı olarak ayarlayın.
   • Uygulama Yapılandırması adını Uygulama Yapılandırma mağazanıza kaynak adı olarak ayarlayın.
   • Kalan parametreler için varsayılan değerleri bırakın.
8. Bir sürümü kaydedin ve kuyruğa kaydedin. Yayın günlüğü, görevin yürütülmesi sırasında karşılaşılan hataları görüntüler.

Parametreler

Aşağıdaki parametreler, Azure Uygulama Yapılandırması kullanılır:

• Azure aboneliği: Kullanılabilir Azure hizmet bağlantılarınızı içeren bir açılan liste. Kullanılabilir Azure hizmet bağlantıları listenizi güncelleştirmek ve yenilemek için metin kutusunun sağında yer alan 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üken bir açılan liste. Kullanılabilir yapılandırma depoları listenizi güncelleştirmek ve yenilemek için metin kutusunun sağında bulunan Uygulama Yapılandırma Adını Yenile düğmesine basın.
• Anahtar Filtresi: Filtre, verilerden hangi anahtar-değerlerin Azure Uygulama Yapılandırması. * değeri tüm anahtar-değerleri seçer. hakkında daha fazla bilgi için bkz. Sorgu anahtarı değerleri.
• Etiket: Uygulama Yapılandırma mağazasından anahtar-değer seçiminde hangi etiketin kullan gerektiğini belirtir. Hiçbir etiket sağlanamıyorsa, etiketi olmayan anahtar-değerler alınır. Şu karakterlere izin verilmez: , *.
• Kırpma Anahtarı Ön Eki: Uygulama Yapılandırma anahtarlarından, bunları değişken olarak ayarlamadan önce kırpıldıklarından bir veya daha fazla ön ek belirtir. Birden çok ön ek yeni satır karakteriyle ayrılabilir.

Sonraki görevlerde anahtar değerlerini kullanma

Uygulama Yapılandırması'dan alınan anahtar-değerler, ortam değişkenleri olarak erişilebilen işlem hattı değişkenleri olarak ayarlanır. Ortam değişkeninin anahtarı, belirtilmişse ön ek kırpıldıktan sonra Uygulama Yapılandırması'dan alınan anahtar-değerin anahtarıdır.

Örneğin, sonraki bir görev bir PowerShell betiği çalıştırırsa, aşağıdaki gibi 'myBuildSetting' anahtarına sahip bir anahtar-değer tüketir:

echo "$env:myBuildSetting"

Değeri de konsola yazdırılır.

Sorun giderme

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

SSS

Nasıl yaparım? anahtar ve etiketten yapılandırmamı mı oluşturabilirsiniz?

Yapılandırmanın birden çok etiketten (örneğin, varsayılan ve geliştirme) bir şekilde bestelenmiş olması gereken zamanlar vardır. Bu senaryoyu uygulamak için bir işlem hattında birden çok Uygulama Yapılandırması görevi kullanılabilir. Sonraki adımlarda bir görev tarafından alınan anahtar-değerler, önceki adımlardan alınan değerlerin yerine geçeceğiz. Daha önce yer alan örnekte, bir görev varsayılan etikete sahip anahtar-değerleri seçmek için, ikinci bir görev ise geliştirme etiketine sahip anahtar-değerleri seçmek için kullanılabilir. Geliştirme etiketine sahip anahtarlar, aynı anahtarları varsayılan etiketle geçersiz kılar.