مشاركة عبر

إعداد إجراءات GitHub باستخدام Azure CLI في Azure Container Apps

  • مقالة

تسمح لك Azure Container Apps باستخدام GitHub Actions لنشر المراجعات إلى تطبيق الحاوية. عند دفع التثبيتات إلى مستودع GitHub الخاص بك، يتم تشغيل سير عمل GitHub Actions الذي يحدث صورة الحاوية في سجل الحاوية. بمجرد تحديث الحاوية في السجل، تقوم Azure Container Apps بإنشاء مراجعة جديدة استنادًا إلى صورة الحاوية المحدثة.

تؤدي التغييرات في مستودع GitHub إلى إجراء لإنشاء مراجعة جديدة.

يتم تشغيل سير عمل GitHub Actions عند وجود تثبيتات لفرع معين في المستودع الخاص بك. يمكنك اختيار الفرع الذي يقوم بتشغيل الإجراء عند إعداد سير العمل.

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

المصادقة

عند إضافة تكامل GitHub Actions أو إزالته، يمكنك المصادقة إما عن طريق تمرير رمز وصول شخصي GitHub، أو باستخدام تجربة تسجيل الدخول التفاعلية GitHub. تفتح التجربة التفاعلية نموذجًا في متصفح الويب الخاص بك وتمنحك الفرصة لتسجيل الدخول إلى GitHub. بمجرد المصادقة بنجاح، يتم تمرير رمز مميز مرة أخرى إلى CLI الذي يستخدمه GitHub لبقية جلسة العمل الحالية.

  • لتمرير رمز وصول شخصي، استخدم المعلمة --token وقدم قيمة رمز مميز.
  • إذا اخترت استخدام تسجيل الدخول التفاعلي، فاستخدم المعلمة --login-with-github بدون قيمة.

إشعار

يجب أن يكون workflow رمز الوصول الشخصي GitHub الخاص بك محددا النطاق.

إضافة

ينشئ الأمر containerapp github-action add تكامل إجراءات GitHub مع تطبيق الحاوية.

إشعار

قبل المتابعة مع المثال المحدد، يجب أن يكون تطبيق الحاوية الأول قد تم نشره بالفعل.

في المرة الأولى التي تقوم فيها بإرفاق GitHub Actions بتطبيق الحاوية، تحتاج إلى توفير سياق كيان الخدمة. يوضح لك الأمر التالي كيفية إنشاء كيان خدمة.

az ad sp create-for-rbac \
  --name <SERVICE_PRINCIPAL_NAME> \
  --role "contributor" \
  --scopes /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP_NAME>

أثناء التفاعل مع هذا المثال، أدخل قيمك بدلاً من العناصر النائبة المحاطة <>.

تتضمن القيم المرجعة appIdpasswordtenantمن هذا الأمر و. تحتاج إلى تمرير هذه القيم إلى az containerapp github-action add الأمر .

يوضح لك المثال التالي كيفية إضافة تكامل في أثناء استخدام رمز وصول شخصي.

az containerapp github-action add \
  --repo-url "https://github.com/<OWNER>/<REPOSITORY_NAME>" \
  --context-path "./dockerfile" \
  --branch <BRANCH_NAME> \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --registry-url <URL_TO_CONTAINER_REGISTRY> \
  --registry-username <REGISTRY_USER_NAME> \
  --registry-password <REGISTRY_PASSWORD> \
  --service-principal-client-id <appId> \
  --service-principal-client-secret <password> \
  --service-principal-tenant-id <tenant> \
  --token <YOUR_GITHUB_PERSONAL_ACCESS_TOKEN>

أثناء التفاعل مع هذا المثال، أدخل قيمك بدلاً من العناصر النائبة المحاطة <>.

‏‏إظهار

يقوم الأمر containerapp github-action show بإرجاع إعدادات تكوين إجراءات GitHub لتطبيق حاوية.

يوضح هذا المثال كيفية إضافة تكامل في أثناء استخدام الرمز المميز للوصول الشخصي.

az containerapp github-action show \
  --resource-group <RESOURCE_GROUP_NAME> \
  --name <CONTAINER_APP_NAME>

أثناء التفاعل مع هذا المثال، أدخل قيمك بدلاً من العناصر النائبة المحاطة <>.

يقوم هذا الأمر بإرجاع حمولة JSON مع إعدادات تكوين تكامل إجراءات GitHub.

حذف

يقوم الأمر containerapp github-action delete بإزالة إجراءات GitHub من تطبيق الحاوية.

az containerapp github-action delete \
  --resource-group <RESOURCE_GROUP_NAME> \
  --name <CONTAINER_APP_NAME> \
  --token <YOUR_GITHUB_PERSONAL_ACCESS_TOKEN>

أثناء التفاعل مع هذا المثال، أدخل قيمك بدلاً من العناصر النائبة المحاطة <>.