Nachdem Sie eine Sitevorlage entwickelt haben, können Sie die Befehlszeilenschnittstelle (CLI) von OCE Toolkit verwenden, um die Vorlage auf den Oracle Content Management-Servern von der Entwicklungsphase über die Testphase zur Produktionsphase zu propagieren.
Bei der Propagierung von Änderungen können Sie Toolkit-Befehle verwenden, um Sites zu erstellen und deren Lebenszyklen auf Entwicklungs-, Test- und Produktionsservern zu verwalten. Sie können Änderungen an Sites in einer Entwicklungsumgebung vornehmen und diese Änderungen zu Test- und Produktionsumgebungen propagieren. Sie können dieses Set aus Befehlszeilenutilitys auch in Ihre Scripting-Umgebungen integrieren, um Deployments zu verwalten. Mit den CLI-Utilitys können Sie neue Elemente wie Assets und Komponenten einführen sowie vorhandenen Inhalt aktualisieren.
In den folgenden Schritten wird gezeigt, wie Sie Änderungen mit der OCE Toolkit-CLI von der Entwicklungsphase über die Testphase zur Produktionsphase propagieren:
Richten Sie die Entwicklungs-, Test- und Produktionsserver mit demselben Repository und derselben Lokalisierungs-Policy ein.
Um Änderungen von einem Entwicklungsserver zu einem Testserver und dann zu einem Produktionsserver zu propagieren, müssen Sie ein Repository mit demselben Namen und derselben Lokalisierungs-Policy auf jedem der drei Server einrichten. Die Standardlokalisierungs-Policy für das Asset-Repository ist en-US. Sie können aber auch eine andere Policy verwenden, solange sie auf allen drei Servern gleich ist.
Siehe Asset-Repositorys einrichten.
Registrieren Sie Ihre Entwicklungs-, Test- und Produktionsserver bei Oracle Content Management.
Bevor Sie Änderungen an einer Site propagieren, müssen Sie jeden der Server registrieren. Sie können einen Server mit dem Befehl cec register-server
von OCE Toolkit registrieren:
cec register-server <name>
Geben Sie die folgenden Befehlsoptionen an:
-e <endpoint> für die Server-URL
-u <user> und -p <password> für die Verbindung mit dem Server
-t <type> (optional) zum Festlegen des Servertyps. Der Standardwert lautet pod_ec
.
Wenn Sie eine Verbindung zu einem Oracle Content Management-Mandanten auf Oracle Public Cloud herstellen, verwenden Sie nur pod_ec
.
Beispiel: Mit dem folgenden Befehl registrieren Sie einen Server, der ein Mandant auf Oracle Public Cloud ist:
cec register-server DEV -e https://DEV.example.com -u user1 -p <password>
Mit dem nächsten Befehl registrieren Sie eine Standalone-Entwicklungsinstanz von Oracle Content Management:
cec register-server DEV -e https://DEV.git.oraclecorp.example.com -u user1 -p <password>
Nachdem Sie einen Oracle Content Management-Server registriert haben, können Sie dessen Inhalt mit dem Toolkit-Befehl cec list
auflisten.
Mit dem folgenden Befehl listen Sie die Inhalte eines Entwicklungsservers auf:
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
Laden Sie eine Sitevorlage in den Entwicklungsserver hoch, und erstellen Sie eine Site aus der Vorlage.
Sie können eine Sitevorlage mit dem Befehl cec create-template
erstellen und diese dann in den Entwicklungsserver hochladen. Dann können Sie mit dem Befehl cec create-site
eine Site aus der Vorlage erstellen. Mit den folgenden Befehlen können Sie eine Vorlage erstellen und hochladen:
- cec create-template blog -f BlogTemplate - cec upload-template blog -s DEV
Der nächste Befehl erstellt eine Site namens blog
aus der hochgeladenen Vorlage:
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
Veröffentlichen Sie die Site, und stellen Sie sie auf dem Entwicklungsserver online.
Nachdem Sie eine Site erstellt haben, können Sie diese mit dem Befehl cec control-site
veröffentlichen und online stellen:
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
Um eine Site von DEV zu UAT zu verschieben, müssen Sie diese verpacken. Die Vorlage dient als Verpackungsmodell zum Verschieben von Sites zwischen Servern. Erstellen Sie eine neue Vorlage aus der Site, die Sie auf dem Entwicklungsserver erstellt haben, und laden Sie diese herunter.
Der Befehl cec create-template-from-site
im folgenden Beispiel erstellt eine Sitevorlage namens blog2
aus blog
.
cec create-template-from-site blog2 -s blog
Laden Sie die Vorlage, die Sie aus der Entwicklungssite erstellt haben, mit dem Befehl cec download-template
herunter:
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
Laden Sie die Vorlage hoch, um die Inhaltstypen und Inhaltslayoutmaps zu erstellen.
cec upload-template blog2 --server UAT
Laden Sie die Vorlage ohne die Inhaltselemente (Inhaltsvorlage) hoch.
cec upload-template blog2 --server UAT -x
Damit erstellen Sie eine Site, deren Inhalt dieselben GUIDs wie die ursprüngliche Site aufweist. Wenn Sie eine Site aus einer Vorlage mit Inhalt erstellen, erhält der gesamte Inhalt in der neuen Site neue GUIDs. Da Sie den Inhalt aktualisieren und nicht neuen Inhalt erstellen möchten, müssen Sie den Inhalt aus der Vorlage ausschließen.
Erstellen Sie die Site aus der Vorlage.
cec create-site blog -t blog2 -r r -l "en-US" -d "end-US" --server UAT
Laden Sie die Inhaltsvorlage in den Kanal und die Sammlung der Site hoch. Dies ist erforderlich, weil Sie den Inhalt in Schritt 7 aus der Vorlage ausgeschlossen haben.
cec upload-content blog2 -t -r r -c blog -l "blog site" --server UAT
Veröffentlichen Sie die Site, und stellen Sie sie auf dem Testserver online.
Verwenden Sie den Befehl cec control-site
, um die Site zu veröffentlichen und online zu stellen:
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
Wenn Sie dann Änderungen an der Site blog
auf dem DEV-Server vornehmen, können Sie die Änderungen an die Site propagieren, die Sie bereits auf dem UAT-Server erstellt haben.
Erstellen Sie eine andere Vorlage aus der Site, damit diese die Änderungen enthält.
cec create-template-from-site blog3 -s blog --server DEV
Laden Sie die Vorlage herunter.
cec download-template blog3 -s DEV
Laden Sie die Vorlage hoch, und erstellen Sie eine Site daraus, um die Änderungen an die Testumgebung zu propagieren.
cec upload-template blog3 -s UAT
Dieser Befehl erstellt oder aktualisiert alle geänderten Komponenten und Themes, schließt aber den Inhalt aus.
Rufen Sie jetzt mit dem Befehl update-site
den Inhalt ab, um die Seiten zu aktualisieren.
cec update-site blog -t blog3 - UAT
Beispiel:
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.
Prüfen Sie die Site, um sicherzustellen, dass die Änderungen propagiert wurden.
Die Schritte zum Verschieben vom UAT-Server zum PROD-Server sind mit denen zum Verschieben der Site von DEV zu UAT identisch.
Erstellen Sie die Site auf dem Produktionsserver, stellen Sie sie online, und prüfen Sie die Änderungen.
Mit dem Befehl cec list
können Sie die Inhalte der Produktionssite anzeigen und sicherstellen, dass diese die in der Entwicklungsumgebung vorgenommenen Änderungen enthält. Außerdem können Sie die Site prüfen, um sicherzustellen, dass die Änderungen auf den Produktionsserver propagiert wurden.