Configuración del recurso personalizado (CR) IBM Mobile Foundation

Parámetros

[OPCIONAL] Crear secretos de inicio de sesión en la consola personalizados

De forma predeterminada, los secretos de inicio de sesión de la consola para todos los componentes de Mobile Foundation se crean automáticamente durante el despliegue. De forma opcional, puede optar por crear el Secreto de inicio de sesión para acceder a la consola del servidor, Analytics y Application Center. El siguiente es el ejemplo.

Para el servidor,

kubectl create secret generic serverlogin --from-literal=MFPF_ADMIN_USER=admin --from-literal=MFPF_ADMIN_PASSWORD=admin

Para Analytics,

kubectl create secret generic analyticslogin --from-literal=MFPF_ANALYTICS_ADMIN_USER=admin --from-literal=MFPF_ANALYTICS_ADMIN_PASSWORD=admin

Para Analytics Receiver,

kubectl create secret generic analytics_recvrsecret --from-literal=MFPF_ANALYTICS_RECVR_USER=admin --from-literal=MFPF_ANALYTICS_RECVR_PASSWORD=admin

Para Application Center,

kubectl create secret generic appcenterlogin --from-literal=MFPF_APPCNTR_ADMIN_USER=admin --from-literal=MFPF_APPCNTR_ADMIN_PASSWORD=admin

NOTA: Si no se proporcionan estos secretos, se crean con el nombre de usuario y contraseña predeterminados de admin/admin durante la instalación de Mobile Foundation.

[ OPCIONAL] Creación del secreto TLS para la configuración de ingress

Se pueden configurar los componentes de Mobile Foundation con el nombre de host basado en Ingress para que los clientes externos puedan conectarse a los mismos utilizando el nombre de host. Se puede proteger Ingress utilizando una clave TLS privada y un certificado. La clave privada TLS y el certificado se deben definir en un secreto con los nombres de clave tls.key y tls.crt.

El secreto mf-tls-secret se crea en el mismo espacio de nombres que el recurso Ingress utilizando el mandato siguiente.

kubectl create secret tls mf-tls-secret --key=/path/to/tls.key --cert=/path/to/tls.crt

El nombre del secreto se proporciona en el campo global.ingress.secret del archivo yaml de la configuración del recurso personalizado.

[ OPCIONAL] Creación de un secreto de almacén de claves personalizado para los despliegues

Puede proporcionar su propio almacén de claves y almacén de confianza al despliegue del servidor, Push, Analytics y Application Center creando un secreto con su propio almacén de claves y almacén de confianza.

Cree previamente un secreto con keystore.jks y truststore.jks junto con la contraseña del almacén de claves y el almacén de confianza utilizando los literales KEYSTORE_PASSWORD y TRUSTSTORE_PASSWORD; proporcione el nombre de secreto en el campo keystoreSecret del componente respectivo.

El siguiente es un ejemplo de cómo crear el secreto del almacén de clave para el despliegue del servidor utilizando keystore.jks, truststore.jks y establecer sus contraseñas.

kubectl create secret generic server-secret --from-file=./keystore.jks --from-file=./truststore.jks --from-literal=KEYSTORE_PASSWORD=worklight --from-literal=TRUSTSTORE_PASSWORD=worklight

NOTA: Los nombres de los archivos y literales deben ser los mismos que se han mencionado en el mandato anterior. Proporcione este nombre de secreto en el campo de entrada keystoresSecretName del componente respectivo para reemplazar los almacenes de claves predeterminados cuando configura el gráfico helm.

[OPCIONAL] Creación de secretos para clientes confidenciales

Mobile Foundation Server está predefinido con clientes confidenciales para el servicio de administración. Las credenciales de estos clientes se proporcionan en los campos mfpserver.adminClientSecret y mfpserver.pushClientSecret.

Estos secretos se pueden crear del modo siguiente:

kubectl create secret generic mf-admin-client --from-literal=MFPF_ADMIN_AUTH_CLIENTID=admin --from-literal=MFPF_ADMIN_AUTH_SECRET=admin

kubectl create secret generic mf-push-client --from-literal=MFPF_PUSH_AUTH_CLIENTID=admin --from-literal=MFPF_PUSH_AUTH_SECRET=admin

Si no se proporcionan los valores de los campos mfpserver.pushClientSecret, mfpserver.adminClientSecret y mfpserver.liveupdateClientSecret durante la instalación del gráfico de helm, se crean los secretos del cliente predeterminados respectivamente con las credenciales siguientes, como se indica a continuación:

• admin / nimda for mfpserver.adminClientSecret
• push / hsup for mfpserver.pushClientSecret
• liveupdate / etadpuevil for mfpserver.liveupdateClientSecret

[OPCIONAL] Configuración del servidor personalizada

Para personalizar la configuración, (por ejemplo, para modificar un valor de rastreo de registro, añadir una nueva propiedad jndi, etc.), tendrá que crear un mapa de configuración con el archivo XML de configuración. Esto le permite añadir un nuevo valor de configuración o reemplazar las configuraciones existentes de los componentes de Mobile Foundation.

Los componentes de Mobile Foundation acceden a la configuración personalizada mediante un configMap (mfpserver-custom-config) que se puede crear del modo siguiente -

kubectl create configmap mfpserver-custom-config --from-file=<configuration file in XML format>

El configmap creado utilizando el mandato anterior se debe proporcionar en la Configuración del servidor personalizada del gráfico Helm durante el despliegue de Mobile Foundation.

El siguiente es un ejemplo de cómo establecer la especificación del registro de rastreo, (el valor predeterminado es info) utilizando mfpserver-custom-config configmap.

• XML de configuración de ejemplo (logging.xml)

<server>
        <logging maxFiles="5" traceSpecification="com.ibm.mfp.*=debug:*=warning"
        maxFileSize="20" />
</server>

• Cree configmap y añádalo durante el despliegue del gráfico helm

kubectl create configmap mfpserver-custom-config --from-file=logging.xml

• Observe el cambio en messages.log (de los componentes de Mobile Foundation) - La propiedad traceSpecification se establecerá en com.ibm.mfp.=debug:*=warning.

[OPCIONAL] Utilización de claves LTPA generadas personalizadas

De forma predeterminada, las imágenes de Mobile Foundation empaquetan un conjunto de ltpa.keys para cada componente de Mobile Foundation. En el entorno de producción, cuando es necesario actualizar ltpa.keys listo para usar con los valores generados personalizados, puede utilizar la configuración personalizada para añadir cualquier ltpa.keys personalizado generado junto con el xml de configuración.

El siguiente es un ltpa.xml de configuración de ejemplo.

<server description="mfpserver">
    <ltpa
        keysFileName="ltpa.keys" />
    <webAppSecurity ssoUseDomainFromURL="true" />
</server>

El mandato siguiente es un ejemplo cómo añadir las claves LTPA personalizadas.

kubectl create configmap mfpserver-custom-config --from-file=ltpa.xml --from-file=ltpa.keys

Para obtener más detalles acerca de la generación de claves LTPA y otros detalles, consulte la Documentación de Liberty.

Nota: Tener varios custom-configmaps no está soportado para añadir la configuración personalizada, en su lugar se recomienda crear el configmap de configuración personalizada como se indica a continuación.

kubectl create configmap mfpserver-custom-config --from-file=ltpa.xml --from-file=ltpa.keys --from-file=moreconfig.xml