overleaf-cep/services/web/modules/server-ce-scripts/scripts/check-mongodb.mjs
Brian Gough d701b8ff9b Merge pull request #26783 from overleaf/bg-server-ce-ignore-mongo-check-failures
allow skipping checks requiring mongo admin privileges in check-mongodb script

GitOrigin-RevId: 0c7157a153457a97c92ea3eb5e8c2a4de7971bf6
2025-07-04 08:05:03 +00:00

137 lines
3.7 KiB
JavaScript

import mongodb from 'mongodb-legacy'
import {
connectionPromise,
db,
} from '../../../app/src/infrastructure/mongodb.js'
const { ObjectId } = mongodb
const MIN_MONGO_VERSION = [6, 0]
const MIN_MONGO_FEATURE_COMPATIBILITY_VERSION = [6, 0]
// Allow ignoring admin check failures via an environment variable
const OVERRIDE_ENV_VAR_NAME = 'ALLOW_MONGO_ADMIN_CHECK_FAILURES'
function shouldSkipAdminChecks() {
return process.env[OVERRIDE_ENV_VAR_NAME] === 'true'
}
function handleUnauthorizedError(err, feature) {
if (
err instanceof mongodb.MongoServerError &&
err.codeName === 'Unauthorized'
) {
console.warn(`Warning: failed to check ${feature} (not authorised)`)
if (!shouldSkipAdminChecks()) {
console.error(
`Please ensure the MongoDB user has the required admin permissions, or\n` +
`set the environment variable ${OVERRIDE_ENV_VAR_NAME}=true to ignore this check.`
)
process.exit(1)
}
console.warn(
`Ignoring ${feature} check failure (${OVERRIDE_ENV_VAR_NAME}=${process.env[OVERRIDE_ENV_VAR_NAME]})`
)
} else {
throw err
}
}
async function main() {
let mongoClient
try {
mongoClient = await connectionPromise
} catch (err) {
console.error('Cannot connect to mongodb')
throw err
}
try {
await checkMongoVersion(mongoClient)
} catch (err) {
handleUnauthorizedError(err, 'MongoDB version')
}
try {
await checkFeatureCompatibilityVersion(mongoClient)
} catch (err) {
handleUnauthorizedError(err, 'MongoDB feature compatibility version')
}
try {
await testTransactions(mongoClient)
} catch (err) {
console.error("Mongo instance doesn't support transactions")
throw err
}
}
async function testTransactions(mongoClient) {
const session = mongoClient.startSession()
try {
await session.withTransaction(async () => {
await db.users.findOne({ _id: new ObjectId() }, { session })
})
} finally {
await session.endSession()
}
}
async function checkMongoVersion(mongoClient) {
const buildInfo = await mongoClient.db().admin().buildInfo()
const [major, minor] = buildInfo.versionArray
const [minMajor, minMinor] = MIN_MONGO_VERSION
if (major < minMajor || (major === minMajor && minor < minMinor)) {
const version = buildInfo.version
const minVersion = MIN_MONGO_VERSION.join('.')
console.error(
`The MongoDB server has version ${version}, but Overleaf requires at least version ${minVersion}. Aborting.`
)
process.exit(1)
}
}
async function checkFeatureCompatibilityVersion(mongoClient) {
const {
featureCompatibilityVersion: { version },
} = await mongoClient
.db()
.admin()
.command({ getParameter: 1, featureCompatibilityVersion: 1 })
const [major, minor] = version.split('.').map(v => parseInt(v))
const [minMajor, minMinor] = MIN_MONGO_FEATURE_COMPATIBILITY_VERSION
if (major < minMajor || (major === minMajor && minor < minMinor)) {
const minVersion = MIN_MONGO_FEATURE_COMPATIBILITY_VERSION.join('.')
console.error(`
The MongoDB server has featureCompatibilityVersion=${version}, but Overleaf requires at least version ${minVersion}.
Open a mongo shell:
- Overleaf Toolkit deployments: $ bin/mongo
- Legacy docker-compose.yml deployments: $ docker exec -it mongo mongosh localhost/sharelatex
In the mongo shell:
> db.adminCommand( { setFeatureCompatibilityVersion: "${minMajor}.${minMinor}" } )
Verify the new value:
> db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
...
{
featureCompatibilityVersion: { version: ${minMajor}.${minMinor}' },
...
Aborting.
`)
process.exit(1)
}
}
main()
.then(() => {
console.error('Mongodb is up.')
process.exit(0)
})
.catch(err => {
console.error(err)
process.exit(1)
})