استقرار یک برنامه وب با خط لوله CI/CD در سرویس برنامه Azure

Summarize this content to 400 words in Persian Lang
مطالب مقدمه مرحله 1: یک برنامه Azure App Service ایجاد کنید مرحله 2: یک سرویس برنامه Azure ایجاد کنیدمرحله 3: یک مخزن GitHub ایجاد کنیدمرحله 4: مخزن خود را به صورت محلی کلون کنید مرحله 5: راه اندازی مرکز استقرار در سرویس Azure Appمرحله 6: خط لوله CI/CD خود را آزمایش کنید

مقدمه

استقرار یک برنامه وب با خط لوله CI/CD (ادغام پیوسته و استقرار مداوم) در برنامه Azure. با سرویس Azure App و کنترل منبع مانند GitHub، Bitbucket یا Azure Repos، راه اندازی خط لوله CI/CD برای برنامه وب شما به یک فرآیند ساده تبدیل می شود. این تضمین می کند که برنامه شما به طور خودکار یکپارچه و مستقر می شود، مداخله دستی مورد نیاز را کاهش می دهد و خطر خطا را به حداقل می رساند. در این مقاله، شما را با مراحل استقرار یک برنامه وب با خط لوله CI/CD در سرویس Azure App با استفاده از GitHub آشنا خواهیم کرد. با دنبال کردن مراحل ذکر شده، می توانید به طور موثر برنامه های وب خود را در Azure استقرار و مدیریت کنید.

پیش نیازها

قبل از شروع، اطمینان حاصل کنید که موارد زیر را دارید:

یک حساب لاجوردی (اگر ندارید در اینجا به صورت رایگان ثبت نام کنید).
الف حساب GitHub برای مدیریت کد منبع اگر ندارید اینجا ثبت نام کنید.
الف کد ویژوال استودیو نصب شده است. برای دانلود و نصب اگر نصب ندارید اینجا کلیک کنید.

بازگشت به محتوا

مرحله 1: یک برنامه Azure App Service ایجاد کنید

ایجاد یک برنامه App Service در Azure یک مرحله کلیدی قبل از استقرار برنامه وب شما است. طرح App Service منطقه، سطح قیمت و مقیاس برنامه وب شما را تعریف می کند.

وارد پورتال Azure شوید به https://portal.azure.com بروید و با حساب Azure خود وارد شوید.
در کادر جستجو تایپ کنید برنامه خدمات اپلیکیشن و آن را از لیست کشویی انتخاب کنید.

پایه و ردیف قیمت‌گذاری برنامه خدمات برنامه را پیکربندی کنید:

اشتراک: اشتراک Azure را که می خواهید استفاده کنید انتخاب کنید.

گروه منابع: یک گروه منبع موجود را انتخاب کنید یا یک گروه جدید ایجاد کنید.

نام: نامی برای طرح App Service خود وارد کنید.

سیستم عامل: بر اساس نیازهای برنامه خود، بین ویندوز یا لینوکس یکی را انتخاب کنید.

منطقه: منطقه ای را که می خواهید برنامه سرویس App شما میزبانی شود، انتخاب کنید. برای کاهش تأخیر، منطقه ای نزدیک به کاربران خود انتخاب کنید.
را کلیک کنید طرح های قیمت گذاری را بررسی کنید برای کاوش و انتخاب ردیف قیمت گذاری.
یک ردیف قیمتی را انتخاب کنید که متناسب با نیاز شما باشد. این ردیف‌ها از طرح‌های رایگان و مشترک برای توسعه/آزمایش تا برنامه‌های استاندارد و ممتاز برای حجم کاری تولید را شامل می‌شود.
را کلیک کنید انتخاب کنید هنگامی که ردیف قیمت گذاری مناسب را انتخاب کردید. در اینجا ما از لایه آزاد استفاده می کنیم.

را کلیک کنید ایجاد کنید پس از تأیید اعتبار برای ایجاد برنامه خدمات برنامه .

بازگشت به محتوا

مرحله 2: یک سرویس برنامه Azure ایجاد کنید

ایجاد یک سرویس برنامه Azure بسیار ساده است. در اینجا مراحل دقیق برای ایجاد یک App Service در Azure آمده است:

در کادر جستجو تایپ کنید خدمات برنامه و آن را از لیست کشویی انتخاب کنید.
را کلیک کنید ایجاد کنید نوع خدمات برنامه مورد نظر خود را انتخاب کنید. در اینجا ما با برنامه وب کار خواهیم کرد.

اصول اولیه برنامه وب را پیکربندی کنید

اشتراک: اشتراک Azure را که می خواهید استفاده کنید انتخاب کنید.

گروه منابع: یک گروه منبع موجود را انتخاب کنید یا یک گروه جدید ایجاد کنید.

نام: یک نام منحصر به فرد برای برنامه وب خود وارد کنید (این بخشی از URL برنامه شما خواهد بود).

منتشر کنید: نوع کدی را که می خواهید اجرا کنید (کد، کانتینر یا برنامه وب استاتیک) انتخاب کنید.

پشته زمان اجرا: پشته زمان اجرا (به عنوان مثال php، .NET، Node.js، Python، Java) را برای برنامه خود انتخاب کنید. در اینجا ما از php 8.3 استفاده خواهیم کرد.

سیستم عامل: بر اساس نیازهای برنامه خود، بین ویندوز یا لینوکس یکی را انتخاب کنید. در اینجا ما از Linus استفاده خواهیم کرد.

منطقه: منطقه ای را که می خواهید App Service شما میزبانی شود انتخاب کنید.

طرح قیمت گذاری

برای انتخاب طرح خدمات برنامه کلیک کنید. اگر برنامه قبلی ندارید، طرح خدمات برنامه ایجاد شده قبلی یا ایجاد جدید را انتخاب کنید تا یک برنامه خدمات برنامه جدید ایجاد کنید.

کلیک کنید بررسی + ایجاد: برای بررسی تنظیمات پیکربندی خود.

را کلیک کنید ایجاد کنید پس از تأیید اعتبار برای ایجاد سرویس App.

بازگشت به محتوا

مرحله 3: یک مخزن GitHub ایجاد کنید

وارد GitHub شوید با اعتبار حساب GitHub شما.
روی + نماد در گوشه سمت راست بالای صفحه
انتخاب کنید مخزن جدید از منوی کشویی

یک نام برای مخزن خود وارد کنید. نام باید منحصر به فرد حساب شما باشد و باید توصیفی از پروژه شما باشد.

توضیحات (اختیاری): شرح کوتاهی از پروژه خود اضافه کنید.
انتخاب کنید که آیا می خواهید مخزن شما باشد عمومی (هر کسی می تواند آن را ببیند) یا خصوصی (فقط شما و افرادی که به صراحت آن را با آنها به اشتراک می گذارید می توانید آن را ببینید).

این مخزن را با:

README: این کادر را علامت بزنید تا یک فایل README اضافه کنید، که مکانی عالی برای توصیف پروژه شما و ارائه دستورالعمل برای دیگران است.

.gitignore: برای افزودن یک فایل .gitignore این کادر را علامت بزنید. الگویی را انتخاب کنید که با نوع پروژه ای که روی آن کار می کنید مطابقت داشته باشد (به عنوان مثال PHP، Node، Python، Java).

مجوز: برای افزودن یک فایل مجوز، این کادر را علامت بزنید. مجوزی را که می خواهید برای پروژه خود اعمال کنید انتخاب کنید.

بر روی کلیک کنید مخزن ایجاد کنید هنگامی که تنظیمات مخزن را پیکربندی کردید را فشار دهید.

بازگشت به محتوا

مرحله 4: مخزن خود را به صورت محلی کلون کنید

برای کار بر روی پروژه خود به صورت محلی، باید مخزن را در ماشین محلی خود کلون کنید. در اینجا، ما از git bash در ترمینال کد ویژوال استودیو استفاده خواهیم کرد.

به مخزن جدید ایجاد شده خود در GitHub بروید. -روی کلیک کنید کد دکمه
آدرس ارائه شده را کپی کنید.

یک ترمینال جدید با کد ویژوال استودیو باز کنید.

یک دایرکتوری ایجاد کنید که در آن می خواهید مخزن خود را کلون کنید.

mkdir

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

جایگزین کنید با نام مخزن شما مثال است mkdir Project.

به دایرکتوری بروید.

cd

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

جایگزین کنید با نام مخزن شما مثال است cd Project.

دستور زیر را اجرا کنید:

git clone

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

جایگزین کنید با آدرسی که از GitHub کپی کردید.

فایل‌ها را اضافه کنید، Commit و Push کنید

touch

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

جایگزین کنید با نام فایل شما مثال است touch Index.php. یک فایل Index.php ایجاد می شود، آن را باز کنید، سپس یک برنامه وب ساده را در زیر کپی و جایگذاری کنید و ذخیره کنید.

Index

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

فایل ها را به مخزن خود اضافه کنید.

git add .

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

git commit -m “Adding Index.php”

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

کد (فایل) خود را به مخزن GitHub فشار دهید: از دستور زیر استفاده کنید.

git push origin main

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

جایگزین کنید main با نام شعبه پیش فرض اگر متفاوت باشد.

تایید فشار فایل به GitHub بروید تا تأیید کنید که فایل فشار داده شده ساکن است.

بازگشت به محتوا

مرحله 5: راه اندازی مرکز استقرار در سرویس برنامه Azure

به * خود برویدبرنامه وب * در پورتال لاجوردی
در قسمت سمت چپ، را انتخاب کنید استقرار **و سپس **مرکز استقرار.
انتخاب کنید GitHub به عنوان کنترل منبع
کلیک کنید مجاز کردن تا Azure به حساب GitHub شما دسترسی داشته باشد، اگر قبلاً به آن دسترسی نداشته اید. وارد GitHub خود شوید و مجوز دهید.

خود را انتخاب کنید نام کاربری GitHub برای سازمان
را انتخاب کنید مخزن و **شعبه**می خواهید از آن مستقر شوید.

زیر تنظیمات احراز هویت، انتخاب کنید نوع احراز هویت ** و ** اشتراک. اگر هویت اختصاص داده شده به کاربر را انتخاب کنید، باید تخصیص هویت کاربر را ایجاد کنید. می توانید روی ایجاد جدید کلیک کنید تا به طور خودکار برای شما ایجاد شود. اگر پایه را انتخاب کنید، باید به تنظیمات پیکربندی بروید تا احراز هویت اولیه SCM را فعال کنید. در اینجا از احراز هویت اولیه استفاده خواهیم کرد. مطمئن شوید که تغییرات خود را پس از پیکربندی تنظیمات ذخیره کرده اید.

*پیکربندی گردش کار: خط لوله CI/CD *. یک فایل YAML به طور خودکار برای گردش کار GitHub Actions ایجاد می شود. این خط لوله CI/CD است. برای پیش نمایش جریان کار، روی پیش نمایش فایل کلیک کنید و در صورت نیاز ویرایش کنید. در اینجا مثالی از آنچه که گردش کار ممکن است به نظر برسد آورده شده است:

# Docs for the Azure Web Apps Deploy action: https://github.com/Azure/webapps-deploy
# More GitHub Actions for Azure: https://github.com/Azure/actions

name: Build and deploy PHP app to Azure Web App – My-webapp123

on:
push:
branches:
– main
workflow_dispatch:

jobs:
build:
runs-on: ubuntu-latest

steps:
– uses: actions/checkout@v4

– name: Setup PHP
uses: shivammathur/setup-php@v2
with:
php-version: ‘8.3’

– name: Check if composer.json exists
id: check_files
uses: andstor/file-existence-action@v1
with:
files: ‘composer.json’

– name: Run composer install if composer.json exists
if: steps.check_files.outputs.files_exists == ‘true’
run: composer validate –no-check-publish && composer install –prefer-dist –no-progress

– name: Zip artifact for deployment
run: zip release.zip ./* -r

– name: Upload artifact for deployment job
uses: actions/upload-artifact@v4
with:
name: php-app
path: release.zip

deploy:
runs-on: ubuntu-latest
needs: build
environment:
name: ‘production’
url: ${{ steps.deploy-to-webapp.outputs.webapp-url }}

steps:
– name: Download artifact from build job
uses: actions/download-artifact@v4
with:
name: php-app

– name: Unzip artifact for deployment
run: unzip release.zip

– name: ‘Deploy to Azure Web App’
uses: azure/webapps-deploy@v3
id: deploy-to-webapp
with:
app-name: ‘My-webapp123’
slot-name: ‘production’
package: .
publish-profile: ${{ secrets.AzureAppService_PublishProfile_bf7ee8a6c0d4486fae6bfd525ceda399

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

ذخیره را کلیک کنید تا به گزارش ها منتقل شوید. منتظر بمانید تا استقرار در اقدام GitHub تکمیل شود.

بازگشت به محتوا

مرحله 6: خط لوله CI/CD خود را آزمایش کنید

یک متعهد شدن به مخزن خود در GitHub یا تغییرات جدید را از مخزن محلی خود فشار دهید.
برو به اقدامات برای نظارت بر گردش کار، در مخزن GitHub خود برگه بزنید.
مطمئن شوید که گردش کار با موفقیت اجرا می شود و برنامه شما در Azure مستقر شده است.
صفحه url پیش فرض دامنه را بازخوانی کنید تا تغییرات را مشاهده کنید.

در اینجا محتوای به روز رسانی برنامه وب من است.

بازگشت به محتوا

mkdir 

cd 

   git clone 

   touch 

   git add .

   git commit -m "Adding Index.php"

   git push origin main

# Docs for the Azure Web Apps Deploy action: https://github.com/Azure/webapps-deploy
# More GitHub Actions for Azure: https://github.com/Azure/actions

name: Build and deploy PHP app to Azure Web App - My-webapp123

on:
  push:
    branches:
      - main
  workflow_dispatch:

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      - name: Setup PHP
        uses: shivammathur/setup-php@v2
        with:
          php-version: '8.3'

      - name: Check if composer.json exists
        id: check_files
        uses: andstor/file-existence-action@v1
        with:
          files: 'composer.json'

      - name: Run composer install if composer.json exists
        if: steps.check_files.outputs.files_exists == 'true'
        run: composer validate --no-check-publish && composer install --prefer-dist --no-progress

      - name: Zip artifact for deployment
        run: zip release.zip ./* -r

      - name: Upload artifact for deployment job
        uses: actions/upload-artifact@v4
        with:
          name: php-app
          path: release.zip

  deploy:
    runs-on: ubuntu-latest
    needs: build
    environment:
      name: 'production'
      url: ${{ steps.deploy-to-webapp.outputs.webapp-url }}

    steps:
      - name: Download artifact from build job
        uses: actions/download-artifact@v4
        with:
          name: php-app

      - name: Unzip artifact for deployment
        run: unzip release.zip

      - name: 'Deploy to Azure Web App'
        uses: azure/webapps-deploy@v3
        id: deploy-to-webapp
        with:
          app-name: 'My-webapp123'
          slot-name: 'production'
          package: .
          publish-profile: ${{ secrets.AzureAppService_PublishProfile_bf7ee8a6c0d4486fae6bfd525ceda399