Udostępnij za pośrednictwem

Migrowanie klasycznego potoku do języka YAML

  • Artykuł

Azure DevOps Services

Rozpocznij pracę z usługą Azure Pipelines, konwertując istniejący potok klasyczny na użycie kodu YAML. Za pomocą potoku opartego na języku YAML możesz zaimplementować strategię ciągłej integracji/ciągłego wdrażania jako kod i zobaczyć jego historię, porównać wersje, obwiniać, dodawać adnotacje itd.

Podczas konwertowania potoku klasycznego produkt końcowy to dwa potoki. Będziesz mieć jeden nowy potok YAML i klasyczny potok, który można wycofać. Historia uruchamiania klasycznego potoku pozostaje w potoku klasycznym.

Notatka

Plik YAML można wyeksportować tylko z istniejącego potoku klasycznego utworzonego za pomocą klasycznego projektanta kompilacji. Jeśli nie widzisz opcji eksportowania do formatu JSON lub YAML, oznacza to, że twój pipeline nie obsługuje eksportowania. Potoki wydania klasycznego nie mają opcji eksportu do języka YAML. Możesz wyeksportować klasyczny potok wydania, eksportując każde zadanie.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że masz następujące elementy.

  • Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
  • Aktywna organizacja usługi Azure DevOps. Utwórz konto w usłudze Azure Pipelines.
  • Potok roboczy korzystający z klasycznego edytora interfejsu użytkownika.
  • Przykładowy plik potoku YAML w kodzie. Utwórz przykładowy potok YAML w poniższej sekcji.

Tworzenie przykładowego potoku YAML

Wykonaj poniższe kroki, aby utworzyć przykładowy potok YAML, który zostanie zaktualizowany później przy użyciu wyeksportowanego kodu z klasycznego edytora interfejsu użytkownika.

  1. Zaloguj się do organizacji (https://dev.azure.com/{yourorganization}) i wybierz projekt.

  2. Wybierz pozycję Potoki, a następnie pozycję Nowy potok.

    Dwa przyciski do wybrania w celu utworzenia nowego potoku.

  3. Wybierz lokalizację kodu źródłowego jako GitHub lub Azure Repos Git.

    Lista możliwych wyborów dla kodu źródłowego.

  4. Wybierz repozytorium.

    Strona, na której wybierasz repozytorium dla potoku kodu źródłowego.

  5. Na stronie Konfigurowanie potoku wybierz pozycję Potok startowy.

    Lista szablonów do wyboru podczas konfigurowania nowego potoku.

  6. Wybierz pozycję Zapisz i uruchom.

    Przejrzyj stronę, na której wybierzesz pozycję Zapisz i uruchom.

  7. Wprowadź komunikat zatwierdzenia, wybierz pozycję Zatwierdź bezpośrednio w gałęzi głównej, a następnie wybierz pozycję Zapisz i uruchom ponownie. Zostanie uruchomiony nowy przebieg, który zostanie zatwierdzony w repozytorium. Poczekaj na zakończenie przebiegu.

    Zatwierdź komunikat, aby zatwierdzić gałąź główną, a następnie wybierz przycisk Zapisz i uruchom.

Eksportowanie potoku klasycznego

Wykonaj następujące kroki, aby wyeksportować potok klasyczny do pliku YAML, którego można użyć w edytorze.

  1. Przejdź do pozycji Potoki potoków>.

  2. Otwórz potok klasyczny w klasycznym projektancie kompilacji.

  3. Wybierz wielokropek (...), a następnie wybierz pozycję Eksportuj do YAML.

    Zrzut ekranu przedstawiający menu kontekstowe w celu wyeksportowania potoku do języka YAML.

  4. Otwórz pobrany plik YAML w edytorze kodu.

  5. Jeśli potok YAML zawiera zmienne zdefiniowane w klasycznym interfejsie użytkownika, zdefiniuj zmienne ponownie w interfejsie użytkownika ustawień potoku lub w pliku YAML. Aby uzyskać więcej informacji, zobacz Definiowanie zmiennych.

  6. Przejrzyj wszystkie cron harmonogramy w pliku YAML. Domyślnie cron harmonogramy w języku YAML są w formacie UTC. W potokach klasycznych znajdują się one w strefie czasowej organizacji. Aby uzyskać więcej informacji, zobacz Konfigurowanie harmonogramów dla potoków.

  7. Użyj Asystenta zadań, aby wprowadzić inne zmiany w pliku YAML. Asystent zadań to okienko po prawej stronie ekranu, które ułatwia prawidłowe tworzenie i modyfikowanie kroków YAML.

    Skonfiguruj zadanie potoku za pomocą Asystenta zadań.

  8. Zapisz i uruchom potok.

Czyszczenie zasobów

Jeśli nie zamierzasz już używać tego przykładowego potoku, usuń go z projektu. Usunięcie jest trwałe i obejmuje wszystkie kompilacje i skojarzone artefakty.

  1. Wybierz wielokropek (...) i wybierz pozycję Usuń.

  2. Wprowadź nazwę potoku, aby trwale go usunąć, a następnie wybierz pozycję Usuń.

Często zadawane pytania

Czy w potokach YAML istnieje zadanie tworzenia elementów roboczych w przypadku niepowodzenia kompilacji?

Potoki YAML nie mają ustawienia Tworzenie elementu roboczego dla błędu, takiego jak klasyczne potoki kompilacji. Masz kilka opcji samodzielnego tworzenia tej funkcji.

Następne kroki

Dowiedz się więcej o różnicach funkcji między potokami YAML i klasycznymi.

Korzystanie z usługi Azure Pipelines