Keď skončíte s vývojom šablóny lokality, pomocou rozhrania príkazového riadka (CLI) súpravy OCE Toolkit môžete šablónu propagovať z fázy vývoja do fázy testovania pre produkciu na serveroch Oracle Content Management.
Ak chcete propagovať zmeny, pomocou príkazov súpravy OCE Toolkit môžete vytvoriť lokality a spravovať ich životné cykly na vývojových, testovacích a produkčných serveroch. Môžete vykonať zmeny na lokalitách vo vývojovom prostredí a potom propagovať tieto zmeny do testovacích a produkčných prostredí. Túto množinu utilít príkazového riadka môžete zahrnúť do skriptovacích prostredí na správu nasadení. S utilitami príkazového riadka môžete sprístupniť nový obsah, napríklad položky, komponenty či aktualizácie existujúceho obsahu.
V nasledujúcich krokoch je vysvetlené, ako používať rozhranie príkazového riadka súpravy OCE Toolkit na propagáciu zmien z fázy vývoja do fázy testovania pre produkciu:
Pre vývojové, testovacie a produkčné servery nastavte rovnaký depozitár a stratégiu lokalizácie.
Aby ste mohli propagovať zmeny z vývojového servera na testovací server a potom na produkčný server, na každom z týchto troch serverov je potrebné nastaviť depozitár s rovnakým názvom a stratégiu lokalizácie. Predvolená stratégia lokalizácie pre depozitár položiek je en-US, ale môžete použiť aj inú za predpokladu, že bude rovnaká na všetkých troch serveroch.
Pozrite si časť Nastavenie depozitárov položiek.
Vývojový, testovací a produkčný server zaregistrujte v službe Oracle Content Management.
Pred tým, ako budete zmeny propagovať na lokalite, je potrebné každý z týchto serverov zaregistrovať. Na registráciu servera môžete použiť príkaz cec register-server
zo súpravy OCE Toolkit.
cec register-server <name>
Zadajte nasledujúce voľby príkazu:
-e <endpoint> pre adresu URL servera,
-u <user> a -p <password> na pripojenie k serveru,
-t <type> na nastavenie typu servera. Táto voľba je voliteľná. Predvolená hodnota je pod_ec
.
Keď sa pripájate k nájomcovi služby Oracle Content Management v službe Oracle Public Cloud, použite len voľbu pod_ec
.
Nasledujúci príkaz napríklad zaregistruje server, ktorý je nájomcom v službe Oracle Public Cloud:
cec register-server DEV -e https://DEV.example.com -u user1 -p <password>
Nasledujúci príkaz zaregistruje samostatnú vývojovú inštanciu služby Oracle Content Management:
cec register-server DEV -e https://DEV.git.oraclecorp.example.com -u user1 -p <password>
Po zaregistrovaní servera Oracle Content Management môžete pomocou príkazu súpravy Toolkit cec list
zobraziť zoznam obsahu servera.
Nasledujúci príkaz zobrazí zoznam obsahu vývojového servera:
cec-compontents> cec list -s DEV - Logged in to remote server: <host:port> Channels: Name Token StarterSite <site-id> Components: Name Type Published FooterBar Component group StarterComponent Local component StarterFooter Component group StarterNavMenu Local component Localization policies: Name Required languages Optional Languages en-US en-US Repositories: Name r Sites: Theme Type Published Online Name StarterSiteTheme Enterprise Templates: Name Theme Type StarterTemplate StarterTheme Standard
Na vývojový server nahrajte šablónu lokality a z tejto šablóny vytvorte lokalitu.
Šablónu lokality môžete vytvoriť pomocou príkazu cec create-template
a potom ju nahrať na vývojový server. Následne môžete zo šablóny vytvoriť lokalitu pomocou príkazu cec create-site
. Nasledujúce príkazy vytvoria a nahrajú šablónu:
- cec create-template blog -f BlogTemplate - cec upload-template blog -s DEV
Nasledujúci príkaz vytvorí z nahranej šablóny lokalitu s názvom blog
:
cec-components> cec create-site blog -t blog -r r -l "en-US" -d "en-US" --server DEV - Logged in to remote server: <https:<host:<port> - establish user session - get template - get repository - get localization policy - creating enterprise site . . . name blog template blog site prefix blog repository r localization policy en-US default language en-US - submit create site site - create site in process: percentage 95 - create site in process: percentage 95 - create site in process: percentage 95 - create site in process: percentage 95 - create site in process: percentage 95 - site created
Lokalitu publikujte na vývojovom serveri a prepnite ju do režimu online.
Vytvorenú lokalitu môžete pomocou príkazu cec control-site
publikovať a prepnúť online:
cec-components> cec control-site Usage: cec contrl-site <action> Perform <action> on site in CEC server. Specify the site with -s <site> Specify the server with -r <server>. publish unpublish bring-online take-offline Options: --site, -s <site> Site --server, -r <server> The registered CEC server --help, -h Show help Examples: cec control-site publish -s Site1 Publish site Site1 on the server cec control-site publish -s Site1 -r UAT Publish site Site1 on the registered server UAT cec control-site unpublish -s Site1 -r UAT Inpublish site Site1 on the registered server UAT cec control-site bring-online -s Site1 -r UAT Bring site Site1 online on the registered server UAT cec control-site take-offline -s Site1 -r UAT Take site Site1 offline on the registered server UAT Not enough non-option arguments: got 0, need at least 1 cec-components> cec control-site publish --site blog --server DEV - Logged in to the remote server: https://<host>:<port> - establish user session - get site: runtimeStatus: offline publishStatus: unpublished - submit publish site - publish in process: percentage 20 - publish in process: percentage 40 - publish in process: percentage 49 - publish in process: percentage 49 - publish in process: percentage 50 - publish in process: percentage 50
Lokalitu, ktorú chcete presunúť zo servera DEV na server UAT, je potrebné zabaliť. Model balenia na presun lokalít medzi servermi v šablóne. Vytvorte novú šablónu z lokality, ktorú ste vytvorili na vývojovom serveri, a potom šablónu stiahnite.
Príkaz cec create-template-from-site
v nasledujúcom príklade vytvorí šablónu lokality s názvom blog2
zo šablóny blog
.
cec create-template-from-site blog2 -s blog
Šablónu, ktorú ste vytvorili, stiahnite z vývojovej lokality pomocou príkazu cec download-template
:
cec-components: cec download-template blog2 --server DEV - Logged in to remote server: https://<host>:<port> - establish user session - export template - template download to /Users/<user-name>/devenv/git/webclient/developer/sites-toolkit/cec-components/dist/blog2.zip - the template will be at /Users/<user-name>/devenv/git/webclient/developer/sites-toolkit/cec-components/src/main/templates/blog2 - the theme for the template will be at /Users/<user-name>/devenv/git/webclient/developer/sites-toolkit/cec-components/src/main/themes/blogTheme - create link _scs_theme_root_ - create link _scs_design_name_ - override component /Users/<user-name>devenv/git/webclient/developer/sites-toolkit/cec-components/src/main/components/Starter-Blog-Author-Summary - override component /Users/<user-name>devenv/git/webclient/developer/sites-toolkit/cec-components/src/main/components/Starter-Blog-Post-Content - override component /Users/<user-name>devenv/git/webclient/developer/sites-toolkit/cec-components/src/main/components/Starter-Blog-Post-Header - override component /Users/<user-name>devenv/git/webclient/developer/sites-toolkit/cec-components/src/main/components/Starter-Blog-Post-Search-Result - override component /Users/<user-name>devenv/git/webclient/developer/sites-toolkit/cec-components/src/main/components/Starter-Blog-Post-Post-Sidebar - override component /Users/<user-name>devenv/git/webclient/developer/sites-toolkit/cec-components/src/main/components/Starter-Blog-Post-Summary - set themeName to blogTheme in siteinfo.json - unzip tmplate content file *** template is ready to test: https://localhost:8085/templates/blog2 cec upload-template blog2 --server UAT
Nahrajte šablónu na vytvorenie typov obsahu a máp rozloženia obsahu.
cec upload-template blog2 --server UAT
Nahrajte šablónu, ale vylúčte z nej obsahové položky (šablónu obsahu).
cec upload-template blog2 --server UAT -x
Týmto vytvoríte lokalitu s obsahom, ktorá má rovnaké identifikátory GUID ako pôvodná lokalita. Keď vytvoríte lokalitu zo šablóny, ktorá má obsah, celý obsah na novej lokalite bude mať nové identifikátory GUID. Pretože chceme povoliť aktualizáciu obsahu radšej ako vytváranie nového obsahu, obsah je potrebné zo šablóny vylúčiť.
Zo šablóny vytvorte lokalitu.
cec create-site blog -t blog2 -r r -l "en-US" -d "end-US" --server UAT
Šablónu obsahu nahrajte na kanál a do kolekcie lokality. Toto je potrebné urobiť, pretože v kroku 7 ste šablónu obsahu vylúčili zo šablóny.
cec upload-content blog2 -t -r r -c blog -l "blog site" --server UAT
Lokalitu publikujte na testovacom serveri a prepnite ju do režimu online.
Pomocou príkazu cec control-site
lokalitu publikujte a prepnite ju do režimu online:
cec-components> cec control-site publish --site blog --server UAT - Logged in to the remote server: https://<host>:<port> - establish user session - get site: runtimeStatus: offline publishStatus: unpublished - submit publish site - publish in process: percentage 20 - publish in process: percentage 40 - publish in process: percentage 49 - publish in process: percentage 49 - publish in process: percentage 50 - publish in process: percentage 50 - publish blob finished
Ak následne vykonáte zmeny v šablóne blog
lokality na serveri DEV, môžete ich propagovať na lokalitu, ktorú ste už vytvorili na serveri UAT.
Z lokality vytvorte ďalšiu šablónu, ktorá bude obsahovať vykonané zmeny.
cec create-template-from-site blog3 -s blog --server DEV
Stiahnite šablónu.
cec download-template blog3 -s DEV
Nahrajte šablónu a vytvorte z nej lokalitu, aby sa zmeny propagovali do testovacieho prostredia.
cec upload-template blog3 -s UAT
Tento príkaz vytvorí alebo aktualizuje všetky zmenené komponenty a motívy, ale vylúči obsah.
Teraz pomocou príkazu update-site
načítajte obsah a aktualizujte stránky.
cec update-site blog -t blog3 - UAT
Príklad:
cec-components> cec update-site blog -t blog3 --server UAT Updating site: blog3 - Logged in to remote server: https://<host>:<port> - pages : updating file# 6 of 6 files - content : updating file# 3 of 3 files - System Files : updating file# 5 of 5 files - controller : no files in update, removing files on server - favicons : no files in update, removing files on server - misc : no files in update, removing files on server - seo : no files in update, removing files on server - system : no files in update, removing files on server - created content file /Users/<user-name>/devenv/git/webclient/developer/sites-toolkit/cec-compnents/dist/blog3_export.zip - upload content file - get CSRF token - submit import job, updating content - import job in progress. . . - import job in progress. . . - import job in progress. . . - content imported: Update Site Results: - Site Pages : completed with 0 errors. - Embedded Content : completed with 0 errors. - System Files : completed with 0 errors. - Settings Files : completed with 0 errors. - Content Update : completed with 0 errors.
Skontrolujte lokalitu a zistite, či sa vykonané zmeny propagovali.
Pri presune lokality zo servera UAT na server PROD postupujte rovnako, ako ste postupovali pri jej presune zo servera DEV na server UAT.
Vytvorte lokalitu na produkčnom serveri, prepnite ju online a overte vykonané zmeny.
Pomocou príkazu cec list
môžete zobraziť obsah produkčnej lokality a overiť, či obsahuje zmeny, ktoré ste vykonali vo vývojovom prostredí. Zároveň môžete overiť, či sa zmeny lokality propagovali do produkcie.