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 әрекеттері туралы ақпарат