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

عند تكوين التخزين على نطاق النسخة المتماثلة باستخدام 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 Files باستخدام Azure CLI، يجب استخدام تعريف YAML لإنشاء تطبيق الحاوية أو تحديثه.

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

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

   • SMB
   • NFS

   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، استخدم اسم التخزين الذي قمت بتعريفه في البيئة.
   • لكل حاوية في القالب الذي تريد تحميل تخزين ملفات Azure، حدد تحميل وحدة تخزين في volumeMounts صفيف تعريف الحاوية.
     • volumeName هو الاسم المحدد في volumes الصفيف.
     • mountPath هو المسار في الحاوية لتحميل وحدة التخزين.
   • SMB
   • NFS

   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
       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.

   • SMB
   • NFS

   {
     "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. تحديث مورد تطبيق الحاوية لإضافة وحدة تخزين وتركيب وحدة تخزين.

   • SMB
   • NFS

   {
     "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"
               }
             ]
           }
         ],
         "scale": {
           "minReplicas": 1,
           "maxReplicas": 3
         },
         "volumes": [
           {
             "name": "azure-files-volume",
             "storageType": "AzureFile",
             "storageName": "myazurefiles"
           }
         ]
       }
     }
   }
   

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

راجع مواصفات واجهة برمجة تطبيقات قالب 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. في جزء إضافة سياق مشاركة ملف، أدخل المعلومات التالية:

   • SMB
   • NFS

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

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

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

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

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

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

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

12. حدد إضافة.

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

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

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

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

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

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

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

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

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

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