Linux-alapú emulátor (előzetes verzió)

Az Azure Cosmos DB emulátor következő generációja teljesen Linux-alapú, és Docker-tárolóként érhető el. Támogatja a processzorok és operációs rendszerek széles körének futtatását.

Előfeltételek

• Docker

Telepítés

A Docker-tároló lemezképének lekérése a következővel docker pull: . A tárolórendszerkép a Microsoft Eszközjegyzék a mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:vnext-previewkövetkezőképpen lesz közzétéve.

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

Futó

A tároló futtatásához használja a következőt docker run: . Ezután ellenőrizze, docker ps hogy a tároló fut-e.

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

Docker-parancsok

Az alábbi táblázat az emulátor konfigurálásához elérhető Docker-parancsokat foglalja össze. Ez a táblázat az egyes parancsok megfelelő argumentumait, környezeti változóit, engedélyezett értékeit, alapértelmezett beállításait és leírását ismerteti.

Szolgáltatások támogatása

Ez az emulátor aktív fejlesztésben és előzetes verzióban érhető el. Emiatt nem minden Azure Cosmos DB-funkció támogatott. Bizonyos funkciók a jövőben sem lesznek támogatottak. Ez a táblázat a különböző funkciók állapotát és azok támogatási szintjét tartalmazza.

Korlátozások

A még nem támogatott vagy nem tervezett funkciók mellett az alábbi lista az emulátor aktuális korlátozásait is tartalmazza.

• Az Azure Cosmos DB -hez készült .NET SDK nem támogatja a tömeges végrehajtást az emulátorban.
• A .NET és a Java SDK nem támogatja a HTTP módot az emulátorban.

Tanúsítványok telepítése Java SDK-hoz

Ha az Azure Cosmos DB-hez készült Java SDK-t az emulátor ezen verziójával https módban használja, telepíteni kell a tanúsítványokat a helyi Java megbízhatósági tárolóba.

Tanúsítvány lekérése

bash Egy ablakban futtassa a következőt:

# 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

Tanúsítvány telepítése

Keresse meg a java-telepítés könyvtárát, ahol cacerts a fájl található (cserélje le az alábbiakat a megfelelő könyvtárra):

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

Importálja a tanúsítványt (lehet, hogy jelszót kér, az alapértelmezett érték a "changeit"):

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

Ha hibaüzenetet kap, mert az alias már létezik, törölje, majd futtassa újra a fentieket:

keytool -cacerts -delete -alias cosmos_emulator

Jelentéskészítési problémák

Ha problémákba ütközik az emulátor ezen verziójának használatával kapcsolatban, nyisson meg egy hibát a GitHub-adattárban (https://github.com/Azure/azure-cosmos-db-emulator-docker), és címkével lássa el.cosmosEmulatorVnextPreview