firestore-backup-restore

    1.3.1 • Public • Published

    firestore-backup-restore

    A Google Firebase Firestore backup and restore tool. This project was forked from https://github.com/steadyequipment/node-firestore-backup.git and extended.

    You can backup your Firestore documents to disk, clone data from one Firestore to another, and restore from disk.

    Installation

    Install using npm.

    npm install -g firestore-backup-restore

    or yarn

    yarn global add firestore-backup-restore

    or on the fly

    npx firestore-backup-restore
    

    Alternatively download the source.

    git clone https://github.com/willhlaw/node-firestore-backup-restore/commits/master

    Retrieving Google Cloud Account Credentials

    1. Visit the Firebase Console
    2. Select your project
    3. Navigate to Project Settings (at the time of writing the gear icon button at the top left of the page).
    4. Navigate to Service Accounts
    5. Click Generate New Private Key

    This downloaded json file contains the proper credentials needed for firestore-backup-restore to authenticate.

    Usage

    Options:

    Usage: firestore-backup-restore [options]

    Options:

    • -V, --version output the version number
    • -a, --accountCredentials <path> Google Cloud account credentials JSON file.
    • -B, --backupPath <path> Path to store backup.
    • -a2, --restoreAccountCredentials <path> Google Cloud account credentials JSON file for restoring documents.
    • -P, --prettyPrint JSON backups done with pretty-printing.
    • -S, --stable JSON backups done with stable-stringify.
    • -J, --plainJSONBackup JSON backups done without preserving any type information. - Lacks full fidelity restore to Firestore. - Can be used for other export purposes.
    • -h, --help output usage information

    Backup:

    Retrieves data from Firestore specified in accountCredentials and saves files to backupPath.

    As of version 1.2, the default is to save files with each field converted to a {value, type} object so that the type information can be preserved and used when restoring to Firestore. Otherwise, a timestamp or reference would be restored as a string. See -J or --plainJSONBackup to change this default behavior.

    Example backup:

    firestore-backup-restore --accountCredentials path/to/account/credentials/file.json --backupPath /backups/myDatabase

    Clone:

    Move data from Firestore in accountCredentials to Firestore specified in accountRestoreCredentials.

    As of version 1.2, this process still requires --backupPath option. This may be a simple change and tested. In fact, there is an issue marked good first issue to fix this if there are any takers.

    Example clone:

    firestore-backup-restore --accountCredentials path/to/account/credentials/file.json --backupPath /backups/myDatabase --restoreAccountCredentials path/to/restore/credentials/file.json

    Restore:

    If a backup has already been performed, then later, you can restore the backup in --backupPath to Firestore specified in --restoreAccountCredentials.

    Example restore:

    firestore-backup-restore --backupPath /backups/myDatabase --restoreAccountCredentials path/to/restore/credentials/file.json

    Backup with pretty printing:

    If you want the documents to look pretty on disk and don't mind giving up extra disk space, then use the --prettyPrint option.

    • -P, --prettyPrint - JSON backups done with pretty-printing.

    Example:

    firestore-backup-restore --accountCredentials path/to/account/credentials/file.json --backupPath /backups/myDatabase --prettyPrint

    Backup with stable stringify:

    If you want the json documents to have sorted keys, then use the --stable option.

    • -S, --stable - JSON backups done with stable-stringify.

    Example:

    firestore-backup-restore --accountCredentials path/to/account/credentials/file.json --backupPath /backups/myDatabase --stable

    Backup without type information as plain JSON documents:

    To change the default behavior and backup the Firestore documents as plain JSON documents, use --plainJSONBackup.

    The default is to save type information. In order for restore to work with full fidelity for field types and to work with clone for references to be changed from the original Firestore to the destination Firestore, then documents need to be saved to disk in a format that preserves the type information (that is gleaned through inspection by constructDocumentObjectToBackup during save). If this default behavior is not wanted and you want the regular JSON document to be saved to disk instead, then use --plainJSONBackup.

    • -J, --plainJSONBackup - JSON backups done without preserving any type information
      • Lacks full fidelity restore to Firestore
      • Can be used for other export purposes

    Example:

    firestore-backup-restore --accountCredentials path/to/account/credentials/file.json --backupPath /backups/myDatabase --plainJSONBackup

    Document saved with -J or --plainJSONBackup option:

    {
      name: 'UserCreationError',
      type: 'error',
      // undefined fields are ignored for Firestore types
      fooWillBeIgnored: undefined,
      message: {
        code: 'ValidationError',
        _embedded: {
          errors: [
            {
              _links: {},
              code: 'NotAllowed',
              path: '/dateOfBirth',
              message: 'DateOfBirth value not allowed.'
            }
          ]
        },
        message:
          'Validation error(s) present. See embedded errors list for more details.'
      },
      status: 'read',
      identifier: 'provider'
    };
    

    Document saved with type information (Default)

    {
      name: { value: 'UserCreationError', type: 'string' },
      type: { value: 'error', type: 'string' },
      message: {
        value: {
          code: { value: 'ValidationError', type: 'string' },
          _embedded: {
            value: {
              errors: {
                value: [
                  {
                    value: {
                      path: { value: '/dateOfBirth', type: 'string' },
                      message: {
                        value: 'DateOfBirth value not allowed.',
                        type: 'string'
                      },
                      _links: { value: {}, type: 'object' },
                      code: { value: 'NotAllowed', type: 'string' }
                    },
                    type: 'object'
                  }
                ],
                type: 'array'
              }
            },
            type: 'object'
          },
          message: {
            value:
              'Validation error(s) present. See embedded errors list for more details.',
            type: 'string'
          }
        },
        type: 'object'
      },
      status: { value: 'read', type: 'string' },
      identifier: { value: 'provider', type: 'string' }
    

    Contributions

    Feel free to report bugs in the Issue Tracker, fork and create pull requests!

    Install

    npm i firestore-backup-restore

    DownloadsWeekly Downloads

    116

    Version

    1.3.1

    License

    MIT

    Unpacked Size

    1.07 MB

    Total Files

    157

    Last publish

    Collaborators

    • isheepdog
    • willhlaw