UI for Azure Cosmos DB. Powers the Azure Portal, https://cosmos.azure.com/, and the Cosmos DB Emulator (Mirror of https://github.com/Azure/cosmos-explorer)
Go to file
Steve Faulkner 6da43ee27b
Publish IE specific Nuget package (#347)
* Publish IE specific Nuget package

* Require ally tests to pass
2020-12-17 17:41:38 -06:00
.github Publish IE specific Nuget package (#347) 2020-12-17 17:41:38 -06:00
.vscode Initial Move from Azure DevOps to GitHub 2020-05-25 21:30:55 -05:00
__mocks__ Clean up unused utility functions for creating databases and collections (#181) 2020-09-03 13:05:22 -07:00
configs Bundle config.json with published nugets (#64) 2020-06-30 13:49:14 -05:00
externals Remove jquery.contextMenu (#248) 2020-10-08 18:19:24 -05:00
fonts/segoe-ui/west-european/normal Initial Move from Azure DevOps to GitHub 2020-05-25 21:30:55 -05:00
images Remove enableGallery feature flag (#68) 2020-07-06 12:10:26 -07:00
less Added Support for editing Mongo Indexing Policy from Settings tab (#284) 2020-10-26 14:17:40 -07:00
quickstart Initial Move from Azure DevOps to GitHub 2020-05-25 21:30:55 -05:00
sampleData Remove RUPM (#328) 2020-12-01 07:06:38 +00:00
src Fix duplicate settings tabs (#343) 2020-12-17 13:01:36 -08:00
strict-migration-tools Initial Move from Azure DevOps to GitHub 2020-05-25 21:30:55 -05:00
test Added testExplorer and notebooks UI automated tests (#323) 2020-11-19 09:29:38 -08:00
utils Create Cassandra Keyspace via ARM (#142) 2020-08-13 13:26:52 -05:00
.env.example Added testExplorer and notebooks UI automated tests (#323) 2020-11-19 09:29:38 -08:00
.eslintignore Explorer.ts Cleanup (#341) 2020-12-16 20:00:39 -06:00
.eslintrc.js Prevent JSON.stringify(error) (#298) 2020-10-26 16:50:31 -05:00
.gitignore Use Puppeteer for Emulator Test (#321) 2020-11-13 10:58:38 -06:00
.npmrc Initial Move from Azure DevOps to GitHub 2020-05-25 21:30:55 -05:00
CONTRIBUTING.md Add more files to strict compile. Update CONTRIBUTING.md (#63) 2020-07-06 17:16:24 +02:00
DataExplorer.nuspec Initial Move from Azure DevOps to GitHub 2020-05-25 21:30:55 -05:00
LICENSE Initial Move from Azure DevOps to GitHub 2020-05-25 21:30:55 -05:00
README.md Explorer.ts Cleanup (#341) 2020-12-16 20:00:39 -06:00
ReleaseNotes.md Initial Move from Azure DevOps to GitHub 2020-05-25 21:30:55 -05:00
azure-pipelines.cg.yml Update azure-pipelines.cg.yml for Azure Pipelines 2020-10-15 16:20:38 -05:00
babel.config.js Initial Move from Azure DevOps to GitHub 2020-05-25 21:30:55 -05:00
copyToConsumers.js Initial Move from Azure DevOps to GitHub 2020-05-25 21:30:55 -05:00
jest-puppeteer.config.js Fixes e2e test input focus swapping (#262) 2020-10-07 15:41:38 -04:00
jest.config.e2e.js Initial Portal Runner (#51) 2020-06-24 14:07:01 -05:00
jest.config.js Refresh Caches only in Portal (#129) 2020-08-05 15:54:17 -05:00
mockModule.js Initial Move from Azure DevOps to GitHub 2020-05-25 21:30:55 -05:00
package-lock.json Fix offer update notification for AAD users (#338) 2020-12-11 13:38:57 -06:00
package.json Added testExplorer and notebooks UI automated tests (#323) 2020-11-19 09:29:38 -08:00
tsconfig.contracts.json Initial Move from Azure DevOps to GitHub 2020-05-25 21:30:55 -05:00
tsconfig.json Added testExplorer and notebooks UI automated tests (#323) 2020-11-19 09:29:38 -08:00
tsconfig.strict.json Move read offer to RP (#326) 2020-11-19 17:13:11 -08:00
tsconfig.test.json Initial Move from Azure DevOps to GitHub 2020-05-25 21:30:55 -05:00
tslint.json Initial Move from Azure DevOps to GitHub 2020-05-25 21:30:55 -05:00
web.config Initial Move from Azure DevOps to GitHub 2020-05-25 21:30:55 -05:00
webpack.config.js Added testExplorer and notebooks UI automated tests (#323) 2020-11-19 09:29:38 -08:00

README.md

Cosmos DB Explorer

UI for Azure Cosmos DB. Powers the Azure Portal, https://cosmos.azure.com/, and the Cosmos DB Emulator

Getting Started

  • npm install
  • npm run build

Developing

Watch mode

Run npm start to start the development server and automatically rebuild on changes

Hosted Development (https://cosmos.azure.com)

  • Visit: https://localhost:1234/hostedExplorer.html
  • Local sign in via AAD will NOT work. Connection string only in dev mode. Use the Portal if you need AAD auth.
  • The default webpack dev server configuration will proxy requests to the production portal backend: https://main.documentdb.ext.azure.com. This will allow you to use production connection strings on your local machine.

Emulator Development

Setting up a Remote Emulator

The Cosmos emulator currently only runs in Windows environments. You can still develop on a non-Windows machine by setting up an emulator on a windows box and exposing its ports publicly:

  1. Expose these ports publicly: 8081, 8900, 8979, 10250, 10251, 10252, 10253, 10254, 10255, 10256

  2. Download and install the emulator: https://docs.microsoft.com/en-us/azure/cosmos-db/local-emulator

  3. Start the emulator from PowerShell:

> cd C:/

> .\CosmosDB.Emulator.exe -AllowNetworkAccess -Key="<EMULATOR MASTER KEY>"

Portal Development

Testing

Unit Tests

Unit tests are located adjacent to the code under test and run with Jest:

npm run test

End to End CI Tests

Jest and Puppeteer are used for end to end browser based tests and are contained in test/. To run these tests locally:

  1. Copy .env.example to .env
  2. Update the values in .env including your local data explorer endpoint (ask a teammate/codeowner for help with .env values)
  3. Make sure all packages are installed npm install
  4. Run the server npm run start and wait for it to start
  5. Run npm run test:e2e

Releasing

We generally adhere to the release strategy documented by the Azure SDK Guidelines. Most releases should happen from the master branch. If master contains commits that cannot be released, you may create a release from a release/ or hotfix/ branch. See linked documentation for more details.

Contributing

Please read the contribution guidelines.