När du har utvecklat en webbplatsmall kan du använda kommandoradsgränssnittet (CLI) i OCE Toolkit för att sprida mallen från utveckling till test till produktion på servrarna för Oracle Content Management.
Du kan sprida ändringar genom att använda verktygskommandon för att skapa webbplatser och hantera deras livscykler på utvecklingsservrar, testservrar och produktionsservrar. Du kan utföra ändringar på webbplatser i en utvecklingsmiljö och sprida de här ändringarna till testmiljö och produktionsmiljö. Du kan även införliva den här uppsättningen kommandoradsverktyg i skriptmiljöerna för att hantera distributioner. Med CLI-verktygen kan du distribuera nya objekt, t.ex. tillgångar och komponenter, samt uppdateringar av befintligt innehåll.
I följande steg visas hur du använder CLI i verktygen för OCE för att sprida ändringarna från utveckling till test till produktion:
Ställ in utvecklings-, test- och produktionsservrar med samma datalager och språkanpassningspolicy.
För att sprida ändringar från en utvecklingsserver till en testserver och sedan till en produktionsserver måste du ställa in ett datalager med samma namn och språkanpassningspolicy på var och en av de tre servrarna. Standardinställningen för tillgångsdatalagrets språkanpassningspolicy är en-US, men du kan använda en annan om den är densamma på alla tre servrar.
Registrera utvecklings-, test- och produktionsservrarna med Oracle Content Management.
Innan du sprider ändringar på en webbplats måste du registrera var och en av servrarna. Du kan registrera en server med kommandot cec register-server
i verktygen för OCE:
cec register-server <name>
Ange följande kommandoalternativ:
-e <endpoint> för serverns URL
-u <user> och -p <password> för att ansluta till servern
-t <type>, som är valfritt, för att ange servertypen. Standardvärdet är pod_ec
.
Vid anslutning till en klient för Oracle Content Management på Oracle Public Cloud ska du endast använda pod_ec
.
Till exempel registrerar följande kommando en server som är en klient på Oracle Public Cloud:
cec register-server DEV -e https://DEV.example.com -u user1 -p <password>
Nästa kommando registrerar en fristående utvecklingsinstans av Oracle Content Management:
cec register-server DEV -e https://DEV.git.oraclecorp.example.com -u user1 -p <password>
När du har registrerat en server för Oracle Content Management kan du lista dess innehåll med verktygskommandot cec list
.
Följande kommando listar innehållet på en utvecklingsserver:
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
Ladda upp en webbplatsmall till utvecklingsservern och skapa en webbplats från mallen.
Du kan skapa en webbplatsmall med kommandot cec create-template
och sedan ladda upp mallen till utvecklingsservern. Sedan kan du skapa en webbplats från mallen med kommandot cec create-site
. Följande kommandon skapar en mall och laddar upp mallen:
- cec create-template blog -f BlogTemplate - cec upload-template blog -s DEV
Nästa kommando skapar en webbplats med namnet blog
från den uppladdade mallen:
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
Publicera webbplatsen och ta den online på utvecklingsservern.
När du har skapat en webbplats kan du använda kommandot cec control-site
för att publicera webbplatsen och ta den 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
För att flytta en webbplats från DEV till UAT måste du paketera webbplatsen. Paketeringsmodellen för att flytta webbplatser mellan servrar är mallen. Skapa en ny mall från webbplatsen du skapade på utvecklingsservern och ladda ned mallen.
Kommandot cec create-template-from-site
i följande exempel skapar en webbplatsmall benämnd blog2
från blog
.
cec create-template-from-site blog2 -s blog
Ladda ned mallen du skapade från utvecklingswebbplatsen med kommandot 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
Ladda upp mallen för att skapa innehållstyperna och innehållslayoutmappningarna.
cec upload-template blog2 --server UAT
Ladda upp mallen, men exkludera innehållsobjekten (innehållsmall) från mallen.
cec upload-template blog2 --server UAT -x
Du gör detta för att skapa en webbplats med innehåll som har samma GUID:n som den ursprungliga webbplatsen. När du skapar en webbplats från en mall som har innehåll får allt innehåll på den nya webbplatsen nya GUID:n. Eftersom vi vill möjliggöra uppdatering av innehåll snarare än skapa nytt innehåll måste du exkludera innehållet från mallen.
Skapa webbplatsen från mallen.
cec create-site blog -t blog2 -r r -l "en-US" -d "end-US" --server UAT
Ladda upp innehållsmallen till webbplatsens kanal och samling. Du måste göra detta eftersom du exkluderade den från mallen i steg 7.
cec upload-content blog2 -t -r r -c blog -l "blog site" --server UAT
Publicera webbplatsen och ta den online på testservern.
Använd kommandot cec control-site
för att publicera webbplatsen och ta den 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
Om du sedan gör ändringar på webbplatsen blog
på DEV-servern kan du sprida ändringarna till den webbplats du redan har skapat på UAT-servern.
Skapa en till mall från webbplatsen, så att mallen innehåller ändringarna.
cec create-template-from-site blog3 -s blog --server DEV
Ladda ned mallen.
cec download-template blog3 -s DEV
Ladda upp mallen och skapa en webbplats från den för att sprida ändringarna till testmiljön.
cec upload-template blog3 -s UAT
Det här kommandot skapar eller uppdaterar alla komponenter och teman som har ändrats, men exkluderar innehållet.
Använd nu kommandot update-site
för att hämta innehållet och uppdatera sidorna.
cec update-site blog -t blog3 - UAT
Exempel:
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.
Kontrollera webbplatsen för att verifiera att ändringarna har spridits.
Utför samma steg för att flytta från UAT-servern till PROD-servern som du utförde för att flytta webbplatsen från DEV till UAT.
Skapa webbplatsen på produktionsservern, ta den online och kontrollera ändringarna.
Du kan använda kommandot cec list
för att visa innehållet på produktionswebbplatsen och kontrollera att den inkluderar ändringarna du gjorde i utvecklingsmiljön. Du kan även kontrollera webbplatsen för att verifiera att ändringarna har spridits till produktion.