# mongodb-backup-cloud
> backup mongodb databases and upload to github/google drive
Latest version **1.0.8** (published 2023-08-15) · ISC license · 0 weekly downloads
## Install
```sh
npm install mongodb-backup-cloud
pnpm add mongodb-backup-cloud
yarn add mongodb-backup-cloud
bun add mongodb-backup-cloud
```
## Health
**Score 25/100 (F)** — status: abandoned.
Positive: has types; no vulnerabilities; high quality score.
Warnings: low downloads; no esm support.
Negative: abandoned; low maintenance score.
## Facts
| | |
|---|---|
| Version | 1.0.8 |
| Published | 2023-08-15 |
| First published | 2022-03-25 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 7 |
| Unpacked size | 128.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | ShamalRathnayake |
| Maintainers | shamal_rathnayake |
| Keywords | mongodb, backup, google drive, cron, git, mongo |
## Links
- npm: https://www.npmjs.com/package/mongodb-backup-cloud
- Homepage: https://github.com/ShamalRathnayake/Mongodb-backup-cloud
- npm.io page: https://npm.io/package/mongodb-backup-cloud
## Dependencies (7)
- [globby](https://npm.io/package/globby.md) ^11.1.0
- [node-cron](https://npm.io/package/node-cron.md) ^3.0.0
- [googleapis](https://npm.io/package/googleapis.md) ^94.0.0
- [mime-types](https://npm.io/package/mime-types.md) ^2.1.34
- [@octokit/rest](https://npm.io/package/@octokit/rest.md) ^18.12.0
- [@types/node-cron](https://npm.io/package/@types/node-cron.md) ^3.0.1
- [@octokit/plugin-retry](https://npm.io/package/@octokit/plugin-retry.md) ^3.0.9
## Alternatives
- [angular-pipes](https://npm.io/package/angular-pipes.md) — 5.6K weekly downloads
- [@ng-web-apis/midi](https://npm.io/package/@ng-web-apis/midi.md) — 2.6K weekly downloads
- [happn-3](https://npm.io/package/happn-3.md) — 1.6K weekly downloads
- [@opensip-cli/lang-go](https://npm.io/package/@opensip-cli/lang-go.md) — 1.2K weekly downloads
- [mongoose-typescript](https://npm.io/package/mongoose-typescript.md) — 85 weekly downloads
## Recent versions
- 1.0.8 (latest) — 2023-08-15
- 1.0.7 — 2022-09-18
- 1.0.6 — 2022-09-11
- 1.0.5 — 2022-08-25
- 1.0.4 — 2022-03-27
- 1.0.3 — 2022-03-27
- 1.0.2 — 2022-03-27
- 1.0.1 — 2022-03-25
## README
# Mongodb-backup-cloud
> Automate mongodb instance backup & upload to Github / GDrive
```js
npm i mongodb-backup-cloud
```
#### What can this package do?
- Backup **Mongodb** database instances
- Upload backup files to **Github**
- Upload backup files to **Google Drive**
## Note
- Backup process can be executed once or repeatedly using cron schedules
- In order for the backup process to work the computer running the code must have **Mongodb Database Tools** installed and added to **Path**
[How to install Mongodb Database Tools](https://docs.mongodb.com/database-tools/installation/installation/)
----
### usage
Backup Process
```js
import {Backup, DirectOptions, URIOptions } from "mongodb-backup-cloud";
// Backup with mongodb connection string
-----------------------------------------------
const uriOptions: URIOptions = {
uri: "mongodb://localhost:27017/",
database: 'test_db',
collection: 'test_collection',
outputPath: './test_backup_path',
};
Backup.withConnectionString(uriOptions);
// Backup with host & port
-----------------------------------------------
const directOptions: DirectOptions = {
host: "localhost",
port: "27017",
database: "test_db",
collection: "test_collection",
outputPath: "./test_backup_path",
};
Backup.withHostAndPort(directOptions);
// Backup + Delete old backup files
----------------------------------------------
const uriOptions: URIOptions = {
uri: "mongodb://localhost:27017/",
database: "test_db",
collection: "test_collection",
outputPath: "./test_backup_path",
removeOldBackups: true,
oldBackupPath: "./old_backup",
};
Backup.withConnectionString(uriOptions);
// Run backup with cron schedule
---------------------------------------------
const scheduleOptions: DirectOptions = {
host: "localhost",
port: "27017",
database: "test_db",
collection: "test_collection",
outputPath: "./test_backup_path",
schedule: '00 00 00 * * *',
scheduleCallback: (args) => { /* do something */ },
};
Backup.withHostAndPort(scheduleOptions);
// Backup + Delete old backups with cron schedule
--------------------------------------------------
const scheduleOptions: DirectOptions = {
host: "localhost",
port: "27017",
database: "test_db",
collection: "test_collection",
outputPath: "./test_backup_path",
schedule: "00 00 00 * * *",
scheduleCallback: (args) => {/* do something */ },
removeOldBackups: true,
localBackupRange: 2,
};
Backup.withHostAndPort(scheduleOptions);
```
----
Upload Process
```js
import {Upload, GDriveOptions, GithubOptions,} from "mongodb-backup-cloud";
// Upload files to github
const githubOptions: GithubOptions = {
token: 'private access token', // with repo and read:user access to read repo names
repository: 'test_repo',
branch: 'main',
email: 'your github email',
filePath: './backups'
}
Upload.toGitHub(githubOptions);
// Upload files to Google Drive
const driveOptions: GDriveOptions = {
clientId: 'oAuth client id',
clientSecret: 'oAuth client secret',
refreshToken: 'oAuth refresh token',
driveFolderName: 'test_upload',
filePath: './backups'
}
Upload.toGoogleDrive(driveOptions);
```
[How to get OAuth Credentials](https://blog.tericcabrel.com/upload-file-to-google-drive-with-nodejs/)
---
#### Available Options
> Backup
| option | type | default | description |
| ------------------ | ------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| uri | string | --- | Mongodb connection string |
| host | string | --- | Specifies the resolvable hostname of the MongoDB deployment. |
| port | string | --- | Specifies the TCP port on which the MongoDB instance listens for client connections. |
| username | string | --- | Specifies a username with which to authenticate to a MongoDB database that uses authentication. |
| password | string | --- | Specifies a password with which to authenticate to a MongoDB database that uses authentication. |
| verbose | number (1-5) | 1 | Increases the amount of logging output |
| quiet | boolean | false | Limits the amount of output |
| readPreference | object | primary | Specifies the read preference for mongodump |
| gzip | boolean | false | Compresses the output. The files have the suffix ' .gz ' |
| outputPath | string | current_directory/backup | Specifies the directory where mongodump will write BSON files for the dumped databases. **(can't be used together with archive option )** |
| archive | string | --- | Writes the output to a specified archive file. **(can't be used together with outputPath option )** |
| archiveExtension | string | --- | File extension of the archive file. |
| schedule | string | --- | cron schedule string. ex:- '0 0 * * * *' |
| scheduleCallback | function | --- | Callback function to run after every scheduled backup process completion |
| removeOldBackups | boolean | false | Remove previous backups |
| removeOldDir | boolean | false | Remove entire directory containing previous backups |
| oldBackupPath | string | --- | Relative path to the previous backup that should be removed
** useful only when NOT using the schedule option** |
| localBackupRange | number | 7 | Number of days to keep previous backups. Backups made before the specified number of days will be removed
** available only when using the schedule option** |
| database | string | --- | Specifies a database to backup. If you do not specify a database, mongodump copies all databases of the instance into the dump files. |
| collection | string | --- | Specifies a collection to backup. If you do not specify a collection, this option copies all collections in the specified database or instance to the dump files. |
| query | string | --- | Provides a JSON document as a query that optionally limits the documents included in the output of mongodump.
** available only when using the collection option** |
| queryFilePath | string | --- | Specifies the path to a file containing a JSON document as a query filter that limits the documents included in the output of mongodump. |
| dumpUsersAndRoles | boolean | false | Includes user and role definitions in the database's dump directory
** available only when using the database option** |
| excludeCollection | Array[string] | --- | Excludes the specified collections from the mongodump output
example :- ['coll_1', 'coll_2'] |
| excludeWithPrefix | Array[string] | --- | Excludes all collections with a specified prefix from the mongodump outputs.
example :- ['coll', 'test'] |
| parallel | number | --- | Number of collections mongodump should export in parallel. |
| viewsAsCollections | boolean | --- | When specified, mongodump exports read-only views as collections. |
---
> Upload
- Github
| option | type | description |
| ---------- | ------ | ---------------------------------------------------------- |
| token | string | Github private access token |
| repository | string | Github repository name |
| branch | string | Github repository branch name |
| email | string | Github account email |
| filePath | string | Path to file or directory that needs to be added to github |
---
- Google Drive
| option | type | description |
| --------------- | ------ | -------------------------------------------------------------------------------- |
| clientId | string | OAuth client id |
| clientSecret | string | OAuth client secret |
| refreshToken | string | OAuth refresh token |
| filePath | string | Path to the file or directory that needs to be uploaded. |
| driveFolderName | string | Google drive root level folder name. folder will be created if it doesn't exist. |
[How to get OAuth Credentials](https://blog.tericcabrel.com/upload-file-to-google-drive-with-nodejs/)
---
---
_Source: https://npm.io/package/mongodb-backup-cloud · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._