Migrar una base de datos de la aplicación a una implementación externa

Cómo funciona la migración

El recurso de MongoDB Ops Manager comienza con una base de datos de la aplicación gestionada internamente, y el operador de Kubernetes posee un StatefulSet llamado <primary-om-name>-db. La migración procede de la siguiente manera:

1. Usted crea un recurso de MongoDB con spec.role configurado como AppDB y con el mismo nombre que el StatefulSet, en un proyecto administrado por una instancia de Ops Manager. El recurso de MongoDB aún no puede tomar posesión del StatefulSet, por lo que permanece en la fase Pending con un mensaje que indica que no puede tomar posesión del StatefulSet de la base de datos de la aplicación.

2. Se agrega spec.externalApplicationDatabaseRef al recurso del Administrador de operaciones. El operador de Kubernetes desvincula el StatefulSet eliminando la referencia de propietario del recurso del Administrador de operaciones y marcando el StatefulSet como listo para la migración. El recurso de MongoDB toma entonces la propiedad del mismo.

Debido a que el operador de Kubernetes calcula la misma cadena de conexión que antes, que utiliza los mismos nombres de host, los pods del administrador de operaciones no se reinician.

Requisitos previos

Antes de comenzar, cumpla con las siguientes tareas:

• Instala el operador de Kubernetes y kubectl. Para aprender más, consulta Instala con Kubernetes.

• Implemente un recurso primario de MongoDB Ops Manager que utilice una base de datos de la aplicación gestionada internamente. Este recurso establece spec.applicationDatabase, y el operador de Kubernetes posee un StatefulSet llamado <primary-om-name>-db. Para obtener más información, consulta Implementar un recurso de MongoDB Ops Manager.

• Implemente un recurso de Ops Manager de administración que se encuentre en la fase Running y que sea el propietario del proyecto de la base de datos de aplicaciones externa. Para obtener más información, consulte Implementar Ops Manager con una base de datos de aplicaciones externa.

• Cree credenciales para el operador de Kubernetes. El secreto contiene el par de claves API programáticas que el operador de Kubernetes utiliza para autenticarse en la API de administración de Ops Manager en su nombre. Puede asignarle cualquier nombre al secreto. Para obtener más información, consulte Crear credenciales para el operador de Kubernetes.

Considerations

Revise las siguientes consideraciones antes de migrar:

• La versión de la base de datos de la aplicación que configure en el recurso de MongoDB debe coincidir con la versión que ejecuta la base de datos de la aplicación administrada internamente, y debe ser una versión de MongoDB que ofrezca la instancia de administración de Ops Manager.

• El Kubernetes operador no es compatible con spec.applicationDatabase.passwordSecretKeyRef durante la migración. El Kubernetes operador genera una nueva contraseña y rota cualquier contraseña que haya proporcionado.

• La base de datos de la aplicación puede no estar disponible durante uno o dos minutos si la configuración de recursos de MongoDB difiere de la configuración de la base de datos de la aplicación gestionada internamente, por ejemplo, debido a una plantilla de pod o un conjunto de contenedores diferentes. Si ambas configuraciones son semánticamente idénticas, la base de datos de la aplicación permanece disponible.

• El operador de Kubernetes solo admite la migración en un único clúster de Kubernetes.

Procedimiento

export K8S_CTX="<your-kube-context>"
export MDB_NS="mongodb"
export MANAGEMENT_OM_NAME="management-om"
export PRIMARY_OM_NAME="primary-om"
export APPDB_NAME="${PRIMARY_OM_NAME}-db"
export APPDB_VERSION="8.0.5-ent"
export MANAGEMENT_OM_URL="http://${MANAGEMENT_OM_NAME}-svc.${MDB_NS}.svc.cluster.local:8080"
export MANAGEMENT_OM_ADMIN_KEY_SECRET="<your-operator-credentials-secret>"
export APPDB_PROJECT_CONFIGMAP="${APPDB_NAME}-config"
export APPDB_PROJECT_NAME="external-appdb"

kubectl create configmap "${APPDB_PROJECT_CONFIGMAP}" \
  --context "${K8S_CTX}" -n "${MDB_NS}" \
  --from-literal=baseUrl="${MANAGEMENT_OM_URL}" \
  --from-literal=projectName="${APPDB_PROJECT_NAME}" \
  --from-literal=orgId=""

kubectl apply --context "${K8S_CTX}" -n "${MDB_NS}" -f - <<EOF
apiVersion: mongodb.com/v1
kind: MongoDB
metadata:
  name: ${APPDB_NAME}
spec:
  members: 3
  version: ${APPDB_VERSION}
  type: ReplicaSet
  role: AppDB
  opsManager:
    configMapRef:
      name: ${APPDB_PROJECT_CONFIGMAP}
  credentials: ${MANAGEMENT_OM_ADMIN_KEY_SECRET}
  persistent: true
  security:
    authentication:
      enabled: true
      modes: ["SCRAM"]
      ignoreUnknownUsers: true
EOF

kubectl wait --for=jsonpath='{.status.phase}'=Pending \
  mdb/"${APPDB_NAME}" --context "${K8S_CTX}" -n "${MDB_NS}" --timeout=300s
kubectl get mdb "${APPDB_NAME}" --context "${K8S_CTX}" -n "${MDB_NS}" \
  -o jsonpath='{.status.message}{"\n"}'

kubectl patch om "${PRIMARY_OM_NAME}" \
  --context "${K8S_CTX}" -n "${MDB_NS}" \
  --type merge \
  -p "{\"spec\":{\"externalApplicationDatabaseRef\":{\"name\":\"${APPDB_NAME}\",\"kind\":\"MongoDB\"}}}"

kubectl wait --for=jsonpath='{.status.phase}'=Running \
  mdb/"${APPDB_NAME}" --context "${K8S_CTX}" -n "${MDB_NS}" --timeout=1200s
kubectl wait --for=jsonpath='{.status.opsManager.phase}'=Running \
  om/"${PRIMARY_OM_NAME}" --context "${K8S_CTX}" -n "${MDB_NS}" --timeout=1800s

Problemas comunes de migración

Próximos pasos

• Para realizar una copia de seguridad de la base de datos de la aplicación externa, habilite la copia de seguridad en el recurso MongoDB del proyecto que administra la instancia de Ops Manager. Para obtener más información,consulte Configurar copias de seguridad de la base de datos MongoDB.

• Para revertir esta migración, consulte Devolver una base de datos de la aplicación externa a Ops Manager.