Emulador baseado em Linux (visualização)

A próxima geração do emulador do Azure Cosmos DB é totalmente baseada em Linux e está disponível como um contêiner do Docker. Ele suporta a execução em uma ampla variedade de processadores e sistemas operacionais.

Pré-requisitos

• Docker

Instalação

Obtenha a imagem do contêiner do Docker usando docker pullo . A imagem do contêiner é publicada no Microsoft Artifact Registry como mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:vnext-preview.

docker pull mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:vnext-preview

Em Execução

Para executar o contêiner, use docker run. Depois, use docker ps para validar se o contêiner está em execução.

docker run --detach --publish 8081:8081 --publish 1234:1234 mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:vnext-preview

docker ps

CONTAINER ID   IMAGE                                                             COMMAND                  CREATED         STATUS         PORTS                                                                                  NAMES
c1bb8cf53f8a   mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:vnext-preview  "/bin/bash -c /home/…"   5 seconds ago   Up 5 seconds   0.0.0.0:1234->1234/tcp, :::1234->1234/tcp, 0.0.0.0:8081->8081/tcp, :::8081->8081/tcp   <container-name>

docker run --detach --publish 8081:8081 --publish 1234:1234 mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:vnext-preview --protocol https

Comandos do Docker

A tabela a seguir resume os comandos do Docker disponíveis para configurar o emulador. Esta tabela detalha os argumentos correspondentes, variáveis de ambiente, valores permitidos, configurações padrão e descrições de cada comando.

Suporte de funcionalidades

Este emulador está em desenvolvimento ativo e visualização. Como resultado, nem todos os recursos do Azure Cosmos DB são suportados. Alguns recursos também não serão suportados no futuro. Esta tabela inclui o estado de vários recursos e seu nível de suporte.

Limitações

Além dos recursos ainda não suportados ou não planejados, a lista a seguir inclui as limitações atuais do emulador.

• O SDK do .NET para Azure Cosmos DB não oferece suporte à execução em massa no emulador.
• Os SDKs .NET e Java não suportam o modo HTTP no emulador.

Instalando certificados para Java SDK

Ao usar o Java SDK para Azure Cosmos DB com esta versão do emulador no modo https, é necessário instalar seus certificados em seu armazenamento confiável Java local.

Obter certificado

Em uma bash janela, execute o seguinte:

# If the emulator was started with /AllowNetworkAccess, replace localhost with the actual IP address of it:
EMULATOR_HOST=localhost
EMULATOR_PORT=8081
EMULATOR_CERT_PATH=/tmp/cosmos_emulator.cert
openssl s_client -connect ${EMULATOR_HOST}:${EMULATOR_PORT} </dev/null | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > $EMULATOR_CERT_PATH

Instalar certificado

Navegue até o diretório de sua instalação java onde cacerts o arquivo está localizado (substitua abaixo pelo diretório correto):

cd "C:/Program Files/Eclipse Adoptium/jdk-17.0.10.7-hotspot/bin"

Importe o certificado (pode ser-lhe pedida uma palavra-passe, o valor predefinido é "changeit"):

keytool -cacerts -importcert -alias cosmos_emulator -file $EMULATOR_CERT_PATH

Se você receber um erro porque o alias já existe, exclua-o e execute o acima novamente:

keytool -cacerts -delete -alias cosmos_emulator

Comunicar problemas

Se você encontrar problemas com o uso desta versão do emulador, abra um problema no repositório GitHub (https://github.com/Azure/azure-cosmos-db-emulator-docker) e marque-o com o rótulo cosmosEmulatorVnextPreview.