Változócsoportok kezelése

1. Az Azure DevOps-projektben válassza a Pipelines>Library elemet a bal oldali menüből.

2. A Tár lapon válassza a + Változó csoport lehetőséget.

   

3. Az új változócsoport lap Tulajdonságok csoportjában adja meg a változócsoport nevét és opcionális leírását.

4. A Változók csoportban válassza a + Hozzáadás lehetőséget, majd adjon meg egy változónevet és értéket, amely szerepel a csoportban. Ha titkosítani szeretné és biztonságosan szeretné tárolni az értéket, válassza a változó melletti zárolás ikont.

5. Az új változók hozzáadásához válassza a + Hozzáadás lehetőséget. Amikor befejezte a változók hozzáadását, válassza a Mentés lehetőséget.

   

Ezt a változócsoportot most már használhatja a projektfolyamatokban.

Az Azure DevOps Servicesben változócsoportokat hozhat létre az Azure DevOps parancssori felületével.

az pipelines variable-group create --name home-office-config
                                   --variables app-location=home-office app-name=contoso
                                   --output yaml

authorized: false
description: null
id: 5
name: home-office-config
providerData: null
type: Vsts
variables:
  app-location:
    isSecret: null
    value: home-office
  app-name:
    isSecret: null
    value: contoso

A változócsoportokat az Azure Pipelines felhasználói felületén frissítheti.

1. Az Azure DevOps-projektben válassza a Pipelines>Library elemet a bal oldali menüből.
2. A Tár lapon válassza ki a frissíteni kívánt változócsoportot. Rámutathat a változócsoport-lista ikonra, a További beállítások ikonra, majd a szerkesztés gombra a menüben.
3. A változócsoport lapján módosítsa bármelyik tulajdonságot, majd válassza a Mentés lehetőséget.

Az Azure DevOps Servicesben az Azure DevOps CLI használatával frissítheti a változócsoportokat.

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

az pipelines variable-group update --group-id 4
                                   --name my-new-variables
                                   --description "New home office variables"
                                   --output table

ID    Name              Description               Is Authorized  Number of Variables
----  ----------------  ------------------------- -------------  -------------------
4     my-new-variables  New home office variables false          2

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

authorized: false
description: Variables for my new app
id: 4
name: my-new-variables
providerData: null
type: Vsts
variables:
  app-location:
    isSecret: null
    value: home-office
  app-name:
    isSecret: null
    value: contoso

Az Azure Pipelines felhasználói felületén törölheti a változócsoportokat.

1. Az Azure DevOps-projektben válassza a Pipelines>Library elemet a bal oldali menüből.
2. A Tár lapon mutasson a törölni kívánt változócsoportra, és válassza a További beállítások ikont.
3. Válassza a Törlés lehetőséget a menüből, majd válassza a Törlés lehetőséget a megerősítést kérő képernyőn.

Az Azure DevOps Servicesben az Azure DevOps CLI használatával törölheti a változócsoportokat.

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

Változócsoportok változóit az Azure Pipelines felhasználói felületén módosíthatja, hozzáadhatja vagy törölheti.

1. Az Azure DevOps-projektben válassza a Pipelines>Library elemet a bal oldali menüből.
2. A Tár lapon válassza ki a frissíteni kívánt változócsoportot. Rámutathat a változócsoport-lista ikonra, a További beállítások ikonra, majd a szerkesztés gombra a menüben.
3. A változócsoportlapon a következőt teheti:
   • Módosítsa bármelyik változó nevét vagy értékét.
   • Törölje bármelyik változót a változó neve melletti szemétgyűjtő ikon kiválasztásával.
   • Módosítsa a változókat titkos vagy nem titkos értékre a változó értéke melletti zárolás ikon kiválasztásával.
   • Új változók hozzáadása a + Hozzáadás lehetőség kiválasztásával.
4. A módosítások elvégzése után válassza a Mentés lehetőséget.

Az Azure DevOps Servicesben az Azure DevOps parancssori felületével kezelheti a változócsoportok változóit.

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

Name            Is Secret    Value
--------------  -----------  -----------
app-location    False        home-office
app-name        False        contoso

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

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

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

requires-login:
  isSecret: true
  value: null

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.

Ha csak a YAML-folyamatokban nevezi el a változócsoportot, bárki, aki le tudja küldeni a kódot az adattárba, kinyerheti a változócsoport titkos kulcsainak tartalmát. Ezért ha YAML-folyamatokkal szeretne változócsoportot használni, engedélyeznie kell a folyamatot a csoport használatára. Engedélyezheti a folyamat számára, hogy változócsoportot használjon az Azure Pipelines felhasználói felületén, vagy az Azure DevOps PARANCSSOR használatával.

Engedélyezés a Pipelines felhasználói felületén keresztül

Az Azure Pipelines felhasználói felületén engedélyezheti a folyamatok számára a változócsoportok használatát.

1. Az Azure DevOps-projektben válassza a Pipelines>Library elemet a bal oldali menüből.
2. A Kódtár lapon válassza ki az engedélyezni kívánt változócsoportot.
3. A változócsoportlapon válassza a Folyamatengedélyek lapot.
4. A Folyamatengedélyek képernyőn válassza ki+, majd válassza ki az engedélyezni kívánt folyamatot. Vagy válassza a További műveletek ikont, válassza a Hozzáférés megnyitása lehetőséget, majd a hozzáférés ismételt megnyitása lehetőséget a megerősítéshez.

A folyamat kiválasztása engedélyezi a folyamat számára a változócsoport használatát. Egy másik folyamat engedélyezéséhez válassza újra az ikont + . A Nyílt hozzáférés lehetőség választásával az összes projektfolyamat használhatja a változócsoportot. A nyílt hozzáférés akkor lehet jó megoldás, ha nincsenek titkos kulcsok a csoportban.

A változócsoportok engedélyezésének másik módja a folyamat kiválasztása, a Szerkesztés, majd a build manuális üzenetsorba helyezése. Erőforrás-engedélyezési hiba jelenik meg, és explicit módon hozzáadhatja a folyamatot a változócsoport jogosult felhasználójaként.

Engedélyezés az Azure DevOps CLI-vel

Az Azure DevOps Servicesben az Azure DevOps CLI használatával engedélyezheti a változócsoportokat.

Változócsoport csatolása folyamathoz

Miután engedélyezte egy YAML-folyamat számára, hogy változócsoportot használjon, használhat változókat a folyamatban lévő csoporton belül.

Egy változócsoport változóinak használatához adjon hozzá egy hivatkozást a YAML-folyamatfájl csoportnevére.

variables:
- group: my-variable-group

Ugyanabban a folyamatban több változócsoportra is hivatkozhat. Ha több változócsoport is tartalmazza az azonos nevű változókat, a fájlban a változót használó utolsó változócsoport beállítja a változó értékét. A változók elsőbbségével kapcsolatos további információkért lásd a változók kiterjesztését ismertető témakört.

Sablon változócsoportra is hivatkozhat. Az alábbi variables.yml sablonfájl a változócsoportra my-variable-grouphivatkozik. A változócsoport tartalmaz egy .myhello

variables:
- group: my-variable-group

A YAML-folyamat a variables.yml sablonra hivatkozik, és a változócsoport my-variable-groupváltozóját $(myhello) használja.

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

Változók használata csatolt változócsoportban

A változóértékeket egy csatolt változócsoportban ugyanúgy érheti el, mint a folyamaton belül definiált változókat. Például a folyamathoz csatolt változócsoportban elnevezett customer változó értékének eléréséhez használhat $(customer) tevékenységparamétert vagy szkriptet.

Ha a folyamatfájlban önálló változókat és változócsoportokat is használ, használja az name-value önálló változók szintaxisát.

variables:
- group: my-variable-group
- name: my-standalone-variable
  value: 'my-standalone-variable-value'

Egy változócsoport változóira való hivatkozáshoz használhat makrószintaxist vagy futtatókörnyezeti kifejezést. Az alábbi példákban a csoportnak my-variable-group van egy változója.myhello

Futtatókörnyezeti kifejezés használata:

variables:
- group: my-variable-group
- name: my-passed-variable
  value: $[variables.myhello]
- script: echo $(my-passed-variable)

Makrószintaxis használata:

variables:
- group: my-variable-group

steps:
- script: echo $(myhello)

A titkos változók, köztük a titkosított változók és a kulcstartó változói közvetlenül nem érhetők el szkriptekben. Ezeket a változókat argumentumként kell átadnia egy tevékenységnek. További információ: Titkos kódváltozók.

Változócsoportok használata klasszikus folyamatokban

A klasszikus folyamatok külön engedélyezés nélkül is használhatnak változócsoportokat. Változócsoport használata:

1. Nyissa meg a klasszikus folyamatot.

2. Válassza a Változók>változócsoportok lehetőséget, majd válassza a Változócsoport csatolása lehetőséget.

   • A buildelési folyamatban megjelenik az elérhető csoportok listája. Jelöljön ki egy változócsoportot, és válassza a Hivatkozás lehetőséget. A csoport összes változója elérhető a folyamaton belül.

   • A kiadási folyamatban a folyamat szakaszainak legördülő listája is megjelenik. Csatolja a változócsoportot magához a folyamathoz vagy a kiadási folyamat egy vagy több konkrét szakaszához. Ha egy vagy több fázisra hivatkozik, a változócsoport változói ezekre a szakaszokra terjednek ki, és nem érhetők el a kiadás többi szakaszában.

   

Ha egy azonos nevű változót több hatókörben állít be, a rendszer a következő prioritást használja, először a legmagasabbat:

1. Várakozás során beállított változó
2. Változókészlet a folyamatban
3. Változókészlet a változócsoportban

A változók elsőbbségével kapcsolatos további információkért lásd a változók kiterjesztését ismertető témakört.