[Update docs] CosmosDB emulator container not work on Apple Silicon

[galvesribeiro]

The docs should mention this emulator don't work with MacOS on Apple Silicon (i.e. M1/M2) Macs.

When trying to run the container on Apple Silicon devices with the suggested commands:

docker run \
    --platform linux/amd64 \
    --publish 8081:8081 \
    --memory 3g --cpus=2.0 \
    --name=test-linux-emulator \
    --env AZURE_COSMOS_EMULATOR_PARTITION_COUNT=10 \
    --env AZURE_COSMOS_EMULATOR_ENABLE_DATA_PERSISTENCE=true \
    --env AZURE_COSMOS_EMULATOR_IP_ADDRESS_OVERRIDE=$ipaddr \
    --interactive \
    --tty \
    mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator

The container start but quickly it dies with the following message:

This is an evaluation version.  There are [67] days left in the evaluation period.

It works on Intel Macs but not on Apple Silicon.

---

Document Details

⚠ Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.

• ID: 4b8e447c-2814-df77-a9cb-d631e7f5c491
• Version Independent ID: 44ed5bc8-1eb7-c981-96ad-7faa2645a61b
• Content: Run the Azure Cosmos DB Emulator on Docker for Linux
• Content Source: articles/cosmos-db/docker-emulator-linux.md
• Service: cosmos-db
• GitHub Login: @StefArroyo
• Microsoft Alias: esarroyo

[RamanathanChinnappan-MSFT]

@galvesribeiro Thanks for your feedback! We will investigate and update as appropriate.

[shaktisingh-msft]

Hi @StefArroyo,

Could you please look into this document request. Thanks

[seesharprun]

Hello @galvesribeiro!

The current version of the Docker emulator doesn't always work on M1 and M2 chips. We have added a note to the relevant article that will publish soon. The emulator team is hard at work looking for a workaround.

[galvesribeiro]

@seesharprun I think this emulator need a real revamp. It doesn't work on GitHub Actions and Azure DevOps pipelines either :(

[seesharprun]

:tada:

We recently released a complete revamp of the emulator documentation to cover many of the content gaps, be more succinct, and enable you to use the emulator quickly.

The new emulator documentation shows how to use the containerized (Docker) or local (Windows) variants of the emulators across five different APIs (NoSQL, MongoDB, Apache Cassandra, Apache Gremlin, Table) and three programming languages (Python, .NET, JavaScript).

We have also retired the outdated legacy emulator documentation as many of the code samples and instructions were out of date relative to the latest SDKs/libraries for each API and programming language.

Here's a few helpful links to get you started with the new emulator docs:

	Link
Emulator landing page	https://learn.microsoft.com/azure/cosmos-db/emulator
How-to use the emulator guide	https://learn.microsoft.com/azure/cosmos-db/how-to-develop-emulator
Emulator release notes (local Windows only)	https://learn.microsoft.com/azure/cosmos-db/emulator-release-notes
**Emulator command-line arguments (local Windows only)	https://learn.microsoft.com/azure/cosmos-db/emulator-windows-arguments

I hope this helps unblock you. If you need changes to the emulator docs, feel free to open a new GitHub issue.

Thank you for your patience!

[seesharprun]

@seesharprun I think this emulator need a real revamp. It doesn't work on GitHub Actions and Azure DevOps pipelines either :(

Try this:

    name: Continuous Integration
    on:
      push:
        branches:
          - main
    jobs:
      unit_tests:
        name: Run Python unit tests
        runs-on: windows-latest
        steps:
          - name: Checkout (GitHub)
            uses: actions/checkout@v3
          - name: Start Azure Cosmos DB emulator
            run: >-
              Write-Host "Launching Cosmos DB Emulator"
              Import-Module "$env:ProgramFiles\Azure Cosmos DB Emulator\PSModules\Microsoft.Azure.CosmosDB.Emulator"
              Start-CosmosDbEmulator
          - name: Install test runner
            run: pip install pytest
          - name: Run Python tests
            run: pytest