Exportación e importación de temas personalizados y configuración de sitio

Puede utilizar los mandatos del portal en la CLI del kit de herramientas para replicar los cambios de una instancia del Portal del desarrollador a otra. Es posible que desee utilizar estos mandatos para copiar los temas o un cambio de configuración, desde un entorno de transición a un entorno de producción.

Antes de empezar

Para completar este escenario, debe tener un Portal del desarrollador de transición y un Portal del desarrollador de producción habilitado. Debe tener acceso de administrador, y el permiso settings:manage, a ambos para completar este escenario. La guía de aprendizaje Creación del portal explica cómo habilitar el portal si todavía no lo ha hecho.

Acerca de este escenario

En este escenario, en el Portal del desarrolladorde transición, cree un tema y realice algunos cambios de configuración. A continuación, utilice la CLI del kit de herramientas para replicar los cambios en el Portal del desarrolladorde producción.

Este caso de ejemplo le lleva a través de los pasos siguientes:
  1. Cree un tema personalizado en el Portal del desarrolladorde transición.
  2. Añada un campo a un tipo de contenido de aplicación para cambiar el site-config en el Portal del desarrolladorde transferencia.
  3. Utilice cli para exportar los temas personalizados y site-config en el Portal del desarrolladorde transferencia.
  4. Utilice cli para importar los temas personalizados y site-config en el Portal del desarrolladorde producción.

Crear un tema personalizado en el Portal del desarrollador de transferencia

  1. Inicie sesión en el Portal del desarrollador de transición como administrador.
  2. Si no se visualiza el panel de control del administrador, pulse Gestionar para visualizarlo.
  3. Pulse Aspecto > Generar subtema. Se visualiza la ventana Generate sub-theme .
  4. Especifique un Nombre de subtemay seleccione CSS para el Tipo de subtema. (Si lo prefiere, puede seleccionar SCSS, pero esta extensión a CSS es para desarrolladores de temas avanzados y no está cubierta por este escenario.)
    Generar ventana de subtema.
  5. Seleccione la plantilla Predeterminada en la que basar su sub-theme . Puede crear un sub-theme basado en una plantilla de color. Sin embargo, para este escenario se utiliza la plantilla connect_theme predeterminada.
  6. Pulse Generar.
  7. Descargue el sub-theme generado en una ubicación de su elección y extraiga todos los archivos del archivo .zip .

En el sistema, vaya a los archivos que ha extraído. Busque el archivo overrides.css aquí banka_theme/banka_theme/css/overrides.css. Ahora puede personalizar el archivo overrides.css .

  1. Abra el archivo overrides.css en el editor elegido.
  2. Personalice sub-theme especificando los siguientes elementos en el archivo overrides.css :
    /* Body of the home page */
body.path-frontpage.contexthome {
  color: #152935;
  background-color: #d1f0f7;
}

/* Header of the home page */
.navbar {
  background-color: #a0a0a0;
}

/* Footer of the home page */
footer.footer {
background-color: #dee0e2;
}

footer.footer ul.nav > li > a {
color: #454A4C;
}
    Copie el bloque de código proporcionado en el archivo css
  3. Guarde el archivo overrides.css.

Ahora puede instalar y habilitar el tema personalizado.

  1. Cuando haya terminado de actualizar el archivo overrides.css , vuelva a comprimir todos los archivos de tema en el archivo .zip sub-theme que ha descargado originalmente.
  2. En el Portal del desarrollador, pulse Aspecto > Instalar nuevo tema. Se visualiza la ventana Install new theme .
  3. En Cargar un módulo o archivador de tema para instalar pulse Examinary vaya al archivo de tema comprimido recién actualizado.
  4. Pulse Instalar para instalar el tema en el sitio.
  5. Pulse Habilitar temas recién añadidosy busque el tema nuevo en la lista de Disabled themes. Pulse Habilitar y establecer como predeterminado para establecer el nuevo sub-theme personalizado como el tema predeterminado para el sitio.
  6. Vuelva a la página de inicio del Portal del desarrollador pulsando Volver al sitio. Ahora puede ver el tema personalizado.
    La página de inicio con el tema actualizado

Añada un campo a un tipo de contenido de aplicación para cambiar el site-config en el Portal del desarrollador de transferencia

  1. Inicie sesión en el Portal del desarrollador de transición como administrador.
  2. Si no se visualiza el panel de control del administrador, pulse Gestionar para visualizarlo.
  3. Pulse Estructura > Tipos de contenido > Aplicación > Gestionar campos.
  4. Pulse + Añadir campo.
  5. En Add a new field, seleccione Texto (sin formato, largo). Especifique Company name como título de etiqueta.

    Una captura de pantalla de la página Añadir campo

  6. Pulse Guardar y continuar.
  7. Deje el Allowed number of values establecido en 1 y pulse Guardar valores de campo.
  8. Pulse Guardar valores de campo. Ahora puede ver su nuevo campo.

    Nuevo campo que ahora se muestra en la lista

Utilice la CLI del kit de herramientas para exportar los temas personalizados y site-config en el Portal del desarrollador de transferencia

  1. Inicie sesión en el servidor de gestión.
    apic login --server management_server --realm realm --username org_username --password org_password
    Por ejemplo:
    apic login -s manager.stagingexample.com --realm provider/default-idp-2 --username ibm --password Qwerty123£

    Para obtener más información sobre las opciones de variables, consulte Inicio de sesión en un servidor de gestión.

  2. Exporte los temas personalizados.
    El mandato custom-theme:create-export crea una tarea de exportación en el portal de los catalog y orgespecificados. A continuación, el mandato sondea el estado de la tarea hasta que tiene FINISHED y los artefactos se vuelven a transmitir.
    Nota: El mandato continúa sondeando hasta que se alcanza el tiempo máximo de sondeo de 15 minutos. En ese momento puede utilizar los mandatos custom-theme:get-export-status y custom-theme:get-export para obtener el estado y potencialmente un artefacto.
    apic --mode portaladmin custom-theme:create-export --catalog name/id --org name/id --server management_server
    • El tema .tgz se guarda en el directorio en el que ha ejecutado el mandato.
    • El .tgz guardado tiene el formato custom_theme_createExport-20200217134637.tgz.
    • Puede guardar las exportaciones en el sistema de gestión de control de cambios.
    Por ejemplo:
    apic --mode portaladmin custom-theme:create-export --catalog dev --org ibm --server manager.stagingexample.com
  3. Exporte la configuración del sitio.

    El mandato site-config:create-export crea una tarea de exportación en el portal del catalog y orgespecificados, a continuación, el mandato sondea el estado de la tarea hasta que tiene FINISHED y los artefactos se vuelven a transmitir.

    apic --mode portaladmin site-config:create-export --catalog name/id --org name/id --server management_server
    • La configuración del sitio .tgz se guarda en el directorio en el que ha ejecutado el mandato.
    • El .tgz guardado tiene el formato site_config_createExport-20200217134637.tgz.
    • Puede guardar las exportaciones en el sistema de gestión de control de cambios.
    Por ejemplo:
    apic --mode portaladmin site-config:create-export --catalog dev --org ibm --server manager.stagingexample.com
Nota: Para solucionar problemas relacionados con la exportación o importación de site-config , consulte ¿Por qué tengo problemas de migración con entornos no idénticos?

Utilice la CLI del kit de herramientas para importar los temas personalizados y site-config en el Portal del desarrollador de producción

  1. Inicie sesión en el servidor de gestión.
    apic login --server management_server --realm realm --username org_username --password org_password
    Por ejemplo:
    apic login -s manager.productionexample.com --realm provider/default-idp-2 --username ibm --password Qwerty123£

    Para obtener más información sobre las opciones de variables, consulte Inicio de sesión en un servidor de gestión.

  2. Importe los temas personalizados.
    El mandato custom-theme:create-import utiliza el archivo .tgz proporcionado para importar los temas personalizados en el portal de los catalog y orgespecificados. A continuación, el mandato sondea el estado de la tarea hasta que la tarea tiene FINISHED correctamente o ha fallado debido a un error.
    Nota: El mandato continúa sondeando hasta que se alcanza el tiempo máximo de sondeo de 15 minutos. En ese momento, puede utilizar el mandato custom-theme:get-import-status para obtener el estado de la importación.
    apic --mode portaladmin custom-theme:create-import --catalog name/id --org name/id --server management_server /PATH/TO/THEME/TGZ
    Por ejemplo:
    apic --mode portaladmin custom-theme:create-import --catalog prod --org ibm --server manager.productionexample.com C:/users/example/desktop/custom_theme_createExport-20200217134637.tgz
  3. Importe la configuración del sitio.

    El mandato site-config:create-import utiliza el archivo .tgz proporcionado para importar la configuración del sitio en el portal del catalog y orgespecificados. A continuación, el mandato sondea el estado de la tarea hasta que la tarea tiene FINISHED correctamente o ha fallado debido a un error.

    apic --mode portaladmin site-config:create-import --catalog name/id --org name/id --server management_server /PATH/TO/CONFIG/TGZ
    Por ejemplo:
    apic --mode portaladmin site-config:create-import --catalog prod --org ibm --server manager.productionexample.com C:/users/example/desktop/site_config_createExport-20200217134637.tgz

Qué ha hecho en este escenario

En este escenario, ha creado un tema y ha cambiado la configuración en el Portal del desarrolladorde transición. A continuación, ha utilizado la CLI del kit de herramientas para replicar los cambios en el Portal del desarrolladorde producción.

Ahora puede ver los cambios que ha realizado en el Portal del desarrolladorde producción.