قم بربط تطبيق App Service بـCosmos DB باستخدام CLI

  • مقالة
  • قراءة خلال 3 دقائق

ينشئ هذا النموذج للبرنامج النصي حساب Azure Cosmos DB باستخدام واجهة برمجة تطبيق Azure Cosmos DB لـ MongoDB وتطبيق App Service. ثم يربط سلسلة اتصال MongoDB بتطبيق الويب باستخدام إعدادات التطبيق.

إذا لم يكن لديك اشتراك Azure، فأنشئ حساب Azure مجاني قبل أن تبدأ.

المتطلبات الأساسية

نموذج البرنامج النصي

تشغيل Azure Cloud Shell

إن Azure Cloud Shell هو واجهة تفاعلية Shell مجانية يُمكنك استخدامها لتنفيذ الخطوات الواردة في هذه المقالة. يحتوي على أدوات Azure الشائعة والمثبتة مسبقًا والتي تم تكوينها للاستخدام مع حسابك.

لفتح Cloud Shell، ما عليك سوى تحديد "Try it" من الزاوية العليا اليسرى لكتلة التعليمة البرمجية. يمكنك أيضاً تشغيل Cloud Shell في علامة تبويب مستعرض منفصلة بالانتقال إلى https://shell.azure.com.

عند فتح Cloud Shell، تحقق من تحديد Bash لبيئتك. ستستخدم الجلسات اللاحقة Azure CLI في بيئة Bash، حدد نسخ لنسخ كتل التعليمات البرمجية، وألصقها في Cloud Shell، واضغط على Enter لتشغيلها.

تسجيل الدخول إلى Azure

يُصادق Cloud Shell تلقائياً بموجب الحساب الأولي الذي سُجل الدخول به. استخدم البرنامج النصي التالي لتسجيل الدخول باستخدام اشتراك مختلف، واستبدل <Subscription ID> بمعرّف اشتراك Azure الخاص بك. إذا لم يكن لديك اشتراك في Azure، فأنشئ حساب Azure مجاني قبل أن تبدأ.

subscription="<subscriptionId>" # add subscription here

az account set -s $subscription # ...or use 'az login'

لمزيد من المعلومات، راجع تعيين اشتراك نشط أو تسجيل الدخول بشكل تفاعلي

تشغيل البرنامج النصي

# Connect an App Service app to Cosmos DB
# set -e # exit if error
# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="msdocs-app-service-rg-$randomIdentifier"
tag="connect-to-documentdb.sh"
appServicePlan="msdocs-app-service-plan-$randomIdentifier"
webapp="msdocs-web-app-$randomIdentifier"

# Create a resource group.
echo "Creating $resourceGroup in "$location"..."
az group create --name $resourceGroup --location "$location" --tag $tag

# Create an App Service Plan
echo "Creating $appServicePlan"
az appservice plan create --name $appServicePlan --resource-group $resourceGroup \
--location "$location"

# Create a Web App
az webapp create --name $webapp --plan $appServicePlan --resource-group $resourceGroup 

# Create a Cosmos DB with MongoDB API
az cosmosdb create --name $webapp --resource-group $resourceGroup --kind MongoDB

# Get the MongoDB URL
connectionString=$(az cosmosdb keys list  --name $webapp --resource-group $resourceGroup --type connection-strings --query connectionStrings[0].connectionString --output tsv)

# Assign the connection string to an App Setting in the Web App
az webapp config appsettings set --name $webapp --resource-group $resourceGroup \
--settings "MONGODB_URL=$connectionString"

تنظيف الموارد

استخدم الأمر التالي لإزالة مجموعة الموارد وجميع الموارد المقترنة بها باستخدام الأمر حذف مجموعة az - إلا إذا وُجدت حاجة مستمرة لهذه الموارد. قد يستغرق إنشاء بعض هذه الموارد بعض الوقت، وكذلك حذفها.

az group delete --name $resourceGroup

مرجع النموذج

يستخدم هذا البرنامج النصي الأوامر التالية لإنشاء مجموعة موارد وتطبيق App Service وCosmos DB وجميع الموارد ذات الصلة. يرتبط كل أمر في الجدول بالمستندات الخاصة بالأمر.

الأمر ملاحظات
az group create يُنشئ مجموعة موارد يتم فيها تخزين جميع الموارد.
az appservice plan create إنشاء خطة App Service.
az webapp create إنشاء تطبيق App Service.
az cosmosdb create يُنشئ حساب Cosmos DB.
az cosmosdb list-connection-strings يسرد سلاسل الاتصال لحساب Cosmos DB المحدد.
az webapp config appsettings set يُنشئ إعداد لتطبيق App Service أو تحديثه. يتم عرض إعدادات التطبيق كمتغيرات لبيئة التطبيق الخاص بك (انظر ⁧⁩متغيرات البيئة ومرجع إعدادات التطبيق⁧⁩).

الخطوات التالية

لمزيد من المعلومات عن Azure CLI، راجع وثائق Azure CLI.

يمكن العثور على نماذج البرامج النصية الإضافية لـ CLI في ⁧⁩وثائق Azure App Service⁧⁩.