Değişken grupları & Ekle

Denetlemek istediğiniz değerleri depolamak ve birden çok işlem hattı genelinde kullanılabilir hale getirmek için bir değişken grubu kullanın. Ayrıca, BIR YAML ardışık düzenine geçirilmesigerekebilecek gizli dizileri ve diğer değerleri depolamak için de değişken gruplarını kullanabilirsiniz. Değişken grupları, işlem hatları altında kitaplık sayfasında tanımlanır ve yönetilir.

Değişken grupları, korunan bir kaynaktır. Onayları ve denetimleri ekleyebilir ve ardışık düzen izinlerini ayarlayabilirsiniz.

Not

Microsoft Team Foundation Server (TFS) 2018 ve önceki sürümlerde, derleme ve yayın işlem hatları tanımlar olarak adlandırılır, çalışmalara derlemeler denir, hizmet bağlantılarına hizmet uç noktaları denir, aşamalar ortamlar olarak adlandırılır ve işler aşamalar olarak adlandırılır.

Not

Değişken grupları, yalnızca Azure DevOps ve TFS 2018 ' deki bir yapı ardışık düzeninde kullanılabilir. TFS 'nin önceki sürümlerindeki derleme ardışık düzeninde kullanılamaz.

Değişken grubu oluşturma

Değişken grupları YAML içinde oluşturulamaz, ancak değişken grubu kullanmabölümünde açıklandığı gibi kullanılabilirler.

Değişken grubu kullanma

Değişken grubundan bir değişken kullanmak için YAML dosyanız içinde gruba bir başvuru eklemeniz gerekir:

variables:
- group: my-variable-group

Bundan sonra değişken grubundan değişkenler YAML dosyanız içinde kullanılabilir.

Hem değişkenleri hem de değişken gruplarını kullanıyorsanız, tek tek (grupsız) değişkenler için name / value söz dizimi kullansanız gerekir:

variables:
- group: my-variable-group
- name: my-bare-variable
  value: 'value of my-bare-variable'

Bir değişken grubuna başvuru yapmak için makro söz dizimi veya çalışma zamanı ifadesi kullanabilirsiniz. Bu örnekte, grubun my-variable-group adlı bir değişkeni myhello var.

variables:
- group: my-variable-group
- name: my-passed-variable
  value: $[variables.myhello] # uses runtime expression

steps:
- script: echo $(myhello) # uses macro syntax
- script: echo $(my-passed-variable) 

Aynı işlem hattında birden çok değişken grubu başvurusunda bulundurun. Birden çok değişken grubu aynı değişkeni içeriyorsa, YAML dosyanızdaki en son eklenen değişken grubu değişkenin değerini ayarlar.

variables:
- group: my-first-variable-group
- group: my-second-variable-group

Ayrıca, bir şablonda bir değişken grubuna da başvurabilirsiniz. Şablonda variables.yml , gruba my-variable-group başvurulur. Değişken grubu adlı bir değişken içerir myhello .

# variables.yml
variables:
- group: my-variable-group

Bu işlem hattında, içinde bulunan $(myhello) değişken grubundaki değişkene my-variable-group variables.yml başvurulur.

# azure-pipeline.yml
stages:
- stage: MyStage
  variables:
  - template: variables.yml
  jobs:
  - job: Test
    steps:
    - script: echo $(myhello)

Değişken gruplarıyla çalışmak için grubu yetkilendirmelisiniz. Bu bir güvenlik özelliğidir: yalnızca bir değişken grubunu YAML 'de adlandırmak zorunda kaldıysanız, deponuza kod gönderebilen herkes, değişken grubundaki gizli dizi içeriğini ayıklayabilir. Bunu yapmak için veya derlemenize bir kaynak yetkilendirme hatası yaşarsanız, aşağıdaki tekniklerden birini kullanın:

  • Herhangi bir diziyle ilgili herhangi bir gizli dizi yoksa, uygun bir seçenek olabilecek değişken grubunu kullanmak için herhangi bir işlem hattını yetkilendirmek isterseniz, Azure Pipelines gidin, kitaplık sayfasını açın, değişken grupları' nı seçin, söz konusu değişken grubunu seçin ve tüm Işlem hattına erişime izin ver ayarını etkinleştirin.

  • Belirli bir işlem hattı için bir değişken grubuna yetki vermek istiyorsanız, bir derlemeyi el ile Düzenle ve kuyruğa Al ' ı seçerek işlem hattını açın. Hata üzerinde bir kaynak yetkilendirme hatası ve "kaynakları Yetkilendir" eylemi görürsünüz. İşlem hattını değişken grubunun yetkili kullanıcısı olarak açıkça eklemek için bu eylemi seçin.

Not

Bir işlem hattına bir değişken grubu eklediyseniz ve bir tane beklediğiniz derlemede bir kaynak yetkilendirme hatası alamazsanız yukarıda açıklanan tüm işlem hatları için erişime Izin ver ayarını kapatın.

YAML derlemeleri TFS 'de henüz kullanılabilir değil.

Bağlı bir değişken grubundaki değişkenlerin değerine, işlem hattının kendisi içinde tanımladığınız değişkenlerletamamen aynı şekilde erişirsiniz. Örneğin, işlem hattına bağlı bir değişken grubundaki Müşteri adlı bir değişkenin değerine erişmek için, $(customer) bir görev parametresinde veya bir betik içinde kullanın. Ancak, gizli değişkenlere (şifrelenmiş değişkenlere ve Anahtar Kasası değişkenlerine) doğrudan betiklerin içine erişilemez. bunun yerine, bir göreve bağımsız değişken olarak geçirilmesi gerekir. Daha fazla bilgi için bkz. gizlilikler

Değişken grubundaki bir değişiklik veya yeni değişkenlerin eklenmesi gibi bir değişken grubuna merkezi olarak yapılan değişiklikler, değişken grubunun bağlı olduğu tüm tanımlar veya aşamalar için otomatik olarak kullanılabilir hale getirilir.

Değişken grubunu yönetme

Azure DevOps CLı kullanarak, projenizdeki işlem hattı çalıştırmaları için değişken gruplarını listeleyebilir ve her birinin ayrıntılarını gösterebilirsiniz. Artık ihtiyacınız yoksa, değişken gruplarını da silebilirsiniz.

Değişken gruplarını listele | Değişken grubunun ayrıntılarını gösterme | Değişken grubunu silme

Değişken gruplarını listele

az pipelines variable-group list komutuyla projenizin değişken gruplarını listeebilirsiniz. Çalışmaya başlama için bkz. Kullanmaya başlayın CLI ile Azure DevOps.

az pipelines variable-group list [--action {manage, none, use}]
                                 [--continuation-token]
                                 [--group-name]
                                 [--org]
                                 [--project]
                                 [--query-order {Asc, Desc}]
                                 [--top]

İsteğe bağlı parametreler

  • action: Değişken gruplarında gerçekleştirilecek eylemi belirtir. Kabul edilen değerler yönet, yok ve kullanır.
  • continuation-token: Devamlılık belirteci sağlandıktan sonra değişken gruplarını listeler.
  • group-name: Değişken grubunun adı. Joker karakterler, gibi kabul new-var* edilir.
  • org: Azure DevOps URL'si. varsayılan kuruluşu kullanarak az devops configure -d organization=ORG_URL yapılandırarak. Varsayılan olarak yapılandırılmamışsa veya kullanılarak toplanmazsa git config gereklidir. Örnek: --org https://dev.azure.com/MyOrganizationName/.
  • project: Projenin adı veya kimliği. Varsayılan projeyi kullanarak az devops configure -d project=NAME_OR_ID yapılandırarak. Varsayılan olarak yapılandırılmamışsa veya kullanılarak toplanmazsa git config gereklidir.
  • sorgu sırası: Sonuçları artan veya azalan (varsayılan) sırada listeler. Kabul edilen değerler Asc ve Desc değerleridir.
  • top: Listelen değişken grubu sayısı.

Örnek

Aşağıdaki komut, ilk 3 değişken gruplarını artan düzende listeler ve sonuçları tablo biçiminde döndürür.

az pipelines variable-group list --top 3 --query-order Asc --output table

ID    Name               Type    Number of Variables
----  -----------------  ------  ---------------------
1     myvariables        Vsts    2
2     newvariables       Vsts    4
3     new-app-variables  Vsts    3

Değişken grubunun ayrıntılarını gösterme

az pipelines variable-group show komutuyla projeniz içinde bir değişken grubunun ayrıntılarını görüntüebilirsiniz. Çalışmaya başlama için bkz. Kullanmaya başlayın CLI ile Azure DevOps.

az pipelines variable-group show --group-id
                                 [--org]
                                 [--project]

Parametreler

  • group-id: Gerekli. Değişken grubunun kimliği. Değişken grubu kimliğini bulmak için bkz. Değişken gruplarını listele.
  • org: Azure DevOps URL'si. varsayılan kuruluşu kullanarak az devops configure -d organization=ORG_URL yapılandırarak. Varsayılan olarak yapılandırılmamışsa veya kullanılarak toplanmazsa git config gereklidir. Örnek: --org https://dev.azure.com/MyOrganizationName/.
  • project: Projenin adı veya kimliği. Varsayılan projeyi kullanarak az devops configure -d project=NAME_OR_ID yapılandırarak. Varsayılan olarak yapılandırılmamışsa veya kullanılarak toplanmazsa git config gereklidir.

Örnek

Aşağıdaki komut, id 4 olan değişken grubunun ayrıntılarını gösterir ve sonuçları YAML biçiminde döndürür.

az pipelines variable-group show --group-id 4 --output yaml

authorized: false
description: Variables for my new app
id: 4
name: MyNewAppVariables
providerData: null
type: Vsts
variables:
  app-location:
    isSecret: null
    value: Head_Office
  app-name:
    isSecret: null
    value: Fabrikam

Değişken grubunu silme

az pipelines variable-group delete komutuyla projeniz içinde bir değişken grubunu silebilirsiniz. Çalışmaya başlama için bkz. Kullanmaya başlayın CLI ile Azure DevOps.

az pipelines variable-group delete --group-id
                                   [--org]
                                   [--project]
                                   [--yes]

Parametreler

  • group-id: Gerekli. Değişken grubunun kimliği. Değişken grubu kimliğini bulmak için bkz. Değişken gruplarını listele.
  • org: Azure DevOps URL'si. varsayılan kuruluşu kullanarak az devops configure -d organization=ORG_URL yapılandırarak. Varsayılan olarak yapılandırılmamışsa veya kullanılarak çekildiğinde gereklidir git config . Örnek: --org https://dev.azure.com/MyOrganizationName/.
  • Proje: projenin adı veya kimliği. Varsayılan projeyi kullanarak yapılandırabilirsiniz az devops configure -d project=NAME_OR_ID . Varsayılan olarak yapılandırılmamışsa veya kullanılarak çekildiğinde gereklidir git config .
  • Evet: isteğe bağlı. Onay istemez.

Örnek

Aşağıdaki komut, KIMLIĞI 1 olan değişken grubunu siler ve onay istemez.

az pipelines variable-group delete --group-id 1 --yes

Deleted variable group successfully.

Değişken grubundaki değişkenleri yönetme

Azure DevOps CLı kullanarak bir işlem hattı çalıştırmasında değişken grubundan değişkenler ekleyebilir ve silebilirsiniz. Ayrıca değişken grubundaki değişkenleri listeleyebilir ve gerektiğinde güncelleştirmeler yapabilirsiniz.

Değişken grubuna | değişken ekleme Değişken grubundaki | değişkenleri listeleme Değişken grubundaki | değişkenleri güncelleştirme Değişken grubundan değişkenleri silme

Değişken grubuna değişken ekleme

Az işlem hattı değişken grubu değişkeni oluştur komutuyla bir değişken grubuna değişken ekleyebilirsiniz. Başlamak için bkz. Azure DevOps CLI ile çalışmaya başlama.

az pipelines variable-group variable create --group-id
                                            --name
                                            [--org]
                                            [--project]
                                            [--secret {false, true}]
                                            [--value]

Parametreler

  • Grup Kimliği: gerekli. Değişken grubunun KIMLIĞI. Değişken grubu KIMLIĞINI bulmak için bkz. değişken gruplarını listeleme.
  • ad: gerekli. Eklemekte olduğunuz değişkenin adı.
  • org: Azure DevOps kuruluş URL 'si. varsayılan kuruluşu kullanarak az devops configure -d organization=ORG_URL yapılandırarak. Varsayılan olarak yapılandırılmamışsa veya kullanılarak toplanmazsa git config gereklidir. Örnek: --org https://dev.azure.com/MyOrganizationName/.
  • project: Projenin adı veya kimliği. Varsayılan projeyi kullanarak az devops configure -d project=NAME_OR_ID yapılandırarak. Varsayılan olarak yapılandırılmamışsa veya kullanılarak toplanmazsa git config gereklidir.
  • secret: İsteğe bağlı. Değişkenin değerinin gizli bir değer olup olmadığını gösterir. Kabul edilen değerler false ve true değerleridir.
  • value: Gizli olmayan değişken için gereklidir. Değişkenin değeri. Gizli değişkenler için değer parametresi sağlanmazsa ön ekli ortam değişkenlerinden seçilir veya kullanıcıdan standart giriş AZURE_DEVOPS_EXT_PIPELINE_VAR_ aracılığıyla girişi istenir. Örneğin, Ortam değişkeni kullanılarak MySecret adlı bir değişken gir AZURE_DEVOPS_EXT_PIPELINE_VAR_MySecret olabilir.

Örnek

Aşağıdaki komut, 4 kimliğine sahip değişken grubunda bir değişken oluşturur. Yeni değişken requires-login olarak adlandırılmıştır ve True değerine sahip olur ve sonuç tablo biçiminde gösterilir.

az pipelines variable-group variable create --group-id 4 --name requires-login --value True --output table

Name            Is Secret    Value
--------------  -----------  -------
requires-login  False        True

Değişken grubunda değişkenleri listele

Değişken grubunda yer alan değişkenleri az pipelines variable-group variable list komutuyla listeleyebilirsiniz. Çalışmaya başlama için bkz. Kullanmaya başlayın CLI ile Azure DevOps.

az pipelines variable-group variable list --group-id
                                          [--org]
                                          [--project]

Parametreler

  • group-id: Gerekli. Değişken grubunun kimliği. Değişken grubu kimliğini bulmak için bkz. Değişken gruplarını listele.
  • org: Azure DevOps kuruluş URL 'si. Kullanarak varsayılan organizasyonu yapılandırabilirsiniz az devops configure -d organization=ORG_URL . Varsayılan olarak yapılandırılmamışsa veya kullanılarak çekildiğinde gereklidir git config . Örnek: --org https://dev.azure.com/MyOrganizationName/.
  • Proje: projenin adı veya kimliği. Varsayılan projeyi kullanarak yapılandırabilirsiniz az devops configure -d project=NAME_OR_ID . Varsayılan olarak yapılandırılmamışsa veya kullanılarak çekildiğinde gereklidir git config .

Örnek

Aşağıdaki komut, KIMLIĞI 4 olan değişken grubundaki tüm değişkenleri listeler ve sonucu tablo biçiminde gösterir.

az pipelines variable-group variable list --group-id 4 --output table

Name            Is Secret    Value
--------------  -----------  -----------
app-location    False        Head_Office
app-name        False        Fabrikam
requires-login  False        True

Değişken grubundaki değişkenleri güncelleştirme

Bir değişken grubundaki bir değişkeni az işlem hattı değişken grubu değişken Update komutuyla güncelleştirebilirsiniz. Başlamak için bkz. Azure DevOps CLI ile çalışmaya başlama.

az pipelines variable-group variable update --group-id
                                            --name
                                            [--new-name]
                                            [--org]
                                            [--project]
                                            [--prompt-value {false, true}]
                                            [--secret {false, true}]
                                            [--value]

Parametreler

  • Grup Kimliği: gerekli. Değişken grubunun KIMLIĞI. Değişken grubu KIMLIĞINI bulmak için bkz. değişken gruplarını listeleme.
  • ad: gerekli. Eklemekte olduğunuz değişkenin adı.
  • Yeni-ad: isteğe bağlı. Değişkenin adını değiştirmek için belirtin.
  • org: Azure DevOps kuruluş URL 'si. Kullanarak varsayılan organizasyonu yapılandırabilirsiniz az devops configure -d organization=ORG_URL . Varsayılan olarak yapılandırılmamışsa veya kullanılarak çekildiğinde gereklidir git config . Örnek: --org https://dev.azure.com/MyOrganizationName/.
  • project: Projenin adı veya kimliği. Varsayılan projeyi kullanarak az devops configure -d project=NAME_OR_ID yapılandırarak. Varsayılan olarak yapılandırılmamışsa veya kullanılarak toplanmazsa git config gereklidir.
  • prompt-value: Ortam değişkeni veya istem kullanarak standart giriş aracılığıyla gizli dizi değişkeninin değerini güncelleştirmek için true olarak ayarlayın. Kabul edilen değerler false ve true değerleridir.
  • secret: İsteğe bağlı. Değişkenin değerinin gizli tutulıp tutul olmadığını gösterir. Kabul edilen değerler false ve true değerleridir.
  • value: Değişkenin değerini günceller. Gizli değişkenler için, standart giriş aracılığıyla girmeniz istendiğinde prompt-value parametresini kullanın. Etkileşimli olmayan konsollar için ön ekli ortam değişkenlerinden AZURE_DEVOPS_EXT_PIPELINE_VAR_ seçebilirsiniz. Örneğin, Ortam değişkeni kullanılarak MySecret adlı bir değişken gir AZURE_DEVOPS_EXT_PIPELINE_VAR_MySecret olabilir.

Örnek

Aşağıdaki komut, requires-login değişkenlerini 4 kimliğine sahip değişken grubunda false yeni değeriyle günceller. Değişkenin bir gizli dizi olduğunu belirtir ve sonucu YAML biçiminde gösterir. Bir gizli dizi değeri (gizli) olduğu için çıktının değeri False yerine null olarak gösterir.

az pipelines variable-group variable update --group-id 4 --name requires-login --value False --secret true --output yaml

requires-login:
  isSecret: true
  value: null

Değişken grubundan değişkenleri silme

az pipelines variable-group variable delete komutuyla değişken grubundan bir değişkeni silebilirsiniz. Çalışmaya başlama için bkz. Kullanmaya başlayın CLI ile Azure DevOps.

az pipelines variable-group variable delete --group-id
                                            --name
                                            [--org]
                                            [--project]
                                            [--yes]

Parametreler

  • group-id: Gerekli. Değişken grubunun kimliği. Değişken grubu KIMLIĞINI bulmak için bkz. değişken gruplarını listeleme.
  • ad: gerekli. Silmekte olduğunuz değişkenin adı.
  • org: Azure DevOps kuruluş URL 'si. Kullanarak varsayılan organizasyonu yapılandırabilirsiniz az devops configure -d organization=ORG_URL . Varsayılan olarak yapılandırılmamışsa veya kullanılarak çekildiğinde gereklidir git config . Örnek: --org https://dev.azure.com/MyOrganizationName/.
  • Proje: projenin adı veya kimliği. Varsayılan projeyi kullanarak yapılandırabilirsiniz az devops configure -d project=NAME_OR_ID . Varsayılan olarak yapılandırılmamışsa veya kullanılarak çekildiğinde gereklidir git config .
  • Evet: isteğe bağlı. Onay istemez.

Örnek

Aşağıdaki komut, KIMLIĞI 4 olan değişken grubundan login-LOGIN değişkenini siler ve onay ister.

az pipelines variable-group variable delete --group-id 4 --name requires-login

Are you sure you want to delete this variable? (y/n): y
Deleted variable 'requires-login' successfully.

Mevcut bir Azure anahtar kasasını bir değişken grubuna bağlayın ve seçmeli kasa gizli dizilerini değişken grubuyla eşleyin.

  1. Değişken grupları sayfasında, Azure anahtar kasasından değişkenleri olarak bağlantı sırlarını etkinleştirin. Gizli dizilerinizi içeren var olan bir anahtar kasasının olması gerekir. Azure Portalkullanarak bir Anahtar Kasası oluşturabilirsiniz.

    Azure Anahtar Kasası tümleştirmesiyle değişken grubu

  2. Azure abonelik bitiş noktanızı ve sırlarınızı içeren kasasının adını belirtin.

    Azure hizmet bağlantısında parolaların kasasında en az Get ve list Management izinlerine sahip olduğundan emin olun. Kasa adının yanında Yetkilendir ' i seçerek bu izinleri ayarlamak için Azure Pipelines etkinleştirebilirsiniz. Alternatif olarak, izinlerini uygulamanın içinde el ile Azure portal:

    • Kasanın Ayarlar dikey penceresinde Erişim ilkeleri'ne ve ardından Yeni ekle'ye tıklayın.
    • Erişim ilkesi ekle dikey penceresinde Sorumlu seç'i seçin ve istemci hesabınız için hizmet sorumlularını seçin.
    • Erişim ilkesi ekle dikey penceresinde Gizli izinler'i seçin ve Al ve Liste'nin işaretli olduğundan emin olun (işaretlenir).
    • Değişiklikleri kaydetmek için Tamam'ı seçin.

  3. Değişken grupları sayfasında + Ekle'yi seçerek kasanız tarafından bu değişken grubuna eşlenen belirli gizli dizileri seçin.

Gizli dizi yönetimi notları

  • Gizli değerlerle değil, yalnızca gizli adlar değişken grubuyla eşlenmiş olur. Her gizli anahtar değerinin en son sürümü kasadan getiri ve çalıştırma sırasında değişken grubuna bağlı işlem hattında kullanılır.

  • Anahtar kasasında mevcut gizli dizilerde yapılan tüm değişiklikler (örneğin, bir gizli dizinin değerindeki bir değişiklik) otomatik olarak değişken grubunun kullandığı tüm işlem hatlarında kullanılabilir.

  • Kasaya yeni gizli diziler ekleniyorsa veya kasadan bir gizli dizi silindiğinde, ilişkili değişken grupları otomatik olarak güncelleştirilmez. Değişken grubuna dahil edilen gizli dizilerin, değişken grubunu kullanan işlem hatlarının doğru şekilde yürütülması için açıkça güncelleştirilmiş olması gerekir.

  • Azure Key Vault, Şifreleme anahtarlarının ve gizli dizilerin Azure'da depolanması ve yönetilmesini destekler. Şu anda Azure Pipelines grup tümleştirmesi yalnızca Azure Anahtar Kasası'nda bulunan gizli dizilerin eşlentir unu destekler. Şifreleme anahtarları ve sertifikalar desteklenmiyor.

Bir gruptaki değişkenlerin genişletilmesi

Bir grupta bir değişken ayarp yaML dosyasında kullanırsanız, YAML dosyasında tanımlanan diğer değişkenlerle aynı önceliğe sahip olur. Değişkenlerin önceliği hakkında daha fazla bilgi için değişkenleriyle ilgili konuya bakın.

TFS'de YAML desteklenmiyor.