Når du har udviklet en siteskabelon, kan du bruge kommandolinjeinterfacet (CLI) i OCE Toolkit til at propagere skabelonen fra udvikling til test til produktion på Oracle Content Management-serverne.
Hvis du vil propagere ændringer, kan du bruge Toolkit-kommandoer til at oprette sites og håndtere deres livscyklus på udviklings-, test- og produktionsservere. Du kan foretage ændringer af sites i et udviklingsmiljø og propagere ændringerne til test- og produktionsmiljøer. Du kan også inkorporere dette sæt CLI-hjælpeprogrammer i dine scripting-miljøer for at håndtere dine ibrugtagninger. Ved hjælp af CLI-hjælpeprogrammerne kan du udrulle nye elementer, for eksempel aktiver og komponenter, samt opdateringer af eksisterende indhold.
De følgende trin viser, hvordan du bruger OCE Toolkit CLI til at propagere ændringer fra udvikling til test til produktion:
Konfigurer udviklings-, test- og produktionsservere med den samme informationsbase og lokaliseringspolitik.
Hvis du vil propagere ændringer fra en udviklingsserver til en testserver og derefter til en produktionsserver, skal du konfigurere en informationsbase med det samme navn og den samme lokaliseringspolitik på alle tre servere. Standardlokaliseringspolitikken for aktivinformationsbasen er en-US, men du kan bruge en anden lokaliseringspolitik, hvis den er den samme på alle tre servere.
Registrer din udviklings-, test- og produktionsserver i Oracle Content Management.
Før du propagerer ændringer til et site, skal du registrere hver enkelt server. Du kan registrere en server med OCE Toolkit-kommandoen cec register-server
:
cec register-server <name>
Angiv følgende kommandovalg:
-e <slutpunkt> for serveren-URL
-u <bruger> og -p <adgangskode> for oprettelse af forbindelse til serveren
-t <type>, der er valgfri, til angivelse af servertypen. Standardværdien er pod_ec
.
Ved oprettelse af forbindelse til en Oracle Content Management-lejer i Oracle Public Cloud skal du kun bruge pod_ec
.
Følgende kommando registrerer for eksempel en server, der er lejer i Oracle Public Cloud:
cec register-server DEV -e https://DEV.example.com -u user1 -p <password>
Den næste kommando registrerer en enkeltstående udviklingsinstans af Oracle Content Management:
cec register-server DEV -e https://DEV.git.oraclecorp.example.com -u user1 -p <password>
Når du har registreret en Oracle Content Management-server, kan du vise en liste med dens indhold ved hjælp af Toolkit-kommandoen cec list
.
Følgende kommando viser en liste med indholdet af en udviklingsserver:
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
Upload en siteskabelon til din udviklingsserver, og opret et site ud fra skabelonen.
Du kan oprette en siteskabelon med kommandoen cec create-template
og derefter uploade skabelonen til udviklingsserveren. Derefter kan du med kommandoen cec create-site
oprette et site ud fra skabelonen. Følgende kommandoer opretter en skabelon og uploader den:
- cec create-template blog -f BlogTemplate - cec upload-template blog -s DEV
Den næste kommando opretter et site med navnet blog
ud fra den uploadede skabelon:
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
Publicer sitet, og gør det online på din udviklingsserver.
Når du har oprettet et site, kan du med kommandoen cec control-site
publicere det og gøre det 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
Hvis du vil flytte et site fra DEV til UAT, skal du pakke sitet. Pakningsmodellen for flytning af sites mellem servere er skabelonen. Opret en ny skabelon fra det site, som du har oprettet på udviklingsserveren, og download skabelonen.
Kommandoen cec create-template-from-site
i det følgende eksempel opretter et site med navnet blog2
ud fra blog
.
cec create-template-from-site blog2 -s blog
Download den skabelon, som du har oprettet fra dit udviklingssite, ved hjælp af kommandoen 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
Upload skabelonen for at oprette indholdstyperne og indholdslayoutkortene.
cec upload-template blog2 --server UAT
Upload skabelonen, men udelad indholdselementerne (indholdsskabelon) i skabelonen.
cec upload-template blog2 --server UAT -x
Du gør dette for at oprette et site med indhold, der har de samme GUID'er som det oprindelige site. Når du opretter et site ud fra en skabelon med indhold, får alt indhold på det nye site nye GUID'er. Her vil vi tillade opdatering af indhold i stedet for oprettelse af nyt indhold, og du skal derfor udelade indholdet i skabelonen.
Opret sitet ud fra skabelonen.
cec create-site blog -t blog2 -r r -l "en-US" -d "end-US" --server UAT
Upload indholdsskabelonen til sitets kanal og samling. Du skal gøre dette, fordi du udelod det i skabelonen i trin 7.
cec upload-content blog2 -t -r r -c blog -l "blog site" --server UAT
Publicer sitet, og gør det online på din testserver.
Brug kommandoen cec control-site
til at publicere sitet og gøre det 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
Hvis du derefter foretager nogen ændringer af dit site blog
på DEV-serveren, kan du propagere ændringerne til sitet, som du allerede har oprettet på UAT-serveren.
Opret en ny skabelon ud fra dit site, så skabelonen kommer til at indeholde dine ændringer.
cec create-template-from-site blog3 -s blog --server DEV
Download skabelonen.
cec download-template blog3 -s DEV
Upload skabelonen, og opret et site ud fra den for at propagere ændringerne til dit testmiljø.
cec upload-template blog3 -s UAT
Denne kommando opretter eller opdaterer alle komponenter og temaer, som er ændret, men udelader indholdet.
Brug nu kommandoen update-site
til at hente indholdet og opdatere siderne.
cec update-site blog -t blog3 - UAT
Eksempel:
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.
Kontroller sitet for at verificere, at ændringerne er propageret.
Udfør de samme trin for at flytte sitet fra UAT-serveren til PROD-serveren som du har udført for at flytte sitet fra DEV til UAT.
Opret sitet på produktionsserveren, gør det online, og verificer ændringerne.
Du kan bruge kommandoen cec list
til at vise indholdet af produktionssitet og kontrollere, at det indeholder de ændringer, som du har foretaget i udviklingsmiljøet. Du kan også kontrollere sitet for at verificere, at ændringerne er propageret til produktionsmiljøet.