Después de desarrollar una plantilla de sitio, puede emplear la interfaz de línea de comandos (CLI) del toolkit de OCE para propagar la plantilla del entorno de desarrollo a los de prueba y producción de los servidores de Oracle Content Management.
Para propagar los cambios, puede utilizar los comandos del toolkit para crear sitios y gestionar sus ciclos de vida en los servidores de desarrollo, prueba y producción. Puede realizar cambios en los sitios de un entorno de desarrollo y propagar dichos cambios a entornos de prueba y producción. También puede incorporar este juego de utilidades de línea de comandos en sus entornos de creación de scripts para gestionar sus despliegues. Con las utilidades de CLI, puede implementar nuevos elementos, como activos y componentes, así como actualizaciones de contenido existente.
Los siguientes pasos muestran cómo usar la CLI de toolkit de OCE para propagar los cambios del entorno de desarrollo a los de prueba y producción:
Configure los servidores de desarrollo, prueba y producción con el mismo repositorio y la misma política de localización.
Para propagar los cambios de un servidor de desarrollo a un servidor de prueba y, a continuación, a un servidor de producción, necesita configurar un repositorio con el mismo nombre y política de localización en los tres servidores. La política de localización por defecto del repositorio de activos está en en-US, pero puede usar una diferente si es la misma en los tres servidores.
Consulte Configuración de repositorios de activos.
Registre los servidores de desarrollo, prueba y producción con Oracle Content Management.
Antes de propagar los cambios a un sitio, necesita registrar cada uno de los servidores. Puede registrar un servidor con el comando cec register-server proporcionado por el toolkit de OCE:
cec register-server <name>
Especifique las siguientes opciones de comando:
-e <endpoint> para la URL del servidor.
-u <user> y -p <password> para conectarse al servidor.
-t <type>, que es opcional, para definir el tipo del servidor. El valor por defecto es pod_ec.
Cuando se conecte a un inquilino de Oracle Content Management en Oracle Public Cloud, use solo pod_ec.
Por ejemplo, el siguiente comando registra un servidor que es inquilino en Oracle Public Cloud:
cec register-server DEV -e https://DEV.example.com -u user1 -p <password>
El siguiente comando registra una instancia de desarrollo autónoma de Oracle Content Management:
cec register-server DEV -e https://DEV.git.oraclecorp.example.com -u user1 -p <password>
Después de registrar un servidor de Oracle Content Management, puede mostrar el contenido con el comando cec list del toolkit.
El siguiente comando muestra los contenidos de un servidor de desarrollo:
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
Cargue una plantilla de sitio en el servidor de desarrollo y cree un sitio a partir de la plantilla.
Puede crear una plantilla de sitio con el comando cec create-template y después cargar la plantilla en el servidor de desarrollo. A continuación, puede crear un sitio a partir de la plantilla con el comandocec create-site. Los siguientes comandos crean una plantilla y la cargan:
- cec create-template blog -f BlogTemplate - cec upload-template blog -s DEV
El siguiente comando crea un sitio denominado blog a partir de la plantilla cargada:
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
Publique el sitio y póngalo en línea en el servidor de desarrollo.
Después de crear un sitio, puede usar el comando cec control-site para publicar el sitio y ponerlo en línea:
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
Para mover un sitio de DEV a UAT, necesita hacer un paquete del sitio. El modelo de empaquetado para mover sitios entre servidores es la plantilla. Cree una plantilla nueva a partir del sitio que ha creado en el servidor de desarrollo y descargue la plantilla.
El comando cec create-template-from-site del siguiente ejemplo crea una plantilla de sitio denominada blog2 a partir de blog.
cec create-template-from-site blog2 -s blog
Descargue la plantilla que ha creado del sitio de desarrollo con el comando 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
Cargue la plantilla para crear tipos de contenido y asignaciones de diseño de contenido.
cec upload-template blog2 --server UAT
Cargue la plantilla, pero no incluya los elementos de contenido (plantilla de contenido).
cec upload-template blog2 --server UAT -x
Tiene que hacer esto para crear un sitio con contenido que tenga los mismos GUID que el sitio original. Al crear un sitio a partir de una plantilla que albergue contenido, todo el contenido del sitio nuevo tendrá nuevos GUID. Al querer actualizar el contenido en lugar de crear contenido nuevo, es necesario excluir el contenido en la plantilla.
Cree el sitio a partir de la plantilla.
cec create-site blog -t blog2 -r r -l "en-US" -d "end-US" --server UAT
Cargue la plantilla de contenido en el canal y recopilación del sitio. Es necesario hacer esto porque lo excluyó de la plantilla en el paso 7.
cec upload-content blog2 -t -r r -c blog -l "blog site" --server UAT
Publique el sitio y póngalo en línea en el servidor de prueba.
Use el comando cec control-site para publicar el sitio y ponerlo en línea:
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
Si hace cambios en el blog del sitio en el servidor DEV, puede propagarlos al sitio que ha creado en el servidor UAT.
Cree otra plantilla a partir del sitio para que guarde los cambios.
cec create-template-from-site blog3 -s blog --server DEV
Descargue la plantilla.
cec download-template blog3 -s DEV
Cargue la plantilla y cree un sitio a partir de ella para propagar los cambios al entorno de prueba.
cec upload-template blog3 -s UAT
Este comando crea o actualiza los componentes y temas que han cambiado excluyendo el contenido.
Ahora use el comando update-site para seleccionar el contenido y actualizar las páginas.
cec update-site blog -t blog3 - UAT
Por ejemplo:
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.
Compruebe el sitio para asegurarse de que los cambios se han propagado.
Realice los mismos pasos que siguió para los servidores DEV y UAT para mover del servidor UAT al servidor PROD.
Cree el sitio en el servidor de producción, póngalo en línea y compruebe los cambios.
Puede utilizar el comando cec list para ver los contenidos del sitio de producción y asegurarse de que se han incluido los cambios que ha realizado en el entorno de desarrollo. Además, puede comprobar el sitio para asegurarse de que los cambios se han propagado al servidor de producción.