Após o desenvolvimento de um modelo de site, você pode usar a interface de linha de comando (CLI) do Kit de Ferramentas do OCE para propagar o modelo do desenvolvimento para teste e depois para produção nos servidores do Oracle Content Management.
Para propagar alterações, você pode usar os comandos do Kit de Ferramentas para criar sites e gerenciar seus ciclos de vida nos servidores de desenvolvimento, teste e produção. Você pode fazer alterações nos sites em um ambiente de desenvolvimento e propagá-las para ambientes de teste e produção. Pode também incorporar esse conjunto de utilitários de linha de comando nos ambientes de script para gerenciar implantações. Com os utilitários de CLI, é possível implantar novos itens, como ativos e componentes, bem como atualizações de conteúdo existente.
As seguintes etapas mostram como usar a CLI do Kit de Ferramentas do OCE para propagar suas alterações do desenvolvimento para o teste até a produção:
Configure os servidores de desenvolvimento, teste e produção com a mesma política de repositório e localização.
Para propagar as alterações de um servidor de desenvolvimento para um servidor de teste e, em seguida, para um servidor de produção, configure um repositório com o mesmo nome e a mesma política de localização para os três servidores. A política de localização padrão para o repositório de ativos está em inglês dos EUA, mas você pode usar outro idioma se for o mesmo nos três servidores.
Consulte Configure Repositórios de Ativos.
Registre seus servidores de desenvolvimento, teste e produção no Oracle Content Management.
Antes de propagar as alterações para um site, registre cada um dos servidores. Você pode registrar um servidor com o comando cec register-server
fornecido pelo Kit de Ferramentas do OCE:
cec register-server <name>
Especifique as seguintes opções de comando:
-e <endpoint> for the server URL
-u <user> e -p <password> para conexão com o servidor
-t <type>, que é opcional, para definir o tipo de servidor. O valor padrão é pod_ec
.
Ao estabelecer conexão com um tenant do Oracle Content Management no Oracle Public Cloud, use somente pod_ec
.
Por exemplo, o comando a seguir registra um servidor que é um tenant no Oracle Public Cloud:
cec register-server DEV -e https://DEV.example.com -u user1 -p <password>
O próximo comando registra uma instância de desenvolvimento independente do Oracle Content Management:
cec register-server DEV -e https://DEV.git.oraclecorp.example.com -u user1 -p <password>
Depois de registrar um servidor do Oracle Content Management, você pode listar conteúdo dele com o comando cec list
do Kit de Ferramentas.
O seguinte comando lista o conteúdo de um servidor de desenvolvimento:
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
Faça upload de um modelo de site para o servidor de desenvolvimento e crie um site com base no modelo.
Você pode criar um modelo de site com o comando cec create-template
e depois fazer upload do modelo para o servidor de desenvolvimento. Em seguida, poderá criar um site usando o modelo com o comando cec create-site
. Os seguintes comandos criam um modelo e fazem upload dele:
- cec create-template blog -f BlogTemplate - cec upload-template blog -s DEV
O próximo comando cria um site chamado blog
com base no modelo de upload:
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 o site e coloque-o on-line no servidor de desenvolvimento.
Depois de criar um site, você pode usar o comando cec control-site
para publicá-lo e colocá-lo on-line:
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 um site de DEV para UAT, crie o pacote do site. O tipo de pacote para mover os sites entre os servidores é o modelo. Crie um novo modelo com base no site que você criou no servidor de desenvolvimento e faça download do modelo.
O comando cec create-template-from-site
no exemplo a seguir cria um modelo de site chamado blog2
com base no blog
.
cec create-template-from-site blog2 -s blog
Faça download do modelo que você criou utilizando o site de desenvolvimento com o 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
Faça upload do modelo para criar os tipos de conteúdo e os mapas de layout de conteúdo.
cec upload-template blog2 --server UAT
Faça upload do modelo, mas exclua os itens de conteúdo (modelo de conteúdo) do modelo.
cec upload-template blog2 --server UAT -x
Você quer fazer isso para criar um site com conteúdo que tenha os mesmos GUIDs do site original. Ao criar um site com base em um modelo que tem conteúdo, todo o conteúdo do novo site terá novos GUIDs. Como queremos permitir a atualização do conteúdo em vez de criar um novo, exclua o conteúdo do modelo.
Crie o site usando o modelo.
cec create-site blog -t blog2 -r r -l "en-US" -d "end-US" --server UAT
Faça upload do modelo de conteúdo para o canal e a coleção do site. Você precisará fazer isso porque o excluiu do modelo na etapa 7.
cec upload-content blog2 -t -r r -c blog -l "blog site" --server UAT
Publique o site e coloque-o on-line no servidor de teste.
Use o comando cec control-site
para publicá-lo e colocá-lo on-line:
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
Se você depois fizer alterações no site blog
, no servidor DEV, poderá propagar as alterações para o site que já tiver criado no servidor UAT.
Crie outro modelo com base no seu site para que ele tenha suas alterações.
cec create-template-from-site blog3 -s blog --server DEV
Faça download do modelo.
cec download-template blog3 -s DEV
Faça upload do modelo e crie um site com base nele para propagar as alterações para o ambiente de teste.
cec upload-template blog3 -s UAT
Esse comando cria ou atualiza qualquer componente e tema que foi alterado, mas exclui o conteúdo.
Agora use o comando update-site
para selecionar o conteúdo e atualizar as páginas.
cec update-site blog -t blog3 - UAT
Por exemplo:
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.
Verifique o site para confirmar se as alterações foram propagadas.
Execute as mesmas etapas para mover do servidor UAT para o servidor PROD como você fez para mover o site de DEV para UAT.
Crie o site no servidor de produção, coloque-o on-line e verifique as alterações.
Você pode usar o comando cec list
para exibir o conteúdo do site de produção e certificar-se de que ele inclua as alterações feitas no ambiente de desenvolvimento. Além disso, você pode verificar o site para confirmar se as alterações foram propagadas para produção.