Configuración de MobileFirst Server en IBM Cloud Private

improve this page | report issue

Visión general

Siga las instrucciones siguientes para configurar una instancia de MobileFirst Server y una instancia de MobileFirst Analytics en IBM Cloud Private:

  • Configure IBM Cloud Private Kubernetes Cluster.
  • Configure el sistema host con las herramientas necesarias (Docker, IBM Cloud CLI ( bx ), IBM Cloud Private (icp) Plugin for IBM Cloud CLI (bx pr), Kubernetes CLI (kubectl)) y Helm CLI (helm)).
  • Descargue el archivo Passport Advantage (archivo PPA) de IBM Mobile Foundation para IBM Cloud Private.
  • Cargue el archivo PPA en IBM Cloud Private Cluster.
  • Finalmente, deberá configurar e instalar MobileFirst Analytics (opcional) y MobileFirst Server.

Ir a:

Requisitos previos

Debe tener una cuenta de IBM Cloud Private y debe haber configurado Kubernetes Cluster siguiendo la documentación de instalación de IBM Cloud Private.

Para gestionar los contenedores y las imágenes, debe instalar las herramientas siguientes en la máquina host como parte de la configuración de IBM Cloud Private:

  • Docker
  • IBM Cloud CLI (bx)
  • IBM Cloud Private (ICP) plugin for IBM Cloud CLI ( bx pr )
  • Kubernetes CLI (kubectl)
  • Helm (helm)

Para acceder a IBM Cloud Private Cluster mediante CLI, debe configurar el cliente kubectl. Más información.

Descargar el archivo Passport Advantage de IBM Mobile Foundation

El archivo Passport Advantage (PPA) de IBM Mobile Foundation está disponible aquí. El archivo PPA de Mobile Foundation contendrá las imágenes docker y los gráficos Helm de los componentes siguientes de Mobile Foundation:

  • MobileFirst Server
  • MobileFirst Analytics
  • MobileFirst Application Center

Cargar el archivo Passport Advantage de IBM Mobile Foundation

Antes de cargar el archivo PPA de Mobile Foundation, debe configurar Docker. Consulte las instrucciones aquí.

Siga los pasos indicados a continuación para cargar el archivo PPA en el clúster de IBM Cloud Private:

  1. Inicie sesión en el clúster con IBM Cloud ICP plugin (bx pr).

    Consulte Referencia de mandatos de CLI en la documentación de IBM Cloud Private.

    Por ejemplo:

     bx pr login -a https://ip:port
    

    Opcionalmente, si desea omitir la validación SSL, utilice el distintivo --skip-ssl-validation en el mandato anterior. Mediante esta opción, se solicitan los valores de username y password del punto final del clúster. Continúe con los pasos siguientes, una vez iniciada la sesión.

  2. Cargue el archivo PPA de Mobile Foundation mediante el mandato siguiente:
     bx pr load-ppa-archive --archive <archive_name> [--clustername <cluster_name>] [--namespace <namespace>]
    

    archive_name de Mobile Foundation es el nombre del archivo PPA descargado desde IBM Passport Advantage,

    --clustername puede ignorarse si se ha seguido el paso anterior y se ha establecido el punto final del clúster como valor predeterminado para bx pr.

  3. Después de cargar el archivo PPA, sincronice los repositorios, lo que garantiza que se listen los gráficos Helm en el Catálogo. Puede realizar esta acción en la consola de gestión de IBM Cloud Private.
    • Seleccione Administración > Repositorios.
    • Pulse Sincronizar repositorios.
  4. Vea las imágenes Docker y los gráficos Helm en la consola de gestión de IBM Cloud Private. Para ver las imágenes Docker,
    • Seleccione Plataforma > Imágenes.
    • Los gráficos Helm se muestran en el Catálogo.

Tras completar los pasos anteriores, verá que aparece la versión cargada de los gráficos Helm en el catálogo de ICP. MobileFirst Server se lista como ibm-mfpf-server-prod, y MobileFirst Analytics como ibm-mfpf-analytics-prod.

Instalar y configurar gráficos Helm de IBM Mobile Foundation

Antes de instalar y configurar MobileFirst Server, debe tener lo siguiente:

  • [Obligatorio] una base de datos DB2 configurada y lista para utilizar. Necesitará la información de base de datos para configurar MobileFirst Server helm. MobileFirst Server requiere un esquema y tablas, que se crearán (si no existen) en esta base de datos.

  • [Opcional] un secreto con el almacén de claves y el almacén de confianza. Puede proporcionar su propio almacén de claves y almacén de confianza para el despliegue creando un secreto con su propio almacén de claves y almacén de confianza.

    Antes de la instalación, siga estos pasos:

    • Cree un secreto con keystore.jks, keystore-password.txt, truststore.jks, truststore-password.txt y proporcione el nombre del secreto en el campo keystores.keystoresSecretName.

    • Guarde los archivos keystore.jks y su contraseña en un archivo denominado keystore-password.txt, y truststore.jks y su contraseña en un archivo denominado truststore-password.jks.

    • Vaya a la línea de mandatos y ejecute:
      kubectl create secret generic mfpf-cert-secret --from-file keystore-password.txt --from-file truststore-password.txt --from-file keystore.jks --from-file truststore.jks
      

      Nota: Los nombres de los archivos debe ser los mencionados, es decir, keystore.jks, keystore-password.txt, truststore.jks y truststore-password.txt.

    • Proporcione el nombre del secreto en keystoresSecretName para sustituir los almacenes de claves predeterminados.

    Para obtener más información, consulte Configuración del almacén de claves de MobileFirst Server.

Variables de entorno de MobileFirst Analytics

La tabla siguiente indica las variables de entorno utilizadas en MobileFirst Analytics en IBM Cloud Private.

Calificador Parámetro Definición Valor permitido
arch   Arquitectura de nodo de trabajador Arquitectura de nodo de trabajador en la que debe desplegarse este gráfico.
Actualmente, solo se admite la plataforma AMD64.
image pullPolicy Política de extracción de imágenes El valor predeterminado es IfNotPresent.
  tag Etiqueta de imagen Docker Consulte Descripción de etiquetas de Docker
  name Nombre de imagen Docker Nombre de la imagen docker de Operational Analytics.
scaling replicaCount Número de instancias (pods) de Operational Analytics que deben crearse Número entero positivo
El valor predeterminado es 2
mobileFirstAnalyticsConsole user Nombre de usuario de Operational Analytics El valor predeterminado es admin.
  password Contraseña de Operational Analytics El valor predeterminado es admin.
analyticsConfiguration clusterName Nombre del clúster de Analytics El valor predeterminado es mobilefirst
  analyticsDataDirectory Vía de acceso donde se almacenan los datos de análisis. La vía de acceso será la misma si la reclamación de volumen persistente se monta dentro del contenedor. El valor predeterminado es /analyticsData
  numberOfShards Número de fragmentos Elasticsearch de Analytics Número entero positivo
El valor predeterminado es 2
  replicasPerShard Número de réplicas Elasticsearch que se van a mantener por cada fragmento de Analytics Número entero positivo
El valor predeterminado es 2
keystores keystoresSecretName Consulte Instalar y configurar gráficos Helm de IBM Mobile Foundation, donde se describen los pasos para crear el secreto con los almacenes y sus contraseñas.  
jndiConfigurations mfpfProperties Propiedades JNDI que se deben especificar para personalizar Operational Analytics Proporcione pares nombre-valor separados por comas.
resources limits.cpu Describe la cantidad máxima de CPU permitidas El valor predeterminado es 2000m
Lea el significado de CPU.
  limits.memory Describe la cantidad máxima de memoria permitida El valor predeterminado es 4096Mi
Lea el significado de memoria.
  requests.cpu Describe la cantidad mínima de CPU necesarias. Si no se especifica, el valor predeterminado será limits (si se especifica) o el valor definido por implementación. El valor predeterminado es 1000m.
  requests.memory Describe la cantidad mínima de memoria necesaria. Si no se especifica, el valor predeterminado de la cantidad de memoria será limits (si se especifica) o el valor definido por implementación. El valor predeterminado es 2048Mi.
persistence existingClaimName El nombre de la reclamación de volumen de persistencia (PVC)  
logs consoleFormat Especifica el formato de salida del registro del contenedor. El valor predeterminado es json.
  consoleLogLevel Controla la granularidad de los mensajes que van al registro del contenedor. El valor predeterminado es info.
  consoleSource Especifica los orígenes que se escriben en el registro del contenedor. Utilice una lista separada por comas para varios orígenes. El valor predeterminado es message, trace, accessLog, ffdc.

Variables de entorno de MobileFirst Server

La tabla siguiente indica las variables de entorno utilizadas en MobileFirst Server en IBM Cloud Private.

Calificador Parámetro Definición Valor permitido
arch   Arquitectura de nodo de trabajador Arquitectura de nodo de trabajador en la que debe desplegarse este gráfico.
Actualmente, solo se admite la plataforma AMD64.
image pullPolicy Política de extracción de imágenes El valor predeterminado es IfNotPresent.
  tag Etiqueta de imagen Docker Consulte Descripción de etiquetas de Docker
  name Nombre de imagen Docker Nombre de la imagen Docker de Server.
scaling replicaCount Número de instancias (pods) de Server que deben crearse Número entero positivo
El valor predeterminado es 3
mobileFirstOperationsConsole user Nombre de usuario de Server El valor predeterminado es admin.
  password Contraseña del usuario de Server El valor predeterminado es admin.
existingDB2Details db2Host Dirección IP o HOST de la base de datos DB2 donde se deben configurar las tablas de Server Actualmente, solo se admite DB2.
  db2Port Puerto en el que está configurada la base de datos DB2  
  db2Database Nombre de la base de datos que está preconfigurada para utilizar en DB2  
  db2Username Nombre de usuario de DB2 para acceder a la base de datos DB2 El usuario debe tener acceso para crear tablas y crear el esquema si no existe todavía.
  db2Password Contraseña de DB2 de la base de datos proporcionada  
  db2Schema Esquema de DB2 de servidor que se va a crear  
  db2ConnectionIsSSL Tipo de conexión de DB2 Especifique si la conexión de la base de datos debe ser http o https. El valor predeterminado es false (http).
Asegúrese de que el puerto de DB2 también esté configurado para la misma modalidad de conexión.
existingMobileFirstAnalytics analyticsEndPoint URL del servidor de análisis Por ejemplo: http://9.9.9.9:30400.
No especifique la vía de acceso a la consola, se añadirá durante el despliegue.
       
  analyticsAdminUser Nombre de usuario del usuario administrador de analítica  
  analyticsAdminPassword Contraseña del usuario administrador de analítica  
keystores keystoresSecretName Consulte Instalar y configurar gráficos Helm de IBM Mobile Foundation, donde se describen los pasos para crear el secreto con los almacenes y sus contraseñas.  
jndiConfigurations mfpfProperties Propiedades JNDI de servidor para personalizar el despliegue Pares nombre-valor separados por comas.
resources limits.cpu Describe la cantidad máxima de CPU permitidas El valor predeterminado es 2000m
Lea el significado de CPU.
  limits.memory Describe la cantidad máxima de memoria permitida El valor predeterminado es 4096Mi
Lea el significado de memoria.
  requests.cpu Describe la cantidad mínima de CPU necesarias. Si no se especifica, el valor predeterminado es limits (si se especifica) o el valor definido por implementación. El valor predeterminado es 1000m.
  requests.memory Describe la cantidad mínima de memoria necesaria. Si no se especifica, el valor predeterminado es limits (si se especifica) o el valor definido por implementación El valor predeterminado es 2048Mi.
logs consoleFormat Especifica el formato de salida del registro del contenedor. El valor predeterminado es json.
  consoleLogLevel Controla la granularidad de los mensajes que van al registro del contenedor. El valor predeterminado es info.
  consoleSource Especifica los orígenes que se escriben en el registro del contenedor. Utilice una lista separada por comas para varios orígenes. El valor predeterminado es message, trace, accessLog, ffdc.

Para ver la guía de aprendizaje sobre el análisis de registros de utilizando Kibana, consulte aquí.

Instalación de gráficos Helm desde el catálogo de ICP

Instalación de MobileFirst Analytics

La instalación de MobileFirst Analytics es opcional. Si desea habilitar el análisis en MobileFirst Server, primero debe configurar e instalar MobileFirst Analytics, antes de instalar MobileFirst Server.

Antes de empezar la instalación del gráfico de MobileFirst Analytics, configure el Volumen persistente. Proporcione el Volumen persistente para configurar MobileFirst Analytics. Siga los pasos detallados en la documentación de IBM Cloud Private para crear el Volumen persistente.

Siga estos pasos para instalar y configurar IBM MobileFirst Analytics desde la consola de gestión de IBM Cloud Private.

  1. Vaya a Catálogo en la consola de gestión.
  2. Seleccione el gráfico helm ibm-mfpf-analytics-prod.
  3. Pulse Configurar.
  4. Proporcione las variables de entorno. Consulte Variables de entorno de MobileFirst Analytics para obtener más información.
  5. Acepte el Acuerdo de licencia.
  6. Pulse Instalar.

Instalación de MobileFirst Server

Antes de empezar la instalación de MobileFirst Server, preconfigure una base de datos DB2.

Siga estos pasos para instalar y configurar IBM MobileFirst Server desde la consola de gestión de IBM Cloud Private.

  1. Vaya a Catálogo en la consola de gestión.
  2. Seleccione el gráfico helm ibm-mfpf-server-prod.
  3. Pulse Configurar.
  4. Proporcione las variables de entorno. Consulte Variables de entorno de MobileFirst Server para obtener más información.
  5. Acepte el Acuerdo de licencia.
  6. Pulse Instalar.

Verificación de la instalación

Después de haber instalado y configurado MobileFirst Analytics (opcional) y MobileFirst Server, puede verificar la instalación y el estado de los pods desplegados mediante las acciones siguientes:

En la consola de gestión de IBM Cloud Private. Seleccione Cargas de trabajo > Releases de Helm. Pulse el nombre de release de la instalación.

Acceso a la consola

Una vez realizada la instalación correctamente, puede acceder a la consola operativa de IBM mediante <protocol>://<ip_address>:<port>/mfpconsole. Se puede acceder a la consola de IBM MobileFirst Analytics mediante <protocol>://<ip_address>:<port>/analytics/console.

El protocolo puede ser http o https. Además, tenga en cuenta que el puerto será NodePort en el caso del despliegue de NodePort. Para obtener los valores de ip_address y NodePort de los gráficos instalados, siga estos pasos:

  1. En la consola de gestión de IBM Cloud Private, seleccione Cargas de trabajo > Releases de Helm.
  2. Pulse el nombre de release de la instalación de gráfico helm.
  3. Consulte la sección Notas.

Nota: El puerto 9600 se expone internamente en el servicio Kubernetes y las instancias de Analytics lo utilizan como puerto de transporte.

Aplicación de ejemplo

Consulte las guías de aprendizaje para desplegar el adaptador de ejemplo y ejecutar la aplicación de ejemplo en IBM MobileFirst Server en ejecución en IBM Cloud Private,

Actualización de releases y gráficos Helm

Consulte Actualización de productos empaquetados para obtener instrucciones sobre cómo actualizar los gráficos/releases de helm.

Casos de ejemplo para las actualizaciones de release de Helm

  1. Para actualizar el release de helm con los cambios de los valores de values.yaml, utilice el mandato helm upgrade con el distintivo –set. Puede especificar el distintivo –set varias veces. Se dará prioridad al conjunto especificado más a la derecha en la línea de mandatos.
      helm upgrade --set <name>=<value> --set <name>=<value> <existing-helm-release-name> <path of new helm chart>
    
  2. Para actualizar el release de helm indicando valores en un archivo, utilice el mandato helm upgrade con el distintivo -f. Puede utilizar –values o el distintivo -f varias veces. Se dará prioridad al archivo especificado más a la derecha en la línea de mandatos. En el siguiente ejemplo, si myvalues.yaml y override.yaml contienen una clave denominada Test, tendrá prioridad el valor establecido en override.yaml.
      helm upgrade -f myvalues.yaml -f override.yaml <existing-helm-release-name> <path of new helm chart>
    
  3. Para actualizar el release de helm reutilizando los valores del último release y sustituyendo algunos de ellos, se puede utilizar un mandato como el siguiente:
      helm upgrade --reuse-values --set <name>=<value> --set <name>=<value> <existing-helm-release-name> <path of new helm chart>
    

Desinstalar

Para desinstalar MobileFirst Server y MobileFirst Analytics, utilice Helm CLI. Utilice el mandato siguiente para suprimir completamente los gráficos instalados y los despliegues asociados:

helm delete --purge <release_name>

release_name es el nombre de release desplegado del gráfico Helm.

Last modified on October 03, 2018