Scenario di Automazione di Azure - Integrazione del controllo del codice sorgente con Visual Studio Team ServicesAzure Automation scenario - Automation source control integration with Visual Studio Team Services

In questo scenario, è presente un progetto di Visual Studio Team Services che si usa per gestire i runbook di Automazione di Azure o le configurazioni DSC nel controllo del codice sorgente.In this scenario, you have a Visual Studio Team Services project that you are using to manage Azure Automation runbooks or DSC configurations under source control. Questo articolo descrive come integrare VSTS con l'ambiente di Automazione di Azure in modo che venga eseguita l'integrazione continuata per ogni archiviazione.This article describes how to integrate VSTS with your Azure Automation environment so that continuous integration happens for each check-in.

Come ottenere lo scenarioGetting the scenario

Questo scenario è costituito da due runbook di PowerShell che è possibile importare direttamente dalla raccolta di runbook nel portale di Azure o scaricare da PowerShell Gallery.This scenario consists of two PowerShell runbooks that you can import directly from the Runbook Gallery in the Azure portal or download from the PowerShell Gallery.

RunbookRunbooks

RunbookRunbook DescrizioneDescription
Sincronizzazione VSTSSync-VSTS Importare runbook o configurazioni dal controllo del codice sorgente VSTS al termine di un'archiviazione.Import runbooks or configurations from VSTS source control when a check-in is done. Se eseguito manualmente, importerà e pubblicherà tutti i runbook o le configurazioni nell'account di automazione.If run manually, it will import and publish all runbooks or configurations into the Automation account.
Sincronizzazione VSTSGitSync-VSTSGit Importare runbook o configurazioni da VSTS nel controllo del codice sorgente Git al termine di un'archiviazione.Import runbooks or configurations from VSTS under Git source control when a check-in is done. Se eseguito manualmente, importerà e pubblicherà tutti i runbook o le configurazioni nell'account di automazione.If run manually, it will import and publish all runbooks or configurations into the Automation account.

VariabiliVariables

VariabileVariable DescrizioneDescription
VSTokenVSToken Protegge l'asset della variabile creato che contiene il token di accesso personale VSTS.Secure variable asset you will create that contains the VSTS personal access token. È possibile imparare a creare un token di accesso personale VSTS nella pagina di autenticazione VSTS.You can learn how to create a VSTS personal access token on the VSTS authentication page.

Installazione e configurazione dello scenarioInstalling and configuring this scenario

Creare un token di accesso personale in VSTS, che verrà usato per sincronizzare i runbook o le configurazioni nell'account di automazione.Create a personal access token in VSTS that you will use to sync the runbooks or configurations into your automation account.

Creare una variabile protetta nell'account di automazione per contenere il token di accesso personale in modo che il runbook possa eseguire l'autenticazione in VSTS e sincronizzare i runbook o le configurazioni nell'account di automazione.Create a secure variable in your automation account to hold the personal access token so that the runbook can authenticate to VSTS and sync the runbooks or configurations into the Automation account. È possibile denominare questo token VSToken.You can name this VSToken.

Importare il runbook che sincronizzerà i runbook o le configurazioni nell'account di automazione.Import the runbook that will sync your runbooks or configurations into the automation account. È possibile usare il runbook di esempio VSTS oppure il runbook di esempio VSTS con Git da PowerShellGallery.com a seconda se si usa il controllo del codice sorgente VSTS o VSTS con Git ed eseguire la distribuzione al proprio account di automazione.You can use the VSTS sample runbook or the VSTS with Git sample runbook from the PowerShellGallery.com depending on if you use VSTS source control or VSTS with Git and deploy to your automation account.

È ora possibile pubblicare questo runbook in modo da creare un webhook.You can now publish this runbook so you can create a webhook.

Creare un webhook per questo runbook di sincronizzazione VSTS e inserire i parametri come illustrato di seguito.Create a webhook for this Sync-VSTS runbook and fill in the parameters as shown below. Assicurarsi di copiare l'url del webhook, poiché sarà necessario per un hook del servizio in VSTS.Make sure you copy the webhook url as you will need it for a service hook in VSTS. VSAccessTokenVariableName è il nome (VSToken) della variabile protetta creata in precedenza per contenere il token di accesso personale.The VSAccessTokenVariableName is the name (VSToken) of the secure variable that you created earlier to hold the personal access token.

L'integrazione con VSTS (Sync-VSTS.ps1) richiederà i parametri seguenti.Integrating with VSTS (Sync-VSTS.ps1) will take the following parameters.

Parametri di sincronizzazione VSTSSync-VSTS Parameters

.Parameter DescrizioneDescription
WebhookDataWebhookData Questo file conterrà le informazioni di archiviazione inviate dall'hook del servizio VSTS.This will contain the checkin information sent from the VSTS service hook. È necessario lasciare vuoto questo parametro.You should leave this parameter blank.
ResourceGroupResourceGroup Nome del gruppo di risorse in cui si trova l'account di automazione.This is the name of the resource group that the automation account is in.
AutomationAccountNameAutomationAccountName Nome dell'account di automazione che verrà sincronizzato con VSTS.The name of the automation account that will sync with VSTS.
VSFolderVSFolder Nome della cartella in VSTS, in cui sono presenti i runbook e le configurazioni.The name of the folder in VSTS where the runbooks and configurations exist.
VSAccountVSAccount Nome dell'account di Visual Studio Team Services.The name of the Visual Studio Team Services account.
VSAccessTokenVariableNameVSAccessTokenVariableName Nome della variabile protetta (VSToken) che contiene il token di accesso personale VSTS.The name of the secure variable (VSToken) that holds the VSTS personal access token.

Se si usa VSTS con GIT (Sync-VSTSGit.ps1), saranno necessari i parametri seguenti.If you are using VSTS with GIT (Sync-VSTSGit.ps1) it will take the following parameters.

.Parameter DescrizioneDescription
WebhookDataWebhookData Questo file conterrà le informazioni di archiviazione inviate dall'hook del servizio VSTS.This will contain the checkin information sent from the VSTS service hook. È necessario lasciare vuoto questo parametro.You should leave this parameter blank.
AutomationAccountNameAutomationAccountName Nome dell'account di automazione che verrà sincronizzato con VSTS.The name of the automation account that will sync with VSTS.
VSAccountVSAccount Nome dell'account di Visual Studio Team Services.The name of the Visual Studio Team Services account.
VSProjectVSProject Nome del progetto in VSTS, in cui sono presenti i runbook e le configurazioni.The name of the project in VSTS where the runbooks and configurations exist.
GitRepoGitRepo Nome del repository Git.The name of the Git repository.
GitBranchGitBranch Nome del branch nel repository Git VSTS.The name of the branch in VSTS Git repository.
CartellaFolder Nome della cartella nel branch Git VSTS.The name of the folder in VSTS Git branch.
VSAccessTokenVariableNameVSAccessTokenVariableName Nome della variabile protetta (VSToken) che contiene il token di accesso personale VSTS.The name of the secure variable (VSToken) that holds the VSTS personal access token.

Creare un hook del servizio in VSTS per le archiviazioni alla cartella che attiva il webhook all'archiviazione del codice.Create a service hook in VSTS for check-ins to the folder that triggers this webhook on code check-in. Selezionare Web hook come servizio con cui eseguire l'integrazione quando si crea una nuova sottoscrizione.Select Web Hooks as the service to integrate with when you create a new subscription. È possibile acquisire familiarità con gli hook del servizio nella documentazione relativa agli hook del servizio VSTS.You can learn more about service hooks on VSTS Service Hooks documentation.

A questo punto si sarà in grado di eseguire tutte le archiviazioni dei runbook e delle configurazioni in VSTS e di sincronizzarle automaticamente nell'account di automazione.You should now be able to do all check-ins of your runbooks and configurations into VSTS and have these automatically sync’d into your automation account.

Se si esegue manualmente questo runbook senza che sia attivato da VSTS, è possibile lasciare vuoto il parametro webhookdata in modo che sia eseguita una sincronizzazione completa dalla cartella VSTS specificata.If you run this runbook manually without being triggered by VSTS, you can leave the webhookdata parameter empty and it will do a full sync from the VSTS folder specified.

Se si desidera disinstallare lo scenario, rimuovere l'hook del servizio da VSTS, eliminare il runbook e la variabile VSToken.If you wish to uninstall the scenario, remove the service hook from VSTS, delete the runbook, and the VSToken variable.