Linux tabanlı öykünücü (önizleme)

Azure Cosmos DB öykünücüsünün yeni nesli tamamen Linux tabanlıdır ve Docker kapsayıcısı olarak kullanılabilir. Çok çeşitli işlemcilerde ve işletim sistemlerinde çalıştırmayı destekler.

Önkoşullar

• Docker

Yükleme

kullanarak docker pullDocker kapsayıcı görüntüsünü alın. Kapsayıcı görüntüsü olarak Microsoft Yapıt Kayıt Defteri mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:vnext-previewyayımlanır.

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

Çalışıyor

Kapsayıcıyı çalıştırmak için kullanın docker run. Daha sonra, kapsayıcının çalıştığını doğrulamak için kullanın docker ps .

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 komutları

Aşağıdaki tabloda öykünücüyü yapılandırmak için kullanılabilen Docker komutları özetlemektedir. Bu tabloda ilgili bağımsız değişkenler, ortam değişkenleri, izin verilen değerler, varsayılan ayarlar ve her komutun açıklamaları açıklanır.

Özellik desteği

Bu öykünücü etkin geliştirme ve önizleme aşamasındadır. Sonuç olarak, tüm Azure Cosmos DB özellikleri desteklenmez. Bazı özellikler gelecekte de desteklenmeyecektir. Bu tablo çeşitli özelliklerin durumunu ve destek düzeylerini içerir.

Sınırlamalar

Henüz desteklenmeyen veya planlanmamış özelliklere ek olarak, aşağıdaki liste öykünücünün geçerli sınırlamalarını içerir.

• Azure Cosmos DB için .NET SDK'sı öykünücüde toplu yürütmeyi desteklemez.
• .NET ve Java SDK'ları öykünücüde HTTP modunu desteklemez.

Java SDK için sertifika yükleme

Azure Cosmos DB için Java SDK'sını öykünücünün bu sürümüyle https modunda kullanırken, yerel Java güven deponuza sertifikalarını yüklemeniz gerekir.

Sertifika alma

Bir bash pencerede aşağıdakileri çalıştırın:

# 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

Sertifika yükleme

Dosyanın bulunduğu cacerts java yüklemenizin dizinine gidin (aşağıdaki değerini doğru dizinle değiştirin):

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

Sertifikayı içeri aktarın (parola girmeniz istenebilir, varsayılan değer "changeit"dir):

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

Diğer ad zaten var olduğundan bir hata alırsanız, diğer adı silin ve yukarıdakini yeniden çalıştırın:

keytool -cacerts -delete -alias cosmos_emulator

Raporlama sorunları

Öykünücünün bu sürümünü kullanırken sorunlarla karşılaşırsanız GitHub deposunda (https://github.com/Azure/azure-cosmos-db-emulator-docker) bir sorun açın ve etiketiyle etiketleyin cosmosEmulatorVnextPreview.