Бөлісу құралы:


Microsoft Power Platform қызметін әзірлеуге қолжетімді GitHub Actions функциясы

Microsoft Power Platform үшін GitHub әрекеттері келесі бөлімдерде сипатталған. Сонымен қатар, үлгі GitHub жұмыс үрдістері де көрсетілген. GitHub әрекеттері және оларды қалай жүктеу керектігі туралы қосымша ақпарат алу үшін Microsoft Power Platform платформасына арналған GitHub әрекеттері бөліміне өтіңіз.

Microsoft Power Platformбар GitHub әрекеттерімен бірге пайдаланылатын тіркелгі деректерін конфигурациялау

Көптеген әрекеттер Microsoft Dataverse ортасына қосылуды талап етеді. GitHub репозиторийіне құпия ретінде субъект-қызметті немесе пайдаланушы тіркелгі деректерін қосуға болады, содан кейін оларды жұмыс ағындарында пайдалануға болады.

  • GitHub ішінде құпияларды реттеу жолы туралы мәліметтерді Шифрланған құпиялар бөлімінен қараңыз

  • Microsoft Power Platform үшін субъект-қызметтің аутентификациясын реттеу жолы туралы мәліметтерді DevOps құрастыру құралдары бөлімінен қараңыз

Конфигурацияланғаннан кейін сіз субъект-қызметті әрекет сценарийлеріңіздің ішінен шақыра аласыз.

GitHub әрекет сценарийінде орта айнымалылары ретінде анықтайтын параметрлер:

  • Қолданба идентификаторы, мысалы: WF_APPLICATION_ID:<your application id>
  • Клиент идентификаторы, мысалы: WF_TENANT_ID:<your tenant id>

Клиенттің құпиясы GitHub құпиясы ретінде қосылуы және сақталуы керек әрі оған жұмыс ағыны ішінен мына сияқты параметрді пайдаланып сілтеме жасалады: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}

Көмекші тапсырмалары

Қолжетімді көмекші тапсырма төменде сипатталған.

әрекеттер-орнату

GitHub Actions жұмыс процесі жүгіруші мәтінмәнінде Power Platform CLI орнатуды мәжбүрлегенде және күту уақыты қатесі орын алса, қосымша әрекетпен (actions-install) 1 нұсқасын (@v1) пайдалану керек. ) төмендегідей.

Маңызды

  • 1-нұсқаны (@v1) пайдалану ағымдағы жұмыс үрдістерінің жаңартылуына әкелетін бар GitHub әрекеттерінің жаңартуларына әкелуі мүмкін.
  • Орнату Power Platform Құралдар тапсырмасын Power Platform үшін кез келген басқа GitHub әрекеттерінің алдында жұмыс үрдісіндегі бірінші тапсырма ретінде қосуыңыз керек.
jobs:
    builds:
        runs-on: windows-latest   # alternate runner OS is: ubuntu-latest

    steps:
    - name: Install Power Platform Tools
        uses: microsoft/powerplatform-actions/actions-install@v1

    - name: Export Solution
         uses: microsoft/powerplatform-actions/export-solution@v1
      with:
         environment-url: 'https://myenv.crm.dynamics.com'
         user-name: 'me@myenv.onmicrosoft.com'
         password-secret: ${{ secrets.MYPASSWORD }}
         solution-name: aSolution
         solution-output-file: 'aSolution.zip'
         working-directory: 'out'

GitHub әрекеттерінің қосымша үлгілерін Power Platform Әрекеттер бетінен таба аласыз.

whoAmI

Қызмет қосылымын қызметке қосылу және WhoAmI [SDK/Веб API ] сұрауын жіберу арқылы растайды. Өңдеу басталғанға дейін қосылу мүмкіндігін тексеру үшін бұл тапсырманы GitHub жұмыс ағынына ертерек қосу пайдалы болуы мүмкін.

Параметр Сипаттамасы
ортаның URL мекенжайы Сіз қосылатын ортаға арналған URL мекенжай.
пайдаланушы аты Байланысу үшін пайдаланылатын тіркелгінің пайдаланушы аты.
құпиясөз user-name өрісіне арналған құпиясөз. GitHub құпиясөздері Құпиялар тармағының астындағы Параметрлер тармағында анықталады. Анықталғаннан және сақталғаннан кейін сіз құпияны шығарып ала алмайсыз.
app-id Аутентификациялау үшін пайдаланатын бағдарламаның идентификаторы. Бұл параметр субъект-қызметтің тіркелгі деректері арқылы аутентификация кезінде қажет.
client-secret GitHub конвейерін аутентификациялау үшін пайдаланылатын клиент құпиясы. Бұл параметр субъект-қызметтің тіркелгі деректері арқылы аутентификация кезінде қажет.
tenant-id app-id және client-secret арқылы аутентификациялау кезіндегі клиент идентификаторы.

Шешім тапсырмалары

Бұл тапсырмалар шешімдерге қатысты әрекеттерді орындайды және келесілерді қамтиды.

import-solution

Шешімді мақсатты ортаға импорттайды.

Параметр Сипаттамасы
ортаның URL мекенжайы (Міндетті) Шешімді импорттау керек мақсатты ортаның URL мекенжайы (мысалы, https://YourOrg.crm.dynamics.com).
пайдаланушы аты (Міндетті) Егер сіз пайдаланушы аты/құпиясөз аутентификациясын қолдансаңыз, сіз байланысу үшін пайдаланылатын тіркелгінің пайдаланушы аты.
құпиясөз (Міндетті) Егер сіз пайдаланушы аты/құпиясөз аутентификациясын қолдансаңыз, сіз байланысу үшін пайдаланылатын тіркелгінің құпиясөзі.
шешім файлы (Міндетті) Сіз импорттағыңыз келетін шешім файлының жолы мен атауы.
app-id Аутентификациялау үшін пайдаланатын бағдарламаның идентификаторы. Бұл параметр субъект-қызметтің тіркелгі деректері арқылы аутентификация кезінде қажет.
client-secret GitHub конвейерін аутентификациялау үшін пайдаланылатын клиент құпиясы. Бұл параметр субъект-қызметтің тіркелгі деректері арқылы аутентификация кезінде қажет.
tenant-id app-id және client-secret арқылы аутентификациялау кезіндегі клиент идентификаторы.

export-solution

Шешімді бастапқы ортадан экспорттайды.

Параметр Сипаттамасы
ортаның URL мекенжайы (Міндетті) Шешімді экспорттау керек ортаның URL мекенжайы (мысалы, https://YourOrg.crm.dynamics.com).
пайдаланушы аты (Міндетті) Егер сіз пайдаланушы аты/құпиясөз аутентификациясын қолдансаңыз, сіз байланысу үшін пайдаланылатын тіркелгінің пайдаланушы аты.
құпиясөз (Міндетті) Егер сіз пайдаланушы аты/құпиясөз аутентификациясын қолдансаңыз, құпиясөз user-name болады. GitHub құпиясөздері Құпиялар тармағының астындағы Параметрлер тармағында анықталады. Анықталғаннан және сақталғаннан кейін сіз құпияны шығарып ала алмайсыз.
app-id Аутентификациялау үшін пайдаланатын бағдарламаның идентификаторы. Бұл параметр субъект-қызметтің тіркелгі деректері арқылы аутентификация кезінде қажет.
client-secret GitHub конвейерін аутентификациялау үшін пайдаланылатын клиент құпиясы. Бұл параметр субъект-қызметтің тіркелгі деректері арқылы аутентификация кезінде қажет.
tenant-id app-id және client-secret арқылы аутентификациялау кезіндегі клиент идентификаторы.
шешім атауы (Міндетті) Экспортталатын шешімнің атауы. Көрсетілетін атаудың орнына әрқашан шешімнің Атауын қолданыңыз.
шешімнің шығыс файлы (Міндетті) Бастапқы ортаны ішіне экспорттайтын solution.zip файлының жолы және атауы.
басқарылатын (Міндетті) Басқарылатын шешім ретінде экспорттау үшін шын мәнін орнатыңыз; әдепкі (жалған) мәні басқарылмайтын шешім ретінде экспорттау болып табылады.

unpack-solution

Сығымдалған шешім файлын алады және оны бірнеше XML файлдарына бөледі, осылайша бұл файлдарды бастапқы басқару жүйесі оңай оқи және басқара алады.

Параметр Сипаттамасы
шешім файлы (Міндетті) Бумадан шығаруға арналған solution.zip файлының жолы және атауы.
шешім қалтасы (Міндетті) Шешімді бумадан шығарғыңыз келетін жол мен мақсатты қалта.
шешім түрі (Міндетті) Бумадан шығарғыңыз келетін шешімнің түрі. Опцияларға мыналар кіреді: Басқарылмайтын (ұсынылады), Басқарылатын және Екеуі де.

pack-solution

Басқа ортаға импортталуы мүмкін solution.zip файлына бастапқы басқару элементінде берілген шешімді жинақтайды.

Параметр Сипаттамасы
шешім файлы (Міндетті) Шешімді жинауға арналған solution.zip файлының жолы және файл атауы (мысалы, out/CI/ALMLab.zip).
шешім қалтасы (Міндетті) Жинақтауға арналған шешімнің жолы мен бастапқы қалтасы.
шешім түрі (Қосымша) Орауға арналған шешім түрі. Опцияларға мыналар кіреді: Басқарылмайтын (ұсынылады), Басқарылатын және Екеуі де.

publish-solution

Шешімнің теңшелімдерін жариялайды.

Параметр Сипаттамасы
ортаның URL мекенжайы (Міндетті) Шешімді ішіне жариялағыңыз келетін ортаның URL мекенжайы (мысалы, https://YourOrg.crm.dynamics.com).
пайдаланушы аты (Міндетті) Егер сіз пайдаланушы аты/құпиясөз аутентификациясын қолдансаңыз, сіз байланысу үшін пайдаланылатын тіркелгінің пайдаланушы аты.
құпиясөз (Міндетті) Егер сіз пайдаланушы аты/құпиясөз аутентификациясын қолдансаңыз, сіз байланысу үшін пайдаланылатын тіркелгінің құпиясөзі.
шешім файлы (Міндетті) Сіз импорттағыңыз келетін шешім файлының жолы мен атауы.
app-id Аутентификациялау үшін пайдаланатын бағдарламаның идентификаторы. Бұл параметр субъект-қызметтің тіркелгі деректері арқылы аутентификация кезінде қажет.
client-secret GitHub конвейерін аутентификациялау үшін пайдаланылатын клиент құпиясы. Бұл параметр субъект-қызметтің тіркелгі деректері арқылы аутентификация кезінде қажет.
tenant-id app-id және client-secret арқылы аутентификациялау кезіндегі клиент идентификаторы.

clone-solution

Берілген орта үшін шешімді клондайды.

Параметр Сипаттамасы
ортаның URL мекенжайы (Міндетті) Ішінен шешімді клондағыңыз келетін ортаның URL мекенжайы (мысалы, https://YourOrg.crm.dynamics.com).
пайдаланушы аты (Міндетті) Егер сіз пайдаланушы аты/құпиясөз аутентификациясын қолдансаңыз, сіз байланысу үшін пайдаланылатын тіркелгінің пайдаланушы аты.
құпиясөз (Міндетті) Егер сіз пайдаланушы аты/құпиясөз аутентификациясын қолдансаңыз, сіз байланысу үшін пайдаланылатын тіркелгінің құпиясөзі.
шешім файлы (Міндетті) Сіз импорттағыңыз келетін шешім файлының жолы мен атауы.
app-id Аутентификациялау үшін пайдаланатын бағдарламаның идентификаторы. Бұл параметр субъект-қызметтің тіркелгі деректері арқылы аутентификация кезінде қажет.
client-secret GitHub конвейерін аутентификациялау үшін пайдаланылатын клиент құпиясы. Бұл параметр субъект-қызметтің тіркелгі деректері арқылы аутентификация кезінде қажет.
tenant-id app-id және client-secret арқылы аутентификациялау кезіндегі клиент идентификаторы.
шешім атауы (Міндетті) Клондау үшін қажет solution.zip файлының жолы мен атауы (мысалы, out/CI/ALMLab.zip).
solution-version Клондайтын шешімнің нұсқасы.
target-folder Шығарып алынған шешімді орналастыруға арналған мақсатты қалта. (мысалы, Git repository\ttarget-solution-folder).
Жұмыс каталогы Шешімді клондау үшін қажет жұмыс орындалып жатқан артефактілерге арналған уақытша қалта.
әдепкі: root of the repository

check-solution

Сәйкессіздіктерді анықтау үшін шешім файлын тексереді.

Параметр Сипаттамасы
ортаның URL мекенжайы (Міндетті) Ішінен шешімді клондағыңыз келетін ортаның URL мекенжайы (мысалы, https://YourOrg.crm.dynamics.com).
пайдаланушы аты (Міндетті) Егер сіз пайдаланушы аты/құпиясөз аутентификациясын қолдансаңыз, сіз байланысу үшін пайдаланылатын тіркелгінің пайдаланушы аты.
құпиясөз (Міндетті) Егер сіз пайдаланушы аты/құпиясөз аутентификациясын қолдансаңыз, сіз байланысу үшін пайдаланылатын тіркелгінің құпиясөзі.
app-id Аутентификациялау үшін пайдаланатын бағдарламаның идентификаторы. Бұл параметр субъект-қызметтің тіркелгі деректері арқылы аутентификация кезінде қажет.
client-secret GitHub конвейерін аутентификациялау үшін пайдаланылатын клиент құпиясы. Бұл параметр субъект-қызметтің тіркелгі деректері арқылы аутентификация кезінде қажет.
tenant-id app-id және client-secret арқылы аутентификациялау кезіндегі клиент идентификаторы.
path (Міндетті) Сіз тексергіңіз келетін шешім файлының жолы мен атауы.
geo Microsoft Power Platform Checker қызметінің қай географиялық орнын пайдалану керек. Әдепкі мән - «united states».
rule-level-override Ережелердің және олардың деңгейлерінің JSON массивін қамтитын файлдың жолы. Қабылданатын мәндер: Critical, High, Low және Informational. Мысалы: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
checker-logs-artifact-name Microsoft Power Platform тексеруші журналдары жүктеп салынатын артефактілер қалтасының атауы. Әдепкі мән — «CheckSolutionLogs».

upgrade-solution

Шешімді жаңарту мүмкіндігін қамтамасыз етеді.

Параметр Сипаттамасы
ортаның URL мекенжайы (Міндетті) Ішінен шешімді клондағыңыз келетін ортаның URL мекенжайы (мысалы, https://YourOrg.crm.dynamics.com).
пайдаланушы аты (Міндетті) Егер сіз пайдаланушы аты/құпиясөз аутентификациясын қолдансаңыз, сіз байланысу үшін пайдаланылатын тіркелгінің пайдаланушы аты.
құпиясөз (Міндетті) Егер сіз пайдаланушы аты/құпиясөз аутентификациясын қолдансаңыз, сіз байланысу үшін пайдаланылатын тіркелгінің құпиясөзі.
шешім файлы (Міндетті) Сіз импорттағыңыз келетін шешім файлының жолы мен атауы.
app-id Аутентификациялау үшін пайдаланатын бағдарламаның идентификаторы. Бұл параметр субъект-қызметтің тіркелгі деректері арқылы аутентификация кезінде қажет.
client-secret GitHub конвейерін аутентификациялау үшін пайдаланылатын клиент құпиясы. Бұл параметр субъект-қызметтің тіркелгі деректері арқылы аутентификация кезінде қажет.
tenant-id app-id және client-secret арқылы аутентификациялау кезіндегі клиент идентификаторы.
шешім атауы (Міндетті) Жаңартатын шешімнің атауы.
async Шешімді асинхронды түрде жаңартады.
max-async-wait-time Минуттар түріндегі максималды асинхронды күту уақыты. Әдепкі мәні — 60 минут.

Бума тапсырмалары

Бұл тапсырмалар бумаларға қатысты әрекеттерді орындайды және келесілерді қамтиды.

deploy-package

Бума dll файлын немесе бума бар zip файлын орналастыру мүмкіндігін қамтамасыз етеді.

Ескертпе

Бұл әрекетке тек Windows жүйесінде қолдау көрсетіледі.

Параметр Сипаттама
ортаның URL мекенжайы (Міндетті) Ішінен шешімді клондағыңыз келетін ортаның URL мекенжайы (мысалы, https://YourOrg.crm.dynamics.com).
пайдаланушы аты (Міндетті) Егер сіз пайдаланушы аты/құпиясөз аутентификациясын қолдансаңыз, сіз байланысу үшін пайдаланылатын тіркелгінің пайдаланушы аты.
құпиясөз (Міндетті) Егер сіз пайдаланушы аты/құпиясөз аутентификациясын қолдансаңыз, сіз байланысу үшін пайдаланылатын тіркелгінің құпиясөзі.
app-id Аутентификациялау үшін пайдаланатын бағдарламаның идентификаторы. Бұл параметр субъект-қызметтің тіркелгі деректері арқылы аутентификация кезінде қажет.
client-secret GitHub конвейерін аутентификациялау үшін пайдаланылатын клиент құпиясы. Бұл параметр субъект-қызметтің тіркелгі деректері арқылы аутентификация кезінде қажет.
tenant-id app-id және client-secret арқылы аутентификациялау кезіндегі клиент идентификаторы.
package (Міндетті) Бума dll файлының немесе бума бар zip файлының жолы.

Портал тапсырмалары

Бұл тапсырмалар Power Pages бойынша келесі әрекеттерді орындайды.

жүктеп салу-paportal

Деректерді Power Pages бағдарламасына жүктеп салады.

Параметр Сипаттама
ортаның URL мекенжайы (Міндетті) Шешімді импорттағыңыз келетін ортаның URL мекенжайы (мысалы, https://YourOrg.crm.dynamics.com).
app-id Аутентификациялау үшін пайдаланатын бағдарламаның идентификаторы. Бұл параметр субъект-қызметтің тіркелгі деректері арқылы аутентификация кезінде қажет.
client-secret GitHub конвейерін аутентификациялау үшін пайдаланылатын клиент құпиясы. Бұл параметр субъект-қызметтің тіркелгі деректері арқылы аутентификация кезінде қажет.
tenant-id app-id және client-secret арқылы аутентификациялау кезіндегі клиент идентификаторы.
жүктеу-жол Веб-сайт мазмұны сақталатын жол (alias: -p).
орналастыру-профиль deployment-profiles/[profile-name].deployment.yaml файлында профиль айнымалылары арқылы анықталатын орта мәліметтерімен портал деректерін жүктеп салу.
үлгі-нұсқа Жүктеп салынатын сайт деректері стандартты (1) немесе жақсартылған деректер үлгісін (2) пайдаланатынын көрсетеді. Әдепкі мән - "1".

Microsoft Power Platform Power Pagesүшін CLI қолдауы туралы қосымша ақпарат алыңыз.

Каталог тапсырмалары (алдын ала қарау нұсқасы)

Бұл тапсырмалар Power Platform каталогқа қарсы әрекеттерді орындайды және келесілерді қамтиды.

Ескертпе

Қазіргі уақытта Power Platform каталог тапсырмалары алдын ала қарау нұсқасы шығарылымы болып табылады.

Орнату

Каталог элементін мақсатты ортаға орнатыңыз.

Параметр Сипаттама
каталог элементінің идентификаторы (Міндетті) Мақсатты ортаға орнатылатын каталог элементі.
target-url (Міндетті) Каталог элементін орнатуға арналған мақсатты ортаның URL мекенжайы (мысалы, "https://YourOrg.crm.dynamics.com").
параметрлері (Міндетті) Орындалу үшін орнату шеңберіне арналған орындалу уақыты бумасының параметрлері. Жолдың пішімі key=value|key=value болуы керек.
мақсатты нұсқа Орнату үшін мақсатты нұсқа. Бос қалдырылған болса, жарияланған нұсқа таңдалады.
сауалнама мәртебесі Сұрауыңыздың күйін тексеру үшін сауалнама.

жіберу

Ағымдағы Dataverse ортадан (ұйым) жарияланған барлық каталог элементтерін тізімдеңіз.

Параметр Сипаттама
path (Міндетті) Каталогты жіберу құжатына жол.
пакет-zip Буманың zip файлына апаратын жол.
шешім-zip Шешімнің zip файлына апаратын жол.
сауалнама мәртебесі Сұрауыңыздың күйін тексеру үшін сауалнама.

күй

Каталог орнату/жіберу сұрауының күйін алыңыз.

Параметр Сипаттама
қадағалау идентификаторы (Міндетті) Бақылау идентификаторын сұрау.
түрі (Міндетті) Сұраныс түрі (Мәндер: Орнату, Жіберу)

GitHub жұмыс ағынын жасау

GitHub әрекеттерін пайдаланып GitHub жұмыс ағындарын жасау туралы қосымша мәліметтер алу үшін Microsoft Power Platform арналған GitHub әрекеттерін орындаңыз.

Қосымша ақпарат: GitHub әрекеттері туралы ақпарат

Сонымен қатар, келесіні қараңыз:

GitHub әрекеттері Microsoft Power Platform