Wstępne wypełnianie odwołań do połączeń i zmiennych środowiskowych dla zautomatyzowanych wdrożeń

Artykuł
08/08/2023

Odwołania do połączeń i zmienne środowiskowe umożliwiają interaktywne określanie szczegółów połączenia i ustawień konfiguracji specyficznych dla środowiska docelowego, w którym wdrożono aplikację lub rozwiązanie.

Więcej informacji:

Po zaimportowaniu rozwiązania zawierającego referencje połączeń i informacje o zmiennych środowiskowych, w interfejsie użytkownika wyświetlany jest monit o podanie informacji specyficznych dla danego środowiska. Jednak wprowadzanie tych informacji nie działa dobrze w przypadku w pełni zautomatyzowanych scenariuszy ciągłej integracji / ciągłego dostarczania (CI/CD).

Aby umożliwić w pełni zautomatyzowane wdrożenie, można teraz wstępnie wypełnić referencje połączeń i informacje o zmiennych środowiskowych specyficznych dla środowiska docelowego, dzięki czemu nie trzeba ich podawać interaktywnie po zaimportowaniu rozwiązania.

Plik ustawień rozmieszczenia

Aby wstępnie wypełnić referencję połączenia i informacje o zmiennych środowiskowych dla wdrożenia, należy użyć pliku ustawień wdrożenia (JSON) do przechowywania informacji i przekazać je jako parametr podczas importowania rozwiązania za pomocą narzędzi Power Platform Build Tools. Możesz przechowywać plik JSON w swoim systemie kontroli źródeł, aby go aktualizować i zarządzać nim zgodnie z wymaganiami Twojej organizacji.

Poniżej znajduje się przykład pliku ustawień wdrożenia:

{
  "EnvironmentVariables": [
    {
      "SchemaName": "tst_Deployment_env",
      "Value": ""
    },
    {
      "SchemaName": "tst_EnvironmentType",
      "Value": ""
    }
  ],
  "ConnectionReferences": [
    {
      "LogicalName": "tst_sharedtst5fcreateuserandjob5ffeb85c4c63870282_b4cc7",
      "ConnectionId": "",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_tst-5fcreateuserandjob-5ff805fab2693f57dc"
    },
    {
      "LogicalName": "tst_SharepointSiteURL",
      "ConnectionId": "",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline"
    },
    {
      "LogicalName": "tst_AzureDevopsConnRef",
      "ConnectionId": "",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_visualstudioteamservices"
    },
    {
      "LogicalName": "tst_GHConn",
      "ConnectionId": "",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_github"
    }
  ]
}

W powyższym przykładzie pliku JSON, wartości pokazane jako "" są brakujące i będą musiały zostać uzupełnione. Zajmiemy się tym w dalszej części artykułu.

Krok 1: Generowanie pliku ustawień wdrażania

Plik ustawień wdrażania może być generowany przy użyciu CLI Power Platform. Plik ten można wygenerować podczas eksportowania lub klonowania rozwiązania.

Opcja 1: Wygenerowanie pliku z ustawieniami obrazu stanowiska za pomocą właściwości create-settings

Możesz korzystać z właściwości create-settings z CLI Power Platform:

C:\> pac solution create-settings --solution-zip <solution_zip_file_path> --settings-file <settings_file_name>

To polecenie wygeneruje plik JSON, jak pokazano poniżej.

W pliku JSON kilka wartości jest pustych w sekcji ConnectionReferences. Te wartości należy zebrane po utworzeniu ich w środowisku docelowym.

Opcja 2: Wygenerowanie pliku ustawień stanowiska poprzez klonowanie rozwiązania

Klon rozwiązania projektu jest potrzebny do tego kroku, ponieważ renderuje on oryginalne rozwiązanie do formatu nadającego się do budowania. Po sklonowaniu rozwiązania za pomocą CLI Power Platform, na Twoim komputerze zostanie utworzona następująca struktura katalogów:

Przejdź do tworzenia pliku ustawień w kontekście bieżącego folderu i wypełnij wartość pliku ustawień, jak pokazano poniżej.

Krok 2: Uzyskaj odniesienie do połączenia i informacje o zmiennych środowiskowych

Aby wypełnić plik ustawień obrazu stanowiska, należy uzyskać informacje o referencji połączenia i zmiennych środowiskowych rozwiązania docelowego.

Uzyskiwanie informacji o odwołaniach do połączenia

Aby uzyskać identyfikator połączenia w środowisku docelowym, użyj jednego z poniższych sposobów:

Zaloguj się do Power Apps i wybierz środowisko docelowe. W lewym panelu nawigacji wybierz Dane>Połączenia, wybierz połączenie, dla którego chcesz uzyskać identyfikator połączenia, a następnie spójrz na adres URL, aby uzyskać identyfikator połączenia.
Tworzenie aplikacji kanwy w encji odwołania do połączenia. Kroki tego procesu są następujące:
1. Zaloguj się do Power Apps i wybierz środowisko docelowe.
2. W lewym okienku nawigacji wybierz pozycję Aplikacje, a następnie wybierz Nowa aplikacja>Kanwa.
3. Wybierz Dataverse jako źródło danych.
4. Wybierz tabelę Odwołania do połączeń i wybierz opcję Połącz.
5. Spowoduje to utworzenie aplikacji galerii, która wyświetli listę wszystkich połączeń i ich identyfikatorów w środowisku.

Pobierz informacje o zmiennej środowiska

Aby uzyskać wartości zmiennej środowiskowej w środowisku docelowym, zaloguj się do Power Apps i wybierz środowisko docelowe, kliknij prawym przyciskiem myszy na elipsę i wybierz opcję edycji. Dostarczy to informacji potrzebnych do wypełnienia pliku ustawień obrazu stanowiska (wartości podkreślone są wartościami wymaganymi w pliku):

Wartości zmiennych środowiska w środowisku docelowym

W przeciwnym razie można podać odpowiednią wartość dla środowiska docelowego na podstawie posiadanej wiedzy o tym środowisku.

Krok 3: Zaktualizuj wartości w pliku ustawień obrazu stanowiska

Ręcznie edytuj plik ustawień obrazu stanowiska (JSON), aby odpowiednio dodać informacje o połączeniu i zmiennych środowiskowych. Poniżej znajduje się przykładowy plik ustawień z dodanymi (wcześniej) brakującymi wartościami.

{
  "EnvironmentVariables": [
    {
      "SchemaName": "tst_Deployment_env",
      "Value": "Test"
    },
    {
      "SchemaName": "tst_EnvironmentType",
      "Value": "UAT"
    }
  ],
  "ConnectionReferences": [
    {
      "LogicalName": "tst_sharedtst5fcreateuserandjob5ffeb85c4c63870282_b4cc7",
      "ConnectionId": "4445162937b84457a3465d2f0c2cab7e",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_tst-5fcreateuserandjob-5ff805fab2693f57dc"
    },
    {
      "LogicalName": "tst_SharepointSiteURL",
      "ConnectionId": "ef3d1cbb2c3b4e7987e02486584689d3",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline"
    },
    {
      "LogicalName": "tst_AzureDevopsConnRef",
      "ConnectionId": "74e578ccc24846729f32fcee83b630de",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_visualstudioteamservices"
    },
    {
      "LogicalName": "tst_GHConn",
      "ConnectionId": "d8beb0fb533442c6aee5c18ae164f13d",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_github"
    }
  ]
}

Krok 4: Użyj pliku ustawień obrazu stanowiska dla zadań narzędzia Build Tools

Przekazanie pliku z ustawieniami instalacji jako parametru podczas importowania rozwiązania do środowiska docelowego. Spowoduje to utworzenie wymaganych referencji połączeń i środowisk z odpowiednimi wartościami podczas importu bez konieczności interaktywnego określania wartości przez użytkownika.

W przypadku korzystania z zadania Importuj rozwiązanie w narzędziach budowania Power Platform, wybierz opcję Użyj pliku ustawień stanowiska i podaj ścieżkę do pliku ustawień stanowiska. Następnie należy zainicjować potok.

Sprawdzanie poprawności

Podczas importowania rozwiązania odwołania do połączenia są sprawdzane, aby zagwarantować, że połączenia umieszczone w nich będą używane przez właściciela odwołania do połączenia. Upewnij się, że właścicielem połączeń jest właściciel odwołań do połączenia lub czy połączenia są udostępnione.

Zobacz też

Co to jest Microsoft Power Platform CLI?
Microsoft Power Platform Zadania narzędzi kompilacji

Udostępnij za pośrednictwem