Vyplnenie odkazov na pripojenie a premenných prostredia vopred pre automatizované nasadenia

Článok
08/04/2023

Odkazy na pripojenie a premenné prostredia vám umožňujú interaktívne špecifikovať podrobnosti pripojenia a konfiguračné nastavenia špecifické pre cieľové prostredie, kde je vaša aplikácia alebo riešenie nasadené.

Ďalšie informácie:

Po importe riešenia obsahujúceho referenciu na pripojenie a informácie o premenných prostredia sa zobrazí výzva na zadanie informácií špecifických pre vaše prostredie v používateľskom rozhraní. Zadanie týchto informácií však nefunguje dobre v prípade plne automatizovaných scenárov nepretržitej integrácie/nepretržitého doručovania (CI/CD).

Ak chcete povoliť plne automatizované nasadenie, teraz môžete vopred vyplniť referencie na pripojenie a informácie o premenných prostredia špecifické pre cieľové prostredie, aby ste ich po importovaní riešenia nemuseli interaktívne poskytovať.

Súbor s nastaveniami nasadenia

Ak chcete vopred vyplniť referencie na pripojenie a informácie o premenných prostredia pre vaše nasadenie, uložte informácie pomocou súboru nastavení nasadenia (JSON) a odovzdajte ho ako parameter pri importe riešenia pomocou Power Platform Build Tools. Súbor JSON môžete uložiť do svojho systému riadenia zdrojov, aby ste ho mohli aktualizovať a spravovať podľa požiadaviek vašej organizácie.

Nasleduje príklad súboru nastavení nasadenia:

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

Vo vyššie uvedenom príklade súboru JSON chýbajú hodnoty zobrazené ako "" a budú musieť byť vyplnené. Tomu sa budeme venovať neskôr v tomto článku.

Krok 1: Generujte súbor nastavení nasadenia

Súbor nastavení nasadenia je možné vygenerovať pomocou Power Platform CLI. Súbor môžete vygenerovať pri exporte alebo klonovaní riešenia.

Možnosť 1: Generujte súbor nastavení nasadenia pomocou vlastnosti create-settings

Použite vlastnosť create-settings s Power Platform CLI:

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

Tento príkaz vygeneruje súbor JSON, ako je uvedené nižšie.

V súbore JSON je v súbore prázdnych niekoľko hodnôt v sekcii ConnectionReferences. Tieto hodnoty je potrebné zhromaždiť po ich vytvorení v cieľovom prostredí.

Možnosť 2: Vygenerujte súbor nastavení nasadenia klonovaním riešenia

V tomto kroku je potrebný klon projektového riešenia, pretože pôvodné riešenie vykreslí do zostaviteľného formátu. Potom, čo ste klonovali riešenie pomocou Power Platform CLI, získate vo svojom počítači vytvorenú nasledujúcu adresárovú štruktúru:

Pokračujte k vytvoreniu súboru s nastaveniami v kontexte aktuálneho priečinka a vyplňte hodnotu súboru s nastaveniami podľa nižšie uvedeného obrázku.

Krok 2: Získajte referenciu na pripojenie a informácie o premenných prostredia

Na vyplnenie súboru nastavení nasadenia budete potrebovať získať informácie o referenčnom pripojení a premennej prostredia cieľového riešenia.

Získajte referenčné informácie o pripojení

Ak chcete získať ID pripojenia cieľového prostredia, použite jeden z nasledujúcich spôsobov:

Prihláste sa do Power Apps a vyberte svoje cieľové prostredie. Na ľavej navigačnej table vyberte položku Údaje>Pripojenia, vyberte pripojenie, pre ktoré chcete získať ID pripojenia, a potom sa pozrite na URL a získajte ID pripojenia.
Vytvorte aplikáciu plátna na referenčnej entite pripojenia. Kroky sú nasledovné:
1. Prihláste sa do Power Apps a vyberte svoje cieľové prostredie.
2. Na ľavom navigačnom paneli vyberte možnosť Aplikácie a potom stlačte Nová aplikácia>Plátna.
3. Výber možnosti Dataverse ako zdroja údajov.
4. Stlačte tabuľku Referencie na pripojenie a vyberte Pripojiť.
5. Vytvorí sa aplikácia galérie, ktorá vypíše všetky pripojenia a ich identifikátory pripojení v prostredí.

Získajte informácie o premenných prostredia

Ak chcete získať hodnoty premennej prostredia v cieľovom prostredí, prihláste sa do Power Apps, vyberte cieľové prostredie a kliknite pravým tlačidlom myši na tri bodky a zvoľte úpravu. To poskytne informácie potrebné na vyplnenie súboru nastavení nasadenia (podčiarknuté hodnoty sú hodnoty potrebné pre súbor):

Hodnoty premenných prostredia v cieľovom prostredí

V opačnom prípade môžete poskytnúť vhodnú hodnotu pre cieľové prostredie na základe vašich znalostí o cieľovom prostredí.

Krok 3: Aktualizujte hodnoty v súbore nastavení nasadenia

Ručne upravte súbor nastavení nasadenia (JSON), aby ste vhodne pridali informácie o premennej pripojenia a prostredia. Nasleduje príklad súboru nastavení s pridanými (predtým) chýbajúcimi 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: Súbor nastavení nasadenia použite na úlohy Build Tools

Pri importe riešenia do cieľového prostredia odovzdajte súbor nastavení nasadenia ako parameter. To pri importe vytvorí požadovanú referenciu na pripojenie a prostredia s príslušnými hodnotami bez toho, aby používateľ musel hodnotu interaktívne špecifikovať.

Pri použití Úloha Importovať riešenie v Power Platform Build Tools stlačte možnosť Použiť súbor nastavení nasadenia a zadajte cestu k súboru nastavení nasadenia. Ďalej spustite kanál.

Overenie

Počas importu riešenia sa overia odkazy na pripojenia, aby sa zabezpečilo, že pripojenia umiestnené v nich budú môcť používať vlastník odkaz na pripojenie. Uistite sa, že pripojenia sú vo vlastníctve vlastníka odkazov na pripojenie alebo že pripojenia sú zdieľané.

Pozrite si tiež

Čo je Microsoft Power Platform CLI?
Microsoft Power Platform Úlohy Build Tools

Zdieľať cez