Configuración de MobileFirst Server en IBM Cloud Kubernetes Cluster mediante scripts

carpeta bmx-kubernetes

Contiene los archivos de personalización y los scripts necesarios para desplegar Kubernetes Cluster con IBM Cloud Container Service.

Dockerfile-mfpf-analytics y Dockerfile-mfpf-server

• Dockerfile-mfpf-server: Documento de texto que contiene todos los mandatos necesarios para crear la imagen de MobileFirst Server.
• Dockerfile-mfpf-analytics: Documento de texto que contiene todos los mandatos necesarios para crear la imagen de MobileFirst Analytics.
• Carpeta scripts: Esta carpeta contiene la carpeta args que incluye un conjunto de archivos de configuración. También contiene los scripts necesarios para iniciar sesión en IBM Cloud, crear una imagen de MobileFirst Server/MobileFirst Analytics para enviarla por push y ejecutar la imagen en IBM Cloud. Puede optar por ejecutar los scripts de forma interactiva o configurar previamente los archivos de configuración, como se describe más adelante. Aparte de los archivos args/*.properties personalizables, no modifique ningún elemento de esta carpeta. Para obtener ayuda sobre el uso de scripts, utilice los argumentos de línea de mandatos -h o --help, por ejemplo, scriptname.sh --help.
• Carpetas usr-mfpf-server y usr-mfpf-analytics:
  • Carpeta bin: contiene el archivo de script (mfp-init) que se ejecuta cuando se inicia el contenedor. Puede añadir su propio código personalizado para ejecutarlo.
  • Carpeta config: Contiene los fragmentos de configuración del servidor (almacén de claves, propiedades del servidor, registro de usuarios) que utilizan MobileFirst Server/MobileFirst Analytics.
  • keystore.xml - la configuración del repositorio de los certificados de seguridad que se utilizan para el cifrado SSL. Debe hacerse referencia a los archivos listados en la carpeta ./usr/security.
  • ltpa.xml - el archivo de configuración que define la clave LTPA y su contraseña.
  • mfpfproperties.xml - propiedades de configuración para MobileFirst Server y MobileFirst Analytics. Consulte las propiedades soportadas en estos temas de la documentación:
    • Lista de propiedades de JNDI para el servicio de administración de MobileFirst Server
    • Lista de propiedades de JNDI para el tiempo de ejecución de MobileFirst
  • mfpfsqldb.xml - Definición de origen de datos JDBC para conectar con la base de datos DB2 o dashDB.
  • registry.xml - configuración del registro de usuarios. La configuración de basicRegistry (de forma predeterminada, se proporciona una configuración de registro de usuarios básico basado en XML). Se pueden configurar los nombres de usuarios y las contraseñas para basicRegistry o puede configurar ldapRegistry.
  • tracespec.xml - La especificación de rastreo para habilitar la depuración, así como los niveles de registro.
• Carpeta jre-security: Puede actualizar los archivos relacionados con la seguridad JRE (almacén de claves, archivos JAR de políticas, etc.) colocándolos en esta carpeta. Los archivos de esta carpeta se copian en la carpeta JAVA_HOME/jre/lib/security/ del contenedor.
• Carpeta security: Se utiliza para los archivos del almacén de claves, el almacén de confianza y las claves LTPA (ltpa.keys).
• Carpeta env: Contiene las propiedades del entorno que se utilizan para la inicialización del servidor (server.env) y las opciones de JVM personalizadas (jvm.options).



Pulse para obtener una lista de las propiedades de entorno del servidor soportadas

Propiedad	Valor predeterminado	Descripción
MFPF_SERVER_HTTPPORT	9080*	El puerto utilizado para las solicitudes HTTP de cliente. Utilice -1 para inhabilitar este puerto.
MFPF_SERVER_HTTPSPORT	9443*	El puerto utilizado para las solicitudes HTTP de cliente protegidas con SSL (HTTPS). Utilice -1 para inhabilitar este puerto.
MFPF_ADMIN_ROOT	mfpadmin	La raíz de contexto en la que estarán disponibles los servicios de administración de MobileFirst Server.
MFPF_CONSOLE_ROOT	mfpconsole	La raíz de contexto en la que estarán disponibles los servicios de administración de MobileFirst Operations Console.
MFPF_ADMIN_GROUP	mfpadmingroup	El nombre del grupo de usuarios que tiene asignado el rol mfpadmin predefinido.
MFPF_DEPLOYER_GROUP	mfpdeployergroup	El nombre del grupo de usuarios que tiene asignado el rol mfpdeployer predefinido.
MFPF_MONITOR_GROUP	mfpmonitorgroup	El nombre del grupo de usuarios que tiene asignado el rol mfpmonitor predefinido.
MFPF_OPERATOR_GROUP	mfpoperatorgroup	El nombre del grupo de usuarios que tiene asignado el rol mfpoperator predefinido.
MFPF_SERVER_ADMIN_USER	WorklightRESTUser	El usuario administrador del servidor Liberty para los servicios de administración de MobileFirst Server.
MFPF_SERVER_ADMIN_PASSWORD	mfpadmin. Asegúrese de que cambia el valor predeterminado por una contraseña privada antes del despliegue a un entorno de producción.	La contraseña del usuario administrador del servidor Liberty para los servicios de administración de MobileFirst Server.


Cerrar sección

Pulse para obtener una lista de las propiedades de entorno de Analytics soportadas

Propiedad	Valor predeterminado	Descripción
ANALYTICS_SERVER_HTTP PORT	9080*	El puerto utilizado para las solicitudes HTTP de cliente. Utilice -1 para inhabilitar este puerto.
ANALYTICS_SERVER_HTTPS PORT	9443*	El puerto utilizado para las solicitudes HTTP de cliente. Utilice -1 para inhabilitar este puerto.
ANALYTICS_ADMIN_GROUP	analyticsadmingroup	El nombre del grupo de usuarios que tiene asignado el rol worklightadmin predefinido.


Cerrar sección
• Carpeta dependencies: Contiene el tiempo de ejecución de Mobile Foundation junto con IBM Java JRE 8.
• Carpeta mfpf-libs: Contiene las bibliotecas de componentes del producto MobileFirst y CLI.

Cerrar sección

La carpeta args contiene un conjunto de archivos de configuración que contiene los argumentos necesarios para ejecutar los scripts. Rellene los valores de los argumentos en los archivos siguientes:

initenv.properties

• IBM_CLOUD_API_URL - Zona geográfica o región en que desea realizar el despliegue.
  

  Por ejemplo: api.ng.bluemix.net para la región de EE.UU. o api.eu-de.bluemix.net para Alemania o api.au-syd.bluemix.net para Sydney

• IBM_CLOUD_ACCOUNT_ID - Su ID de cuenta, que es un valor alfanumérico, como a1b1b111d11e1a11d1fa1cc999999999
  Utilice el mandato bx target para obtener el ID de cuenta.
• IBM_CLOUD_USER - Su nombre de usuario de IBM Cloud (correo electrónico).
• IBM_CLOUD_PASSWORD - Su contraseña de IBM Cloud.
• IBM_CLOUD_ORG - El nombre de su organización de IBM Cloud.
• IBM_CLOUD_SPACE - Su espacio IBM Cloud (como se ha descrito anteriormente).

prepareserverdbs.properties

El servicio de Mobile Foundation requiere una instancia de DB2 en Cloud.

Nota: También puede utilizar su propia base de datos DB2. IBM Cloud Kubernetes Cluster se debe configurar para su conexión con la base de datos.

Después de configurar la instancia de DB2, proporcione los argumentos necesarios:

• DB_TYPE - dashDB ( si utiliza DB2 on Cloud ) o DB2 si utiliza su propia base de datos DB2.
• Proporcione lo siguiente si utiliza su propia base de datos DB2 (por ejemplo, DB_TYPE=DB2).
  • DB2_HOST - Nombre de host de su configuración de DB2.
  • DB2_DATABASE - Nombre de la base de datos.
  • DB2_PORT - Puerto en el que se conectará a la base de datos.
  • DB2_USERNAME - El usuario de la base de datos DB2 (el usuario debe tener los permisos para crear tablas en el esquema proporcionado o, si el esquema no existe todavía, el usuario debe poder crear un esquema)
  • DB2_PASSWORD - La contraseña del usuario de DB2.
• Proporcione lo siguiente si utiliza DB2 on Cloud (por ejemplo, DB_TYPE=dashDB).
  • ADMIN_DB_SRV_NAME - El nombre de su instancia de servicio de dashDB, para almacenar los datos de administrador.
  • RUNTIME_DB_SRV_NAME - El nombre de su instancia de servicio de dashDB, para almacenar los datos de tiempo de ejecución. El valor predeterminado es el nombre de servicio de administración.
  • PUSH_DB_SRV_NAME - El nombre de su instancia de servicio de dashDB, para almacenar los datos de tiempo de ejecución. El valor predeterminado es el nombre de servicio de administración.
• ADMIN_SCHEMA_NAME - Su nombre de esquema para los datos de administrador. El valor predeterminado es MFPDATA.
• RUNTIME_SCHEMA_NAME - Su nombre de esquema para los datos de tiempo de ejecución. El valor predeterminado es MFPDATA.
• PUSH_SCHEMA_NAME - Su nombre de esquema para los datos de tiempo de ejecución. El valor predeterminado es MFPDATA.

Nota: Si su instancia de servicio de base de datos DB2 la comparten muchos usuarios o varios despliegues de Mobile Foundation, asegúrese de que proporciona nombres de esquema exclusivos.

prepareserver.properties

• SERVER_IMAGE_TAG - Una etiqueta para la imagen. Debe tener el formato: registry-url/namespace/image:tag.
• ANALYTICS_IMAGE_TAG - Una etiqueta para la imagen. Debe tener el formato: registry-url/namespace/image:tag.

Por ejemplo: registry.ng.bluemix.net/myuniquenamespace/mymfpserver:v1
Si todavía no ha creado un espacio de nombres de registro, cree el espacio de nombres de registro utilizando uno de estos mandatos:


• bx cr namespace-add myuniquenamespace
• bx cr namespace-list

Las siguientes instrucciones muestran cómo ejecutar los scripts utilizando los archivos de configuración. También está disponible una lista de argumentos de línea de mandatos, si opta por ejecutarlos fuera del modo interactivo:

1. initenv.sh – Inicio de sesión en IBM Cloud
   Ejecute el script initenv.sh para crear un entorno para compilar y ejecutar Mobile Foundation en IBM Containers: Modo interactivo

   ./initenv.sh

   Modo no interactivo

   ./initenv.sh args/initenv.properties

2. prepareserverdbs.sh - Prepare la base de datos de MobileFirst Server
   El script prepareserverdbs.sh se utiliza para configurar MobileFirst Server con el servicio de base de datos DB2. La instancia de servicio del servicio DB2 debe estar disponible en la organización y espacio en que ha iniciado sesión en el paso 1. Ejecute lo siguiente: Modo interactivo

   ./prepareserverdbs.sh

   Modo no interactivo

   ./prepareserverdbs.sh args/prepareserverdbs.properties

3. initenv.sh (Opcional) – Inicio de sesión en IBM Cloud
   Este paso solo es necesario si necesita crear contenedores en una organización y espacio diferentes a aquellos en los que está disponible la instancia de servicio de DB2. Si es así, actualice initenv.properties con la nueva organización y espacio donde se han de crear (e iniciar) los contenedores, y vuelva a ejecutar el script initenv.sh:

   ./initenv.sh args/initenv.properties

4. prepareserver.sh - Preparar una imagen de MobileFirst Server
   Ejecute el script prepareserver.sh para crear las imágenes de MobileFirst Server y de MobileFirst Analytics y enviarlas mediante push al repositorio de IBM Cloud. Para ver todas las imágenes disponibles en el repositorio de IBM Cloud, ejecute: bx cr image-list
   La lista contiene el nombre, la fecha de creación y el ID de la imagen.
   Modo interactivo

   ./prepareserver.sh

   Modo no interactivo

   ./prepareserver.sh args/prepareserver.properties

5. Despliegue MobileFirst Server y MobileFirst Analytics en contenedores Docker en Kubernetes Cluster utilizando IBM Cloud Container Service.
   1. Establezca el contexto del terminal en su clúster
      bx cs cluster-config my-cluster
      Para averiguar el nombre del clúster, ejecute el mandato siguiente:
      bx cs clusters
      En la salida, la vía de acceso del archivo de configuración se muestra como un mandato para establecer la variable de entorno, por ejemplo:
      export KUBECONFIG=/Users/ibm/.bluemix/plugins/container-service/clusters/my-cluster/kube-config-prod-dal12-my-cluster.yml
      Copie y pegue el mandato anterior, después de sustituir my-cluster por el nombre de clúster, establezca la variable de entorno de su terminal y pulse Intro.
   2. [Mandatory for MobileFirst Analytics]: Cree una Reclamación de volumen persistente. Esto se utilizará para la persistencia de datos de Analytics. Este es un paso de una sola vez. Puede reutilizar PVC si ya ha lo ha creado anteriormente. Edite el archivo yaml args/mfpf-persistent-volume-claim.yaml y, a continuación, ejecute el mandato. Se deben sustituir todas las variables por sus valores antes de ejecutar el mandato kubectl siguiente.
      kubectl create -f ./args/mfpf-persistent-volume-claim.yaml
      Anote el nombre de la Reclamación de volumen persistente, ya que deberá proporcionarlo en el paso siguiente.
   3. Para obtener su dominio de ingreso, ejecute el mandato siguiente:
      bx cs cluster-get my-cluster
      Anote el dominio de ingreso. Si necesita configurar TLS, anote el secreto de ingreso.
   4. Cree los despliegues de Kubernetes
      Edite el archivo yaml args/mfpf-deployment-all.yaml y rellene los detalles. Se deben sustituir todas las variables por sus valores antes de ejecutar el mandato kubectl.
      ./args/mfpf-deployment-all.yaml contiene el despliegue para lo siguiente:
      • un despliegue de kubernetes para MobileFirst Server que consta de 3 instancias (réplicas), con una memoria de 1024 MB y CPU de 1 núcleo.
      • un despliegue de kubernetes para MobileFirst Analytics que consta de 2 instancias (réplicas), con una memoria de 1024 MB y CPU de 1 núcleo.
      • un servicio de kubernetes para MobileFirst Server.
      • un servicio de kubernetes para MobileFirst Analytics.
      • un ingreso para toda la configuración que incluya todos los puntos finales REST para MobileFirst Server y MobileFirst Analytics.
      • un configMap para que las variables de entorno estén disponibles en las instancias de MobileFirst Server y de MobileFirst Analytics.
      Los valores siguientes se deben editar en el archivo YAML:
      
      1. Las diferentes apariciones de my-cluster.us-south.containers.mybluemix.net con la salida del Dominio de ingreso de la salida del mandato bx cs cluster-get, como se ha indicado anteriormente.
      2. registry.ng.bluemix.net/repository/mfpfanalytics:latest y registry.ng.bluemix.net/repository/mfpfserver:latest - Utilice los mismos nombres que ha utilizado en prepareserver.sh para subir las imágenes.
      3. claimName: mfppvc - Utilice el nombre de Reclamación de volumen persistente que ha utilizado anteriormente para crear PVC.
         
      Ejecute el mandato siguiente:
      kubectl create -f ./args/mfpf-deployment-all.yaml

      Nota:
      Se proporcionan los siguientes archivos yaml de plantilla:
      

      • mfpf-deployment-all.yaml: Despliega MobileFirst Server y MobileFirst Analytics con http.
      • mfpf-deployment-all-tls.yaml: Despliega MobileFirst Server y MobileFirst Analytics con https.
      • mfpf-deployment-server.yaml: Despliega MobileFirst Server con http.
      • mfpf-deployment-analytics.yaml: Despliega MobileFirst Analytics con http.

      Después de su creación, para utilizar el panel de control de Kubernetes, ejecute el siguiente mandato:
      kubectl proxy
      Abra localhost:8001/ui, en su navegador.