Ćwiczenie — kompilowanie aplikacji przy użyciu agenta

Ukończone

Teraz, gdy agent kompilacji jest uruchomiony i gotowy do odbierania zadań kompilacji, zobaczmy, jak działa. W tej lekcji zmodyfikujesz podstawową konfigurację kompilacji, którą udostępniamy, aby utworzyć witrynę internetową Space Game przy użyciu agenta, a nie agenta hostowanego przez firmę Microsoft.

Uwaga

Uruchom następujące kroki natychmiast po wykonaniu kroków w poprzednim module Tworzenie agenta kompilacji uruchomionego na platformie Azure.

Na końcu tej lekcji jako opcjonalny krok możesz usunąć pulę agentów z organizacji usługi Microsoft Azure DevOps.

Pobieranie gałęzi z repozytorium GitHub

W tej sekcji pobierzesz build-agent gałąź z usługi GitHub i wyewidencjonujesz lub przełączysz się do tej gałęzi.

Ta gałąź zawiera projekt Space Game , z którym pracowaliśmy w poprzednich modułach, oraz konfigurację usługi Azure Pipelines do rozpoczęcia od.

  1. W programie Visual Studio Code otwórz zintegrowany terminal.

  2. Aby pobrać gałąź o nazwie build-agent z repozytorium Firmy Microsoft i przełączyć się do tej gałęzi, uruchom następujące git fetch polecenia i git checkout :

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

    Pamiętaj, że nadrzędny element odnosi się do repozytorium Microsoft GitHub. Konfiguracja usługi Git projektu rozumie nadrzędną relację zdalną, ponieważ podczas tworzenia rozwidlenia projektu z repozytorium Microsoft i klonowania go lokalnie.

    Wkrótce wypchniesz tę gałąź do repozytorium GitHub o nazwie origin.

  3. Opcjonalnie w programie Visual Studio Code otwórz plik azure-pipelines.yml i zapoznaj się z początkową konfiguracją.

    Konfiguracja przypomina podstawową konfigurację utworzoną w module Tworzenie potoku kompilacji za pomocą usługi Azure Pipelines . Kompiluje tylko konfigurację wydania aplikacji.

Modyfikowanie konfiguracji kompilacji

W tej sekcji zmodyfikujesz konfigurację kompilacji, aby przełączyć się z używania agenta hostowanego przez firmę Microsoft do korzystania z agenta z puli kompilacji.

  1. W programie Visual Studio Code otwórz plik azure-pipelines.yml , a następnie wyszukaj sekcję pool .

    pool:
      vmImage: 'ubuntu-20.04'
      demands:
      - npm
    
  2. Zmodyfikuj sekcję pool , jak pokazano poniżej:

    pool:
      name: 'MyAgentPool'
      demands:
      - npm
    

    Element name używany w tej wersji określa pulę agentów MyAgentPool. Zgodnie z zawartością sekcji demands agent kompilacji musi mieć zainstalowane narzędzie npm, menedżera pakietów środowiska Node.js.

  3. W zintegrowanym terminalu dodaj plik azure-pipelines.yml do indeksu, zatwierdź zmiany i wypchnij gałąź do usługi GitHub.

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

Używanie agenta kompilacji w usłudze Azure Pipelines

Obejrzyj przebieg kompilacji w potoku przy użyciu agenta kompilacji.

  1. W usłudze Azure DevOps przejdź do projektu Space Game — web — Agent .

  2. Na stronie projektu lub w okienku po lewej stronie wybierz pozycję Potoki.

  3. Wybierz potok z obszaru Ostatnio uruchomione potoki i wybierz najnowsze uruchomienie (które zostało uruchomione po zaktualizowaniu potoku w celu korzystania z puli MyAgentPool ).

  4. Wybierz pozycję Zadanie i prześledzić przebieg poszczególnych kroków.

    W zadaniu Inicjowanie zadania zobaczysz, że kompilacja używa agenta kompilacji.

    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.

Opcjonalnie: Usuwanie puli kompilacji

W przyszłości możesz zachować konfigurację puli kompilacji w organizacji usługi Azure DevOps, ale pamiętaj, że maszyna wirtualna, która hostuje agenta, nie będzie już dostępna po wykonaniu kroków oczyszczania na końcu tego modułu.

W praktyce usługa Azure DevOps wykryje, że agent jest w trybie offline. Usługa Azure Pipelines sprawdzi dostępnego agenta przy następnym kolejce kompilacji przy użyciu puli MyAgentPool.

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

Opcjonalnie możesz usunąć konfigurację puli kompilacji z usługi Azure DevOps. Oto jak to zrobić:

  1. W usłudze Azure DevOps przejdź do projektu Space Game — web — Agent .

  2. Wybierz pozycję Ustawienia projektu.

  3. W obszarze Pipelines (Potoki) wybierz pozycję Agent pools (Pule agentów).

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

  4. W obszarze MyAgentPool wybierz ikonę kosza, a następnie wybierz pozycję Usuń.

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