Oefening: De toepassing compileren met behulp van de agent

Voltooid

Nu uw buildagent wordt uitgevoerd en klaar is voor het ontvangen van buildtaken, gaan we deze in actie zien. In deze les wijzigt u een basisconfiguratie voor het bouwen van de Space Game-website met behulp van uw agent en niet de door Microsoft gehoste agent.

Notitie

Voer de volgende stappen uit direct na het uitvoeren van de stappen in de vorige module Een buildagent maken die wordt uitgevoerd in Azure.

Aan het einde van deze les kunt u als optionele stap de agentgroep uit uw Microsoft Azure DevOps-organisatie verwijderen.

De branch ophalen vanuit GitHub

In deze sectie haalt u de vertakking op uit GitHub en checkt u deze build-agent vertakking uit of schakelt u over naar die vertakking.

Deze vertakking bevat het Space Game-project waarmee u hebt gewerkt in eerdere modules en een Azure Pipelines-configuratie om mee te beginnen.

  1. Open in Visual Studio Code de geïntegreerde terminal.

  2. Als u een vertakking wilt downloaden met de naam build-agent uit de Microsoft-opslagplaats en wilt overschakelen naar die vertakking, voert u het volgende git fetch uit en git checkout voert u de volgende opdrachten uit:

    git fetch upstream build-agent
    git checkout -B build-agent upstream/build-agent
    

    Zoals u weet, verwijst upstream naar de Microsoft GitHub-opslagplaats. De Git-configuratie van uw project begrijpt de externe upstream, omdat u die relatie hebt ingesteld wanneer u het project uit de Microsoft-opslagplaats hebt gesplitst en het lokaal hebt gekloond.

    U gaat deze vertakking zo pushen naar uw GitHub-opslagplaats, ook bekend als origin.

  3. U kunt eventueel in Visual Studio Code het bestand azure-pipelines.yml openen en vertrouwd raken met de eerste configuratie.

    De configuratie lijkt op de basis die u hebt gemaakt in de module Een build-pijplijn maken met Azure Pipelines . Hiermee wordt alleen de releaseconfiguratie van de toepassing gebouwd.

De buildconfiguratie wijzigen

In deze sectie wijzigt u de buildconfiguratie om over te schakelen van het gebruik van een door Microsoft gehoste agent naar het gebruik van de agent vanuit uw buildpool.

  1. Open in Visual Studio Code het bestand azure-pipelines.yml en zoek naar de pool sectie.

    pool:
      vmImage: 'ubuntu-20.04'
      demands:
      - npm
    
  2. Wijzig de pool sectie zoals hier wordt weergegeven:

    pool:
      name: 'MyAgentPool'
      demands:
      - npm
    

    Bij deze versie wordt name gebruikt om de agentpool MyAgentPool op te geven. De sectie demands wordt gehandhaafd om op te geven dat voor de buildagent npm (Node.js-pakketbeheer) moet zijn geïnstalleerd.

  3. Voeg in de geïntegreerde terminal azure-pipelines.yml toe aan de index, voer de wijzigingen door en push de vertakking naar GitHub.

    git add azure-pipelines.yml
    git commit -m "Use private agent pool"
    git push origin build-agent
    

Bekijken dat Azure Pipelines uw buildagent gebruikt

Bekijk de builduitvoering in de pijplijn met behulp van uw buildagent.

  1. Ga in Azure DevOps naar het Space Game - web - Agent-project .

  2. Selecteer Pijplijnen op de projectpagina of in het linkerdeelvenster.

  3. Selecteer uw pijplijn in Recent uitgevoerde pijplijnen en kies de meest recente uitvoering (die is gestart toen u de pijplijn bijwerkte om de MyAgentPool-pool te gebruiken).

  4. Kies Job en traceer de uitvoering door elk van de stappen.

    In de taak Initialize ziet u dat de build gebruikmaakt van uw buildagent.

    A screenshot of Azure Pipelines running the build. The Initialize job task shows that it's running the build on the private agent named MyLinxuAgent.

Optioneel: Uw buildpool verwijderen

Voor toekomstig gebruik kunt u de configuratie van de buildgroep in uw Azure DevOps-organisatie behouden, maar houd er rekening mee dat de VIRTUELE machine die als host fungeert voor de agent niet meer beschikbaar is nadat u de opschoonstappen aan het einde van deze module hebt uitgevoerd.

Azure DevOps zal vaststellen dat de agent offline is. Azure Pipelines controleert op een beschikbare agent wanneer een build de volgende keer in de wachtrij wordt geplaatst met behulp van de MyAgentPool-pool.

A screenshot of the agent pool in Azure DevOps showing that the build agent is offline.

Als een optionele stap kunt u de configuratie van de buildpool verwijderen uit Azure DevOps. U doet dit als volgt:

  1. Ga in Azure DevOps naar het Space Game - web - Agent-project .

  2. Selecteer Project-instellingen.

  3. Selecteer onder Pipelines de optie Agentpools.

    A screenshot of the project settings in Azure DevOps showing the location of the Agent pools menu item.

  4. Selecteer onder MyAgentPool het prullenbakpictogram en selecteer vervolgens Verwijderen.

    A screenshot of Azure DevOps showing the location of where to remove the agent from the agent pool.