Tworzenie pierwszego potoku

Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 | TFS 2017

Jest to przewodnik krok po kroku dotyczący używania Azure Pipelines do kompilowania przykładowej aplikacji. W tym przewodniku używane są potoki YAML skonfigurowane za pomocą edytora potoków YAML. Jeśli chcesz zamiast tego użyć potoków klasycznych, zobacz Define your Classic pipeline (Definiowanie potoku klasycznego).

Wymagania wstępne — Azure DevOps

  • Konto GitHub, na którym można utworzyć repozytorium. Jeśli nie masz takiego konta, możesz je utworzyć bezpłatnie.

  • Organizacja Azure DevOps. Jeśli nie masz takiego konta, możesz je utworzyć bezpłatnie. (Organizacja Azure DevOps różni się od twojej GitHub organizacji. Możesz nadać organizacji DevOps i organizacji GitHub taką samą nazwę, jeśli chcesz wyrównać między nimi).

    Jeśli Twój zespół już go ma, upewnij się, że jesteś administratorem Azure DevOps projektu, którego chcesz użyć.

  • Możliwość uruchamiania potoków na agentach hostowanych przez firmę Microsoft. Możesz kupić zadanie równoległe lub zażądać warstwy Bezpłatna. Aby zażądać warstwy Bezpłatna, postępuj zgodnie z instrukcjami w tym artykule. Pamiętaj, że przyznanie warstwy bezpłatna może potrwać od 2 do 3 dni roboczych.

Tworzenie pierwszego potoku

Pobierz przykładowy kod Java

Aby rozpocząć, należy wydychać następujące repozytorium na GitHub konto.

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

Tworzenie pierwszego potoku języka Java

  1. Zaloguj się do swojej Azure DevOps i przejdź do projektu.

  2. W projekcie przejdź do strony Pipelines aplikacji. Następnie wybierz akcję, aby utworzyć nowy potok.

  3. Aby przejść przez kroki kreatora, najpierw wybierz GitHub jako lokalizację kodu źródłowego.

  4. Możesz zostać przekierowany do GitHub, aby się zalogować. Jeśli tak, wprowadź GitHub poświadczenia.

  5. Gdy zostanie wyświetlona lista repozytoriów, wybierz żądane przykładowe repozytorium aplikacji.

  6. Azure Pipelines przeanalizuje repozytorium i zaleci szablon potoku Maven. Wybierz pozycję Zapisz i uruchom, a następnie wybierz pozycję Zat zatwierdzanie bezpośrednio w gałęzi main, a następnie wybierz pozycję Zapisz i uruchom ponownie.

  7. Rozpoczyna się nowy przebieg. Poczekaj na zakończenie przebiegu.

Dowiedz się więcej na temat pracy z kodem Java w potoku.

Dodawanie wskaźnika stanu do repozytorium

Wielu deweloperów chce pokazać, że jakość kodu jest wysoka, wyświetlając wskaźnik stanu w swoim repoecie.

Wskaźnik stanu pokazuje, że potok platformy Azure zakończył się pomyślnie

Aby skopiować wskaźnik stanu do schowka:

  1. W Azure Pipelines przejdź do strony Pipelines, aby wyświetlić listę potoków. Wybierz potok utworzony w poprzedniej sekcji.

  2. W menu kontekstowym potoku wybierz pozycję Wskaźnik stanu.

  3. Skopiuj przykładowy kod Markdown z panelu wskaźników stanu.

Teraz, gdy w schowku znajduje się znaczek Markdown, w GitHub:

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

  2. Wklej znacznik stanu Markdown na początku pliku.

  3. Zat zatwierdzanie zmiany gałęzi master .

  4. Zwróć uwagę, że wskaźnik stanu pojawia się w opisie repozytorium.

Aby skonfigurować anonimowy dostęp do wskaźników dla projektów prywatnych:

  1. Przejdź do Project Ustawienia

  2. Otwórz kartę Ustawienia w obszarze Pipelines

  3. Przełącz suwak Wyłącz anonimowy dostęp do wskaźników w obszarze Ogólne

Uwaga

Nawet w projekcie prywatnym dostęp do wskaźnika anonimowego jest domyślnie włączony. Po włączeniu dostępu do wskaźników anonimowych użytkownicy spoza organizacji mogą mieć możliwość wykonywania zapytań dotyczących informacji, takich jak nazwy projektów, nazwy gałęzi, nazwy zadań i stan kompilacji, za pośrednictwem interfejsu API stanu wskaźnika.

Ponieważ plik w tym repozytorium został właśnie zmieniony, program Azure Pipelines automatycznie skompilować kod zgodnie z konfiguracją w pliku w katalogu głównym Readme.md azure-pipelines.yml repozytorium. Po powrocie Azure Pipelines sprawdź, czy pojawi się nowy przebieg. Za każdym razem, gdy edytujesz, Azure Pipelines uruchamia nowy przebieg.

Zarządzanie potokiem przy użyciu interfejsu wiersza polecenia platformy Azure

Potokami w organizacji można zarządzać za pomocą tych az pipelines poleceń:

Te polecenia wymagają nazwy lub identyfikatora potoku, którym chcesz zarządzać. Identyfikator potoku można uzyskać za pomocą polecenia az pipelines list.

Uruchamianie potoku

Istniejący potok można dodać do kolejki (uruchomić) za pomocą polecenia az pipelines run. Aby rozpocząć pracę, zobacz Get started with Azure DevOps CLI (Wprowadzenie do interfejsu wiersza polecenia).

az pipelines run [--branch]
                 [--commit-id]
                 [--folder-path]
                 [--id]
                 [--name]
                 [--open]
                 [--org]
                 [--project]
                 [--variables]

Parametry

  • branch: nazwa gałęzi, w której ma zostać kolejkowane uruchomienie potoku, na przykład refs/heads/main.
  • commit-id: identyfikator zatwierdzenia, na którym ma zostać kolejkowane uruchomienie potoku.
  • folder-path: ścieżka folderu potoku. Wartość domyślna to folder na poziomie głównym.
  • identyfikator: wymagane, jeśli nazwa nie jest podano. Identyfikator potoku do kolejki.
  • name: wymagane, jeśli nie podano identyfikatora, ale jest ignorowany, jeśli podano identyfikator. Nazwa potoku do kolejki.
  • otwórz: Otwórz stronę wyników potoku w przeglądarce internetowej.
  • org: Azure DevOps adres URL organizacji. Domyślną organizację można skonfigurować przy użyciu programu az devops configure -d organization=ORG_URL . Wymagane, jeśli nie skonfigurowano jako domyślne lub zostały one odebrane przy git config użyciu . Przykład: --org https://dev.azure.com/MyOrganizationName/.
  • project: nazwa lub identyfikator projektu. Projekt domyślny można skonfigurować przy użyciu narzędzia az devops configure -d project=NAME_OR_ID . Wymagane, jeśli nie skonfigurowano jako domyślne lub zostały one odebrane przy git config użyciu .
  • variables: rozdzielone spacjami pary "name=value" dla zmiennych, które chcesz ustawić.

Przykład

Następujące polecenie uruchamia potok o nazwie myGithubname.pipelines-java w potoku gałęzi i wyświetla wynik w formacie tabeli.

az pipelines run --name myGithubname.pipelines-java --branch pipeline --output table

Run ID    Number      Status      Result    Pipeline ID    Pipeline Name                Source Branch    Queued Time               Reason
--------  ----------  ----------  --------  -------------  ---------------------------  ---------------  --------------------------  --------
123       20200123.2  notStarted            12             myGithubname.pipelines-java  pipeline           2020-01-23 11:55:56.633450  manual

Aktualizowanie potoku

Istniejący potok można zaktualizować za pomocą polecenia az pipelines update. Aby rozpocząć pracę, zobacz Get started with Azure DevOps CLI (Wprowadzenie do interfejsu wiersza polecenia).

az pipelines update [--branch]
                    [--description]
                    [--id]
                    [--name]
                    [--new-folder-path]
                    [--new-name]
                    [--org]
                    [--project]
                    [--queue-id]
                    [--yaml-path]

Parametry

  • branch: nazwa gałęzi, w której ma zostać skonfigurowany przebieg potoku, na przykład refs/heads/main.
  • description: Nowy opis potoku.
  • identyfikator: wymagane, jeśli nazwa nie jest podano. Identyfikator potoku do zaktualizowania.
  • name: wymagane, jeśli nie podano identyfikatora. Nazwa potoku do zaktualizowania.
  • new-folder-path: nowa pełna ścieżka folderu, do którego jest przenoszony potok, na przykład user1/production_pipelines.
  • new-name: nowa zaktualizowana nazwa potoku.
  • org: Azure DevOps adres URL organizacji. Domyślną organizację można skonfigurować przy użyciu programu az devops configure -d organization=ORG_URL . Wymagane, jeśli nie skonfigurowano jako domyślne lub zostały one odebrane przy git config użyciu . Przykład: --org https://dev.azure.com/MyOrganizationName/.
  • project: nazwa lub identyfikator projektu. Projekt domyślny można skonfigurować przy użyciu narzędzia az devops configure -d project=NAME_OR_ID . Wymagane, jeśli nie skonfigurowano jako domyślne lub zostały one odebrane przy git config użyciu .
  • queue-id: identyfikator kolejki puli agentów, w której musi zostać uruchomiony potok.
  • yaml-path: ścieżka pliku yaml potoku w repo.

Parametry globalne obejmują debug , , , i help only-show-errors query output verbose .

Porada

Istnieją również parametry globalne, których można użyć, takie jak --output . Parametr --output jest dostępny dla wszystkich poleceń. Wartość tabeli przedstawia dane wyjściowe w przyjaznym formacie. Aby uzyskać więcej informacji, zobacz Formaty danych wyjściowych dla poleceń interfejsu wiersza polecenia platformy Azure.

Przykład

Następujące polecenie aktualizuje potok o identyfikatorze 12 o nowej nazwie i opisie oraz wyświetla wynik w formacie tabeli.

az pipelines update --id 12 --description "rename pipeline" --new-name updatedname.pipelines-java --output table

ID    Name                        Status    Default Queue
----  --------------------------  --------  ------------------
12    updatedname.pipelines-java  enabled   Hosted Ubuntu 1604

Pokazywanie potoku

Szczegóły istniejącego potoku można wyświetlić za pomocą polecenia az pipelines show. Aby rozpocząć pracę, zobacz Get started with Azure DevOps CLI (Wprowadzenie do interfejsu wiersza polecenia).

az pipelines show [--folder-path]
                  [--id]
                  [--name]
                  [--open]
                  [--org]
                  [--project]
                  [--query-examples]
                  [--subscription]

Parametry

  • folder-path: ścieżka folderu potoku. Wartość domyślna to folder na poziomie głównym.
  • identyfikator: wymagane, jeśli nazwa nie jest podano. Identyfikator potoku w celu pokazania szczegółów.
  • name: wymagane, jeśli nazwa nie zostanie podany, ale ignorowane, jeśli podano identyfikator. Nazwa potoku w celu pokazania szczegółów.
  • otwórz: Otwórz stronę podsumowania potoku w przeglądarce internetowej.
  • org: Azure DevOps adres URL organizacji. Domyślną organizację można skonfigurować przy użyciu programu az devops configure -d organization=ORG_URL . Wymagane, jeśli nie skonfigurowano jako domyślne lub zostały one odebrane przy git config użyciu . Przykład: --org https://dev.azure.com/MyOrganizationName/.
  • project: nazwa lub identyfikator projektu. Projekt domyślny można skonfigurować przy użyciu narzędzia az devops configure -d project=NAME_OR_ID . Wymagane, jeśli nie skonfigurowano jako domyślne lub zostały one odebrane przy git config użyciu .
  • przykłady zapytań: zalecane jest użycie ciągu JMESPath.
  • subscription: nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu usługi az account set -s NAME_OR_ID .

Przykład

Następujące polecenie wyświetla szczegóły potoku o identyfikatorze 12 i zwraca wynik w formacie tabeli.

az pipelines show --id 12 --output table

ID    Name                        Status    Default Queue
----  --------------------------  --------  ------------------
12    updatedname.pipelines-java  enabled   Hosted Ubuntu 1604

Uwaga

W programie Microsoft Team Foundation Server (TFS) 2018 i poprzednich wersjach potoki kompilacji i wydania są nazywane definicjami, przebiegi są nazywane kompilacjami, połączenia z usługą są nazywane punktami końcowymi usługi, etapy są nazywane środowiskami , a zadania są nazywane fazami.

Uwaga

Te wskazówki dotyczą serwera TFS w wersji 2017.3 i nowszej.

Pokażemy Ci, jak za pomocą edytora klasycznego w programie Azure DevOps Server 2019 utworzyć kompilację i wydanie z etykietą "Hello world".

Pokażemy Ci, jak za pomocą klasycznego edytora w programie TFS utworzyć kompilację i wydanie, które wyświetla "Hello world".

Wymagania wstępne

Inicjowanie repozytorium

Jeśli masz już repozytorium w projekcie, możesz przejść do następnego kroku: Pomiń dodawanie skryptu do repozytorium

  1. Przejdź do Azure Repos. (Centrum kodu w poprzedniej nawigacji)

    Repos plików

  2. Jeśli projekt jest pusty, zostanie witany ekran ułatwiający dodanie kodu do repozytorium. Wybierz dolny wybór, aby zainicjować swoje repo z readme plikiem:

    Inicjowanie repozytorium

  1. Przejdź do repozytorium, klikając pozycję Kod w górnym menu nawigacyjnym.

  2. Jeśli projekt jest pusty, zostanie witany ekran ułatwiający dodanie kodu do repozytorium. Wybierz dolny wybór, aby zainicjować swoje repo z readme plikiem:

    Inicjowanie repozytorium

Dodawanie skryptu do repozytorium

Utwórz skrypt programu PowerShell, który Hello world drukuje .

  1. Przejdź do Azure Repos.

  2. Dodaj plik.

    Na karcie Pliki w węźle repo wybierz opcję Nowy plik

  3. W oknie dialogowym nazwij nowy plik i utwórz go.

    HelloWorld.ps1
    
  4. Skopiuj i wklej ten skrypt.

    Write-Host "Hello world"
    
  5. Zat zatwierdzanie (zapisywanie) pliku.

  1. Przejdź do centrum Kod.

  2. Dodaj plik.

Na karcie Pliki w węźle repo wybierz opcję "Dodaj plik"

  1. W oknie dialogowym nazwij nowy plik i utwórz go.

    HelloWorld.ps1
    
  2. Skopiuj i wklej ten skrypt.

    Write-Host "Hello world"
    
  3. Zat zatwierdzanie (zapisywanie) pliku.

W tym samouczku skupimy się na ciasnych/cd, więc część kodu jest prosta. Pracujemy w repozytorium Git Azure Repos bezpośrednio w przeglądarce internetowej.

Gdy wszystko będzie gotowe do rozpoczęcia tworzenia i wdrażania rzeczywistej aplikacji, możesz korzystać z szerokiej gamy klientów i usług kontroli wersji za pomocą Azure Pipelines kompilacji ci. Dowiedz się więcej.

Tworzenie potoku kompilacji

Utwórz potok kompilacji, który będzie drukował "Hello world".

  1. Wybierz Azure Pipelines pozycję . Powinno to automatycznie zabrać Cię do strony Kompilacje.

    Przejdź do karty Builds (Kompilacje)

  2. Utwórz nowy potok.

    Wybieranie przycisku na karcie kompilacji

    W przypadku Azure DevOps użytkowników spowoduje to automatyczne utworzenie potoku YAML. Aby uzyskać dostęp do edytora klasycznego i ukończyć ten przewodnik, należy wyłączyć funkcję w wersji zapoznawczej dla nowego procesu tworzenia potoku YAML:

    Kliknij ustawienia w prawym górnym rogu ekranu, a następnie kliknij pozycję Funkcje w wersji zapoznawczej

    Kliknij przełącznik, aby wyłączyć funkcję podglądu yaml

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

  4. Rozpocznij od zadania Empty.

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

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

    Dodawanie zadania kompilacji do zadania

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

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

    Wybieranie skryptu

  9. Wybierz pozycję Zapisz &, a następnie wybierz pozycję Zapisz.

  1. Wybierz pozycję Build and Release(Kompilacja i wydanie), a następnie wybierz pozycję Builds (Kompilacje).

    Wybieranie karty kompilacji

  2. Utwórz nowy potok.

    Tworzenie nowego potoku

  3. Rozpoczynanie pracy z pustym potokiem

  4. Wybierz pozycję Potok i określ nazwę, której chcesz użyć. W przypadku puli agentów wybierz pozycję Domyślna.

  5. Po lewej stronie wybierz pozycję + Dodaj zadanie, aby dodać zadanie do zadania, a następnie po prawej stronie wybierz kategorię Narzędzie, wybierz zadanie programu PowerShell, a następnie wybierz pozycję Dodaj.

    Dodawanie zadania do zadania

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

  7. W przypadku argumentu Ścieżka skryptu wybierz przycisk , aby przejrzeć repozytorium i wybrać utworzony skrypt.

    Wybieranie zadania programu PowerShell

  8. Wybierz pozycję Zapisz &, a następnie wybierz pozycję Zapisz.

  1. Wybierz Azure Pipelines pozycję , a następnie kartę Kompilacje.

    Przejdź do karty kompilacji

  2. Utwórz nowy potok.

    Zrzut ekranu przedstawiający kartę Kompilacje i przycisk Nowy.

  3. Rozpocznij od pustego potoku.

  4. Wybierz pozycję Potok i określ nazwę, której chcesz użyć.

  5. Na karcie Opcje wybierz opcję Domyślna dla puli Agent lub wybierz pulę, której chcesz użyć, która zawiera Windows kompilacji.

  6. Na karcie Zadania upewnij się, że ustawienie Pobierz źródła ma ustawioną wartość Repozytorium i Gałąź, w których utworzono skrypt.

  7. Po lewej stronie wybierz pozycję Dodaj zadanie , a następnie po prawej stronie wybierz kategorię Narzędzie, wybierz zadanie programu PowerShell, a następnie wybierz pozycję Dodaj.

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

  9. W przypadku argumentu Ścieżka skryptu wybierz przycisk , aby przejrzeć repozytorium i wybrać utworzony skrypt.

    Przeglądanie w celu znalezienia skryptu

  10. Wybierz pozycję Zapisz &, a następnie wybierz pozycję Zapisz.

Potok kompilacji to jednostka, za pomocą której definiujesz zautomatyzowany potok kompilacji. W potoku kompilacji tworzysz zestaw zadań, z których każde wykonuje krok w kompilacji. Katalog zadań zawiera bogaty zestaw zadań na początek. Do potoku kompilacji można również dodać skrypty programu PowerShell lub powłoki.

Publikowanie artefaktu z kompilacji

Typowa kompilacja tworzy artefakt, który można następnie wdrożyć na różnych etapach w wydaniu. Aby w prosty sposób zademonstrować tę możliwość, po prostu opublikujemy skrypt jako artefakt.

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

  2. Wybierz kategorię Narzędzie, wybierz zadanie publikowania kompilacji Artifacts, a następnie wybierz pozycję Dodaj.

    Dodawanie zadania publikowania artefaktu

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

    Nazwa artefaktu: wprowadź drop .

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

  1. Na karcie Zadania wybierz pozycję Dodaj zadanie.

  2. Wybierz kategorię Narzędzie, wybierz zadanie publikowania kompilacji Artifacts, a następnie wybierz pozycję Dodaj.

    Wybierz pozycję Dodaj, aby dodać zadanie publikowania artefaktu

    Ścieżka do publikowania: wybierz przycisk, aby przejrzeć i wybrać utworzony skrypt.

    Nazwa artefaktu: wprowadź drop .

    Typ artefaktu: wybierz pozycję Serwer.

Artifacts to pliki, które mają zostać skompilowane. Artifacts to niemal wszystko, czego twój zespół potrzebuje do przetestowania lub wdrożenia aplikacji. Na przykład masz plik wykonywalny .DLL .EXE i . Plik symboli PDB aplikacji .NET w języku C# Windows C++.

Aby umożliwić tworzenie artefaktów, zapewniamy narzędzia, takie jak kopiowanie z dopasowaniem do wzorca i katalog przejściowy, w którym można zebrać artefakty przed ich opublikowaniem. Zobacz Artifacts w Azure Pipelines.

Włączanie ciągłej integracji

  1. Wybierz kartę Wyzwalacze.

  2. Włącz ciągłą integrację.

Wyzwalacz ciągłej integracji w potoku kompilacji wskazuje, że system powinien automatycznie kolejkć nową kompilację za każdym razem, gdy zostanie zatwierdzona zmiana kodu. Możesz ustawić wyzwalacz jako bardziej ogólny lub bardziej konkretny, a także zaplanować kompilację (na przykład w nocy). Zobacz Build triggers (Wyzwalacze kompilacji).

Zapisywanie kompilacji i kolejkowanie jej

Zapisz kompilację i ręcznie ją w kolejce, a następnie przetestuj potok kompilacji.

  1. Wybierz pozycję Zapisz &, a następnie wybierz pozycję Zapisz & kolejki.

  2. W oknie dialogowym wybierz pozycję Zapisz & kolejkę.

    To kolejkuje nową kompilację na agencie hostowanych przez firmę Microsoft.

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

    konsola kompilacji

    Wybierz link, aby obserwować nową kompilację w takiej sytuacji. Po przydzieleniu agenta zaczniesz widzieć dzienniki na żywo kompilacji. Zwróć uwagę, że skrypt programu PowerShell jest uruchamiany w ramach kompilacji i że w konsoli jest drukowana informacja "Hello world".

    Oglądanie w konsoli kompilacji

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

    Otwórz konsolę kompilacji, aby wyświetlić artefakt

  1. Wybierz pozycję Zapisz &, a następnie wybierz pozycję Zapisz & kolejki.

  2. W oknie dialogowym wybierz pozycję Zapisz & kolejkę.

    To kolejkuje nową kompilację na agencie hostowanych przez firmę Microsoft.

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

    Przejdź do konsoli kompilacji

    Wybierz link, aby obserwować nową kompilację w takiej sytuacji. Po przydzieleniu agenta zaczniesz widzieć dzienniki na żywo kompilacji. Zwróć uwagę, że skrypt programu PowerShell jest uruchamiany w ramach kompilacji i że w konsoli jest drukowana informacja "Hello world".


  1. Przejdź do podsumowania kompilacji.

    link konsoli kompilacji do podsumowania kompilacji

  2. Na Artifacts kompilacji zwróć uwagę, że skrypt jest publikowany jako artefakt.

    eksplorator artefaktów

W dowolnym momencie możesz wyświetlić podsumowanie wszystkich kompilacji lub przejść do szczegółów dzienników każdej kompilacji, przechodząc do karty Kompilacje w Azure Pipelines . Dla każdej kompilacji można również wyświetlić listę zatwierdzeń, które zostały skompilowane, oraz elementów roboczych skojarzonych z każdym zatwierdzeniem. Możesz również uruchamiać testy w każdej kompilacji i analizować niepowodzenia testów.

  1. Wybierz pozycję Save & queue (Zapisz kolejkę), a następnie wybierz pozycję Save & queue (Zapisz & kolejki).

  2. W oknie dialogowym wybierz przycisk Kolejka.

    To kolejkuje nową kompilację agenta. Po przydzieleniu agenta zaczniesz widzieć dzienniki na żywo kompilacji. Zwróć uwagę, że skrypt programu PowerShell jest uruchamiany w ramach kompilacji i że w konsoli jest drukowana informacja "Hello world".

    Otwórz konsolę kompilacji, aby zobaczyć witaj, świecie

  3. Przejdź do podsumowania kompilacji.

    Zobacz link konsoli kompilacji, aby wyświetlić podsumowanie kompilacji

  4. Na Artifacts kompilacji zwróć uwagę, że skrypt jest publikowany jako artefakt.

    eksplorator artefaktów

W dowolnym momencie możesz wyświetlić podsumowanie wszystkich kompilacji lub przejść do szczegółów dzienników każdej kompilacji, przechodząc do karty Kompilacje w obszarze Kompilacje i wydanie. Dla każdej kompilacji można również wyświetlić listę zatwierdzeń, które zostały skompilowane, oraz elementów roboczych skojarzonych z każdym zatwierdzeniem. Możesz również uruchamiać testy w każdej kompilacji i analizować niepowodzenia testów.

Dodawanie zmiennych i zatwierdzanie zmian w skrypcie

Przekażemy pewne zmienne kompilacji do skryptu, aby nasz potok był nieco bardziej interesujący. Następnie zatwierdzimy zmianę skryptu i będziemy obserwować automatyczne uruchamianie potoku ci w celu zweryfikowania zmiany.

  1. Edytuj potok kompilacji.

  2. Na karcie Zadania wybierz zadanie skrypt programu PowerShell.

  3. Dodaj te argumenty.

Otwieranie zadania programu PowerShell w konsoli kompilacji

Zadanie programu PowerShell — TFS 2017

Argumenty

-greeter "$(Build.RequestedFor)" -trigger "$(Build.Reason)"

Na koniec zapisz potok kompilacji.

Następnie dodasz argumenty do skryptu.

  1. Przejdź do plików w Azure Repos (centrum kodu w poprzedniej nawigacji i tfs).

  2. Wybierz HelloWorld.ps1, a następnie pozycję Edytuj plik.

  3. Zmień skrypt w następujący sposób:

    Param(
    [string]$greeter,
    [string]$trigger
    )
    Write-Host "Hello world" from $greeter
    Write-Host Trigger: $trigger
    
  4. Zat zatwierdzanie (zapisywanie) skryptu.

Teraz możesz zobaczyć wyniki zmian. Przejdź do Azure Pipelines i wybierz pozycję W kolejce. Zwróć uwagę, że w sekcji W kolejce lub uruchomionej kompilacja jest automatycznie wyzwalana przez zatwierdzona zmianę.

Teraz możesz zobaczyć wyniki zmian. Przejdź do strony Kompilacja i wydanie i wybierz pozycję W kolejce. Zwróć uwagę, że w sekcji W kolejce lub uruchomionej kompilacja jest automatycznie wyzwalana przez zatwierdzona zmianę.

  1. Wybierz nową utworzoną kompilację i wyświetl jej dziennik.

  2. Zauważ, że osoba, która zmieniła kod, ma swoje imię wydrukowane w komunikacie z powitaniami. Widać również, że była to kompilacja CI.

Tworzenie podsumowującego dziennika skryptów programu PowerShell

podsumowanie kompilacji dziennik skryptów programu PowerShell

Właśnie wprowadziliśmy koncepcję zmiennych kompilacji w tych krokach. Wydrukowaliśmy wartość zmiennej, która jest automatycznie wstępnie zdefiniowana i zainicjowana przez system. Zmienne niestandardowe można również definiować i używać ich w argumentach zadań lub jako zmiennych środowiskowych w skryptach. Aby dowiedzieć się więcej na temat zmiennych, zobacz Build variables (Tworzenie zmiennych).

Masz potok kompilacji. Co dalej?

Utworzono potok kompilacji, który automatycznie tworzy i weryfikuje każdy kod zaewidencjonowany przez Twój zespół. W tym momencie możesz przejść do następnej sekcji, aby dowiedzieć się więcej o potokach wydania. Jeśli wolisz, możesz od razu przejść do tworzenia potoku kompilacji dla aplikacji.

Tworzenie potoku wydania

Zdefiniuj proces uruchamiania skryptu w dwóch etapach.

  1. Przejdź do karty Pipelines, a następnie wybierz pozycję Wydania.

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

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

  4. Nadaj etapowi nazwę QA.

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

  6. Wybierz pozycję Błyskawica, aby wyzwolić ciągłe wdrażanie, a następnie włącz wyzwalacz Ciągłe wdrażanie po prawej stronie.

    Wybieranie pioruna w celu wyzwolenia ciągłego wdrażania

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

  8. Wybierz znak plus ( + ) dla zadania, aby dodać zadanie do zadania.

  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. W przypadku argumentu Ścieżka skryptu wybierz przycisk , aby przeglądać artefakty, a następnie wybierz utworzony skrypt.

  12. Dodaj następujące argumenty:

    -greeter "$(Release.RequestedFor)" -trigger "$(Build.DefinitionName)"
    
  13. Na karcie Potok wybierz etap kontroli jakości, a następnie wybierz pozycję Klonuj.

    Klonowanie środowiska wydania w kontroli jakości

  14. Zmień nazwę sklonowanego etapu Production (Produkcja).

  15. Zmień nazwę potoku wydania Hello world.

    Zmienianie nazwy potoku wydania Hello World

  16. Zapisz potok wydania.

  1. Przejdź do karty Build and Release (Kompilacja i wydanie), a następnie wybierz pozycję Releases (Wydania).

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

  3. Wybierz akcję, aby rozpocząć od pustej definicji.

  4. Nadaj etapowi nazwę QA.

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

  6. Wybierz pozycję Błyskawica, aby wyzwolić ciągłe wdrażanie, a następnie włącz wyzwalacz Ciągłe wdrażanie po prawej stronie.


  1. Wybierz kartę Zadania i wybierz etap kontroli jakości.

  2. Wybierz znak plus ( + ) dla zadania, aby dodać zadanie do zadania.

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

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

  5. W przypadku argumentu Ścieżka skryptu wybierz przycisk , aby przeglądać artefakty, a następnie wybierz utworzony skrypt.

  6. Dodaj następujące argumenty:

    -greeter "$(Release.RequestedFor)" -trigger "$(Build.DefinitionName)"
    
  7. Na karcie Potok wybierz etap pytań i odpowiedzi, a następnie wybierz pozycję Klonuj.

    klonowanie środowiska wydania

  8. Zmień nazwę sklonowanego etapu Production.

  9. Zmień nazwę potoku wydania Hello world.

    zmienianie nazwy potoku wydania

  10. Zapisz potok wydania.

  1. Przejdź do Azure Pipelines, a następnie do karty Wydania.

  2. Wybierz akcję, aby utworzyć nowy potok.

  3. W oknie dialogowym wybierz szablon Pusty i wybierz pozycję Dalej.

  4. Upewnij się, że potok kompilacji Hello world utworzony powyżej został wybrany. Wybierz pozycję Ciągłe wdrażanie, a następnie wybierz pozycję Utwórz.

  5. Wybierz pozycję Dodaj zadania na etapie.

  6. W oknie dialogowym Katalog zadań wybierz pozycję Narzędzie, znajdź zadanie programu PowerShell, a następnie wybierz przycisk Dodaj. Wybierz przycisk Zamknij.

  7. W przypadku argumentu Ścieżka skryptu wybierz przycisk , aby przeglądać artefakty, a następnie wybierz utworzony skrypt.

  8. Dodaj następujące argumenty:

    -greeter "$(Release.RequestedFor)" -trigger "$(Build.DefinitionName)"
    
  9. Zmień nazwę etapu na QA.

    Zmienianie nazwy środowiska wydania dla kontroli jakości

  10. Sklonuj etap kontroli jakości.

    Wybierz pozycję Klonuj na etapie kontroli jakości.

    Pozostaw zaznaczoną opcję Automatycznie zatwierdzaj i wdaj automatycznie, a następnie wybierz pozycję Utwórz.

  11. Zmień nazwę nowego etapu Produkcja.

  12. Zmień nazwę potoku wydania Hello world.

    Zmiana nazwy potoku wydania na hello world

  13. Zapisz potok wydania.

Potok wydania to zbiór etapów, na których są wdrażane artefakty kompilacji aplikacji. Definiuje on również rzeczywisty potok wdrażania dla każdego etapu, a także sposób podnoszenia artefaktów z jednego etapu do innego.

Zwróć również uwagę, że w naszych argumentach skryptu uzywnialiśmy pewne zmienne. W tym przypadku u używaliśmy zmiennych wydania zamiast zmiennych kompilacji, których używaliśmy w potoku kompilacji.

Wdrażanie wydania

Uruchom skrypt na każdym etapie.

  1. Utwórz nowe wydanie.

    Tworzenie wersji — DevOps 2019 i 2020

    Gdy pojawi się okno Utwórz nowe wydanie, wybierz pozycję Utwórz.

  2. Otwórz utworzoną wersję.

    utworzone wydanie — DevOps 2019 i 2020

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

    dzienniki wersji — DevOps 2019 i 2020

  1. Utwórz nowe wydanie.

    tworzenie wydania — TFS 2018

    Po wybraniu opcji Utwórz nową wersję wybierz pozycję Utwórz (TFS 2018.2) lub Kolejka (TFS 2018 RTM).

  2. Otwórz utworzoną wersję.

    utworzona wersja — TFS 2018

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

    dzienniki wydania — TFS 2018

  1. Utwórz nowe wydanie.

    tworzenie wydania — TFS 2017

  2. Otwórz utworzoną wersję.

    utworzono wydanie — TFS 2017

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

    dzienniki wydania — TFS 2017

Możesz śledzić postęp każdego wydania, aby sprawdzić, czy zostało ono wdrożone na wszystkich etapach. Możesz śledzić zatwierdzenia, które są częścią każdego wydania, skojarzone elementy robocze i wyniki wszystkich przebiegów testów dodanych do potoku wydania.

Zmienianie kodu i obserwowanie jego automatycznego wdrażania w środowisku produkcyjnym

Dokonamy jeszcze jednej zmiany w skrypcie. Tym razem zostanie ona automatycznie skompilowana, a następnie wdrożona do etapu produkcji.

  1. Przejdź do centrum Kod na karcie Pliki, edytuj plikHelloWorld.ps1 i zmień go w następujący sposób:

    Param(
    [string]$greeter,
    [string]$trigger
    )
    Write-Host "Hello world" from $greeter
    Write-Host Trigger: $trigger
    Write-Host "Now that you've got CI/CD, you can automatically deploy your app every time your team checks in code."
    
  2. Zat zatwierdzeniu (zapisaniu) skryptu.

  3. Wybierz kartę Kompilacje, aby wyświetlić kompilację w kolejce i uruchomić ją.

  4. Po zakończeniu kompilacji wybierz kartę Wydania, otwórz nowe wydanie, a następnie przejdź do dziennika.

Nowy kod jest automatycznie wdrażany na etapie kontroli jakości, a następnie na etapie produkcji.

dziennik końcowy kroku skryptu wydania — DevOps 2019 i 2020

dziennik końcowy kroku skryptu wydania — TFS 2018

dziennik końcowy kroku skryptu wydania — TFS 2017

W wielu przypadkach prawdopodobnie chcesz edytować potok wydania, aby wdrożenie produkcyjne odbywało się dopiero po przetestowaniu i zatwierdzeniu. Zobacz Zatwierdzenia i bramy — omówienie.

Następne kroki

Właśnie wiesz, jak utworzyć pierwszy potok na platformie Azure. Dowiedz się więcej na temat konfigurowania potoków w wybranego języka:

Możesz też przejść do dostosowywania właśnie utworzonego potoku.

Aby uruchomić potok w kontenerze, zobacz Zadania kontenera.

Aby uzyskać szczegółowe informacje na temat GitHub repozytoriów, zobacz Build GitHub repositories (Tworzenie GitHub repozytoriów).

Aby dowiedzieć się, jak opublikować potok Artifacts, zobacz Publikowanie potoku Artifacts.

Aby dowiedzieć się, co jeszcze można zrobić w potokach YAML, zobacz informacje o schemacie YAML.

Czyszczenie

Jeśli utworzono jakiekolwiek potoki testowe, można je łatwo usunąć po ich użyciu.

Aby usunąć potok, przejdź do strony podsumowania dla tego potoku i wybierz pozycję Usuń z menu ... w prawym górnym rogu strony. Wpisz nazwę potoku, aby potwierdzić, a następnie wybierz pozycję Usuń.

Usuwanie potoku

Poznaliśmy podstawy tworzenia i uruchamiania potoku. Teraz możesz skonfigurować potok kompilacji dla języka programowania, z których korzystasz. Utwórz nowy potok kompilacji i tym razem użyj jednego z poniższych szablonów.

Język Szablon do użycia
.NET ASP.NET
.NET Core ASP.NET Core
C++ Program .NET Desktop
Przejdź Go
Java Gradle
JavaScript Node.js
Xcode Xcode

Często zadawane pytania

Gdzie można czytać artykuły dotyczące DevOps i ciasnych/cd?

Co to jest ciągła integracja?

Co to jest ciągłe dostarczanie?

Co to jest metodyka DevOps?

Jakiego systemu kontroli wersji mogę użyć?

Gdy wszystko będzie gotowe do korzystania z funkcji CI/CD dla aplikacji, możesz użyć wybranego systemu kontroli wersji:

Jak mogę replikować potok?

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

all-definitions-build-action-menu-replicate-actions

Zrzut ekranu przedstawiający sposób replikowania potoku.

Po sklonowanym potoku możesz wprowadzić zmiany, a następnie zapisać go.

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

Po utworzeniu szablonu członkowie zespołu mogą używać go do śledzenia wzorca w nowych potokach.

Porada

Jeśli używasz edytora nowych kompilacji, szablony niestandardowe są wyświetlane w dolnej części listy.

Jak mogę pracować z wersjami roboczą?

Jeśli edytujesz potok kompilacji i chcesz przetestować pewne zmiany, które nie są jeszcze gotowe do produkcji, możesz zapisać go jako wersji roboczej.

zapisywanie jako wersja robocza

Zrzut ekranu przedstawiający zapisywanie jako wersja robocza.

W razie potrzeby można edytować i testować wersje robocze.

edytowanie wersji roboczej — DevOps 2019 i 2020 r.

edytowanie wersji roboczej — TFS 2017

Gdy wszystko będzie gotowe, możesz opublikować projekt, aby scalić zmiany z potokiem kompilacji.

publikowanie wersji roboczej — DevOps 2019 i 2020 r.

publikowanie wersji roboczej — TFS 2018

Jeśli natomiast zdecydujesz się odrzucić projekt, możesz usunąć go z karty Wszystkie potoki pokazanej powyżej.

Jak usunąć potok?

Aby usunąć potok, przejdź do strony podsumowania dla tego potoku i wybierz pozycję Usuń z menu ... w prawym górnym rogu strony. Wpisz nazwę potoku, aby potwierdzić, a następnie wybierz pozycję Usuń.

Co jeszcze mogę zrobić, gdy kolejkę kompilacji?

Kompilacje można dodać do kolejki automatycznie lub ręcznie.

W przypadku ręcznego kolejkowania kompilacji można dla pojedynczego uruchomienia kompilacji:

Kompilacje można dodać do kolejki automatycznie lub ręcznie.

W przypadku ręcznego kolejkowania kompilacji można dla pojedynczego uruchomienia kompilacji:

Gdzie można dowiedzieć się więcej o ustawieniach potoku kompilacji?

Aby dowiedzieć się więcej na temat ustawień potoku kompilacji, zobacz:

Aby dowiedzieć się więcej na temat ustawień potoku kompilacji, zobacz:

Jak mogę programowo utworzyć potok kompilacji?

Dokumentacja interfejsu API REST: tworzenie potoku kompilacji

Uwaga

Możesz również zarządzać kompilacjami i potokami kompilacji z wiersza polecenia lub skryptów przy użyciu interfejsu wiersza Azure Pipelines wiersza polecenia.

Czy mogę uruchomić wiele potoków w Azure DevOps Services za pomocą jednego polecenia?

Obecnie interfejs wiersza polecenia platformy Azure i interfejsy API platformy Azure nie oferują poleceń, które uruchamiają wiele potoków z wiersza polecenia. Za pomocą poleceń interfejsu wiersza polecenia platformy Azure można wyświetlić listę wszystkich potoków i definicji oraz podać pojedyncze wydanie lub identyfikator kompilacji jako parametr. Wszystkie polecenia są przeznaczone do pracy dla niezależnych przebiegów niezależnych potoków i wymagają unikatowych żądań identyfikatorów, które zezwalają tylko na jedną, unikatową wartość. Aby dowiedzieć się więcej o wyzwalaczach potoku, zobacz Określanie zdarzeń, które wyzwalają potoki.