Testing Azure Cosmos DB Regionally Utilizing A Docker Container Picture

Why utilizing the emulator? And why Docker?

Microsoft’s Cosmos DB is a cloud-based, scalable database service that has been common ever since its launch in Could 2017. With a view to develop options utilizing Cosmos DB as a backend, an affordable and simple approach is to make use of the emulator supplied by Microsoft. Nonetheless, no person desires to fiddle with putting in stuff like this domestically in your developer workstation. And absolutely virtualized VMware pictures devour a big portion of assets. Docker involves the rescue, as a docker picture co-uses the kernel of the machine its working on and thus is slick, has a somewhat small footprint each in storage and reminiscence consumption and will get you up and working in minutes.

The way to get began?

To begin with, it’s essential set up the Docker consumer in your machine. For Home windows, Docker Desktop may be downloaded from right here. As soon as put in, you’ll be able to seize the Cosmos DB emulator from Microsoft’s container registry by utilizing the command line:

docker pull windows/azure-cosmos-emulator

With a view to begin the container picture, all it’s important to do afterwards is to create a brand new listing after which run the picture mounting this listing. You could need to adapt the reminiscence footprint you are permitting for, nevertheless the 2GB appear to be simply sufficient to get by. Be sure that the ports you are passing should not conflicting with different ports you may have in use.

md %LOCALAPPDATApercentCosmosDBEmulatorbind-mount

docker run --name azure-cosmosdb-emulator --memory 2GB --mount "sort=bind,supply=%LOCALAPPDATApercentCosmosDBEmulatorbind-mount,vacation spot=C:CosmosDB.Emulatorbind-mount" --interactive --tty -p 8081:8081 -p 8900:8900 -p 8901:8901 -p 8902:8902 -p 10250:10250 -p 10251:10251 -p 10252:10252 -p 10253:10253 -p 10254:10254 -p 10255:10255 -p 10256:10256 -p 10350:10350 windows/azure-cosmos-emulator

Working this command leads to an output like this:

Moreover, a PowerShell script will get created routinely that comprises the code required to import the SSH certificates for the docker container occasion. You may discover it within the newly created bind-mount listing. Import the certificates by double-clicking the importcert.ps1 file. Additionally word the completely different endpoints supplied within the response. You can begin the emulator by navigating to this endpoint in your browser then. Particularly, to <endpoint>/_explorer/index.html. For the pattern above, this might be

which brings up the Azure Cosmos DB Emulator UI:

Testing Azure Cosmos DB locally using a Docker container image

From right here you can begin your encounters working with the Cosmos DB database. For a fast begin, you would possibly take a look at this weblog submit that will get you up and working with a TODO assortment. Microsoft gives very helpful means to get began with a C# app that are described in additional element there.


The offered emulator resolution utilizing Docker is a really useful approach to maintain your machine clear, save prices throughout the growth part and get to know Cosmos DB. Let me know for those who’ve labored with the emulator earlier than and ensure to share your experiences. 

Show More

Related Articles

Leave a Reply

Your email address will not be published. Required fields are marked *

Back to top button