Registry / aws / umbraco-cloud-fetch-database

umbraco-cloud-fetch-database

library0.3.0jsnpmunverified

Wizard-based CLI that downloads a database from Umbraco Cloud and replaces the LocalDB .mdf/.ldf files in a local Umbraco ASP.NET Core project. Version 0.3.0, released as needed. Windows-only, auto-downloads sqlpackage, keeps 3 latest backups. Key differentiators: dedicated Umbraco Cloud integration, automatic sqlpackage management, backup safety.

aws devops database

npm install umbraco-cloud-fetch-database

github ↗package ↗

INSTALL

IMPORT

SIG · UMBRACO-CLOUD-FETC

umbraco-cloud-fetch-database

awsjavascriptv0.3.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ npx umbraco-cloud-fetch-database@latest

✗ npm install -g umbraco-cloud-fetch-database

Use npx to run the CLI without installing globally. Global install works but is not recommended.

(package.json bin)

✓ npx umbraco-cloud-fetch-database

✗ umbraco-cloud-fetch-database (without npx, if not in PATH)

If installed globally, the command is available as 'umbraco-cloud-fetch-database'.

Run the CLI inside an Umbraco web project folder to start the interactive wizard.

cd /path/to/your/umbraco/web/project npx umbraco-cloud-fetch-database@latest

umbraco-cloud-fetch-database --version

Debug

Known issues

breakingWindows-only tool will refuse to run on other operating systems.

fix

Use a Windows machine or Windows VM.

affects: >=0.1.0

gotchaRequires that the project already has a working LocalDB database (the .mdf/.ldf files must exist).

fix

Start the Umbraco project once to let it create the database files.

affects: >=0.1.0

gotchasqlpackage is auto-downloaded only if not already in PATH. Use of GitHub releases may require internet access.

fix

Ensure internet access for automatic download or install sqlpackage manually.

affects: >=0.1.0

gotchaCloud database password is entered interactively and is never stored. Ensure the terminal is secure.

fix

Use a secure terminal and avoid screen recording.

affects: >=0.1.0

Errors

Common errors & fixes

Cannot find module '...'

Node.js version <20

fix

Upgrade Node.js to >=20

LocalDB not detected

LocalDB is not installed or sqllocaldb.exe not in PATH

fix

Install SQL Server Express LocalDB from Microsoft

sqlpackage: command not found

sqlpackage not in PATH and auto-download failed

fix

Install sqlpackage manually or check internet connection

Upgrade

Version history

0.3.0latest on npm

Audit

Dependencies

nodeoptionalRuntime requirement

Agent activity

41 hits · last 30 days

node