ممارسة - إعداد البيئة الخاصة بك

مكتمل

هام

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

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

لتحقيق هذه الأهداف، عليك القيام بما يلي:

  • إعداد مشروع Azure DevOps لهذه الوحدة النمطية.
  • نسخ مستودع المشروع إلى جهاز الكمبيوتر الخاص بك.
  • إنشاء مجموعة موارد في Azure.
  • إنشاء اتصال خدمة في Azure Pipelines.

الحصول على مشروع Azure DevOps

في هذا القسم، تأكد من إعداد مؤسسة Azure DevOps لإكمال بقية هذه الوحدة النمطية. يمكنك إعداده عن طريق تشغيل قالب يقوم بإنشاء مشروع في Azure DevOps.

الوحدات النمطية في مسار التعلم هذا هي جزء من التقدم. لأغراض التعلم، تحتوي كل وحدة نمطية على مشروع Azure DevOps مقترن.

تلميح

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

تشغيل القالب

قم بتشغيل قالب يقوم بإعداد مشروع Azure DevOps الخاص بك.

على موقع منشئ العرض التوضيحي Azure DevOps:

  1. حدد Sign In، ثم وافق على شروط استخدام الموقع بتحديد Accept.

  2. في صفحة Create New Project، حدد مؤسسة Azure DevOps خاصتك، ثم في مربع New Project Nam، أدخل اسم مشروع، مثل toy-reusable.

    لقطة شاشة للجزء Azure DevOps Demo Generator لإنشاء مشروع جديد.

  3. حدد إنشاء مشروع.

    يستغرق تشغيل القالب بضع لحظات. يقوم تلقائياً بإنشاء ملف مسار وBicep لتعمل معه في التدريبات القليلة التالية.

  4. حدد الانتقال إلى المشروع للانتقال إلى مشروعك في Azure DevOps.

هام

يحتوي التمرين الأخير في هذه الوحدة على خطوات تنظيف مهمة. تأكد من اتباع خطوات التنظيف حتى إذا لم تكمل هذه الوحدة النمطية.

نسخ المستودع

  1. حدد Repos>الملفات.

    لقطة شاشة لـ Azure DevOps تعرض قائمة

  2. حدد Clone.

    لقطة شاشة لـ Azure DevOps تعرض المستودع، مع تمييز الزر

  3. حدد إنشاء بيانات اعتماد Git. انسخ كلمة المرور واحفظها. ستحتاج إلى بيانات الاعتماد هذه عند المصادقة على المستودع الخاص بك عندما تقوم لاحقا بتثبيت التحديثات على ملفاتك YAML .

    لقطة شاشة ل Azure DevOps تعرض إعدادات المستودع، مع تمييز الزر Generate Git Credentials.

  4. حدد النسخ في VS Code. إذا تمت مطالبتك بالسماح بفتح Visual Studio Code، فحدد فتح.

    لقطة شاشة لخدمة Azure DevOps تظهر إعدادات المستودع، مع تمييز الزر «Clone in VS Code».

  5. قم بإنشاء مجلد لاستخدامه للمستودع، ثم حدد Select Repository Location.

  6. أنت تستخدم هذا المستودع لأول مرة، لذلك قد يُطلب منك تسجيل الدخول.

    • إذا كنت تستخدم Windows، أدخل بيانات الاعتماد نفسها التي استخدمتها لتسجيل الدخول إلى Azure DevOps في وقت سابق من هذا التمرين.

    • إذا كنت تستخدم macOS، فأدخل اسم مستخدم وكلمة مرور Git اللذين أنشأتهما منذ لحظات قليلة.

  7. يطالبك Visual Studio Code بفتح المستودع. حدد فتح.

    لقطة شاشة لـ Visual Studio Code تعرض مطالبة بفتح المستودع المنسوخ، مع تمييز الزر

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

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

  1. في القائمة المحطة الطرفية، حدد محطة طرفية جديدة. عادة ما تفتح نافذة المحطة الطرفية في النصف السفلي من الشاشة.

    عادة ما تكون shell الافتراضية pwsh، كما هو موضح على الجانب الأيمن من نافذة المحطة الطرفية.

    لقطة شاشة لنافذة محطة Visual Studio Code الطرفية، حيث يتم عرض pwsh كخيار shell.

  2. حدد القائمة المنسدلة Launch Profile، ثم حدد Azure Cloud Shell (Bash).

    لقطة شاشة لنافذة المحطة الطرفية ل Visual Studio Code. يتم عرض القائمة المنسدلة terminal shell وعنصر قائمة Azure Cloud Shell (Bash).

    يفتح shell جديد.

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

  1. من الوحدة الطرفية «Visual Studio Code»، شغّل الأمر التالي لتسجيل الدخول إلى Azure:

    az login
    
  2. في المتصفح الذي يفتح، سجل الدخول إلى حسابك في Azure.

للعمل مع مجموعات الموارد في Azure، قم بتسجيل الدخول إلى حسابك في Azure من المحطة الطرفية لتعليمة Visual Studio البرمجية. تأكد من تثبيت Azure PowerShell بالفعل.

  1. في القائمة المحطة الطرفية، حدد محطة طرفية جديدة. عادة ما تفتح نافذة المحطة الطرفية في النصف السفلي من الشاشة.

    عادة ما تكون shell الافتراضية pwsh، كما هو موضح على الجانب الأيمن من نافذة المحطة الطرفية.

    لقطة شاشة لنافذة محطة Visual Studio Code الطرفية، حيث يتم عرض pwsh كخيار shell.

  2. حدد القائمة المنسدلة Launch Profile، ثم حدد Azure Cloud Shell (PowerShell).

    لقطة شاشة لنافذة المحطة الطرفية ل Visual Studio Code. يتم عرض القائمة المنسدلة terminal shell وعنصر القائمة Azure Cloud Shell (PowerShell).

    يفتح shell جديد.

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

  1. من الوحدة الطرفية «Visual Studio Code»، شغّل الأمر التالي لتسجيل الدخول إلى Azure:

    Connect-AzAccount
    
  2. في المتصفح الذي يفتح، سجل الدخول إلى حسابك في Azure.

إنشاء مجموعة الموارد في Azure

لإنشاء مجموعة موارد جديدة، شغّل أمر «Azure CLI» في الوحدة الطرفية «Visual Studio Code»:

az group create --name ToyReusable --location westus3

لإنشاء مجموعة موارد، شغّل أمر «Azure PowerShell» هذا في الوحدة الطرفية «Visual Studio Code»:

New-AzResourceGroup -Name ToyReusable -Location westus3

إنشاء اتصال خدمة في Azure Pipelines

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

  1. في المستعرض، حدد Project settings.

    لقطة شاشة ل Azure DevOps تعرض القائمة، مع تمييز عنصر إعدادات المشروع.

  2. حدد Service connections>Create service connection.

    لقطة شاشة لـ Azure DevOps تعرض جزء

  3. حدد Azure Resource Manager > التالي.

    لقطة شاشة لـ Azure DevOps تعرض جزء 'Service connections'، مع تمييز نوع اتصال خدمة 'Azure Resource Manager'.

  4. حدد Service principal (automatic)>Next.

    لقطة شاشة ل Azure DevOps تعرض جزء اتصال خدمة Azure الجديد، مع تمييز خيار كيان الخدمة (التلقائي).

  5. في القائمة المنسدلة Subscription، حدد اشتراك Azure الخاص بك.

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

  6. في القائمة المنسدلة Resource group، حدد ToyReusable.

  7. في مربع Service connection name، أدخل ToyReusable. تأكد من تحديد مربع الاختيار Grant access permission to all pipelines.

    لقطة شاشة ل Azure DevOps تعرض جزء

    تلميح

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

  8. حدد حفظ.