مشاركة عبر

استخدام عمليات تحميل التخزين في Azure Container Apps

تطبيق الحاوية لديه حق الوصول إلى أنواع مختلفة من التخزين. يمكن لتطبيق واحد الاستفادة من أكثر من نوع واحد من التخزين إذا لزم الأمر.

إشعار

تجنب استخدام أحرف خاصة في أسماء وحدات التخزين لمنع فشل التوزيع. على سبيل المثال، تحتوي وحدة التخزين المسماة credentials.json على حرف خاص (.) ينتج عن ذلك خطأ في النشر.

نوع التخزين ‏‏الوصف استمرار مثال على الاستخدام
التخزين على نطاق الحاوية التخزين المؤقت المتوفر لحاوية قيد التشغيل تتوفر البيانات حتى يتم إيقاف تشغيل الحاوية كتابة ذاكرة التخزين المؤقت للتطبيقات المحلية.
التخزين على نطاق النسخة المتماثلة التخزين المؤقت لمشاركة الملفات بين الحاويات في نفس النسخة المتماثلة تتوفر البيانات حتى يتم إيقاف تشغيل النسخة المتماثلة ملفات سجل كتابة حاوية التطبيق الرئيسية التي تعالجها حاوية sidecar.
ملفات Azure التخزين الدائم البيانات مستمرة في ملفات Azure كتابة الملفات إلى مشاركة ملف لتسهيل الوصول إلى البيانات بواسطة أنظمة أخرى.

إشعار

لا تدعم Azure Container Apps تحميل مشاركات الملفات من Azure NetApp Files أو Azure Blob Storage.

التخزين المؤقت

يمكن لتطبيق الحاوية قراءة البيانات المؤقتة وكتابتها في التخزين المؤقت. يمكن تحديد نطاق التخزين المؤقت إلى حاوية أو نسخة متماثلة. يعتمد إجمالي مقدار التخزين على نطاق الحاوية والنسخة المتماثلة المتوفرة لكل نسخة متماثلة على العدد الإجمالي لوحدات المعالجة المركزية الظاهرية المخصصة للنسخة المتماثلة.

وحدات vCPU إجمالي التخزين المؤقت
0.25 أو أقل 1 جيجابيت
0.5 أو أقل 2 جيبي بايت
1 أو أقل 4 جيجابيت
أكثر من 1 8 جيجابيت

التخزين على نطاق الحاوية

يمكن للحاوية الكتابة إلى نظام الملفات الخاص بها.

يحتوي تخزين نظام ملفات الحاوية على الخصائص التالية:

  • التخزين مؤقت ويختفي عند إيقاف تشغيل الحاوية أو إعادة تشغيلها.
  • الملفات المكتوبة إلى هذا التخزين مرئية فقط للعمليات التي تعمل في الحاوية الحالية.

التخزين على نطاق النسخة المتماثلة

يمكنك تحميل وحدة تخزين مؤقتة سريعة الزوال تعادل EmptyDir (دليل فارغ) في Kubernetes. يتم تحديد نطاق هذا التخزين إلى نسخة متماثلة واحدة. استخدم وحدة EmptyDir تخزين لمشاركة البيانات بين الحاويات في نفس النسخة المتماثلة.

يحتوي التخزين على نطاق النسخة المتماثلة على الخصائص التالية:

  • تستمر الملفات طوال مدة بقاء النسخة المتماثلة.
    • إذا تم إعادة تشغيل حاوية في نسخة متماثلة، تبقى الملفات الموجودة في وحدة التخزين.
  • يمكن لأي حاويات init أو التطبيق في النسخة المتماثلة تحميل نفس وحدة التخزين.
  • يمكن للحاوية تحميل وحدات تخزين متعددة EmptyDir .

لتكوين التخزين على نطاق النسخة المتماثلة، حدد أولا وحدة EmptyDir تخزين في المراجعة. ثم حدد تحميل وحدة تخزين في حاوية واحدة أو أكثر في المراجعة.

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

المتطلبات الإرشادات
حساب Azure إذا لم يكن لديك حساب، فبادر بإنشاء حساب مجانا.
بيئة Azure Container Apps إنشاء بيئة تطبيقات الحاوية.
تكوين الهوية المدارة تأكد من أن الهوية المدارة المرتبطة ببيئة تطبيقات الحاويات الخاصة بك تم تعيينها للأدوار المناسبة للوصول إلى ملفات Azure.

التكوين

عند تكوين التخزين على نطاق النسخة المتماثلة باستخدام Azure CLI، يجب استخدام تعريف YAML لإنشاء تطبيق الحاوية أو تحديثه.

  1. لتحديث تطبيق حاوية موجود لاستخدام التخزين على نطاق النسخة المتماثلة، قم بتصدير مواصفات التطبيق إلى ملف YAML يسمى app.yaml.

    az containerapp show -n <APP_NAME> -g <RESOURCE_GROUP_NAME> -o yaml > app.yaml

  2. قم بإجراء التغييرات التالية على مواصفات تطبيق الحاوية.

    • أضف صفيفا volumes إلى template قسم تعريف تطبيق الحاوية الخاص بك وحدد وحدة تخزين. إذا كان لديك volumes صفيف بالفعل، أضف وحدة تخزين جديدة إلى الصفيف.
      • name هو معرف وحدة التخزين.
      • استخدم EmptyDir ك storageType.
    • لكل حاوية في القالب الذي تريد تحميل وحدة التخزين، حدد تحميل وحدة تخزين في volumeMounts صفيف تعريف الحاوية.
      • volumeName هو الاسم المحدد في volumes الصفيف.
      • mountPath هو المسار في الحاوية لتحميل وحدة التخزين.
    properties:
  managedEnvironmentId: /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP_NAME>/providers/Microsoft.App/managedEnvironments/<ENVIRONMENT_NAME>
  configuration:
    activeRevisionsMode: Single
  template:
    containers:
    - image: <IMAGE_NAME1>
      name: my-container-1
      volumeMounts:
      - mountPath: /myempty
        volumeName: myempty
    - image: <IMAGE_NAME_2>
      name: my-container-2
      volumeMounts:
      - mountPath: /myempty
        volumeName: myempty
    volumes:
    - name: myempty
      storageType: EmptyDir

  3. تحديث تطبيق الحاوية باستخدام ملف YAML.

    az containerapp update --name <APP_NAME> --resource-group <RESOURCE_GROUP_NAME> \
    --yaml app.yaml

راجع مواصفات YAML للحصول على مثال كامل.

لإنشاء وحدة تخزين ذات نطاق نسخة متماثلة وتركيبها في حاوية، قم بإجراء التغييرات التالية على مورد تطبيقات الحاوية في قالب ARM:

  • أضف صفيفا volumes إلى template قسم تعريف تطبيق الحاوية الخاص بك وحدد وحدة تخزين. إذا كان لديك volumes صفيف بالفعل، أضف وحدة تخزين جديدة إلى الصفيف.
    • name هو معرف وحدة التخزين.
    • استخدم EmptyDir ك storageType.
  • لكل حاوية في القالب الذي تريد تحميل وحدة التخزين، حدد تحميل وحدة تخزين في volumeMounts صفيف تعريف الحاوية.
    • volumeName هو الاسم المحدد في volumes الصفيف.
    • mountPath هو المسار في الحاوية لتحميل وحدة التخزين.

مثال على مقتطف قالب ARM:

{
  "apiVersion": "2022-03-01",
  "type": "Microsoft.App/containerApps",
  "name": "[parameters('containerappName')]",
  "location": "[parameters('location')]",
  "properties": {

    ...

    "template": {
      "revisionSuffix": "myrevision",
      "containers": [
        {
          "name": "main",
          "image": "[parameters('container_image')]",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "volumeMounts": [
            {
              "mountPath": "/myempty",
              "volumeName": "myempty"
            }
          ]
        },
        {
          "name": "sidecar",
          "image": "[parameters('sidecar_image')]",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "volumeMounts": [
            {
              "mountPath": "/myempty",
              "volumeName": "myempty"
            }
          ]
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 3
      },
      "volumes": [
        {
          "name": "myempty",
          "storageType": "EmptyDir"
        }
      ]
    }
  }
}

راجع مواصفات واجهة برمجة تطبيقات قالب ARM للحصول على مثال كامل.

لإنشاء وحدة تخزين ذات نطاق نسخة متماثلة وتركيبها في حاوية، انشر مراجعة جديدة لتطبيق الحاوية باستخدام مدخل Microsoft Azure.

  1. في مدخل Microsoft Azure، انتقل إلى تطبيق الحاوية.

  2. حدد إدارة المراجعة في القائمة اليمنى.

  3. حدد إنشاء مراجعة جديدة.

  4. حدد الحاوية حيث تريد تحميل وحدة التخزين.

  5. في جزء تحرير سياق حاوية ، حدد علامة التبويب تحميلات وحدة التخزين.

  6. ضمن قسم التخزين المؤقت، أنشئ وحدة تخزين جديدة بالمعلومات التالية.

    • اسم وحدة التخزين: اسم وحدة التخزين المؤقتة.
    • مسار التحميل: المسار المطلق في الحاوية لتحميل وحدة التخزين.

  7. حدد حفظ لحفظ التغييرات والخروج من جزء السياق.

  8. حدد Create لإنشاء المراجعة الجديدة.

وحدة تخزين ملفات Azure

يمكنك تحميل مشاركة ملف من Azure Files كمستوى تخزين في حاوية.

يحتوي تخزين ملفات Azure على الخصائص التالية:

  • يتم الاحتفاظ بالملفات المكتوبة ضمن موقع التحميل إلى مشاركة الملف.
  • تتوفر الملفات الموجودة في المشاركة عبر موقع التحميل.
  • يمكن للحاويات المتعددة تحميل نفس مشاركة الملف، بما في ذلك تلك الموجودة في نسخة متماثلة أخرى أو مراجعة أو تطبيق حاوية.
  • يمكن لجميع الحاويات التي تقوم بتحميل المشاركة الوصول إلى الملفات المكتوبة بواسطة أي حاوية أو أسلوب آخر.
  • يمكن تحميل أكثر من وحدة تخزين Azure Files واحدة في حاوية واحدة.

تدعم Azure Files بروتوكولات SMB (Server Message Block) وNFS (نظام ملفات الشبكة). يمكنك تحميل مشاركة ملفات Azure باستخدام أي من البروتوكولين. يجب تكوين مشاركة الملف التي تحددها في البيئة بنفس البروتوكول المستخدم بواسطة مشاركة الملف في حساب التخزين.

لتمكين تخزين ملفات Azure في الحاوية الخاصة بك، تحتاج إلى إعداد البيئة تطبيق الحاوية كما يلي:

  • إنشاء تعريف تخزين في بيئة تطبيقات الحاوية.
  • إذا كنت تستخدم NFS، يجب تكوين بيئتك باستخدام VNet مخصص ويجب تكوين حساب التخزين للسماح بالوصول من VNet. لمزيد من المعلومات، راجع مشاركات ملفات NFS في ملفات Azure .
  • إذا تم تكوين بيئتك باستخدام شبكة ظاهرية مخصصة، يجب السماح بالمنافذ 445 و2049 في مجموعة أمان الشبكة (NSG) المقترنة بالشبكة الفرعية.
  • تعريف وحدة تخزين من نوع AzureFile (SMB) أو NfsAzureFile (NFS) في مراجعة.
  • حدد تحميل وحدة تخزين في حاوية واحدة أو أكثر في المراجعة.
  • يجب أن يكون حساب تخزين Azure Files المستخدم متاحا من الشبكة الظاهرية لتطبيق الحاوية. لمزيد من التفاصيل، راجع إنشاء شبكة اتصال ظاهرية.

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

المتطلبات الإرشادات
حساب Azure إذا لم يكن لديك حساب، فبادر بإنشاء حساب مجانا.
حساب Azure Storage قم بإنشاء حساب تخزين.
بيئة Azure Container Apps إنشاء بيئة تطبيقات الحاوية.

التكوين

عند تكوين تطبيق حاوية لتحميل وحدة تخزين Azure Files باستخدام Azure CLI، يجب استخدام تعريف YAML لإنشاء تطبيق الحاوية أو تحديثه.

للحصول على برنامج تعليمي خطوة بخطوة حول تحميل مشاركة ملف SMB، راجع إنشاء تحميل تخزين ملفات Azure في Azure Container Apps.

  1. أضف تعريف تخزين إلى بيئة Container Apps.

    az containerapp env storage set --name my-env --resource-group my-group \
    --storage-name mystorage \
    --storage-type AzureFile \
    --azure-file-account-name <STORAGE_ACCOUNT_NAME> \
    --azure-file-account-key <STORAGE_ACCOUNT_KEY> \
    --azure-file-share-name <STORAGE_SHARE_NAME> \
    --access-mode ReadWrite

    استبدل <STORAGE_ACCOUNT_NAME> و <STORAGE_ACCOUNT_KEY> باسم ومفتاح حساب التخزين الخاص بك. استبدل <STORAGE_SHARE_NAME> باسم مشاركة الملف في حساب التخزين.

    القيم الصالحة ل --access-mode هي ReadWrite و ReadOnly.

  2. لتحديث تطبيق حاوية موجود لتحميل مشاركة ملف، قم بتصدير مواصفات التطبيق إلى ملف YAML يسمى app.yaml.

    az containerapp show -n <APP_NAME> -g <RESOURCE_GROUP_NAME> -o yaml > app.yaml

  3. قم بإجراء التغييرات التالية على مواصفات تطبيق الحاوية.

    • أضف صفيفا volumes إلى template قسم تعريف تطبيق الحاوية الخاص بك وحدد وحدة تخزين. إذا كان لديك volumes صفيف بالفعل، أضف وحدة تخزين جديدة إلى الصفيف.
      • name هو معرف وحدة التخزين.
      • بالنسبة إلى storageType، استخدم AzureFile ل SMB أو NfsAzureFile ل NFS. يجب أن تتطابق هذه القيمة مع نوع التخزين الذي قمت بتعريفه في البيئة.
      • بالنسبة إلى storageName، استخدم اسم التخزين الذي قمت بتعريفه في البيئة.
      • mountOptions هو سلسلة مفصولة بفواصل من خيارات التحميل. لمزيد من المعلومات، راجع استخدام إعدادات mountOptions في Azure Files.
      • secrets القائمة هي قائمة من الأسرار لتحميلها في وحدة التخزين. لمزيد من المعلومات، راجع إدخال البيانات السرية في وحدة تخزين.
    • لكل حاوية في القالب الذي تريد تحميل تخزين ملفات Azure، حدد تحميل وحدة تخزين في volumeMounts صفيف تعريف الحاوية.
      • volumeName هو الاسم المحدد في volumes الصفيف.
      • mountPath هو المسار في الحاوية لتحميل وحدة التخزين.
      • subPath هو المسار في وحدة التخزين لتحميل. إذا لم يتم تحديده، يتم تحميل جذر وحدة التخزين. لمزيد من المعلومات، راجع (مسار #sub).
    properties:
  managedEnvironmentId: /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP_NAME>/providers/Microsoft.App/managedEnvironments/<ENVIRONMENT_NAME>
  configuration:
  template:
    containers:
    - image: <IMAGE_NAME>
      name: my-container
      volumeMounts:
      - volumeName: azure-files-volume
        mountPath: /my-files
        subPath: my-sub-path
    volumes:
    - name: azure-files-volume
      storageType: AzureFile
      storageName: mystorage

  4. تحديث تطبيق الحاوية باستخدام ملف YAML.

    az containerapp update --name <APP_NAME> --resource-group <RESOURCE_GROUP_NAME> \
    --yaml app.yaml

راجع مواصفات YAML للحصول على مثال كامل.

توضح قصاصات قالب ARM التالية كيفية إضافة مشاركة Azure Files إلى بيئة Container Apps واستخدامها في تطبيق حاوية.

  1. storages إضافة مورد تابع إلى بيئة Container Apps.

    {
  "type": "Microsoft.App/managedEnvironments",
  "apiVersion": "2022-03-01",
  "name": "[parameters('environment_name')]",
  "location": "[parameters('location')]",
  "properties": {
    "daprAIInstrumentationKey": "[parameters('dapr_ai_instrumentation_key')]",
    "appLogsConfiguration": {
      "destination": "log-analytics",
      "logAnalyticsConfiguration": {
        "customerId": "[parameters('log_analytics_customer_id')]",
        "sharedKey": "[parameters('log_analytics_shared_key')]"
      }
    }
  },
  "resources": [
    {
      "type": "storages",
      "name": "myazurefiles",
      "apiVersion": "2022-03-01",
      "dependsOn": [
        "[resourceId('Microsoft.App/managedEnvironments', parameters('environment_name'))]"
      ],
      "properties": {
        "azureFile": {
          "accountName": "[parameters('storage_account_name')]",
          "accountKey": "[parameters('storage_account_key')]",
          "shareName": "[parameters('storage_share_name')]",
          "accessMode": "ReadWrite"
        }
      }
    }
  ]
}

  2. تحديث مورد تطبيق الحاوية لإضافة وحدة تخزين وتركيب وحدة تخزين.

    {
  "apiVersion": "2023-05-01",
  "type": "Microsoft.App/containerApps",
  "name": "[parameters('containerappName')]",
  "location": "[parameters('location')]",
  "properties": {

    ...

    "template": {
      "revisionSuffix": "myrevision",
      "containers": [
        {
          "name": "main",
          "image": "[parameters('container_image')]",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "volumeMounts": [
            {
              "mountPath": "/myfiles",
              "volumeName": "azure-files-volume",
              "subPath": "my-sub-path"
            }
          ]
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 3
      },
      "volumes": [
        {
          "name": "azure-files-volume",
          "storageType": "AzureFile",
          "storageName": "myazurefiles"
        }
      ]
    }
  }
}
    • أضف صفيفا volumes إلى template قسم تعريف تطبيق الحاوية الخاص بك وحدد وحدة تخزين. إذا كان لديك volumes صفيف بالفعل، أضف وحدة تخزين جديدة إلى الصفيف.
      • name هو معرف وحدة التخزين.
      • بالنسبة إلى storageType، استخدم AzureFile ل SMB أو NfsAzureFile ل NFS. يجب أن تتطابق هذه القيمة مع نوع التخزين الذي قمت بتعريفه في البيئة.
      • بالنسبة إلى storageName، استخدم اسم التخزين الذي قمت بتعريفه في البيئة.
      • mountOptions هو سلسلة مفصولة بفواصل من خيارات التحميل. لمزيد من المعلومات، راجع استخدام إعدادات mountOptions في Azure Files.
      • secrets القائمة هي قائمة من الأسرار لتحميلها في وحدة التخزين. لمزيد من المعلومات، راجع إدخال البيانات السرية في وحدة تخزين.
    • لكل حاوية في القالب الذي تريد تحميل تخزين ملفات Azure، حدد تحميل وحدة تخزين في volumeMounts صفيف تعريف الحاوية.
      • volumeName هو الاسم المحدد في volumes الصفيف.
      • mountPath هو المسار في الحاوية لتحميل وحدة التخزين.
      • ( subPath اختياري) هو المسار في وحدة التخزين لتحميل. إذا لم يتم تحديده، يتم تحميل جذر وحدة التخزين. لمزيد من المعلومات، راجع (مسار #sub).

راجع مواصفات واجهة برمجة تطبيقات قالب ARM للحصول على مثال كامل.

لتكوين تحميل وحدة تخزين لتخزين ملفات Azure في مدخل Microsoft Azure، أضف مشاركة ملف إلى بيئة Container Apps ثم أضف تحميل وحدة تخزين إلى تطبيق الحاوية الخاص بك عن طريق إنشاء مراجعة جديدة.

  1. في مدخل Microsoft Azure، انتقل إلى بيئة Container Apps.

  2. في جزء التنقل، ضمن Settings، حدد Azure Files.

  3. حدد إضافة.

  4. حدد Server Message Block (SMB) أو Network File System (NFS)، اعتمادا على البروتوكول المستخدم من قبل مشاركة الملف.

  5. في جزء إضافة سياق مشاركة ملف، أدخل المعلومات التالية:

    • الاسم: اسم لمشاركة الملف.
    • اسم حساب التخزين: اسم حساب التخزين الذي يحتوي على مشاركة الملف.
    • مفتاح حساب التخزين: مفتاح الوصول لحساب التخزين.
    • مشاركة الملف: اسم مشاركة الملف.
    • وضع الوصول: وضع الوصول لمشاركة الملف. القيم الصالحة هي القراءة/الكتابة والقراءة فقط.

  6. حدد إضافة للخروج من جزء السياق.

  7. حدد حفظ لتثبيت التغييرات.

  8. انتقل إلى تطبيق الحاوية.

  9. في جزء التنقل، ضمن Application، حدد Revisions and replicas.

  10. حدد إنشاء مراجعة جديدة.

  11. في صفحة إنشاء ونشر مراجعة جديدة، حدد علامة التبويب وحدات التخزين .

  12. حدد إضافة.

  13. في جزء إضافة سياق وحدة تخزين ، قم بتعيين ما يلي.

    • نوع وحدة التخزين: وحدة تخزين ملف Azure.
    • الاسم: أدخل اسم وحدة تخزين.
    • اسم مشاركة الملف: حدد مشاركة الملف التي قمت بإنشائها مسبقا.
    • خيارات التحميل: اختياريا، أدخل سلسلة مفصولة بفواصل من خيارات التحميل. لمزيد من المعلومات، راجع استخدام إعدادات mountOptions في Azure Files.

  14. حدد إضافة للخروج من جزء السياق.

  15. في صفحة Create and reploy new revision ، حدد علامة التبويب Container .

  16. حدد الحاوية التي تريد تحميل وحدة التخزين فيها.

  17. في جزء تحرير سياق حاوية ، حدد علامة التبويب تحميلات وحدة التخزين.

  18. ضمن اسم وحدة التخزين، حدد وحدة التخزين التي قمت بإنشائها مسبقا.

  19. في مسار التحميل، أدخل المسار المطلق في الحاوية لتحميل وحدة التخزين.

  20. في المسار الفرعي (اختياري) ، أدخل المسار في وحدة التخزين المراد تحميلها. إذا لم يتم تحديده، يتم تحميل جذر وحدة التخزين. لمزيد من المعلومات، راجع (مسار #sub).

  21. حدد حفظ لحفظ التغييرات والخروج من جزء السياق.

  22. حدد Create لإنشاء المراجعة الجديدة.

المسار الفرعي

عند تحميل مشاركة ملف من Azure Files، بالإضافة إلى مسار التحميل، يمكنك أيضا تحديد مسار فرعي.

  • مسار التحميل: المسار في الحاوية حيث تريد تحميل وحدة التخزين.
  • المسار الفرعي: المسار في وحدة التخزين التي تريد تحميلها.

المسار الفرعي اختياري. إذا لم يتم تحديده، يتم تحميل جذر وحدة التخزين.

المسار الفرعي هو مسار نسبي من جذر وحدة التخزين. يجب ألا يبدأ المسار الفرعي ب /. قد يؤدي تحديد مسار فرعي يبدأ ب / إلى منع بدء تشغيل تطبيق الحاوية. على سبيل المثال، my-volume-folder هو مسار فرعي صالح، حيث /my-volume-folder لا يكون.

يمكن أن يشير المسار الفرعي إما إلى مجلد أو ملف في وحدة التخزين.

  • إذا كان المسار الفرعي يشير إلى مجلد، يجب أن يشير مسار التحميل إلى مجلد فارغ في الحاوية.

  • إذا كان المسار الفرعي يشير إلى ملف، يجب أن يشير مسار التحميل إلى ملف غير موجود بالفعل في الحاوية.

    على سبيل المثال، افترض أن المسار الفرعي هو my-volume-folder/my-volume-file.txt، ومسار التحميل هو /my-container-folder/my-container-file. يجب أن يكون المجلد /my-container-folder موجودا بالفعل في الحاوية ولكن يجب ألا يحتوي بعد على الملف my-container-file.txt.

يتم تجاهل أي شرطة مائلة لاحقة للمسار الفرعي.

المحتوى ذو الصلة

  • Last updated on