Stwórz swój pierwszy potok

Jest to szczegółowy przewodnik dotyczący tworzenia przykładowej aplikacji z repozytorium Git przy użyciu usługi Azure Pipelines. W tym przewodniku są używane potoki YAML skonfigurowane za pomocą edytora potoków YAML.

Aby uzyskać więcej informacji na temat różnych sekcji w potoku YAML, zobacz potok w schemacie YAML usługi Azure Pipelines i Dostosowywanie potoku YAML.

Jeśli zamiast tego chcesz używać potoków klasycznych, zobacz Definiowanie potoku klasycznego. Aby uzyskać wskazówki dotyczące korzystania z TFVC, zobacz Zbuduj repozytoria TFVC.

Wymagania wstępne — Azure DevOps

Upewnij się, że masz:

• Konto usługi GitHub, na którym można utworzyć repozytorium. Utwórz je bezpłatnie.

• Organizacja: Azure DevOps. Utwórz je bezpłatnie. Jeśli twój zespół już go ma, upewnij się, że jesteś administratorem projektu usługi Azure DevOps, którego chcesz użyć.

• Możliwość uruchamiania pipeline'ów na agentach hostowanych przez firmę Microsoft. Aby korzystać z agentów hostowanych przez firmę Microsoft, organizacja usługi Azure DevOps musi mieć dostęp do zadań równoległych hostowanych przez firmę Microsoft. Możesz kupić zadanie równoległe lub zażądać bezpłatnej dotacji.

Stwórz swój pierwszy potok

https://github.com/MicrosoftDocs/pipelines-java

https://github.com/MicrosoftDocs/pipelines-dotnet-core

https://github.com/Microsoft/python-sample-vscode-flask-tutorial

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

Wyświetlaj i zarządzaj swoimi potokami.

Potoki można wyświetlać i nimi zarządzać, wybierając Potoki z menu po lewej stronie, co przeniesie cię na stronę główną potoków.

Zrzut ekranu przedstawiający stronę docelową pipelines.

Na stronie głównej potoków można przeglądać potoki i ich realizacje, tworzyć oraz importować potoki, zarządzać zabezpieczeniami i przechodzić do szczegółów potoków oraz ich realizacji.

Wybierz pozycję Ostatnie , aby wyświetlić ostatnio uruchomione potoki (widok domyślny) lub wybierz pozycję Wszystkie , aby wyświetlić wszystkie potoki.

Wybierz potok, aby zarządzać tym potokiem i wyświetlić przebiegi. Wybierz numer kompilacji ostatniego uruchomienia, aby wyświetlić wyniki tej kompilacji; wybierz nazwę gałęzi, aby zobaczyć gałąź dla tego uruchomienia; lub wybierz menu kontekstowe, aby uruchomić pipeline i wykonać inne czynności zarządzania.

Wybierz Uruchomienia, aby wyświetlić wszystkie przebiegi potoku. Możesz, jeśli chcesz, filtrować wyświetlane przebiegi.

Wybierz przebieg potoku, aby wyświetlić informacje o tym uruchomieniu.

Możesz zachować lub usunąć przebieg z menu kontekstowego. Aby uzyskać więcej informacji na temat przechowywania przebiegów, zapoznaj się z Politykami przechowywania kompilacji i wydania.

Wyświetl szczegóły pipeline'u

Strona szczegółowa potoku pozwala na przeglądanie i zarządzanie tym potokiem.

Wybierz pozycję Edytuj, aby edytować pipeline. Aby uzyskać więcej informacji, zobacz Edytor potoków YAML. Można także edytować potok przetwarzania, modyfikując bezpośrednio plik azure-pipelines.yml w repozytorium, które go hostuje.

Wyświetl szczegóły przebiegu procesów

W podsumowaniu przebiegu potoku możesz zobaczyć stan swojego przebiegu, zarówno podczas jego trwania, jak i po zakończeniu.

W panelu podsumowania możesz wyświetlić szczegóły zadania i fazy, pobrać artefakty i przejść do powiązanych zatwierdzeń, wyników testów i elementów roboczych.

Zadania i etapy

Okienko zadań zawiera omówienie stanu etapów i zadań. To okienko może zawierać wiele kart w zależności od tego, czy łańcuch ma etapy i zadania, czy tylko zadania. W tym przykładzie potok danych ma dwa etapy o nazwach Kompilacja i Wdrażanie. Możesz zajrzeć w szczegóły kroków potoku, wybierając zadanie w okienku Etapy lub Zadania.

Wybierz zadanie, aby wyświetlić kroki dla tego zadania.

W widoku kroków możesz przejrzeć stan i szczegóły każdego kroku. Z Więcej akcji możesz przełączać znaczniki czasu lub przeglądać surowy log wszystkich kroków w pipeline'u.

Anuluj i uruchom ponownie potok

Jeśli pipeline działa, możesz go anulować, wybierając opcję Anuluj. Jeśli przebieg został ukończony, możesz ponownie uruchomić potok, wybierając Uruchom nowy.

Menu działania potoku — więcej akcji

Z menu Więcej działań można pobrać dzienniki, dodać tagi, edytować potok danych, usunąć zadanie i skonfigurować przechowywanie dla zadania.

Dodaj wskaźnik stanu do repozytorium

Wielu deweloperów lubi pokazać, że utrzymuje wysoką jakość kodu, wyświetlając wskaźnik stanu w repozytorium.

Aby skopiować odznakę statusu do schowka:

1. W usłudze Azure Pipelines przejdź do strony Potoki , aby wyświetlić listę potoków. Wybierz potok, który utworzyłeś w poprzedniej sekcji.

2. Wybierz pozycję , a następnie wybierz odznakę stanu.

3. Wybierz odznakę stanu.

4. Skopiuj przykładowy kod Markdown z sekcji Przykładowy kod Markdown.

Teraz, mając skopiowaną odznakę Markdown w schowku, wykonaj następujące kroki w GitHub:

1. Przejdź do listy plików i wybierz pozycję Readme.md. Wybierz ikonę ołówka, aby edytować.

2. Wklej wskaźnik stanu Markdown na początku pliku.

3. Zatwierdź zmianę w main branch.

4. Zwróć uwagę, że wskaźnik stanu jest wyświetlany w opisie repozytorium.

Aby skonfigurować anonimowy dostęp do znaczków dla projektów prywatnych:

1. Przejdź do Ustawienia projektu w lewym dolnym rogu strony

2. Otwórz kartę Ustawienia w obszarze Potoki

3. Przełącz suwak Wyłącz anonimowy dostęp do znaczków w sekcji Ogólne

Ponieważ właśnie zmieniłeś plik Readme.md w tym repozytorium, usługa Azure Pipelines automatycznie buduje twój kod zgodnie z konfiguracją w pliku azure-pipelines.yml w katalogu głównym twojego repozytorium. Wróć do usługi Azure Pipelines, aby zobaczyć, że zostanie wyświetlony nowy przebieg. Za każdym razem, gdy dokonasz edycji, Azure Pipelines uruchamia nowy proces.

Pokażemy, jak używać klasycznego edytora w usłudze Azure DevOps Server 2019 w celu utworzenia kompilacji i wydania, która wyświetla tekst "Hello world".

1. Przejdź do usługi Azure Repos. Centrum kodu w poprzedniej nawigacji

   

2. Jeśli projekt jest pusty, zostanie wyświetlony ekran, który pomoże Ci dodać kod do repozytorium. Wybierz ostatnią opcję, aby zainicjować swoje repozytorium z plikiem readme.

   

1. Przejdź do usługi Azure Repos.

2. Dodaj plik.

   

3. W oknie dialogowym nadaj nowemu plikowi nazwę i utwórz go.

   HelloWorld.ps1
   

4. Skopiuj i wklej ten skrypt.

   Write-Host "Hello world"
   

5. Zatwierdź (zapisz) plik.

1. Wybierz Azure Pipelines, powinno nastąpić automatyczne przejście do Builds.

   

2. Utwórz nowy potok.

   

   W przypadku nowych użytkowników usługi Azure DevOps nastąpi automatyczne przejście do środowiska tworzenia potoków YAML. Aby przejść do klasycznego edytora i ukończyć ten przewodnik, należy wyłączyć funkcję podglądu dla doświadczenia tworzenia nowego potoku YAML:

   

   

3. Upewnij się, że źródło, projekt, repozytorium i gałąź domyślna są zgodne z lokalizacją, w której utworzono skrypt.

4. Zacznij od pustego zadania.

5. Po lewej stronie wybierz pozycję Potok i określ dowolną nazwę , której chcesz użyć. W polu puli agentów wybierz opcję Hostowana VS2017.

6. Po lewej stronie wybierz znak plus ( + ), aby dodać zadanie do zadania 1. Po prawej stronie wybierz kategorię Narzędzie , wybierz zadanie programu PowerShell z listy, a następnie wybierz pozycję Dodaj.

   

7. Po lewej stronie wybierz nowe zadanie skryptu programu PowerShell .

8. Dla argumentu Ścieżka skryptu wybierz przycisk , aby przejrzeć repozytorium i wybrać utworzony skrypt.

   

9. Wybierz Zapisz i zakolejkuj, a następnie Zapisz.

1. Na karcie Zadania wybierz znak plus ( + ), aby dodać zadanie do zadania 1.

2. Wybierz kategorię Narzędzia, wybierz zadanie Publikuj artefakty kompilacji, a następnie wybierz Dodaj.

   

   Ścieżka do opublikowania: wybierz przycisk do przeglądania i wybierz utworzony skrypt.

   Nazwa artefaktu: wprowadź .drop

   Miejsce publikowania artefaktu: wybierz pozycję Azure Artifacts/TFS.

1. Wybierz pozycję Zapisz i dodaj do kolejki, a następnie wybierz pozycję Zapisz i dodaj do kolejki.

2. W oknie dialogowym wybierz pozycję Zapisz i ustaw w kolejce po raz kolejny.

   To powoduje uruchomienie nowej kompilacji na agencie hostowanym przez Microsoft.

3. W górnej części strony zostanie wyświetlony link do nowej kompilacji.

   

   Wybierz link, aby obejrzeć nową wersję na żywo. Po przydzieleniu agenta zaczniesz widzieć aktywne dzienniki kompilacji. Zwróć uwagę, że skrypt programu PowerShell jest uruchamiany w ramach kompilacji, a komunikat "Hello world" jest drukowany w konsoli programu .

   

4. Przejdź do podsumowania kompilacji. Na karcie artefaktów kompilacji zwróć uwagę, że skrypt jest publikowany jako artefakt.

   

Teraz możesz zobaczyć wyniki zmian. Przejdź do Azure Pipelines i wybierz pozycję Kolejka. Zwróć uwagę, że w sekcji Kolejkowane lub uruchomione kompilacja jest automatycznie inicjowana przez zmianę, którą zatwierdziłeś.

1. Przejdź do zakładki Pipelines, a następnie wybierz Wydania.

2. Wybierz akcję, aby utworzyć nowy pipeline. Jeśli potok wydawniczy został już utworzony, wybierz znak plus ( + ) i następnie wybierz Utwórz potok wydawniczy.

3. Wybierz akcję, aby rozpocząć od pustego zadania.

4. Nadaj etapowi nazwę QA.

5. W panelu Artefakty wybierz pozycję + Dodaj i określ źródło (potok kompilacji). Wybierz Dodaj.

6. Wybierz ikonę Lightning bolt , aby wyzwolić ciągłe wdrażanie, a następnie włącz wyzwalacz ciągłego wdrażania po prawej stronie.

   

7. Wybierz kartę Zadania i wybierz swój etap kontroli jakości.

8. Wybierz znak plus ( + ) przy zadaniu, aby dodać do niego zadanie.

9. W oknie dialogowym Dodawanie zadań wybierz pozycję Narzędzie, znajdź zadanie programu PowerShell, a następnie wybierz przycisk Dodaj.

10. Po lewej stronie wybierz nowe zadanie skryptu programu PowerShell .

11. Dla argumentu Ścieżka skryptu wybierz przycisk , aby przejrzeć swoje artefakty i wybrać utworzony skrypt.

12. Dodaj następujące argumenty:

    -greeter "$(Release.RequestedFor)" -trigger "$(Build.DefinitionName)"
    

13. Na karcie Pipeline wybierz etap QA i wybierz Klonuj.

    

14. Zmień nazwę sklonowanego etapu Produkcja.

15. Zmień nazwę przepływu wydań Hello world.

    

16. Zapisz przepływ wydawniczy.

1. Utwórz nową wersję.

   

   Po wyświetleniu pozycji Utwórz nową wersję wybierz pozycję Utwórz.

2. Otwórz wersję, którą utworzyłeś.

   

3. Wyświetl dzienniki, aby uzyskać dane w czasie rzeczywistym dotyczące wydania.

   

Wiesz już, jak utworzyć pierwszy pipeline na platformie Azure. Teraz dowiedz się więcej o konfigurowaniu potoków w wybranym języku:

• .NET Core
• Przejdź
• Java
• Node.js
• Python
• Kontenery

Możesz również dostosować utworzony potok.

Aby uruchomić potok w kontenerze, zobacz Zadania kontenerowe.

Aby uzyskać szczegółowe informacje na temat tworzenia repozytoriów GitHub, zobacz Tworzenie repozytoriów GitHub.

Aby dowiedzieć się, jak opublikować swoje artefakty potoku, zobacz Publikowanie artefaktów potoku.

Aby dowiedzieć się, co jeszcze można zrobić w potokach YAML, zobacz Odniesienie do schematu YAML.

Czyszczenie

Jeśli stworzyłeś/łaś jakiekolwiek potoki testowe, można je łatwo usunąć, gdy zakończysz z nimi pracę.

az pipelines list [--detect {false, true}]
                  [--folder-path]
                  [--name]
                  [--org]
                  [--project]
                  [--query-order {ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None}]
                  [--repository]
                  [--repository-type {bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol}]
                  [--top]

az pipelines delete --id
                    [--detect {false, true}]
                    [--org]
                    [--project]
                    [--yes]

az pipelines list --output table

ID    Path    Name           Status    Default Queue
----  ------  -------------  --------  ------------------
6     \       FabrikamFiber  enabled   Hosted Ubuntu 1604

az pipelines delete --id 6

Are you sure you want to delete this pipeline? (y/n): y
Pipeline 6 was deleted successfully.

• Klienci

  • Program Visual Studio Code dla systemów Windows, macOS i Linux
  • Program Visual Studio z usługą Git dla systemu Windows lub Visual Studio dla komputerów Mac
  • Eclipse
  • Xcode
  • IntelliJ
  • Wiersz polecenia

• Usługi

  • Azure Pipelines
  • Dostawcy usług Git, tacy jak Azure Repos Git, GitHub i Bitbucket Cloud
  • Subversion

Jak mogę replikować potok?

Jeśli potok ma wzorzec, który chcesz replikować w innych potokach, sklonuj go, wyeksportuj lub zapisz jako szablon.

Po sklonowaniu pipeline'u możesz wprowadzić zmiany i następnie go zapisać.

Po wyeksportowaniu potoku możesz zaimportować go z karty Wszystkie potoki .

Po utworzeniu szablonu członkowie zespołu mogą używać go do podążania za wzorcem w nowych pipeline'ach.

Jak mogę pracować z wersjami roboczymi?

Jeśli edytujesz potok kompilacji i chcesz przetestować pewne zmiany, które nie są jeszcze gotowe do użycia w środowisku produkcyjnym, możesz zapisać go jako wersję roboczą.

Co jeszcze mogę zrobić podczas kolejkowania kompilacji?

Można kolejkować kompilacje automatycznie lub ręcznie.

Gdy ręcznie dodajesz kompilację do kolejki, możesz w trakcie jednego uruchomienia kompilacji:

• Określ pulę, do której przesyłana jest kompilacja.

• Dodaj i zmodyfikuj niektóre zmienne.

• Dodaj wymagania.

• W repozytorium Git

  • Utwórz gałąź lub tag.

  • Skompiluj zatwierdzenie.

Aby dowiedzieć się więcej o ustawieniach potoku, przejdź do:

• Pobieranie źródeł
• Zadania
• Zmienne
• Wyzwalacze
• Przechowywanie
• Historia

Jak mogę programowo utworzyć potok kompilacji?

Dokumentacja interfejsu API REST: tworzenie pipeline'u kompilacji