البرنامج التعليمي: إنشاء تطبيقك ونشره في Azure Container Apps

az login

Connect-AzAccount

az upgrade

Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

تجاهل أي تحذيرات حول الوحدات النمطية المستخدمة حاليا.

az extension add --name containerapp --upgrade

az extension add --name containerapp --upgrade --allow-preview true

Install-Module -Name Az.App

تأكد من تحديث الوحدة النمطية Az.App إلى أحدث إصدار.

Update-Module -Name Az.App

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

حدد المتغيرات التالية في bash shell.

RESOURCE_GROUP="album-containerapps"
LOCATION="canadacentral"
ENVIRONMENT="env-album-containerapps"
API_NAME="album-api"
FRONTEND_NAME="album-ui"
GITHUB_USERNAME="<YOUR_GITHUB_USERNAME>"

قبل تشغيل هذا الأمر، تأكد من استبدال <YOUR_GITHUB_USERNAME> باسم مستخدم GitHub الخاص بك.

بعد ذلك، حدد اسم سجل حاوية فريدا لك.

ACR_NAME="acaalbums"$GITHUB_USERNAME

حدد المتغيرات التالية في وحدة تحكم PowerShell.

$ResourceGroup = "album-containerapps"
$Location = "canadacentral"
$Environment = "env-album-containerapps"
$APIName="album-api"
$FrontendName="album-ui"
$GITHUB_USERNAME = "<YOUR_GITHUB_USERNAME>"

قبل تشغيل هذا الأمر، تأكد من استبدال <YOUR_GITHUB_USERNAME> باسم مستخدم GitHub الخاص بك.

بعد ذلك، حدد اسم سجل حاوية فريدا لك.

$ACRName = "acaalbums"+$GITHUB_USERNAME

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

الآن يمكنك استنساخ نسخة المستودع الخاص بك من مستودع العينة.

استخدم الأمر git التالي لاستنساخ المستودع المتشعب في مجلد التعليمات البرمجية إلى السحابة :

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-csharp.git code-to-cloud

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

الآن يمكنك استنساخ نسخة المستودع الخاص بك من مستودع العينة.

استخدم الأمر git التالي لاستنساخ المستودع المتشعب في مجلد التعليمات البرمجية إلى السحابة :

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-go.git code-to-cloud

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

الآن يمكنك استنساخ نسخة المستودع الخاص بك من مستودع العينة.

استخدم الأمر git التالي لاستنساخ المستودع المتشعب في مجلد التعليمات البرمجية إلى السحابة :

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-java.git code-to-cloud

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

الآن يمكنك استنساخ نسخة المستودع الخاص بك من مستودع العينة.

استخدم الأمر git التالي لاستنساخ المستودع المتشعب في مجلد التعليمات البرمجية إلى السحابة :

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-javascript.git code-to-cloud

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

الآن يمكنك استنساخ نسخة المستودع الخاص بك من مستودع العينة.

استخدم الأمر git التالي لاستنساخ المستودع المتشعب في مجلد التعليمات البرمجية إلى السحابة :

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-python.git code-to-cloud

az group create \
  --name $RESOURCE_GROUP \
  --location "$LOCATION"

New-AzResourceGroup -Location $Location -Name $ResourceGroupName

1. إنشاء هوية مُدارة يُعينها المستخدم. قبل تشغيل الأوامر التالية، اختر اسما لهويتك المدارة واستبدل \<PLACEHOLDER\> بالاسم .

   IDENTITY="<YOUR_IDENTITY_NAME>"
   

   az identity create \
       --name $IDENTITY \
       --resource-group $RESOURCE_GROUP
   

2. احصل على معرف مورد الهوية.

   IDENTITY_ID=$(az identity show \
       --name $IDENTITY \
       --resource-group $RESOURCE_GROUP \
       --query id \
       --output tsv)
   

1. إنشاء هوية مُدارة يُعينها المستخدم. قبل تشغيل الأوامر التالية، اختر اسما لهويتك المدارة واستبدل \<PLACEHOLDER\> بالاسم .

   $IdentityName="<YOUR_IDENTITY_NAME>"
   $Identity = New-AzUserAssignedIdentity -ResourceGroupName $ResourceGroup -Name $IdentityName
   

2. احصل على مورد الهوية ومعرفها الأساسي.

   $IdentityId = $Identity.Id
   $PrincipalId = (Get-AzUserAssignedIdentity -Name $IdentityName -ResourceGroupName $ResourceGroup).PrincipalId
   

3. احصل على معرف مورد السجل. قبل تشغيل الأمر التالي، استبدل <العناصر> النائبة باسم مجموعة الموارد للسجل الخاص بك.

   $RegistryId = (Get-AzContainerRegistry -ResourceGroupName $ResourceGroup -Name $ACRName).Id
   

4. acrpull إنشاء تعيين الدور للهوية.

   New-AzRoleAssignment -ObjectId $PrincipalId -Scope $RegistryId -RoleDefinitionName acrpull
   

az containerapp env create \
  --name $ENVIRONMENT \
  --resource-group $RESOURCE_GROUP \
  --location "$LOCATION"

مساحة عمل Log Analytics مطلوبة لبيئة Container Apps. تنشئ الأوامر التالية مساحة عمل Log Analytics وتحفظ معرف مساحة العمل والمفتاح المشترك الأساسي إلى المتغيرات.

$WorkspaceArgs = @{
    Name = 'my-album-workspace'
    ResourceGroupName = $ResourceGroup
    Location = $Location
    PublicNetworkAccessForIngestion = 'Enabled'
    PublicNetworkAccessForQuery = 'Enabled'
}
New-AzOperationalInsightsWorkspace @WorkspaceArgs
$WorkspaceId = (Get-AzOperationalInsightsWorkspace -ResourceGroupName $ResourceGroup -Name $WorkspaceArgs.Name).CustomerId
$WorkspaceSharedKey = (Get-AzOperationalInsightsWorkspaceSharedKey -ResourceGroupName $ResourceGroup -Name $WorkspaceArgs.Name).PrimarySharedKey

لإنشاء البيئة، قم بتشغيل الأمر التالي:

$EnvArgs = @{
    EnvName = $Environment
    ResourceGroupName = $ResourceGroup
    Location = $Location
    AppLogConfigurationDestination = 'log-analytics'
    LogAnalyticConfigurationCustomerId = $WorkspaceId
    LogAnalyticConfigurationSharedKey = $WorkspaceSharedKey
}

New-AzContainerAppManagedEnv @EnvArgs

az containerapp create \
  --name $API_NAME \
  --resource-group $RESOURCE_GROUP \
  --environment $ENVIRONMENT \
  --image $ACR_NAME.azurecr.io/$API_NAME \
  --target-port 8080 \
  --ingress external \
  --registry-server $ACR_NAME.azurecr.io \
  --user-assigned "$IDENTITY_ID" \
  --registry-identity "$IDENTITY_ID" \
  --query properties.configuration.ingress.fqdn

• من خلال الإعداد --ingress إلى external، يمكن الوصول إلى تطبيق الحاوية الخاص بك من الإنترنت العام.

• target-port تم تعيين إلى 8080 لمطابقة المنفذ الذي تستمع إليه الحاوية للطلبات.

• بدون خاصية query ، يقوم الاستدعاء بإرجاع az containerapp create استجابة JSON التي تتضمن مجموعة غنية من التفاصيل حول التطبيق. تؤدي إضافة معلمة استعلام إلى تصفية الإخراج إلى اسم المجال المؤهل بالكامل للتطبيق فقط (FQDN).

• يضيف acrPull هذا الأمر الدور إلى الهوية المدارة المعينة من قبل المستخدم، حتى يتمكن من سحب الصور من سجل الحاوية.

لإنشاء تطبيق الحاوية، قم بإنشاء كائنات القالب التي تمررها كوسيطات إلى New-AzContainerApp الأمر .

1. إنشاء كائن قالب لتعريف معلمات صورة الحاوية.

   $ImageParams = @{
       Name = $APIName
       Image = $ACRName + '.azurecr.io/' + $APIName + ':latest'
   }
   $TemplateObj = New-AzContainerAppTemplateObject @ImageParams
   

2. إنشاء كائن بيانات اعتماد السجل لتعريف معلومات السجل.

   $RegistryArgs = @{
       Server = $ACRName + '.azurecr.io'
       Identity = $IdentityId
   }
   $RegistryObj = New-AzContainerAppRegistryCredentialObject @RegistryArgs
   

3. احصل على معرف البيئة الخاص بك.

   $EnvId = (Get-AzContainerAppManagedEnv -EnvName $Environment -ResourceGroup $ResourceGroup).Id
   

4. إنشاء تطبيق الحاوية.

   $AppConfig = @{
       IngressTargetPort = 8080
       IngressExternal = $true
       Registry = $RegistryObj
   }
   $AppConfigObj = New-AzContainerAppConfigurationObject @AppConfig
   
   $AppArgs = @{
       Name = $APIName
       Location = $Location
       ResourceGroupName = $ResourceGroup
       ManagedEnvironmentId = $EnvId
       TemplateContainer = $TemplateObj
       Configuration = $AppConfigObj
       UserAssignedIdentity = @($IdentityId)
   }
   $MyApp = New-AzContainerApp @AppArgs
   
   # Show the app's fully qualified domain name (FQDN).
   $MyApp.LatestRevisionFqdn
   

   • من خلال الإعداد IngressExternal إلى $true، يمكن الوصول إلى تطبيق الحاوية الخاص بك من الإنترنت العام.
   • IngressTargetPort تم تعيين المعلمة إلى 8080 لمطابقة المنفذ الذي تستمع إليه الحاوية للطلبات.

az group delete --name $RESOURCE_GROUP

Remove-AzResourceGroup -Name $ResourceGroup -Force