Power Pages үшін Microsoft Power Platform CLI қолдауы
Microsoft Power Platform CLI (Пәрмен жолы интерфейсі) — әзірлеушілерге және бағдарлама жасаушыларына код құрамдастарын жасауға мүмкіндік беретін қарапайым, әмбебап әзірлеуші пәрмен жолының интерфейсі.
Microsoft Power Platform CLI құралы — бұл кәсіпорын әзірлеушілері мен ISV жеткізушілері кеңейтімдер мен теңшеулерді жылдам, әрі тиімді жасап, құрап, түзетіп және жариялай алатын кешенді бағдарлама жарамдылық кезеңін басқаруға алғашқы қадам. Қосымша ақпарат алу үшін Microsoft Power Platform CLI бағдарламасы дегеніміз не? бөлімін қараңыз
Осы мүмкіндіктің көмегімен Microsoft Power Platform CLI порталы Power Pages сайты конфигурациясының CI/CD (үздіксіз біріктіру/үздіксіз орналастыру) мүмкіндігін қосуға қолдау көрсетеді. Енді сіз веб-сайттың конфигурациясын бастапқы басқару элементіне тіркей аласыз және веб-сайтты Microsoft Power Platform CLI бағдарламасының көмегімен кез келген ортаға жылжыта аласыз.
Ескертпе
- Бұл мүмкіндік әдетте Power Platform CLI бағдарламасының 1.9.8 нұсқасынан бастап қолжетімді. Соңғы нұсқаны орнату туралы білу үшін Microsoft Power Platform CLI бағдарламасын орнату бөлімін қараңыз.
- Power Platform CLI 1.27 нұсқасынан бастап
pac paportalпәрмені келесіге өзгертіледіpac powerpages.paportalжұмысын жалғастырады, бірақ бізpowerpagesалға қарай пайдалануды ұсынамыз. Жақында бұл мақала орнынаpowerpagesқолдану үшін жаңартыладыpaportal.
Microsoft Power Platform CLI бағдарламасын веб-сайтты әзірлеуде не үшін қолдану керек?
Microsoft Power Platform CLI бағдарламасына қолдау көрсететін порталдармен енді веб-сайт мазмұнына өзгертулер енгізу арқылы веб-сайттарды теңшеу үшін офлайн тәрізді мүмкіндікті қолдана аласыз. Барлық теңшеулер немесе өзгертулер сақталғаннан кейін веб-сайт конфигурациясын Microsoft Dataverse ішіне кері жүктеп салуға болады. Веб-сайт мазмұнын Microsoft Power Platform CLI бағдарламасының көмегімен жүктеп алған кезде, мазмұн YAML және HTML пішімдеріне құрылымдалады, бұл оны теңшеуді жеңілдетеді және кәсіби әзірлеу тәжірибесін қосады.
Microsoft Power Platform CLI бағдарламасының қолдауымен порталдар қолданатын функциялар мен мүмкіндіктер тізімі келесідей:
Қолданудың қарапайымдылығы
Жергілікті файлдық жүйеден веб-сайт конфигурациясы деректерін жүктеп алу/жүктеп салуға қолдау көрсету
Бұрыннан бар Microsoft Power Platform CLI құралын пайдалану.
Бағдарламаның жарамдылық кезеңін басқару (ALM)
Ұйым ішіндегі веб-сайт конфигурациясының өзгерістерін бақылау
Конфигурация файлдарын ұйымдар немесе қатысушылар бойынша жылжыту
Кәсіби әзірлеу және кәсіпорын қолдауы
"git" сияқты кез келген бастапқы басқару элементі құралдарымен оңай біріктіруге көмектеседі
CI/CD үдерістер тізбегін оңай орнату
Microsoft Power Platform CLI бағдарламасын орнату
Қадамдық нұсқауларды Microsoft Power Platform CLI қызметін орнату бөлімінен қараңыз.
Қолдау көрсетілген кестелер
Microsoft Power Platform CLI бағдарламасына қолдау көрсететін порталдар тек төменде келтірілген кестелермен шектеледі.
adx_ad
adx_adplacement
adx_blog
adx_blogpost
adx_botconsumer
adx_communityforum
adx_communityforumaccesspermission
adx_contentsnippet
adx_entityform
adx_entityformmetadata
adx_entitylist
adx_entitypermission
adx_forumthreadtype
adx_pagetemplate
adx_poll
adx_polloption
adx_pollplacement
adx_portallanguage
adx_publishingstate
adx_redirect
adx_shortcut
adx_sitemarker
adx_sitesetting
adx_tag
adx_urlhistory
adx_webfile
adx_webform
adx_webformmetadata
adx_webformstep
adx_weblink
adx_weblinkset
adx_webpage
adx_webpageaccesscontrolrule
adx_webrole
adx_website
adx_websiteaccess
adx_websitebinding (тек жүктеп алу)
adx_websitelanguage
adx_webtemplate
аннотация
Маңызды
- Реттелетін кестелер мен портал үлгісіне арналған кестелерге (блог, қауымдастық немесе идеялар порталы сияқты) Microsoft Power Platform CLI бағдарламасының көмегімен теңшеуге қолдау көрсетілмейді.
- Жарнама (adx_ad) жазбаларына кескін файлы тіркемелері Power Platform CLI арқылы жүктеп алынбайды. Уақытша шешім ретінде Кескіннің URL мекенжайы өрісін пайдаланыңыз немесе Көшіру өрісіндегі кескін файлы бар веб-файл жазбасына HTML сілтемесін қосыңыз.
Порталдарға арналған Microsoft Power Platform CLI бағдарламасын орнату және тексеру
Microsoft Power Platform CLI бағдарламасын орнату туралы ақпарат алу үшін Microsoft Power Platform CLI бағдарламасын орнату бөліміне өтіңіз.
Microsoft Power Platform CLI бағдарламасын орнатқаннан кейін, пәрмен жолын ашыңыз және нәтижеде Power Apps порталдарына арналған “paportal” пәрменінің бар екендігіне көз жеткізу үшін pac іске қосыңыз.
Порталдарға арналған Microsoft Power Platform CLI пәрмендері
Порталдарға арналған Microsoft Power Platform CLI пәрмені – “paportal”.
Келесі бөлімдерде "paportal" пәрменінің әртүрлі сипаттары туралы қосымша мәліметтер келтірілген.
Параметрлер
| Сипат атауы | Сипаттама | Мысал |
|---|---|---|
| тізім | Ағымдағы Dataverse ортасындағы барлық портал веб-сайттарын тізімдейді. Алдын ала қарау нұсқасы Сайт стандартты немесе жақсартылған деректер үлгісін пайдаланып жатқанын көрсету үшін -v параметрін қосуға болады |
pac paportal list |
| жүктеп алу | Ағымдағы Dataverse ортасынан портал веб-сайтының мазмұнын жүктеп алыңыз. Оның келесі параметрлері бар: - жол: веб-сайт мазмұны жүктеп алынатын жол (alias: -p) - webSiteId: жүктеп алуға арналған портал веб‑сайтының идентификаторы (alias: -id) - қайта жазу: (қосымша) шын - бұрыннан бар мазмұнды қайта жазу үшін; жалған ‑ егер қалтада веб‑сайт мазмұны бұрыннан бар болса сәтсіз (alias: -o) Алдын ала қарау нұсқасы - modelVersion : 1 немесе 2 жүктеп алынатын сайт деректері стандартты (1) немесе пайдаланатынын көрсету үшін кеңейтілген деректер үлгісі (2). |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 |
| жүктеп салу | Ағымдағы Dataverse ортасына портал веб-сайтының мазмұнын жүктеп салыңыз. Оның келесі параметрі бар: - жол: веб-сайт мазмұны сақталатын жол (alias: -p) -deploymentProfile: deployment-profiles/[profile-name].deployment.yaml файлындағы профиль айнымалылары арқылы анықталған орта мәліметтері бар портал деректерін жүктеп салыңыз Алдын ала қарау нұсқасы - modelVersion : 1 немесе 2 жүктеп салынатын сайт деректері стандартты (1) немесе пайдаланатынын көрсету үшін кеңейтілген деректер үлгісі (2). |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" |
Орналастыру профилін пайдалану
deploymentProfile ауыстырып‑қосқышы YAML пішіміндегі орта үшін айнымалылар жинағын анықтауға мүмкіндік береді. Мысалы, сізде профильде анықталған әртүрлі схема мәліметтері бар әртүрлі орналастыру профильдері болуы мүмкін (мысалы, әзірлеу, тексеру, өндіру).
Егер сіз сынақ профилін жасайтын болсаңыз, deployment-profiles файлында "test.deployment.yml" (яғни, <profileTag>.deployment.yml) атты файл жасауға болады. Осы профильді пайдалану үшін (<profileTag>) тегі бар пәрменді іске қосуға болады:
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test
Бұл файлда кесте идентификаторы бар кесте (нысан) атауы, төлсипаттар тізімі және deploymentProfile параметрін пайдалану арқылы портал конфигурациясын жүктеп салу кезінде қайта анықтау керек мәндер болуы мүмкін.
Сонымен қатар операциялық жүйенің орта айнымалыларына қатынасу үшін OS айнымалысын пайдалануға болады.
Бірегей схема мәліметтері бар осы "test.deployment.yml" профилінің YAML файлының мысалы:
adx_sitesetting:
- adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
adx_value: ${OS.FacebookAppId}
adx_name: Authentication/OpenAuth/Facebook/AppId
- adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
adx_value: contoso_sample
adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
- adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
adx_name: PowerBI/contoso/sales
adx_value: https://powerbi.com/group/contoso/sales
Ескертпе
Порталдарға қоса CLI бағдарламасында қолданылатын барлық пәрмендер туралы ақпарат алу үшін Microsoft Power Platform CLI бағдарламасындағы жалпы пәрмендер бөліміне өтіңіз.
Манифест файлдары
CLI пәрменін pac paportal жүктеп алу арқылы веб-сайт мазмұнын жүктеп алған кезде, сайт мазмұнын жүктеп алумен бірге ол екі манифест файлын жасайды;
- Ортаның манифест файлы (org-url-manifest.yml)
- Бақылау манифест файлын жою (manifest.yml)
Ортаның манифест файлы (org-url-manifest.yml)
Ортаның манифест файлы pac paportal жүктеп алу пәрмені іске қосылған сайын жасалады.
Әрбір жүктеп алу әрекетінен кейін PAC CLI құралы бар орта манифест файлын оқиды және ортада жойылған жазбаларды жаңартады немесе ол жоқ болса, орта манифест файлын жасайды.
Портал веб-сайтының мазмұнын жүктеп салу үшін pac paportal жүктеп салу пәрменін іске қосқан кезде. Ол ортаның манифест файлын оқиды және соңғы жүктеп алғаннан кейін жасалған өзгерістерді анықтайды және тек жаңартылған мазмұнды жүктеп салады. Бұл жүктеп салу процесін оңтайландыруға көмектеседі, өйткені әрбір жүктеп салу пәрменіндегі барлық мазмұнды жүктеп салудың орнына тек жаңартылған веб-сайт мазмұны жүктеп салынады.
Кездейсоқ өзгерістерді болдырмау үшін ортаның манифест файлы бір ортаға қосылғанда ғана оқылатын болады (ортаның URL мекенжайы файл атауына сәйкес келеді).
Ескертпе
- Ортаның манифест файлы веб-сайтты әртүрлі орталарға орналастыру кезіндегі өзгерістерді бақылауға арналмаған.
- Ортаның манифест файлы әзірлеушілерге өздерінің әзірлеушілер ортасында жергілікті қолдану үшін пайдалануға арналған және оны елемеу тізіміне қосу керек.
Бақылау манифест файлын жою (manifest.yml)
Бұл файл ортадан жойылған жазбаларды қадағалау үшін пайдаланылады.
Веб-сайт мазмұны pac paportal жүктеп алу пәрменімен жүктеп алынғанда, бұл жойылған жазбаларды ортаның манифест файлынан (org-url-manifest.yml) manifest.yml файлына қосады. Осылайша, pac paportal жүктеп салу пәрмені арқылы веб-сайт мазмұнын жүктеп салған кезде, ол файлдарды ортадан (тіпті басқа ортаға) жояды. Бұл файл жойылмайды және ол қай ортаға қосылғаныңызға қарамастан пайдаланылады. Бұл файлды мақсатты ортадағы элементтерді жоюды қарастыру үшін бастапқы басқару элементіне өзгертулерді итеру кезінде ескеру қажет.
Ескертпе
Бір ортадағы сайт мазмұны жазбаларын жою және PAC CLI арқылы басқа ортадағы бірдей мазмұн жазбаларын жою үшін веб-сайт жазбасының мазмұнын жоймас бұрын және одан кейінpac paportal жүктеп алу пәрменін орындау қажет. manifest.yml бұл өзгерістерді қадағалайды және pac paportal жүктеп салу пәрмені іске қосылған кезде мақсатты ортадағы тиісті жазбаларды жояды.
Visual Studio Code кеңейтімін пайдалану
Сондай‑ақ IntelliSense кірістірілген Liquid тілін пайдалану үшін, кодты аяқтауға көмектесу үшін, кеңесу және Microsoft Power Platform CLI бағдарламасымен VS Code Integrated Terminal қызметі арқылы өзара әрекеттесу үшін VS код кеңейтімін Power Platform VS код кеңейтімі қызметін пайдалануға болады. Қосымша ақпарат: Visual Studio Code кеңейтімін (алдын ала қарау нұсқасы) пайдалану
Қосымша ұсыныстар
- Егер сіздің файл жолыңыз жолдың максималды ұзындығы шегінен асып кетсе, қате туралы хабарланады. Қосымша ақпарат: Windows жүйесіндегі жол ұзындығының максималды шегі
- Қайталанатын жазбалар үшін, мысалы, қайталатын веб-беттің атауы, Microsoft Power Platform CLI бағдарламасы екі түрлі қалтаны жасайды — біреуі веб-беттің атауымен, ал екіншісі хэш-кодпен префикстелген дәл сол атаумен. Мысалы, "Менің бетім" және "Менің бетім-хэш-код".
Келесі қадамдар
Оқулық: порталдары бар Microsoft Power Platform CLI бағдарламасын пайдалану