Configuración de MobileFirst Application Center 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-mfp-appcenter

• Dockerfile-mfp-appcenter: Documento de texto que contiene todos los mandatos necesarios para crear la imagen de MobileFirst Application Center.
• 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 Application Center 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.
• Carpeta usr-mfp-appcenter:
  • Carpeta bin folder: Contiene el archivo de script (mfp-appcenter-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 utiliza MobileFirst Application Center.
  • 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.
  • appcentersqldb.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
APPCENTER_SERVER_HTTPPORT	9080*	El puerto utilizado para las solicitudes HTTP de cliente. Utilice -1 para inhabilitar este puerto.
APPCENTER_SERVER_HTTPSPORT	9443*	El puerto utilizado para las solicitudes HTTP de cliente protegidas con SSL (HTTPS). Utilice -1 para inhabilitar este puerto.
APPCENTER_ROOT	applicationcenter	La raíz de contexto en la que estarán disponibles los servicios de administración de MobileFirst Application Center.
APPCENTER_CONSOLE_ROOT	appcenterconsole	La raíz de contexto en la que estará disponible la consola de MobileFirst Application Center.
APPCENTER_ADMIN_GROUP	appcenteradmingroup	El nombre del grupo de usuarios que tiene asignado el rol appcenteradmin predefinido.
APPCENTER_USER_GROUP	appcenterusergroup	El nombre del grupo de usuarios que tiene asignado el rol appcenteruser 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).

prepareappcenterdbs.properties

MobileFirst Application Center 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).
  • APPCENTER_DB_SRV_NAME: El nombre de su instancia de servicio de dashDB, para almacenar los datos de Appcenter.
• APPCENTER_SCHEMA_NAME: Su nombre de esquema para los datos de Appcenter. El valor predeterminado es APPCNTR.

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

prepareappcenter.properties

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

Por ejemplo: registry.ng.bluemix.net/myuniquenamespace/myappcenter: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 MobileFirst Application Center en IBM Containers: Modo interactivo

   ./initenv.sh

   Modo no interactivo

   ./initenv.sh args/initenv.properties

2. prepareappcenterdbs.sh - Prepare la base de datos de MobileFirst Application Center
   El script prepareappcenterdbs.sh se utiliza para configurar MobileFirst Application Center 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

   ./prepareappcenterdbs.sh

   Modo no interactivo

   ./prepareappcenterdbs.sh args/prepareappcenterdbs.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. prepareappcenter.sh - Prepare una imagen de MobileFirst Application Center
   Ejecute el script prepareappcenter.sh para crear la imagen de MobileFirst Application Center y enviarla 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

   ./prepareappcenter.sh

   Modo no interactivo

   ./prepareappcenter.sh args/prepareappcenter.properties

5. Despliegue MobileFirst Application Center 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. 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.
   3. Cree los despliegues de Kubernetes
      Edite el archivo yaml args/mfp-deployment-appcenter.yaml y rellene los detalles. Se deben sustituir todas las variables por sus valores antes de ejecutar el mandato kubectl.
      ./args/mfp-deployment-appcenter.yaml contiene el despliegue para lo siguiente:
      • un despliegue de kubernetes para MobileFirst Application Center que consta de 1 instancia (réplica), con una memoria de 1024 MB y CPU de 1 núcleo.
      • un servicio de kubernetes para MobileFirst Application Center.
      • un ingreso para toda la configuración que incluya todos los puntos finales REST para MobileFirst Application Center.
      • un configMap para que las variables de entorno estén disponibles en las instancias de MobileFirst Application Center instance.
      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/mfpappcenter:latest: Utilice los mismos nombres que ha utilizado en prepareappcenter.sh para subir la imagen.
      Ejecute el mandato siguiente:
      kubectl create -f ./args/mfp-deployment-appcenter.yaml

      Nota:
      Se proporcionan los siguientes archivos yaml de plantilla:
      

      • mfp-deployment-appcenter.yaml: Despliega MobileFirst Application Center con http.
      • mfp-deployment-appcenter-with-tls.yaml: Despliega MobileFirst Application Center con https.

      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.