Szybki start — tworzenie i publikowanie pakietu Node.js przy użyciu usługi Azure Pipelines

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Potok usługi Azure DevOps umożliwia tworzenie, wdrażanie i testowanie aplikacji JavaScript.

Ten przewodnik Szybki start przeprowadzi cię przez proces tworzenia pakietu Node.js za pomocą narzędzia Node Menedżer pakietów (npm) i publikowania artefaktu potoku.

Wymagania wstępne

Musisz mieć następujące elementy w usłudze Azure DevOps:

• Konto usługi GitHub, na którym można utworzyć repozytorium. Utwórz je bezpłatnie.
• Organizacja i projekt usługi Azure DevOps. Utwórz je bezpłatnie.
• Możliwość uruchamiania potoków na agentach hostowanych przez firmę Microsoft. Możesz kupić zadanie równoległe lub zażądać warstwy Bezpłatna.

1 — Tworzenie rozwidlenia przykładowego kodu

Utwórz rozwidlenie następującej przykładowej aplikacji serwera Express.js w witrynie GitHub.

https://github.com/Azure-Samples/js-e2e-express-server

2 — Tworzenie potoku

1. Zaloguj się do usługi Azure Pipelines. Przeglądarka przejdzie do https://dev.azure.com/my-organization-name pulpitu nawigacyjnego usługi Azure DevOps i wyświetli go.

2. Przejdź do projektu i wybierz pozycję Potoki>Utwórz nowy potok.

3. Wybierz pozycję GitHub jako lokalizację kodu źródłowego.

4. Jeśli nastąpi przekierowanie do usługi GitHub w celu zalogowania się, wprowadź swoje poświadczenia usługi GitHub.

5. Po wyświetleniu listy repozytoriów wybierz repozytorium przykładowe Node.js.

6. Usługa Azure Pipelines analizuje kod w repozytorium i zaleca Node.js szablon potoku. Wybierz ten szablon.

7. Usługa Azure Pipelines generuje plik YAML dla potoku. Wybierz pozycję Zapisz i uruchom>zatwierdzenie bezpośrednio w gałęzi głównej, a następnie wybierz pozycję Zapisz i uruchom ponownie.

8. Zostanie uruchomiony nowy przebieg. Poczekaj na zakończenie przebiegu.

Gdy skończysz, masz działający plik YAML azure-pipelines.yml w repozytorium, który jest gotowy do dostosowania.

3 — Kompilowanie pakietu i publikowanie artefaktu

1. Edytuj plik azure-pipelines.yml.

2. Zaktualizuj zadanie Instalatora narzędzi Node.js, aby użyć Node.js wersji 16 LTS.

   trigger:
   - main
   
   pool:
     vmImage: 'ubuntu-latest'
   
   steps:
   - task: UseNode@1
     inputs:
       version: '16.x'
     displayName: 'Install Node.js'
   
   - script: |
       npm install
     displayName: 'npm install'
   
   - script: |
       npm run build
     displayName: 'npm build'
   

3. Dodaj nowe zadania do potoku, aby skopiować pakiet npm, package.json i opublikować artefakt. Zadanie Copy Files kopiuje pliki ze ścieżki lokalnej na agencie, gdzie pliki kodu źródłowego są pobierane i zapisuje pliki w ścieżce lokalnej na agencie, do którego są kopiowane wszystkie artefakty przed wypchnięciem do ich miejsca docelowego. src Tylko foldery i public pobierają kopie. Zadanie Publikowanie artefaktu potoku pobiera pliki z wcześniejszych zadań Kopiowania plików i udostępnia je jako artefakty potoku, które zostaną opublikowane przy użyciu kompilacji potoku.

   - task: CopyFiles@2
     inputs:
       sourceFolder: '$(Build.SourcesDirectory)'
       contents: |
          src/*
          public/*
       targetFolder: '$(Build.ArtifactStagingDirectory)'
     displayName: 'Copy project files'
   
   - task: PublishPipelineArtifact@1
     inputs:
       artifactName: e2e-server
       targetPath: '$(Build.ArtifactStagingDirectory)'
       publishLocation: 'pipeline'
     displayName: 'Publish npm artifact'
   

4 — Uruchamianie potoku

Zapisz i uruchom potok. Po uruchomieniu potoku sprawdź, czy zadanie zostało uruchomione pomyślnie i czy widzisz opublikowany artefakt.

1. Rozwidlenie następującego repozytorium w usłudze GitHub.

   https://github.com/Azure-Samples/js-e2e-express-server
   

2. Po utworzeniu przykładowego kodu we własnym repozytorium utwórz pierwszy potok i wybierz szablon Pusty proces .

3. Wybierz pozycję Proces na karcie Zadania w edytorze potoku i zmień właściwości w następujący sposób:

   • Kolejka agentów:Hosted Ubuntu Latest

4. Dodaj następujące zadania do potoku w określonej kolejności:

   • npm

     • Polecenie:install

   • npm

     • Nazwa wyświetlananpm test:
     • Polecenie:custom
     • Polecenia i argumenty:test

   • Publikowanie wyników testu

     • Pozostaw wszystkie wartości domyślne właściwości

   • Pliki archiwum

     • Folder główny lub plik do archiwizacji:$(System.DefaultWorkingDirectory)
     • Wstępna nazwa folderu głównego do ścieżek archiwum: Niezaznaczone

   • Publikowanie artefaktów kompilacji

     • Pozostaw wszystkie wartości domyślne właściwości

5. Zapisz potok i utwórz kolejkę kompilacji, aby zobaczyć ją w akcji.

Następne kroki

Gratulacje. Pomyślnie ukończono ten przewodnik Szybki start!

Konfigurowanie języka JavaScript