Konfigurowanie potoków usługi ALM Accelerator
Potoki to aparaty akceleratora ALM Accelerator. Automatyzują proces ALM dla Power Platform. Są one zbudowane przy użyciu potoków Azure Pipelines, usługi Azure DevOps oraz są przechowywane w projekcie Azure DevOps.
Cztery główne potoki są używane do zautomatyzowania procesu ALM:
- Import
- Export
- Delete
- Build/Deploy
Potoki zostały zaprojektowane tak, aby można je było używać z aplikacją ALM Accelerator. Nie musisz z tej aplikacji korzystać, ale ją zalecamy. Ta aplikacja udostępnia prosty interfejs do inwertowania potoków oraz sposobu konfigurowania ich bez konieczności zrozumienia podstawowych parametrów.
Typowe scenariusze potoku akceleratora ALM Accelerator
Potoki i aplikacja Akcelerator ALM mają domyślne konfiguracje, które pozwalają szybko rozpocząć pracę z programem ALM dla oprogramowania Power Platform. Mogą one obejmować wiele różnych scenariuszy ALM spełniających wymagania organizacji. W poniższych sekcjach przedstawiono typowe scenariusze oraz sposób, w jaki mogą one zostać uwzględnione w konfiguracji potoku, profilach wdrażania i krokach w aplikacji ALM Accelerator lub bezpośrednio przy użyciu potoku.
Instalowanie potoków w jednym projekcie i kod źródłowy w innym projekcie
W aplikacji ALM Accelerator oraz w profilach wdrażania można określić projekt potoku i projekt źródłowy. Opcja w kreatorze konfiguracji umożliwiająca określenie oddzielnego projektu potoku i ponownego uruchomienia. Opcje te są przydatne, jeśli trzeba segmentować magazyn rozwiązań na podstawie użytkowników, struktury firmowej lub innych czynników. W większości przypadków pliki YAML potoku są przechowywane w projekcie potoku, a potoki eksportu, importu i usuwania są tworzone w projekcie, w którym rozwiązanie jest kontrolowane przez źródło.
Uruchamianie potoków bez akceleratora ALM Accelerator
Kanwa akceleratora ALM Accelerator umożliwia łatwe w obsłudze przyciski służące do uruchamiania potoków. Nie jest jednak potrzebna aplikacja do ich uruchamiania. Jeśli chcesz używać potoków niezależnie od aplikacji, uruchom je bezpośrednio z wiersza polecenia. Możesz także utworzyć własną aplikację. Użyj niestandardowego łącznika interfejsu API Azure DevOps zawartego w rozwiązaniu ALM Accelerator, aby wywoływać potoki Power Automate przy użyciu lub innych technologii Power Platform.
W obu przypadkach, jeśli chcesz samodzielnie korzystać z potoków, najważniejsze jest zrozumienie kluczowych parametrów, które są do nich przekazywane.
Parametry potoku
Parametry importu niezarządzanego do środowiska deweloperskiego: użyj potoku importu rozwiązania, aby zaimportować rozwiązanie niezarządzane z kontroli źródła do środowiska programistycznego.
W poniższej tabeli opisano parametry potoku importu.
| Parametr | Przykład | opis |
|---|---|---|
| Project | Mój projekt Azure DevOps | Nazwa projektu, do który ma zaimportować rozwiązanie |
| Repozytorium | Moje repozytorium Azure DevOps | Nazwa repozytorium, z którego ma zostać zaimportowane rozwiązanie |
| Nazwa rozwiązania | MySolutionName | Nazwa rozwiązania do importu |
| me@example.com | Adres e-mail użytkownika importującego rozwiązanie | |
| UserName | Ostatnia, Pierwsza | Nazwa użytkownika importującego rozwiązanie |
| Oddział | main | Odgałęzienie w celu budowy rozwiązania i zaimportowania z systemu |
| ServiceConnectionName | MyServiceConnection | Nazwa połączenia usługi do użycia podczas importu |
| ServiceConnectionUrl | example.crm.dynamics.com | Adres URL środowiska twórców dla importu |
| NazwaŚrodowiska | MyDevEnvironment | Użyte do znalezienia ustawień wdrażania w potoku wdrożenia; zwraca nazwę folderu pod katalogiem konfiguracyjnym w źródle rozwiązania |
Parametry delete-unmanaged-solution-and-components: Użyj potoku usuwania rozwiązania, aby usunąć rozwiązanie niezarządzane i wszystkie jego składniki ze środowiska programistycznego.
W poniższej tabeli opisano parametry potoku usuwania.
| Parametr | Przykład | opis |
|---|---|---|
| Nazwa rozwiązania | MySolutionName | Nazwa rozwiązania do usunięcia |
| ServiceConnectionName | MyServiceConnection | Nazwa połączenia usługi, które ma zostać użyte do usunięcia rozwiązania |
| ServiceConnectionUrl | example.crm.dynamics.com | Adres URL środowiska twórców dla rozwiązania do usunięcia |
Parametry export-solution-to-git: Użyj potoku eksportu rozwiązania, aby wyeksportować rozwiązanie do repozytorium Git.
W poniższej tabeli opisano parametry potoku eksportu.
| Parametr | Przykład | opis |
|---|---|---|
| Project | Mój projekt Azure DevOps | Nazwa projektu, do którego ma zostać wyeksportowany kod źródłowy rozwiązania |
| Repozytorium | Moje repozytorium Azure DevOps | Nazwa repozytorium, do którego mogła zostać wyeksportowana kod źródłowy rozwiązania |
| Nazwa rozwiązania | MySolutionName | Nazwa rozwiązania do wyeksportowania |
| me@example.com | Adres e-mail użytkownika eksportującego rozwiązanie | |
| UserName | Ostatnia, Pierwsza | Nazwa użytkownika eksportującego rozwiązanie |
| CommitMessage | Poprawki błędów #1234 | Opis zmian, które mają być przechowywane w repozytorium |
| Oddział | main | Albo odgałęzienie źródłowe, aby utworzyć odgałęzienie, albo istniejące odgałęzienie do zatwierdzenia |
| BranchToCreate | feature-1234 | Unikatowa nazwa nowego odgałęzienia do utworzenia na podstawie parametru Branch, jeśli jest to konieczne |
| ServiceConnectionName | MyServiceConnection | Nazwa połączenia usługi, które ma być użyte do eksportu rozwiązania |
| ServiceConnectionUrl | example.crm.dynamics.com | Adres URL środowiska twórców, dla którego istnieje niezarządzane rozwiązanie do wyeksportowania |
| Dane | [Ustawienia wdrażania JSON] | Ciąg JSON zawierający ustawienia wdrożenia do użycia w przypadku eksportowania i konfigurowania potoków wdrażania |
| PortalSiteName | MyPortalSite | Nazwa witryny sieci Power Pages skojarzonej z eksportowaym rozwiązaniem |
Dostosowywanie wersji rozwiązań, gdy do ich eksportowania lub wdrażania są stosowane potoki akceleratora ALM Accelerator
Domyślnie eksportowane i wdrażane rozwiązania są wersje przy użyciu nazwy określonej w pliku potoku wdrożenia pliku YAML. Jednak potoki ALM Accelerator pozwalają na dostosowanie wersji rozwiązania podczas jego eksportu lub wdrażania. W poniższych sekcjach opisano metody, których można użyć.
Eksportowane przechowywanie wersji
Użyj numeru wersji wyeksportowanego przez potoki jako numeru wersji we wszystkich środowiskach wdrożonych. Utwórz zmienną o nazwie UseSolutionVersionFromDatasize w potoku eksportu lub zmienną globalną w bibliotece zmiennej dla akceleratora ALM Accelerator. Nadaj mu wartość Prawda. Zmienna zapewnia, że numer wersji wyeksportowany w rozwiązaniu został zachowane w środowiskach down następnie i jest odzwierciedlany w kontrolce źródłowej podczas zaangażowania źródła rozwiązania.
Niestandardowa logika numerowania wersji
Do ustawienia wersji rozwiązania można użyć oprogramowania ALM Accelerator. Dodaj logikę niestardardową do szablonu build-solution-pack-pre-hook.yml, by manipulować Solution.xmlbezpośrednio lub przy użyciu innych narzędzi, jak wersja rozwiązania pac.
Niestandardowe wersje szablonów własnych
Możliwość tworzenia własnych szablonów w celu generowania potoków wdrażania zapewnia elastyczność podczas pierwszego eksportowania rozwiązania. Na przykład można utworzyć kopię build-deploy-validation/test/prod-SampleSolution.yml i zmienić nazwę kompilacji z domyślnej na strategię numerowania wersji na podstawie skonfigurowanych numerów uruchomienia lub kompilacji:
build:
- name: 1.0.$(Date:yyyyMMdd)$(Rev:.r)
...
Po zakończeniu instalacji szablonów należy zaktualizować kroki wdrożenia w profilu wdrażania, tak aby je wskazać.
Dostosowywanie liczby kroków wdrażania w potokach i nazw środowisk docelowych
Podobnie do przechowywania wersji w szablonach, możliwość tworzenia własnych szablonów w celu generowania potoków wdrażania zapewnia elastyczność podczas pierwszego eksportowania rozwiązania. Określ projekt, w którym istnieją szablony, i ścieżkę do szablonu, który ma być użycia do wygenerowania potoku wdrożenia. Ustawienia projektu i ścieżki są dostępne w profilu wdrażania i tabeli Kroki wdrażania w aplikacji administracyjnej ALM Accelerator.
Ścieżka do szablonu jest względna w stosunku do głównej lokalizacji rurociągu eksportowego. Na przykład można ścieżkę do domyślnych szablonów potoku wdrożenia środowiska sprawdzania poprawności /Pipelines/build-deploy-validation-SampleSolution.yml. Aby użyć szablonu w tym samym projekcie, co w przypadku eksportu, określ ścieżkę jako/Pipelines/build-deploy-validation-MyCustomTemplate.yml.
W poniższej tabeli opisano symbole zastępcze w szablonach dla wartości specyficznych dla rozwiązania, które są zastępowane podczas generowania potoku wdrożenia.
| Symbol zastępczy | opis |
|---|---|
| SampleSolutionName | Nazwa rozwiązania, które ma zostać wdrożone |
| RepositoryContainingTheBuildTemplates | Repozytorium zawierające szablony budowania, które mają być używane w potoku wdrożeniowym |
| BranchContainingTheBuildTemplates | Gałąź zawierająca szablony budowania, które mają być używane w potoku wdrażania |
| alm-accelerator-variable-group | Globalna grupa zmiennych szablony kompilacji używają szablonów kompilacji dla potoku wdrożenia |
Zaleca się skopiowanie szablonu potoku build-deploy-validation/test/prod-SampleSolution.yml w celu rozpoczęcia pracy z własnym szablonem niestandardowym.
Wykonywanie niestandardowych kroków w potokach bez modyfikowania szablonów domyślnych
Szablony potoku accelerator ALM Accelerator mają kilka punktów rozszerzeń (czyli plików potoku) mogą zostać użyć do dostosowania potoków, minimalizując zakłócenia ze względu na konflikty podczas uaktualniania. Dowiedz się więcej o punktach zaczepienia akceleratora ALM.
Włączanie i wyłączanie określonych akcji w potokach
Potoki używają zmiennych do określenia, czy zadanie powinno być wykonywane, czy też powinno być wykonywane o wielu możliwościach. W poniższej tabeli przedstawiono zmienne, które można ustawić dla poszczególnych potoków lub — za pośrednictwem grupy zmiennych (alm-accelerator-variable-group) — wszystkie potoki.
Uwaga
Aby ustawić te zmienne dla określonych rozwiązań w odniesieniu do eksportu, należy utworzyć określony potok eksportu na podstawie szablonu potoku eksportu. Nazwij go export-solution-to-git-{SolutionName}. Aplikacja ALM Accelerator używa tej potoku eksportu dla rozwiązania, a nie ogólnego zastosowania w przypadku eksportu rozwiązania do potoku.
| Zmienna | Wartość domyślna | Potoki | opis |
|---|---|---|---|
| GenerateDeploymentSettings | Prawda | Export | Jeśli wartość to fałsz, ustawienia wdrożenia nie są generowane i przechowywane w kontrolce źródłowej. |
| UseDeploymentSettingsPlaceholders | Prawda | Export | Jeśli wartość jest fałsz, ustawienia wdrożenia nie używają symboli zastępczych, a wszystkie wartości ustawień wdrożenia są zapisywane w plikach deploymentSettings.json i customDeploymentSettings.json.WAŻNE: Informacje poufne mogą być zapisywane w postaci zwykłego tekstu w ustawieniach wdrożenia. Każdy użytkownik, który ma dostęp do formantu źródłowego, może odczytać te wartości. Należy zadbać o ustawienie wartości tej zmiennej. |
| DisableFlows | Fałsz | Export | Jeśli prawda, wszystkie przepływy są wyłączone w nierozpakowanym kodzie źródłowym przed zatwierdzeniem. |
| UseSolutionVersionFromDataverse | Fałsz | Export | Jeśli prawda, numer wersji wyeksportowany w rozwiązaniu jest zachowywany w środowiskach do klienta. Numer wersji jest odzwierciedlany w kontrolce źródłowej w momencie, gdy źródło rozwiązania zostanie zatwierdzone. |
| DoNotExportCurrentEnvironmentVariableValues | Fałsz | Export | Jeśli prawda, wartości zmiennych dla bieżącego środowiska są usuwane z kodu źródłowego dla nierozpakowanego rozwiązania. |
| PublishCustomizationsBeforeExport | Prawda | Export | Jeśli te informacje są fałsz, dostosowania nie są publikowane przed wyeksportowaniem rozwiązania. Ta opcja jest przydatna w przypadku pracy w środowisku udostępnianym i umożliwia wyeksportowanie najnowszych opublikowanych dostosowań. |
| CacheEnabled | Prawda | Eksportowanie/wdrażanie | Jeśli wartość false jest wyłączona, buforowanie modułów programu PowerShell jest wyłączone. Ta opcja jest przydatna w przypadku, gdy potoki wykonają oczyszczanie katalogu pamięci podręcznej po wykonaniu potoków. |
| ProcessCanvasApps | Prawda | Eksportowanie/wdrażanie | Jeśli wartość to Fałsz, aplikacje kanwy nie będą rozpakowywane podczas eksportu ani pakowane podczas kompilacji. UWAGA: Funkcja rozpakowywania i pakowania płótna jest obecnie dostępna w wersji zapoznawcza. W tej chwili nie zaleca się używania ich w środowiskach produkcyjnych. Nie można jednak wyświetlić kodu źródłowego kanw w kontrolce źródłowej, chyba że ta zmienna zostanie ustawiona na Prawda. |
| DisableSolutionChecker | Fałsz | Wdrażaj | Jeśli to prawda, sprawdzanie rozwiązania nie jest uruchomione dla każdej kompilacji zainicjowanej za pomocą żądania pull. |
| SkipSolutionImport | Fałsz | Wdrażaj | Jeśli wartością jest Prawda, krok importu rozwiązania jest pominięciem podczas wdrażania. Jednak inne działania, takie jak aktywacja przepływu i udostępnianie, nadal będą wykonywane. |