Alta de front-end en plataforma existente

El documento Alta de plataforma que detalla el proceso de crear una plataforma desde cero, también incluye los pasos para dar de alta un front-end; se podría extrapolar desde ahí para dar de alta un front-end para una plataforma existente, pero hemos creído preferible crear un documento aparte, dado que es un proceso relativamente frecuente.

Alta de dominios

Haremos este paso lo primero de todo para dar tiempo a que el alta se propague

Para dar de alta los dominios:

• Acceder a https://console.cloud.google.com con el usuario: support@yunbit.es
• Pulsar en Network Services y posteriormente acceder a Cloud DNS o poner en el buscador Cloud DNS

Los dominios a dar de alta deben ser:

• Tipo de subdominio: CNAME
• Dominios front-end: ppe2-<frontend>.yunbit.es y <frontend>.yunbit.es
• El campo Destino (IP/hostname) apuntará a ppe2-gc.yunbit.es (dominios PPE) o yunbit-web-yunbit-es.yunbit.es (dominios prod)

<frontend> normalmente coincide con el nombre del proyecto; pero si hay varios front-end, será necesario un elemento diferenciador.

Para verificar que los dominios están correctamente dados de alta se debería poder resolver su URL.

Añadir la información del front-end a la información técnica del proyecto.

En la plataforma Yunbit, ir a Modelo de datos BC / Plataformas BusinessCloud / Clientes / Proyectos de clientes; buscar el proyecto correspondiente; y añadir esta información (modificada para el nuevo front-end que estamos creando):

Normalmente, las secciones "Entorno de preproducción", "Entorno de producción" y "Repositorio Git" ya existirán y habrá que añadir los bloques correspondientes en su sitio.

Host virtual

Para crear un host virtual asociado a nuestra plataforma de alojamiento, basta con darlo de alta en nuestra plataforma Yunbit: Modelo de Datos BC / Plataformas BusinessCloud / Clientes / Portales de Clientes / Gestión de VirtualHosts.

En título y URL principal ponemos el subdominio correspondiente; en Portal asociado, seleccionamos el portal BusinessCloud; en Entorno y Balanceador se indica producción o preproducción según corresponda. En Tipo de producto indicamos front-end.

La ruta de despliegue debe ser el nombre del frontend (normalmente el nombre del proyecto en minúsculas) seguido de /web

Una vez creados los podemos desplegar con el botón correspondiente (aunque no funcionarán hasta que completemos el paso de crear directorios).

Credenciales para el servicio ECM

Dado que la plataforma ya existe, esto puede existir ya. Debemos verificarlo, y si falta alguna parte, añadirlas.

Para el correcto funcionamiento de los permlinks de imágenes y documentos, es necesario indicar las siguientes variables de configuración:

• dataservice_user: El nombre del usuario del servicio. Suele ser el nombre del proyecto
• dataservice_passw: La contraseña para acceder al servicio. Suele ser la contraseña del usuario de sólo lectura de base de datos
• dataservice_url: La url al servicio. En prod será: https://ondemand.yunbit.es/SRV/GeaECMCGI.php, en ppe: https://ppe2-ondemand.yunbit.es/SRV/GeaECMCGI.php, y en local: http://ondemand.local/SRV/GeaECMCGI.php

Además de añadir estas variables a 5.3.9, también es necesario añadir estos datos en la clase GeaECMService.class de la versión del producto 6.0.0 (GEANET-PRODUCTS/6.0.0/WEB-INF/classes/com/geanet/geaecm/GeaECMService.class); en el array $this->_userdata que se define en el método _readUserData(), incluir una entrada nueva con este contenido:

'IDPLAT' => array ('password' => "PWPLAT", 'db' => 'DBPLAT', 'dbuser' => 'DBUSER', 'dbpassw' => 'DBPW', 'customer' => 'METAGROUPID', 'editpattern' => '-plat-', 'db_utf8' => '1'),

Donde:

• IDPLAT es un identificador de plataforma, se suele poner el mismo del proyecto.
• PWPLAT es una contraseña asociada a ese identificador. Podemos usar la de base de datos, o inventarnos una nueva. Típicamente se pone la del usuario ro_
• DBPLAT es la base de datos de la plataforma. Suele ser igual a IDPLAT en mayúsculas.
• DBUSER el el usuario de la base de datos. Suele ser igual a IDPLAT.
• PWDB es la contraseña del usuario DBUSER.
• METAGROUPID es el identificador del metagrupo al que están asociados los contenidos.
• editpattern ya no se usa, se puede dejar tal cual; db_utf8 siempre será 1 para plataformas nuevas
• dbserver y dbport, en principio se dejan como todos los demás (bbdd06 y 6033)

IDPLAT y PWPLAT deben coincidir, respectivamente, con los valores de las variables de configuración dataservice_user y dataservice_passw

Alta de front-end

• Con FileZilla u otra aplicación ftp, establecer conexión con preproducción y acceder a la siguiente ruta: /data/webs/desarrollo/php/BusinessCloud.projects/< NOMBRE >/web, donde <NOMBRE> es el nombre de la plataforma a dar de alta
• En dicho directorio copiar:
• El favicon: favicon.ico
• El fichero Index.html, que únicamente contendrá:

<?php include("GeanetBusinessCloudWebFrontEnd_PHP/index.php")?>

• El fichero permlink.php con el contenido:

<?php include("GeanetBusinessCloudWebFrontEnd_PHP/permlinkv2.php")?>

Portal del empleado

Para dar de alta un portal del empleado es necesario, como mínimo:

• Dar de alta al menos un idioma (normalmente Español)
• Crear el web de tipo Portal del Empleado en Administración de GEA-ECM Es importante rellenar el campo Directorio de los gestores (ruta completa: /<metagrupo>_ADMIN/GEA-ECM/CMA_PORTAL) para que se creen correctamente los gestores de contenidos.
• Para el caso de plataformas existentes, la recomendación es dar de alta el portal en Producción y copiar las tablas a PPE.
• Si la solución GeaECM no está configurada para esta plataforma, hay que añadirla (tanto la solución del metamodelo, como la del metagrupo).
• Es recomendable copiar el logo a la carpeta img con nombre logo.png
• Crear un fichero local_globals.php en el directorio config. Se puede copiar de otro portal del empleado; el contenido a tener en cuenta es

<?php

// Activamos el módulo de ecommerce

$g_modules->activeModule(GeaModulesNames::EMPLOYEE_PORTAL);

// Configuramos algunas propiedades del módulo

$Module = $g_modules->getEnabledModule();

$Module->setWebId('STARMADRID_EMPLOYEEPORTAL'); // El ID del portal web en GeaECM

defined('GEA_FAPP') or define('GEA_FAPP', 'starmadrid'); //nombre de la aplicacion, Front APP

$g_base->setConfKey ("dataservice_user", "<token de usuario maestro, intentemos que no sea support>");

$g_base->setConfKey ("dataservice_passw", "");

if (preg_match ("/local/", $g_base->getHostName() ) ) {

// Variables en local

$g_base->setConfKey ("dataservice_url", "http://ondemand.local/SRV/GeaECMCGI.php");

$g_base->setConfKey('dataservice_url_bc', 'http://starmadridbc.local');

$g_base->setConfKey ("resources_baseurl", "http://starmadrid.local/");

$g_base->setConfKey ("dataservice_url_539", "http://starmadrid.local/");

$g_base->setConfKey ("bc_url", "http://starmadridbc.local");

$g_base->setConfKey ("web_url", "http://www.starmadrid.local")

} else if (preg_match ("/ppe/", $g_base->getHostName() ) ) {

// Variables en PPE

$g_base->setConfKey ("dataservice_url", "http://ppe2-ondemand.yunbit.es/SRV/GeaECMCGI.php");

$g_base->setConfKey('dataservice_url_bc', 'https://ppe2-cloud-starmadrid.yunbit.es/cloud'); // Ojo, en prod y ppe incluir el sufijo Cloud

$g_base->setConfKey ("resources_baseurl", "https://ppe2-cloud-starmadrid.yunbit.es/");

$g_base->setConfKey ("dataservice_url_539", "https://ppe2-cloud-starmadrid.yunbit.es/");

$g_base->setConfKey ("bc_url", "https://ppe2-cloud-starmadrid.yunbit.es/cloud");

$g_base->setConfKey ("web_url", "https://ppe2-starmadrid.yunbit.es")

} else {

$g_base->setConfKey ("dataservice_url", "http://ondemand.yunbit.es/SRV/GeaECMCGI.php");

$g_base->setConfKey('dataservice_url_bc', 'https://cloud-starmadrid.yunbit.es/cloud'); // Ojo, en prod incluir el sufijo Cloud

$g_base->setConfKey ("resources_baseurl", "https://cloud-starmadrid.yunbit.es/");

$g_base->setConfKey ("dataservice_url_539", "https://cloud-starmadrid.yunbit.es/");

$g_base->setConfKey ("bc_url", "https://cloud-starmadrid.yunbit.es/cloud");

$g_base->setConfKey ("web_url", "https://starmadrid.yunbit.es"); // tener en cuenta si hay varios URLs válidos (p.e. el de Yunbit y el del cliente)

$g_base->setConfKey('geaCacheActivated', true);

}

$g_base->setConfKey ("GEAECM_VALIDLANGS", 'en,es');

$g_base->setConfKey("GEAECM_COMMON_END", '1');

$g_base->setConfKey('GEAECM_404', 1);

Alta del repositorio Git

Para realizar el alta del repositorio de GIT es necesario acceder al gestor de configuración de VirtualHost en la pestaña de Modelos de Datos BC. Debemos ir a los registros correspondientes a los VirtualHost de producción.

Se deben introducir los datos relevantes de la plataforma y la ruta en el que se encuentra el mismo.
Por ejemplo al elegir el tipo de producto FrontEnd GBC este buscará dentro del directorio BussinessCloud.projects.
Una vez se encuentren los datos rellenos simplemente se debe hacer click en el botón Inicializar Repositorio y se generará un repositorio de git que coincida con dicha ruta, en este caso se genera:

gituser@git.yunbit.es:/data/reposgit/BusinessCloud.projects/tal/web

Este proceso sube lo que haya en PPE y hace un clone en prod; por tanto, no es necesario subir ficheros de un entorno a otro.