Verziókövetés-integrálás használata

Az Azure Automation verziókövetési integrációja támogatja az egyirányú szinkronizációt a verziókövetési adattárból. A verziókövetés lehetővé teszi a runbookok naprakészen tartását az Ön Automation-fiókjában a GitHubon vagy az Azure DevOps verziókövetési adattárban található szkriptekkel. Ezzel a jellemzővel egyszerűen előresorolhatja a fejlesztői környezetben tesztelt kódot az éles Automation-fiókba.

A forrásvezérlési integrációval egyszerűen együttműködhet a csapatával, nyomon követheti a módosításokat, és visszaállíthatja a runbookok korábbi verzióit. A forrásvezérlés lehetővé teszi például a forrásvezérlés különböző ágainak szinkronizálását a fejlesztési, tesztelési és éles Automation-fiókokkal.

Forrásvezérlő típusok

Az Azure Automation háromféle forrásvezérlést támogat:

• GitHub
• Azure DevOps (Git)
• Azure DevOps (TFVC)

Előfeltételek

• Egy verziókövetési adattár (GitHub vagy Azure DevOps)
• Az Automation-fiókhoz legalább egy rendszer vagy felhasználó által hozzárendelt felügyelt identitásra van szükség. Ha nem konfigurált felügyelt identitást az Automation-fiókkal, a létrehozásához lásd: Rendszer által hozzárendelt felügyelt identitás engedélyezése vagy Felhasználó által hozzárendelt felügyelt identitás engedélyezése.
• Rendelje hozzá a felhasználó vagy a rendszer által hozzárendelt felügyelt identitást az Automation-fiók Közreműködő szerepköréhez.

Forrásvezérlő konfigurálása

Ez a szakasz bemutatja, hogyan konfigurálhatja a forrásvezérlést az Automation-fiókhoz. Használhatja az Azure Portalt vagy a PowerShellt.

Felügyelt identitás hozzárendelése közreműködői szerepkörhöz

Ez a példa az Azure PowerShell használatával mutatja be, hogyan rendelheti hozzá az előfizetés közreműködői szerepkörét az Azure Automation-fiók erőforrásához.

1. Nyisson meg egy Emelt szintű jogosultságokkal rendelkező PowerShell-konzolt.

2. Jelentkezzen be az Azure-ba a parancs futtatásával Connect-AzAccount.

3. A felügyelt identitás közreműködői szerepkörhöz való hozzárendeléséhez futtassa a következő parancsot.

   New-AzRoleAssignment `
       -ObjectId <automation-Identity-Object(Principal)-Id> `
       -Scope "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}" `
       -RoleDefinitionName "Contributor"
   

Forrásvezérlés konfigurálása az Azure Portalon

Ezzel az eljárással konfigurálhatja a forrásvezérlést az Azure Portal használatával.

1. Az Automation-fiókban válassza a Forrásvezérlő lehetőséget, majd kattintson a Hozzáadás gombra.

   

2. Válassza a Forrásvezérlő típusa lehetőséget, majd kattintson a Hitelesítés gombra.

3. Megnyílik egy böngészőablak, és kéri, hogy jelentkezzen be. Kövesse az utasításokat a hitelesítés befejezéséhez.

4. A Forrásvezérlő összegzése lapon a mezőkkel töltse ki az alább definiált forrásvezérlő-tulajdonságokat. Ha végzett, kattintson a Mentés gombra.

   Tulajdonság	Leírás
   Forrásvezérlő neve	A forrásvezérlő rövid neve. Ennek a névnek csak betűket és számokat kell tartalmaznia.
   Forrásvezérlő típusa	A forrásvezérlő mechanizmus típusa. Elérhető lehetőségek: * GitHub * Azure DevOps (Git) * Azure DevOps (TFVC)
   Adattár	Az adattár vagy projekt neve. Az első 200 adattár beolvasva. Adattár kereséséhez írja be a nevet a mezőbe, és kattintson a Keresés a GitHubon elemre.
   Branch	Ág, amelyről le szeretné húzni a forrásfájlokat. Az ágcélzás nem érhető el a TFVC-forrásvezérlő típusához.
   Mappa elérési útja	A szinkronizálandó runbookokat tartalmazó mappa, például a /Runbookok. A rendszer csak a megadott mappában lévő runbookokat szinkronizálja. A rekurzió nem támogatott.
   Automatikus szinkronizálás1	Az automatikus szinkronizálást be- vagy kikapcsoló beállítás, ha véglegesítés történik a forrásvezérlő-adattárban vagy a GitHub-adattárban.
   Runbook közzététele	A Be beállítás, ha a runbookok automatikusan megjelennek a forrásvezérlőből való szinkronizálás után, máskülönben kikapcsolva.
   Leírás	A forrásvezérlő további részleteit megadó szöveg.

   ^{1 Az Automatikus szinkronizálás engedélyezéséhez a forrásvezérlés Azure DevOps-integrációjának konfigurálásakor a Projektadminisztrátornak vagy a GitHub-adattár tulajdonosának kell lennie. A közreműködők csak automatikus szinkronizálás nélkül konfigurálhatják a forrásvezérlőt.}
   Az automatikus szinkronizálás nem működik az Automation Private Link szolgáltatással. Ha engedélyezi a privát kapcsolatot, a forrásvezérlő webhook-hívásai meghiúsulnak, mivel az a hálózaton kívül van.

   

Forrásvezérlő konfigurálása a PowerShellben

A PowerShell használatával is konfigurálhatja a forrásvezérlést az Azure Automationben. A műveletHez a PowerShell-parancsmagok használatához személyes hozzáférési jogkivonatra (PAT) van szükség. A Forrásvezérlő kapcsolat létrehozásához használja a New-AzAutomationSourceControl parancsmagot. Ez a parancsmag biztonságos sztringet igényel a PAT számára. A biztonságos sztringek létrehozásáról a ConvertTo-SecureString című témakörben olvashat.

Az alábbi alszakaszok a GitHub, az Azure DevOps (Git) és az Azure DevOps (TFVC) forrásvezérlési kapcsolatának PowerShell-létrehozását szemléltetik.

Forrásvezérlési kapcsolat létrehozása a GitHubhoz

New-AzAutomationSourceControl -Name SCGitHub -RepoUrl https://github.com/<accountname>/<reponame>.git -SourceType GitHub -FolderPath "/MyRunbooks" -Branch main -AccessToken <secureStringofPAT> -ResourceGroupName <ResourceGroupName> -AutomationAccountName <AutomationAccountName>

Forrásvezérlési kapcsolat létrehozása az Azure DevOpshoz (Git)

New-AzAutomationSourceControl -Name SCReposGit -RepoUrl https://dev.azure.com/<accountname>/<adoprojectname>/_git/<repositoryname> -SourceType VsoGit -AccessToken <secureStringofPAT> -Branch main -ResourceGroupName <ResourceGroupName> -AutomationAccountName <AutomationAccountName> -FolderPath "/Runbooks"

Forrásvezérlési kapcsolat létrehozása az Azure DevOpshoz (TFVC)

New-AzAutomationSourceControl -Name SCReposTFVC -RepoUrl https://dev.azure.com/<accountname>/<adoprojectname>/_git/<repositoryname> -SourceType VsoTfvc -AccessToken <secureStringofPAT> -ResourceGroupName <ResourceGroupName> -AutomationAccountName <AutomationAccountName> -FolderPath "/Runbooks"

Személyes hozzáférési jogkivonat (PAT) engedélyei

A forrásvezérléshez minimális engedélyekre van szükség a PAT-khoz. Az alábbi alszakaszok tartalmazzák a GitHubhoz és az Azure DevOpshoz szükséges minimális engedélyeket.

Minimális PAT-engedélyek a GitHubhoz

Az alábbi táblázat a GitHubhoz szükséges minimális PAT-engedélyeket határozza meg. A PAT GitHubon való létrehozásáról további információt a parancssorhoz tartozó személyes hozzáférési jogkivonat létrehozása című témakörben talál.

Minimális PAT-engedélyek az Azure DevOpshoz

Az alábbi lista az Azure DevOpshoz szükséges minimális PAT-engedélyeket határozza meg. További információ a PAT Azure DevOpsban való létrehozásáról: Hozzáférés hitelesítése személyes hozzáférési jogkivonatokkal.

¹ Az Service connections engedély csak akkor szükséges, ha engedélyezte az automatikus szinkronizálást.

Szinkronizálás a forrásvezérlővel

Kövesse az alábbi lépéseket a forrásvezérlővel való szinkronizáláshoz.

1. Válassza ki a forrást a Forrás vezérlőlap táblázatából.

2. Kattintson a Szinkronizálás indítása gombra a szinkronizálási folyamat elindításához.

3. Az aktuális szinkronizálási feladat vagy az előzőek állapotát a Szinkronizálási feladatok fülre kattintva tekintheti meg.

4. A Forrásvezérlés legördülő menüben válasszon egy forrásvezérlő mechanizmust.

   

5. A feladatra kattintva megtekintheti a feladat kimenetét. Az alábbi példa egy forrásvezérlő szinkronizálási feladatának kimenete.

   ===================================================================
   
   Azure Automation Source Control.
   Supported runbooks to sync: PowerShell Workflow, PowerShell Scripts, DSC Configurations, Graphical, and Python 2.
   
   Setting AzEnvironment.
   
   Getting AzureRunAsConnection.
   
   Logging in to Azure...
   
   Source control information for syncing:
   
   [Url = https://ContosoExample.visualstudio.com/ContosoFinanceTFVCExample/_versionControl] [FolderPath = /Runbooks]
   
   Verifying url: https://ContosoExample.visualstudio.com/ContosoFinanceTFVCExample/_versionControl
   
   Connecting to VSTS...
   
   Source Control Sync Summary:
   
   2 files synced:
    - ExampleRunbook1.ps1
    - ExampleRunbook2.ps1
   
   ==================================================================
   
   

6. További naplózás érhető el a Forrásvezérlő szinkronizálási feladat összegzési lapján található Összes napló lehetőség kiválasztásával. Ezek a további naplóbejegyzések segíthetnek a forrásvezérlő használatakor felmerülő problémák elhárításában.

Verziókövetés lecsatlakoztatása

Verziókövetési adattárról való lecsatlakozáshoz:

1. Nyissa meg a Verziókövetés elemet az Automation-fiókban a Fiókbeállítások között.

2. Válassza ki az eltávolítani kívánt verziókövetési mechanizmust.

3. A Verziókövetés Összegzés lapján kattintson a Törlés gombra.

Kódolási problémák kezelése

Ha többen szerkesztenek runbookokat a forrásvezérlő adattárában különböző szerkesztőkkel, kódolási problémák léphetnek fel. Ha többet szeretne megtudni erről a helyzetről, tekintse meg a kódolási problémák gyakori okait.

A PAT frissítése

Jelenleg nem használhatja az Azure Portalt a PAT frissítésére a forrásvezérlőben. Ha lejárt vagy visszavonta a PAT-t, az alábbi módok egyikével frissítheti a forrásvezérlőt egy új hozzáférési jogkivonattal:

• Használja a REST API-t.
• Használja az Update-AzAutomationSourceControl parancsmagot.

Következő lépések

• A runbook-forrásvezérlés Visual Studio Codespace-ekkel való integrálásáról az Azure Automation: Runbook Source Control integrálása a Visual Studio Codespaces használatával című témakörben olvashat.