Nadat u een sitesjabloon hebt ontwikkeld, kunt u de opdrachtregelinterface (CLI, command-line interface) van OCE Toolkit gebruiken om de sjabloon van ontwikkelomgeving naar testomgeving naar productieomgeving te propageren op uw Oracle Content Management servers.
Als u wijzigingen wilt propageren, kunt u Toolkit opdrachten gebruiken om sites te maken en de levenscycli hiervan te beheren op ontwikkelings-, test- en productieservers. U kunt wijzigingen in sites in een ontwikkelingsomgeving aanbrengen en die wijzigingen propageren naar test- en productieomgevingen. U kunt deze set opdrachtregelprogramma's ook opnemen in uw scriptomgevingen om uw implementaties te beheren. Met de CLI-hulpprogramma’s kunt u nieuwe items uitrollen, zoals activa en componenten, en ook updates van bestaande inhoud.
In de volgende stappen wordt uitgelegd hoe u via de OCE Toolkit opdrachtregelinterface wijzigingen kunt propageren van ontwikkel- naar test- naar productieomgeving:
Stel hetzelfde repository- en lokalisatiebeleid in voor de ontwikkelings-, test- en productieserver.
Als u de wijzigingen van een ontwikkelingsserver wilt overbrengen naar een testserver en vervolgens naar een productieserver, moet u op alle drie de servers een repository met dezelfde naam en lokalisatiepolicy instellen. De standaardlokalisatiepolicy voor de activumrepository is 'en-US'. U kunt een andere policy gebruiken, zolang deze maar hetzelfde is op alle drie de servers.
Zie voor meer informatie: Activumrepository's instellen.
Registreer uw ontwikkelings-, test- en productieserver bij Oracle Content Management.
Voordat u de wijzigingen naar een site kunt propageren, moet u alle servers registreren. U kunt een server registreren met de opdracht cec register-server uit OCE Toolkit:
cec register-server <name>
Geef de volgende opdrachtopties op:
-e <endpoint> voor de server-URL
-u <gebruiker> en -p <wachtwoord> om verbinding te maken met de server
-t <type> (optioneel) om het servertype in te stellen. De standaardwaarde is pod_ec.
Wanneer u verbinding maakt met een Oracle Content Management tenant in Oracle Public Cloud, gebruikt u alleen pod_ec.
Met de volgende opdracht wordt bijvoorbeeld een server geregistreerd die een tenant is in Oracle Public cloud:
cec register-server DEV -e https://DEV.example.com -u user1 -p <password>
Met de volgende opdracht wordt een zelfstandige ontwikkelingsinstance van Oracle Content Management geregistreerd:
cec register-server DEV -e https://DEV.git.oraclecorp.example.com -u user1 -p <password>
Nadat u een Oracle Content Management server hebt geregistreerd, kunt u de inhoud ervan inventariseren met de Toolkit opdracht cec list.
Met de volgende opdracht inventariseert u de inhoud van een ontwikkelingsserver:
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 een sitesjabloon naar de ontwikkelingsserver en maak een site op basis van de sjabloon.
U kunt een sitesjabloon maken met de opdracht cec create-template en de sjabloon vervolgens uploaden naar de ontwikkelingsserver. Vervolgens kunt u een site op basis van de sjabloon maken met de opdracht cec create-site. Met de volgende opdrachten maakt en uploadt u de sjabloon:
- cec create-template blog -f BlogTemplate - cec upload-template blog -s DEV
Met de volgende opdracht maakt u een site genaamd blog op basis van de geüploade sjabloon:
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
Publiceer de site en breng deze online op de ontwikkelingsserver.
Nadat u een site hebt gemaakt, kunt u de opdracht cec control-site gebruiken om de site te publiceren en online te brengen:
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
Als u een site wilt verplaatsen van de DEV-server naar de UAT-server, moet u de site in een pakket opnemen. De sjabloon is het pakketmodel om sites tussen servers te verplaatsen. Maak een nieuwe sjabloon op basis van de site die u op de ontwikkelingsserver hebt gemaakt en download de sjabloon.
Met de opdracht cec create-template-from-site in het volgende voorbeeld maakt u een sitesjabloon genaamd blog2 op basis van blog.
cec create-template-from-site blog2 -s blog
Download de sjabloon die u op basis van de ontwikkelingssite hebt gemaakt met de opdracht 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 de sjabloon om de inhoudtypen en mappings voor inhoudlay-out te maken.
cec upload-template blog2 --server UAT
Upload de sjabloon, maar neem de inhouditems (inhoudsjabloon) niet in de sjabloon op.
cec upload-template blog2 --server UAT -x
De reden voor de uitsluiting is dat u een site wilt maken waarvan de inhoud dezelfde GUID's heeft als die in de oorspronkelijke site. Als u een site maakt op basis van een sjabloon die inhoud bevat, worden nieuwe GUID's toegewezen aan alle inhoud in de nieuwe site. U moet de inhoud uitsluiten van de sjabloon, omdat u wilt toestaan dat inhoud wordt bijgewerkt en geen nieuwe inhoud wilt maken.
Maak de site op basis van de sjabloon.
cec create-site blog -t blog2 -r r -l "en-US" -d "end-US" --server UAT
Upload de inhoudsjabloon naar het kanaal en de verzameling van de site. Deze stap is nodig omdat u in stap 7 de inhoud hebt uitgesloten van de sjabloon.
cec upload-content blog2 -t -r r -c blog -l "blog site" --server UAT
Publiceer de site en breng deze online op de testserver.
Gebruik de opdracht cec control-site om de site te publiceren en online te brengen:
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
Als u vervolgens wijzigingen in de site blog op de DEV-server maakt, kunt u de wijzigingen propageren naar de site die u al op de UAT-server hebt gemaakt.
Maak nog een sjabloon op basis van uw site, zodat de sjabloon uw wijzigingen bevat.
cec create-template-from-site blog3 -s blog --server DEV
Download de sjabloon.
cec download-template blog3 -s DEV
Upload de sjabloon en maak een site op basis van die sjabloon om de wijzigingen naar de testomgeving te propageren.
cec upload-template blog3 -s UAT
Met deze opdracht kunt u componenten en thema's maken of gewijzigde componenten en thema's bijwerken, maar de inhoud wordt uitgesloten.
Gebruik nu de opdracht update-site om de inhoud op te halen en de pagina's bij te werken.
cec update-site blog -t blog3 - UAT
Bijvoorbeeld:
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.
Controleer op de site of de wijzigingen zijn gepropageerd.
Voer dezelfde stappen uit om de site van de UAT-server naar de PROD-server te verplaatsen, op dezelfde manier waarop u de site hebt verplaatst van DEV naar UAT.
Maak de site op de productieserver, breng de site online en controleer de wijzigingen.
U kunt de opdracht cec list gebruiken om de inhoud van de productiesite te bekijken en te controleren of deze de wijzigingen bevat die u in de ontwikkelomgeving hebt aangebracht. U kunt ook controleren of de wijzigingen zijn gepropageerd naar de productieomgeving.