Tworzenie pierwszego potoku

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Jest to przewodnik krok po kroku dotyczący tworzenia przykładowej aplikacji przy użyciu usługi Azure Pipelines. W tym przewodniku są używane potoki YAML skonfigurowane za pomocą edytora potoku YAML. Jeśli zamiast tego chcesz używać potoków klasycznych, zobacz Definiowanie potoku klasycznego.

Wymagania wstępne — Azure DevOps

Upewnij się, że masz:

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

• Organizacja usługi Azure DevOps. Utwórz go 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 potoków na agentach hostowanych przez firmę Microsoft. Możesz kupić zadanie równoległe lub zażądać warstwy Bezpłatna.

Tworzenie pierwszego potoku

Java

Pobieranie przykładowego kodu Java

Aby rozpocząć, rozwidlenie następującego repozytorium na koncie usługi GitHub.

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

Tworzenie pierwszego potoku Języka Java

1. Zaloguj się do organizacji usługi Azure DevOps i przejdź do projektu.

2. Przejdź do obszaru Potoki, a następnie wybierz pozycję Nowy potok.

3. Wykonaj kroki kreatora, wybierając najpierw usługę GitHub jako lokalizację kodu źródłowego.

4. Być może nastąpi przekierowanie do usługi GitHub w celu zalogowania się. Jeśli tak, wprowadź poświadczenia usługi GitHub.

5. Po wyświetleniu listy repozytoriów wybierz repozytorium.

6. Być może nastąpi przekierowanie do usługi GitHub w celu zainstalowania aplikacji Usługi Azure Pipelines. Jeśli tak, wybierz pozycję Zatwierdź instalację&.

7. Usługa Azure Pipelines przeanalizuje repozytorium i zaleci szablon potoku maven .

8. Po wyświetleniu nowego potoku przyjrzyj się kodowi YAML, aby zobaczyć, co robi. Gdy wszystko będzie gotowe, wybierz pozycję Zapisz i uruchom.

9. Zostanie wyświetlony monit o zatwierdzenie nowego azure-pipelines.yml pliku w repozytorium. Po zapoznaniu się z komunikatem wybierz pozycję Zapisz i uruchom ponownie.

   Jeśli chcesz obserwować działanie potoku, wybierz zadanie kompilacji.

   Właśnie utworzono i uruchomiono potok, który automatycznie utworzyliśmy dla Ciebie, ponieważ kod wydawał się być dobrym dopasowaniem dla szablonu maven .

   Masz teraz działający potok YAML (azure-pipelines.yml) w repozytorium, który jest gotowy do dostosowania.

10. Gdy wszystko będzie gotowe do wprowadzenia zmian w potoku, wybierz go na stronie Potoki , a następnie pozycję Edytujazure-pipelines.yml plik.

Dowiedz się więcej o pracy z językiem Java w potoku.

.NET

Pobieranie przykładowego kodu platformy .NET

Aby rozpocząć, rozwidlenie następującego repozytorium na koncie usługi GitHub.

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

Tworzenie pierwszego potoku platformy .NET Core

1. Zaloguj się do organizacji usługi Azure DevOps i przejdź do projektu.

2. Przejdź do obszaru Potoki, a następnie wybierz pozycję Nowy potok.

3. Wykonaj kroki kreatora, wybierając najpierw usługę GitHub jako lokalizację kodu źródłowego.

4. Być może nastąpi przekierowanie do usługi GitHub w celu zalogowania się. Jeśli tak, wprowadź poświadczenia usługi GitHub.

5. Po wyświetleniu listy repozytoriów wybierz repozytorium.

6. Być może nastąpi przekierowanie do usługi GitHub w celu zainstalowania aplikacji Usługi Azure Pipelines. Jeśli tak, wybierz pozycję Zatwierdź instalację&.

7. Usługa Azure Pipelines przeanalizuje repozytorium i zaleci szablon potoku ASP.NET Core.

8. Po wyświetleniu nowego potoku przyjrzyj się kodowi YAML, aby zobaczyć, co robi. Gdy wszystko będzie gotowe, wybierz pozycję Zapisz i uruchom.

9. Zostanie wyświetlony monit o zatwierdzenie nowego azure-pipelines.yml pliku w repozytorium. Po zapoznaniu się z komunikatem wybierz pozycję Zapisz i uruchom ponownie.

   Jeśli chcesz obserwować działanie potoku, wybierz zadanie kompilacji.

   Właśnie utworzono i uruchomiono potok, który został utworzony automatycznie, ponieważ kod wydawał się być dobrym dopasowaniem dla szablonu ASP.NET Core.

   Masz teraz działający potok YAML (azure-pipelines.yml) w repozytorium, który jest gotowy do dostosowania.

10. Gdy wszystko będzie gotowe do wprowadzenia zmian w potoku, wybierz go na stronie Potoki , a następnie pozycję Edytujazure-pipelines.yml plik.

Dowiedz się więcej o pracy z platformą .NET Core w potoku.

Python

Pobieranie przykładowego kodu w języku Python

Aby rozpocząć, rozwidlenie następującego repozytorium na koncie usługi GitHub.

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

Tworzenie pierwszego potoku języka Python

1. Zaloguj się do organizacji usługi Azure DevOps i przejdź do projektu.

2. Przejdź do obszaru Potoki, a następnie wybierz pozycję Nowy potok.

3. Wykonaj kroki kreatora, wybierając najpierw usługę GitHub jako lokalizację kodu źródłowego.

4. Być może nastąpi przekierowanie do usługi GitHub w celu zalogowania się. Jeśli tak, wprowadź poświadczenia usługi GitHub.

5. Po wyświetleniu listy repozytoriów wybierz repozytorium.

6. Być może nastąpi przekierowanie do usługi GitHub w celu zainstalowania aplikacji Usługi Azure Pipelines. Jeśli tak, wybierz pozycję Zatwierdź instalację&.

7. Usługa Azure Pipelines przeanalizuje repozytorium i zaleci szablon potoku pakietów języka Python .

8. Po wyświetleniu nowego potoku przyjrzyj się kodowi YAML, aby zobaczyć, co robi. Gdy wszystko będzie gotowe, wybierz pozycję Zapisz i uruchom.

9. Zostanie wyświetlony monit o zatwierdzenie nowego azure-pipelines.yml pliku w repozytorium. Po zapoznaniu się z komunikatem wybierz pozycję Zapisz i uruchom ponownie.

   Jeśli chcesz obserwować działanie potoku, wybierz zadanie kompilacji.

   Właśnie utworzono i uruchomiono potok, który został utworzony automatycznie, ponieważ kod wydawał się być dobrym dopasowaniem szablonu pakietu języka Python .

   Masz teraz działający potok YAML (azure-pipelines.yml) w repozytorium, który jest gotowy do dostosowania.

10. Gdy wszystko będzie gotowe do wprowadzenia zmian w potoku, wybierz go na stronie Potoki , a następnie pozycję Edytujazure-pipelines.yml plik.

Dowiedz się więcej o pracy z językiem Python w potoku.

JavaScript

Pobieranie przykładowego kodu JavaScript

Aby rozpocząć, rozwidlenie następującego repozytorium na koncie usługi GitHub.

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

Tworzenie pierwszego potoku języka JavaScript

1. Zaloguj się do organizacji usługi Azure DevOps i przejdź do projektu.

2. Przejdź do obszaru Potoki, a następnie wybierz pozycję Nowy potok.

3. Wykonaj kroki kreatora, wybierając najpierw usługę GitHub jako lokalizację kodu źródłowego.

4. Być może nastąpi przekierowanie do usługi GitHub w celu zalogowania się. Jeśli tak, wprowadź poświadczenia usługi GitHub.

5. Po wyświetleniu listy repozytoriów wybierz repozytorium.

6. Być może nastąpi przekierowanie do usługi GitHub w celu zainstalowania aplikacji Usługi Azure Pipelines. Jeśli tak, wybierz pozycję Zatwierdź instalację&.

7. Usługa Azure Pipelines przeanalizuje repozytorium i zaleci szablon potoku Node.js .

8. Po wyświetleniu nowego potoku przyjrzyj się kodowi YAML, aby zobaczyć, co robi. Gdy wszystko będzie gotowe, wybierz pozycję Zapisz i uruchom.

9. Zostanie wyświetlony monit o zatwierdzenie nowego azure-pipelines.yml pliku w repozytorium. Po zapoznaniu się z komunikatem wybierz pozycję Zapisz i uruchom ponownie.

   Jeśli chcesz obserwować działanie potoku, wybierz zadanie kompilacji.

   Właśnie utworzono i uruchomiono potok, który został utworzony automatycznie, ponieważ twój kod wydaje się być dobrym dopasowaniem szablonu Node.js .

   Masz teraz działający potok YAML (azure-pipelines.yml) w repozytorium, który jest gotowy do dostosowania.

10. Gdy wszystko będzie gotowe do wprowadzenia zmian w potoku, wybierz go na stronie Potoki , a następnie edytujazure-pipelines.yml plik.

Dowiedz się więcej o pracy z językiem JavaScript w potoku.

Interfejs wiersza polecenia platformy Azure (Java)

1. W wierszu polecenia zaloguj się do interfejsu wiersza polecenia platformy Azure.

   az login
   

2. Rozwidlenie następującego repozytorium na koncie usługi GitHub:

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

   Po jego rozwidleniu sklonuj go na maszynę dewelopera. Dowiedz się, jak utworzyć rozwidlenie repozytorium.

3. Przejdź do sklonowanego katalogu.

4. Utwórz nowy potok:

   az pipelines create --name "First-Java.CI"
   

   Szczegóły repozytorium i gałęzi są pobierane z konfiguracji git dostępnej w sklonowanym katalogu.

5. Jeśli zostanie wyświetlony monit, wprowadź nazwę użytkownika i hasło usługi GitHub, aby uwierzytelnić usługę Azure Pipelines.

   Enter your GitHub username (Leave blank for using already generated PAT): 
   Enter your GitHub password:
   

6. Dodaj nazwę , ContosoPipelineServiceConnectiondla połączenia usługi utworzonego w celu umożliwienia usłudze Azure Pipelines komunikowania się z repozytorium GitHub.

   Enter a service connection name to create? ContosoPipelineServiceConnection
   

7. Wybierz szablon potoku Maven z listy zalecanych szablonów.

   Which template do you want to use for this pipeline?
   [1] Maven
   [2] Maven package Java project Web App to Linux on Azure
   [3] Android
   [4] Ant
   [5] ASP.NET
   [6] ASP.NET Core
   [7] ASP .NET Core (.NET Framework)
   [8] Starter pipeline
   [9] C/C++ with GCC
   [10] Go
   [11] Gradle
   [12] HTML
   [13] Jekyll site
   [14] .NET Desktop
   [15] Node.js
   [16] Node.js with Angular
   [17] Node.js with Grunt
   [18] Node.js with gulp
   [19] Node.js with React
   [20] Node.js with Vue
   [21] Node.js with webpack
   [22] PHP
   [23] Python Django
   [24] Python package
   [25] Ruby
   [26] Universal Windows Platform
   [27] Xamarin.Android
   [28] Xamarin.iOS
   [29] Xcode
   Please enter a choice [Default choice(1)]:
   

8. Wybierz pozycję 2 , aby wyświetlić kod YAML w edytorze domyślnym i wprowadzić zmiany.

   Do you want to view/edit the template yaml before proceeding?
   [1] Continue with the generated yaml
   [2] View or edit the yaml
   Please enter a choice [Default choice(1)]:2
   

9. Wybierz pozycję 1 , aby zatwierdzić plik YAML w gałęzi głównej.

   How do you want to commit the files to the repository?
   [1] Commit directly to the main branch.
   [2] Create a new branch for this commit and start a pull request.
   Please enter a choice [Default choice(1)]:
   

10. Usługa Azure DevOps automatycznie uruchomi uruchomienie potoku. Poczekaj na zakończenie przebiegu.

Dodawanie wskaźnika stanu do repozytorium

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

Aby skopiować wskaźnik stanu do schowka:

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

2. Wybierz pozycję , a następnie wybierz pozycję Znaczek Stan.

3. Wybierz wskaźnik Stan.

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

Teraz przy użyciu znaczka Markdown w schowku wykonaj następujące kroki w usłudze 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 gałęzi.

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 pozycji Ustawienia projektu

2. Otwórz kartę Ustawienia w obszarze Potoki

3. Przełącz suwak Wyłącz dostęp anonimowy do znaczkó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 identyfikatora anonimowego użytkownicy spoza organizacji mogą wykonywać zapytania dotyczące informacji, takich jak nazwy projektów, nazwy gałęzi, nazwy zadań i stan kompilacji za pośrednictwem interfejsu API stanu znaczka.

Ponieważ właśnie zmieniono Readme.md plik w tym repozytorium, usługa Azure Pipelines automatycznie kompiluje kod, zgodnie z konfiguracją w pliku w azure-pipelines.yml katalogu głównym repozytorium. W usłudze Azure Pipelines zwróć uwagę, że zostanie wyświetlone nowe uruchomienie. Za każdym razem, gdy dokonasz edycji, usługa Azure Pipelines rozpoczyna nowy przebieg.

Uwaga

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

Pokażemy, jak używać edytora klasycznego w Azure DevOps Server 2019 r., aby utworzyć kompilację i wydanie, które drukuje komunikat "Hello world".

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

Wymagania wstępne

• Własnego agenta systemu Windows.

Inicjowanie repozytorium

Jeśli masz już repozytorium w projekcie, możesz przejść do następnego kroku: Przejdź do dodawania skryptu do repozytorium

1. Przejdź do 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 dolny wybór, aby zainicjować repozytorium za pomocą readme pliku:

   

1. Przejdź do repozytorium, klikając pozycję Kod w górnej nawigacji.

2. Jeśli projekt jest pusty, zostanie wyświetlony ekran, który pomoże Ci dodać kod do repozytorium. Wybierz dolny wybór, aby zainicjować repozytorium za pomocą readme pliku:

   

Dodawanie skryptu do repozytorium

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

1. Przejdź do 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. Przejdź do centrum Kodu .

2. Dodaj plik.

TFS 2018.2

TFS 2018 RTM

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

   HelloWorld.ps1
   

2. Skopiuj i wklej ten skrypt.

   Write-Host "Hello world"
   

3. Zatwierdź (zapisz) plik.

W tym samouczku koncentrujemy się na ciągłej integracji/ciągłego wdrażania, więc utrzymujemy prostą część kodu. Pracujemy w repozytorium Azure Repos Git bezpośrednio w przeglądarce internetowej.

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

Tworzenie potoku kompilacji

Utwórz potok kompilacji, który wyświetla tekst "Hello world".

1. Wybierz pozycję Azure Pipelines. Powinno nastąpić automatyczne przejście do strony Kompilacje .

   

2. Utwórz nowy potok.

   

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

   

   

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

4. Rozpocznij od pustego zadania.

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

6. Po lewej stronie wybierz znak plus ( + ), aby dodać zadanie do zadania 1. Po prawej stronie wybierz kategorię Narzędzia , 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 pozycję Zapisz & kolejkę, a następnie wybierz pozycję Zapisz.

10. Wybierz pozycję Kompilacja i wydanie, a następnie wybierz pozycję Kompilacje.

    

11. Utwórz nowy potok.

    

12. Rozpoczynanie od pustego potoku

13. Wybierz pozycję Potok i określ dowolną nazwę , której chcesz użyć. W polu Pula agentów wybierz pozycję Domyślne.

14. 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.

    

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

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

    

17. Wybierz pozycję Zapisz & kolejkę, a następnie wybierz pozycję Zapisz.

Potok kompilacji to jednostka, za pomocą której definiujesz zautomatyzowany potok kompilacji. W potoku kompilacji należy utworzyć zestaw zadań, z których każdy wykonuje krok w kompilacji. Katalog zadań zawiera bogaty zestaw zadań, które można rozpocząć. 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. Tutaj, aby zademonstrować możliwości w prosty sposób, 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 Publish Build Artifacts (Publikuj artefakty kompilacji ), a następnie wybierz pozycję Dodaj.

   

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

   Nazwa artefaktu: wprowadź .drop

   Lokalizacja publikowania artefaktów: wybierz pozycję Azure Artifacts/TFS.

1. Na karcie Zadania wybierz pozycję Dodaj zadanie.

2. Wybierz kategorię Narzędzie , wybierz zadanie Publish Build Artifacts (Publikuj artefakty kompilacji ), a następnie wybierz pozycję Dodaj.

   

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

   Nazwa artefaktu: wprowadź .drop

   Typ artefaktu: wybierz pozycję Serwer.

Artefakty to pliki, które mają zostać utworzone przez kompilację. Artefakty mogą być niemal wszystkimi elementami, które zespół musi przetestować lub wdrożyć aplikację. Na przykład masz .DLL i .EXE pliki wykonywalne oraz . Plik symboli PDB aplikacji systemu Windows w języku C# lub C++.

Aby umożliwić tworzenie artefaktów, udostępniamy narzędzia, takie jak kopiowanie z dopasowywaniem wzorców i katalog przejściowy, w którym można zebrać artefakty przed ich opublikowaniem. Zobacz Artefakty w usłudze Azure Pipelines.

Włączanie ciągłej integracji (CI)

1. Wybierz kartę Wyzwalacze .

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

Wyzwalacz ciągłej integracji w potoku kompilacji wskazuje, że system powinien automatycznie kolejkować nową kompilację przy każdym zatwierdzeniu zmiany kodu. Wyzwalacz może być bardziej ogólny lub bardziej szczegółowy, a także zaplanować kompilację (na przykład w nocy). Zobacz Wyzwalacze kompilacji.

Zapisywanie i kolejkowanie kompilacji

Zapisywanie i kolejkowanie kompilacji ręcznie i testowanie potoku kompilacji.

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

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

   Spowoduje to dodanie nowej kompilacji do agenta hostowanego przez firmę Microsoft.

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

   

   Wybierz link, aby obejrzeć 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 tekst "Hello world" jest drukowany w konsoli.

   

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

   

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

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

   Spowoduje to dodanie nowej kompilacji do agenta hostowanego przez firmę Microsoft.

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

   

   Wybierz link, aby obejrzeć 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 tekst "Hello world" jest drukowany w konsoli.

   TFS 2018.2

   

   TFS 2018 RTM

   

---

4. Przejdź do podsumowania kompilacji.

   

5. Na karcie Artefakty kompilacji zwróć uwagę, że skrypt jest publikowany jako artefakt.

   

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

Dodawanie niektórych zmiennych i zatwierdzanie zmiany skryptu

Przekażemy kilka zmiennych kompilacji do skryptu, aby uczynić potok nieco bardziej interesującym. Następnie zatwierdzimy zmianę skryptu i zobaczymy, jak potok ciągłej integracji zostanie automatycznie uruchomiony, aby zweryfikować zmianę.

1. Edytuj potok kompilacji.

2. Na karcie Zadania wybierz zadanie skryptu programu PowerShell.

3. Dodaj te argumenty.

TFS 2018.2

TFS 2018 RTM

Argumenty

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

Na koniec zapisz potok kompilacji.

Następnie dodasz argumenty do skryptu.

1. Przejdź do pozycji Pliki w Azure Repos (centrum Kodu w poprzedniej nawigacji i serwerze TFS).

2. Wybierz plik HelloWorld.ps1 , a następnie 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. Zatwierdź (zapisz) skrypt.

Teraz możesz zobaczyć wyniki zmian. Przejdź do pozycji Azure Pipelines i wybierz pozycję Kolejkowane. Zwróć uwagę, że w sekcji Kolejkowana lub uruchomiona kompilacja jest automatycznie wyzwalana przez zatwierdzoną zmianę.

Teraz możesz zobaczyć wyniki zmian. Przejdź do strony Kompilacja i wydanie i wybierz pozycję Kolejkowane. Zwróć uwagę, że w sekcji Kolejkowana lub uruchomiona kompilacja jest automatycznie wyzwalana przez zatwierdzoną zmianę.

1. Wybierz nową kompilację, która została utworzona i wyświetl jej dziennik.

2. Zwróć uwagę, że osoba, która zmieniła kod, ma swoje imię wydrukowane w wiadomości powitającej. Zobaczysz również, że była to kompilacja ciągłej integracji.

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

Masz potok kompilacji. Co dalej?

Utworzono potok kompilacji, który automatycznie kompiluje i weryfikuje kod zaewidencjonowany przez zespół. Na tym etapie możesz przejść do następnej sekcji, aby dowiedzieć się więcej o potokach wydań. Jeśli wolisz, możesz pominąć tworzenie potoku kompilacji dla aplikacji.

Tworzenie potoku wydania

Zdefiniuj proces uruchamiania skryptu na dwóch etapach.

1. Przejdź do karty Potoki , 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. W panelu Artefakty wybierz pozycję + Dodaj i określ źródło (potok kompilacji). Wybierz pozycję Dodaj.

6. Wybierz element 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 etap QA .

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. Dla argumentu Ścieżka skryptu wybierz przycisk, aby przeglądać artefakty i wybrać utworzony skrypt.

12. Dodaj następujące argumenty:

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

13. Na karcie Potok wybierz etap QA i wybierz pozycję Klonuj.

    

14. Zmień nazwę sklonowanego etapu Produkcja.

15. Zmień nazwę potoku wydania Hello world.

    

16. Zapisz potok wydania.

1. Przejdź do karty Kompilacja i wydanie , 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 definicję wydania.

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

4. Nadaj etapowi nazwę QA.

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

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

   TFS 2018.2

   

   TFS 2018 RTM

   

---

7. Wybierz kartę Zadania i wybierz etap QA .

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. Dla argumentu Ścieżka skryptu wybierz przycisk, aby przeglądać artefakty i wybrać utworzony skrypt.

12. Dodaj następujące argumenty:

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

13. Na karcie Potok wybierz etap QA i wybierz pozycję Klonuj.

    

14. Zmień nazwę sklonowanego etapu Produkcja.

15. Zmień nazwę potoku wydania Hello world.

    

16. Zapisz potok wydania.

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

Zwróć również uwagę, że użyliśmy niektórych zmiennych w argumentach skryptu. W tym przypadku użyliśmy zmiennych wydania zamiast zmiennych kompilacji używanych dla potoku kompilacji.

Wdrażanie wydania

Uruchom skrypt na każdym etapie.

1. Utwórz nową wersję.

   

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

2. Otwórz utworzoną wersję.

   

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

   

4. Utwórz nową wersję.

   

   Po wyświetleniu polecenia Utwórz nową wersję wybierz pozycję Utwórz (TFS 2018.2) lub Kolejka (TFS 2018 RTM).

5. Otwórz utworzoną wersję.

   

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

   

Możesz śledzić postęp każdej wersji, aby sprawdzić, czy została wdrożona na wszystkich etapach. Możesz śledzić zatwierdzenia, które są częścią poszczególnych wydań, skojarzonych elementów roboczych i wyników wszystkich przebiegów testów dodanych do potoku wydania.

Zmienianie kodu i automatyczne wdrażanie go w środowisku produkcyjnym

Wprowadzimy jeszcze jedną zmianę skryptu. Tym razem zostanie ona automatycznie skompilowana, a następnie wdrożona do etapu produkcyjnego.

1. Przejdź do centrum Kodu , kartę Pliki , edytuj plik HelloWorld.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. Zatwierdź (zapisz) skrypt.

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

4. Po zakończeniu kompilacji wybierz kartę Wydania , otwórz nową wersję, a następnie przejdź do obszaru Dzienniki.

Nowy kod jest wdrażany automatycznie na etapie QA , a następnie na etapie Produkcja .

W wielu przypadkach prawdopodobnie chcesz edytować potok wydania, tak aby wdrożenie produkcyjne odbywało się dopiero po zakończeniu niektórych testów i zatwierdzeń. Zobacz Omówienie zatwierdzeń i bram.

Następne kroki

Wiesz już, jak utworzyć pierwszy potok na platformie Azure. Dowiedz się więcej na temat konfigurowania potoków w wybranym języku:

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

Możesz też kontynuować dostosowywanie właśnie utworzonego potoku .

Aby uruchomić potok w kontenerze, zobacz Zadania kontenera.

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

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

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

Czyszczenie

Jeśli utworzono potoki testowe, można je łatwo usunąć po zakończeniu pracy z nimi.

Przeglądarka

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

Interfejs wiersza polecenia usługi Azure DevOps

Aby usunąć potok przy użyciu interfejsu wiersza polecenia platformy Azure, możesz użyć polecenia az pipeline delete . To polecenie wymaga id usunięcia potoku, który można uzyskać za pomocą polecenia az pipeline list .

Wyświetlanie listy potoków | Usuwanie potoku | Przykład

Uwaga

Jeśli używasz poleceń az pipelines po raz pierwszy, zobacz Wprowadzenie do interfejsu wiersza polecenia usługi Azure DevOps.

Wyświetlanie listy potoków

Możesz wyświetlić listę potoków za pomocą polecenia az pipelines list .

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]

Parametry

• wykryj: Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true
• ścieżka-folderu: jeśli określono, filtruje definicje w tym folderze.
• name: Ogranicz wyniki do potoków o tej nazwie lub zaczynając od tej nazwy. Przykłady: "FabCI" lub "Fab*".
• organizacja lub organizacja: adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=ORG_URL. Wymagana, jeśli nie została skonfigurowana jako domyślna lub odebrana za pośrednictwem konfiguracji usługi Git. Przykład: https://dev.azure.com/MyOrganizationName/.
• projekt lub p: nazwa lub identyfikator projektu. Domyślny projekt można skonfigurować przy użyciu polecenia az devops configure -d project=NAME_OR_ID. Wymagana, jeśli nie została skonfigurowana jako domyślna lub odebrana za pośrednictwem konfiguracji usługi Git.
• query-order: Kolejność wyników. Zaakceptowane wartości: ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None
• Repozytorium: ogranicz wyniki do potoków skojarzonych z tym repozytorium.
• Typ repozytorium: ogranicz wyniki do potoków skojarzonych z tym typem repozytorium. Należy przekazać argument repozytorium wraz z tym argumentem. Akceptowane wartości: bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol
• top: Maksymalna liczba potoków do wyświetlenia.

Usuwanie potoku

Potok można usunąć za pomocą polecenia az pipelines delete .

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

Parametry

• id: (Wymagany) identyfikator potoku.
• wykryj: Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true
• organizacja lub organizacja: adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=ORG_URL. Wymagana, jeśli nie została skonfigurowana jako domyślna lub odebrana za pośrednictwem konfiguracji usługi Git. Przykład: https://dev.azure.com/MyOrganizationName/.
• projekt lub p: nazwa lub identyfikator projektu. Domyślny projekt można skonfigurować przy użyciu polecenia az devops configure -d project=NAME_OR_ID. Wymagana, jeśli nie została skonfigurowana jako domyślna lub odebrana za pośrednictwem konfiguracji usługi Git.
• Tak lub y: nie monituj o potwierdzenie.

Przykład

Poniższy przykład zawiera listę potoków w formacie tabeli, a następnie usuwa potok o identyfikatorze 6. W tym przykładzie użyto następującej konfiguracji domyślnej: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

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.

Znasz już podstawy tworzenia i uruchamiania potoku. Teraz możesz skonfigurować potok kompilacji dla używanego języka programowania. Przejdź do przodu i utwórz nowy potok kompilacji, a tym razem użyj jednego z następujących 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 przeczytać artykuły dotyczące metodyki DevOps i ciągłej integracji/ciągłego wdrażania?

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 ciągłej integracji/ciągłego wdrażania dla aplikacji, możesz użyć wybranego systemu kontroli wersji:

• Klienci

  • 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 GitHub i Bitbucket Cloud
  • Subversion

• Klienci

  • 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
  • Program Visual Studio z Kontrola wersji serwera Team Foundation
  • Eclipse
  • Xcode
  • Intellij
  • Wiersz polecenia

• Usługi

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

Jak mogę replikować potok?

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

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

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

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

Porada

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

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ą.

Możesz edytować i testować wersję roboczą zgodnie z potrzebami.

Gdy wszystko będzie gotowe, możesz opublikować wersję roboczą, aby scalić zmiany w potoku kompilacji.

Lub jeśli zdecydujesz się odrzucić wersję roboczą, możesz usunąć ją z karty Wszystkie potoki pokazanej powyżej.

Jak mogę usunąć potok?

Aby usunąć potok, przejdź do strony podsumowania dla tego potoku, a następnie wybierz polecenie 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 kolejkuję kompilację?

Kompilacje można kolejkować automatycznie lub ręcznie.

W przypadku ręcznego kolejkowania kompilacji można wykonać pojedynczy przebieg kompilacji:

• Określ pulę , do której przechodzi kompilacja.

• Dodaj i zmodyfikuj niektóre zmienne.

• Dodawanie żądań.

• W repozytorium Git

  • Utwórz gałąź lub tag.

  • Skompiluj zatwierdzenie.

• W repozytorium Kontrola wersji serwera Team Foundation

  • Określ wersję źródłową jako etykietę lub zestaw zmian.

  • Uruchamianie prywatnej kompilacji zestawu na półce. (Możesz użyć tej opcji w agencie hostowanym przez firmę Microsoft lub własnym agencie).

Kompilacje można kolejkować automatycznie lub ręcznie.

W przypadku ręcznego kolejkowania kompilacji można wykonać pojedynczy przebieg kompilacji:

• Określ pulę , do której przechodzi kompilacja.

• Dodaj i zmodyfikuj niektóre zmienne.

• Dodawanie żądań.

• W repozytorium Git

  • Utwórz gałąź lub tag.

  • Skompiluj zatwierdzenie.

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

Aby dowiedzieć się więcej o ustawieniach potoku kompilacji, zobacz:

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

Aby dowiedzieć się więcej o ustawieniach potoku, zobacz:

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

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 poziomu wiersza polecenia lub skryptów przy użyciu interfejsu wiersza polecenia usługi Azure Pipelines.