Använda källkontrollsintegrering

Källkontrollsintegrering i Azure Automation enkelriktad synkronisering från lagringsplatsen för källkontroll. Med källkontroll kan du hålla dina runbooks i ditt Automation-konto uppdaterade med skript i din GitHub- eller Azure Repos-lagringsplats för källkontroll. Den här funktionen gör det enkelt att höja upp kod som har testats i utvecklingsmiljön till ditt Automation-produktionskonto.

Med källkontrollsintegrering kan du enkelt samarbeta med ditt team, spåra ändringar och återställa till tidigare versioner av dina runbooks. Med källkontroll kan du till exempel synkronisera olika grenar i källkontrollen med dina Automation-konton för utveckling, testning och produktion.

Typer av källkontroll

Azure Automation har stöd för tre typer av källkontroll:

  • GitHub
  • Azure Repos (Git)
  • Azure Repos (TFVC)

Förutsättningar

  • En lagringsplats för källkontroll (GitHub eller Azure Repos)
  • Ett Kör som-konto
  • Modulen AzureRM.Profile måste importeras till ditt Automation-konto. Observera att motsvarande Az-modul ( Az.Accounts ) inte fungerar med Automation-källkontroll.

Anteckning

Synkroniseringsjobb för källkontroll körs under användarens Automation-konto och debiteras med samma pris som andra Automation-jobb.

Konfigurera källkontroll

Det här avsnittet beskriver hur du konfigurerar källkontroll för ditt Automation-konto. Du kan använda antingen Azure Portal eller PowerShell.

Konfigurera källkontroll i Azure Portal

Använd den här proceduren för att konfigurera källkontroll med hjälp av Azure Portal.

  1. I ditt Automation-konto väljer du Källkontroll och klickarLägg till.

    Välj källkontroll

  2. Välj Typ av källkontroll och klicka sedan på Autentisera.

  3. Ett webbläsarfönster öppnas och du uppmanas att logga in. Slutför autentiseringen genom att följa anvisningarna.

  4. På sidan Sammanfattning av källkontroll använder du fälten för att fylla i de egenskaper för källkontroll som definieras nedan. Klicka på Spara när du är klar.

    Egenskap Beskrivning
    Källkontrollnamn Ett eget namn för källkontrollen. Det här namnet får bara innehålla bokstäver och siffror.
    Typ av källkontroll Typ av källkontrollmekanism. De tillgängliga alternativen är:
    * GitHub
    * Azure Repos (Git)
    * Azure Repos (TFVC)
    Lagringsplats Namnet på lagringsplatsen eller projektet. De första 200 lagringsplatsen hämtas. Om du vill söka efter en lagringsplats skriver du namnet i fältet och klickar på Sök på GitHub.
    Gren Gren som källfilerna ska hämtas från. Branch targeting är inte tillgängligt för TFVC-källkontrolltypen.
    Mappsökväg Mapp som innehåller runbooks som ska synkroniseras, till exempel /Runbooks. Endast runbooks i den angivna mappen synkroniseras. Rekursion stöds inte.
    Automatisk synkronisering1 Inställning som aktiverar eller inaktiverar automatisk synkronisering när ett genomförande görs på lagringsplatsen för källkontroll.
    Publicera runbook Inställningen På om runbooks publiceras automatiskt efter synkronisering från källkontrollen och Av i annat fall.
    Description Text som anger ytterligare information om källkontrollen.

    1 Om du vill aktivera automatisk synkronisering när du konfigurerar källkontrollintegrering med Azure Repos måste du vara projektadministratör.

    Sammanfattning av källkontroll

Anteckning

Inloggningen för lagringsplatsen för källkontroll kan vara annorlunda än din inloggning för Azure Portal. Se till att du är inloggad med rätt konto för lagringsplatsen för källkontroll när du konfigurerar källkontroll. Om du är tveksam öppnar du en ny flik i webbläsaren, loggar ut från dev.azure.com, visualstudio.com eller github.com och försöker ansluta till källkontrollen igen.

Konfigurera källkontroll i PowerShell

Du kan också använda PowerShell för att konfigurera källkontroll i Azure Automation. Om du vill använda PowerShell-cmdletarna för den här åtgärden behöver du en personlig åtkomsttoken (PAT). Använd cmdleten New-AzAutomationSourceControl för att skapa källkontrollanslutningen. Denna cmdlet kräver en säker sträng för PAT. Information om hur du skapar en säker sträng finns i ConvertTo-SecureString.

Följande underavsnitt illustrerar hur PowerShell skapar källkontrollanslutningen för GitHub, Azure Repos (Git) och Azure Repos (TFVC).

Skapa källkontrollanslutning för GitHub

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

Skapa källkontrollanslutning för Azure Repos (Git)

Anteckning

Azure Repos (Git) använder en URL som dev.azure.com i stället för visualstudio.com, som används i tidigare format. Det äldre https://<accountname>.visualstudio.com/<projectname>/_git/<repositoryname> URL-formatet är inaktuellt men stöds fortfarande. Det nya formatet är att föredra.

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

Skapa källkontrollanslutning för Azure Repos (TFVC)

Anteckning

Azure Repos (TFVC) använder en URL som dev.azure.com i stället för visualstudio.com, som används i tidigare format. Det äldre https://<accountname>.visualstudio.com/<projectname>/_versionControl URL-formatet är inaktuellt men stöds fortfarande. Det nya formatet är att föredra.

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

Behörigheter för personlig åtkomsttoken (PAT)

Källkontroll kräver vissa minimibehörigheter för PAT:er. Följande underavsnitt innehåller de minsta behörigheter som krävs för GitHub- och Azure-lagringsplatsen.

Minsta PAT-behörigheter för GitHub

I följande tabell definieras de minsta PAT-behörigheter som krävs för GitHub. Mer information om hur du skapar en PAT i GitHub finns i Skapa en personlig åtkomsttoken för kommandoraden.

Omfång Beskrivning
repo
repo:status Status för åtkomst commit
repo_deployment Åtkomstdistributionsstatus
public_repo Få åtkomst till offentliga lagringsplatsen
repo:invite Få åtkomst till databasinbjudningar
security_events Läsa och skriva säkerhetshändelser
admin:repo_hook
write:repo_hook Skriv lagringsplats hookar
read:repo_hook Läsa lagringsplatsens hookar
Minsta PAT-behörigheter för Azure-lagringsplatsen

I följande lista definieras de minsta PAT-behörigheterna som krävs för Azure Repos. Mer information om hur du skapar en PAT i Azure Repos finns i Authenticate access with personal access tokens (Autentisera åtkomst med personliga åtkomsttoken).

Omfång Åtkomsttyp
Code Läsa
Project and team Läsa
Identity Läsa
User profile Läsa
Work items Läsa
Service connections Läsa, fråga, hantera1

1 Service connections Behörigheten krävs endast om du har aktiverat autosynkronisering.

Synkronisera med källkontroll

Följ dessa steg om du vill synkronisera med källkontrollen.

  1. Välj källa från tabellen på sidan Källkontroll.

  2. Klicka på Starta synkronisering för att starta synkroniseringsprocessen.

  3. Visa status för det aktuella synkroniseringsjobbet eller tidigare genom att klicka på fliken Synkronisera jobb.

  4. I listrutan Källkodskontroll väljer du en källkontrollmekanism.

    Synkroniseringsstatus

  5. Om du klickar på ett jobb kan du visa jobbutdata. Följande exempel är utdata från ett synkroniseringsjobb för källkontroll.

    ===================================================================
    
    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. Ytterligare loggning är tillgängligt genom att välja Alla loggar på sidan Sammanfattning av synkroniseringsjobb för källkontroll. Dessa ytterligare loggposter kan hjälpa dig att felsöka problem som kan uppstå när du använder källkontroll.

Koppla från källkontroll

Så här kopplar du från en lagringsplats för källkontroll:

  1. Kontroll med öppen källkod under Kontoinställningar i ditt Automation-konto.

  2. Välj den källkontrollmekanism som ska tas bort.

  3. På sidan Sammanfattning av källkontroll klickar du på Ta bort.

Hantera kodningsproblem

Om flera personer redigerar runbooks på lagringsplatsen för källkontroll med hjälp av olika redigerare kan kodningsproblem uppstå. Mer information om den här situationen finns i Vanliga orsaker till kodningsproblem.

Uppdatera PAT

För närvarande kan du inte använda Azure Portal för att uppdatera PAT i källkontrollen. När din PAT har upphört att gälla eller återkallats kan du uppdatera källkontrollen med en ny åtkomsttoken på något av följande sätt:

Nästa steg