check-mongodb.mjs 3.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137
  1. import mongodb from 'mongodb-legacy'
  2. import {
  3. connectionPromise,
  4. db,
  5. } from '../../../app/src/infrastructure/mongodb.js'
  6. const { ObjectId } = mongodb
  7. const MIN_MONGO_VERSION = [6, 0]
  8. const MIN_MONGO_FEATURE_COMPATIBILITY_VERSION = [6, 0]
  9. // Allow ignoring admin check failures via an environment variable
  10. const OVERRIDE_ENV_VAR_NAME = 'ALLOW_MONGO_ADMIN_CHECK_FAILURES'
  11. function shouldSkipAdminChecks() {
  12. return process.env[OVERRIDE_ENV_VAR_NAME] === 'true'
  13. }
  14. function handleUnauthorizedError(err, feature) {
  15. if (
  16. err instanceof mongodb.MongoServerError &&
  17. err.codeName === 'Unauthorized'
  18. ) {
  19. console.warn(`Warning: failed to check ${feature} (not authorised)`)
  20. if (!shouldSkipAdminChecks()) {
  21. console.error(
  22. `Please ensure the MongoDB user has the required admin permissions, or\n` +
  23. `set the environment variable ${OVERRIDE_ENV_VAR_NAME}=true to ignore this check.`
  24. )
  25. process.exit(1)
  26. }
  27. console.warn(
  28. `Ignoring ${feature} check failure (${OVERRIDE_ENV_VAR_NAME}=${process.env[OVERRIDE_ENV_VAR_NAME]})`
  29. )
  30. } else {
  31. throw err
  32. }
  33. }
  34. async function main() {
  35. let mongoClient
  36. try {
  37. mongoClient = await connectionPromise
  38. } catch (err) {
  39. console.error('Cannot connect to mongodb')
  40. throw err
  41. }
  42. try {
  43. await checkMongoVersion(mongoClient)
  44. } catch (err) {
  45. handleUnauthorizedError(err, 'MongoDB version')
  46. }
  47. try {
  48. await checkFeatureCompatibilityVersion(mongoClient)
  49. } catch (err) {
  50. handleUnauthorizedError(err, 'MongoDB feature compatibility version')
  51. }
  52. try {
  53. await testTransactions(mongoClient)
  54. } catch (err) {
  55. console.error("Mongo instance doesn't support transactions")
  56. throw err
  57. }
  58. }
  59. async function testTransactions(mongoClient) {
  60. const session = mongoClient.startSession()
  61. try {
  62. await session.withTransaction(async () => {
  63. await db.users.findOne({ _id: new ObjectId() }, { session })
  64. })
  65. } finally {
  66. await session.endSession()
  67. }
  68. }
  69. async function checkMongoVersion(mongoClient) {
  70. const buildInfo = await mongoClient.db().admin().buildInfo()
  71. const [major, minor] = buildInfo.versionArray
  72. const [minMajor, minMinor] = MIN_MONGO_VERSION
  73. if (major < minMajor || (major === minMajor && minor < minMinor)) {
  74. const version = buildInfo.version
  75. const minVersion = MIN_MONGO_VERSION.join('.')
  76. console.error(
  77. `The MongoDB server has version ${version}, but Overleaf requires at least version ${minVersion}. Aborting.`
  78. )
  79. process.exit(1)
  80. }
  81. }
  82. async function checkFeatureCompatibilityVersion(mongoClient) {
  83. const {
  84. featureCompatibilityVersion: { version },
  85. } = await mongoClient
  86. .db()
  87. .admin()
  88. .command({ getParameter: 1, featureCompatibilityVersion: 1 })
  89. const [major, minor] = version.split('.').map(v => parseInt(v))
  90. const [minMajor, minMinor] = MIN_MONGO_FEATURE_COMPATIBILITY_VERSION
  91. if (major < minMajor || (major === minMajor && minor < minMinor)) {
  92. const minVersion = MIN_MONGO_FEATURE_COMPATIBILITY_VERSION.join('.')
  93. console.error(`
  94. The MongoDB server has featureCompatibilityVersion=${version}, but Overleaf requires at least version ${minVersion}.
  95. Open a mongo shell:
  96. - Overleaf Toolkit deployments: $ bin/mongo
  97. - Legacy docker-compose.yml deployments: $ docker exec -it mongo mongosh localhost/sharelatex
  98. In the mongo shell:
  99. > db.adminCommand( { setFeatureCompatibilityVersion: "${minMajor}.${minMinor}" } )
  100. Verify the new value:
  101. > db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
  102. ...
  103. {
  104. featureCompatibilityVersion: { version: ${minMajor}.${minMinor}' },
  105. ...
  106. Aborting.
  107. `)
  108. process.exit(1)
  109. }
  110. }
  111. main()
  112. .then(() => {
  113. console.error('Mongodb is up.')
  114. process.exit(0)
  115. })
  116. .catch(err => {
  117. console.error(err)
  118. process.exit(1)
  119. })