Předvyplnění odkazů na připojení a proměnné prostředí pro automatizovaná nasazení

Článek
08/09/2023

Odkazy na připojení a proměnné prostředí vám umožní interaktivně specifikovat podrobnosti připojení a nastavení konfigurace specifické pro cílové prostředí, kde je nasazena vaše aplikace nebo řešení.

Další informace:

Po importu řešení obsahujícího odkaz na připojení a proměnné prostředí budete vyzváni k zadání informací specifických pro vaše prostředí v uživatelském rozhraní. Zadávání těchto informací však nefunguje dobře u plně automatizovaných scénářů průběžné integrace/ průběžného doručování (CI/CD).

Chcete-li aktivovat plně automatizované nasazení, můžete nyní předvyplnit odkaz na připojení a proměnné prostředí specifické pro cílové prostředí, abyste je po importu řešení nemuseli interaktivně poskytovat.

Soubor s nastavením nasazení

Chcete-li předem vyplnit odkaz na připojení a proměnné prostředí pro vaše nasazení, uložte tyto informace do souboru s nastavením nasazení (JSON) a předejte jej jako parametr při importu řešení pomocí Power Platform Build Tools. Soubor JSON můžete uložit do svého systému správy zdrojovýdch kódů, abyste jej mohli aktualizovat a spravovat podle požadavků vaší organizace.

Níže je uveden příklad souboru s nastavením nasazení:

{
  "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"
    }
  ]
}

Ve výše uvedeném příkladu chybí v souboru JSON hodnoty zobrazené jako "" a budou muset být vyplněny. Tomu se budeme věnovat později v tomto článku.

Krok 1: Vygenerujte soubor s nastavením nasazení

Soubor s nastavením nasazení lze vygenerovat z rozhraní příkazového řádku Power Platform. Soubor můžete vygenerovat při exportu nebo klonování řešení.

Možnost 1: Vygenerujte soubor s nastavením nasazení pomocí vlastnosti create-settings

Vlastnost create-settings použijte v rozhraní příkazového řádku Power Platform:

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

Tento příkaz vygeneruje soubor JSON, jak je ukázáno níže.

V souboru JSON je prázdných několik hodnot v sekci ConnectionReferences. Tyto hodnoty je třeba načíst po jejich vytvoření v cílovém prostředí.

Možnost 2: Vygenerujte soubor s nastavením nasazení klonováním řešení

Pro tento krok potřebujete klon řešení projektu, který zformuje původní řešení do sestavitelného formátu. Po naklonování řešení pomocí rozhraní příkazového řádku Power Platform budete mít ve svém počítači vytvořenu následující adresářovou strukturu:

Pokračujte vytvořením souboru s nastavením v kontextu aktuální složky a naplňte hodnotu souboru s nastavením, jak je ukázáno níže.

Krok 2: Získání odkazu na připojení a proměnné prostředí

K naplnění souboru s nastavením nasazení budete potřebovat získat odkaz na připojení a proměnnou prostředí cílového řešení.

Získání odkazu na připojení

ID připojení cílového prostředí získáte jedním z následujících způsobů:

Přihlaste se k Power Apps a vyberte cílové prostředí. V levém navigačním podokně vyberte Data>Připojení, vyberte připojení, pro které chcete získat ID připojení, a poté z adresy URL získejte ID připojení.
Vytvořte aplikaci plátna v entitě odkazu na připojení. Kroky jsou následující:
1. Přihlaste se k Power Apps a vyberte cílové prostředí.
2. V levém navigačním podokně vyberte Aplikace a poté vyberte Nová aplikace>Plátno.
3. Jako zdroj dat vyberte Dataverse.
4. Vyberte tabulku Odkazy na připojení a vyberte Připojit.
5. Tím se vytvoří aplikace galerie, která vypíše všechna připojení a jejich ID připojení v rámci prostředí.

Získání proměnné prostředí

Hodnoty proměnné prostředí v cílovém prostředí získáte tak, že se přihlásíte k Power Apps, vyberete cílové prostředí, kliknete pravým tlačítkem na tři tečky a zvolíte Upravit. Tímto poskytnete informace potřebné k naplnění souboru s nastavením nasazení (podtržené hodnoty jsou potřebné pro daný soubor):

Hodnoty proměnných prostředí v cílovém prostředí

V opačném případě můžete poskytnout příslušnou hodnotu pro cílové prostředí na základě vašich znalostí o cílovém prostředí.

Krok 3: Aktualizujte hodnoty v souboru s nastavením nasazení

Ruční úpravou souboru s nastavením nasazení (JSON) přidejte příslušnou proměnnou prostředí. Níže je ukázkový soubor s nastavením s přidanými (dříve) chybějícími hodnotami.

{
  "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: Použijte soubor s nastavením nasazení pro úlohy Build Tools

Při importu řešení do cílového prostředí předejte soubor s nastavením nasazení jako parametr. Tím se při importu vytvoří požadovaný odkaz na připojení a prostředí s příslušnými hodnotami, aniž by je uživatel musel interaktivně zadávat.

Při použití úlohy Importovat řešení v Power Platform Build Tools vyberte Použít soubor s nastavením nasazení a zadejte cestu k souboru s nastavením nasazení. Dále aktivujte kanál.

Ověření

Během importu řešení jsou informace o připojení ověřeny, aby bylo zajištěno, že připojení umístěná v nich budou použitelná vlastníkem informací o připojení. Ujistěte se, že připojení jsou ve vlastnictví vlastníka informací o připojení nebo že jsou připojení sdílená.

Viz také

Co je rozhraní příkazového řádku Microsoft Power Platform?
Úlohy Microsoft Power Platform Build Tools

Sdílet prostřednictvím