פיתוח API של נתונים באמצעות Azure Web App עבור גורמים מכילים

הושלם

פיתוח API של נתונים באמצעות Azure Web App for Containers מציע פתרון חזק ומדרגי עבור יישומים מודרניים. על-ידי שימוש בעוצמה של גורמים מכילים והשירותים המנוהלים של Azure, מפתחים יכולים לבנות, לפרוס ולנהל ממשקי API בקלות, ולהבטיח ביצועים ואמינות. גישה זו לא רק מפשטת את תהליך הפיתוח אלא גם משפרת את הניידות והמדרגיות של יישומים, מה שהופך אותה לבחירה אידיאלית עבור נוף התוכנה המודרני של ימינו.

גלה את היתרונות של שימוש ב- Web App עבור קונטיינרים

  • ניידות: גורמים מכילים את היישום ואת יחסי התלות שלו, ומבטיחים שהוא יפעל באופן עקבי בסביבות שונות. זה מבטל את בעיית "זה עובד על המחשב שלי" , מה שהופך את הפריסה לפלטפורמות שונות לחלקה.

  • מדרגיות: Azure Web App for Containers מאפשר קנה מידה אוטומטי על סמך דרישה. המשמעות היא שממשק ה-API של הנתונים שלך יכול להתמודד עם עומס מוגבר ללא התערבות ידנית, מה שמבטיח זמינות וביצועים גבוהים.

  • ניהול פשוט יותר: Azure מנהל את התשתית הבסיסית, כולל תיקון מערכת הפעלה, איזון עומסים והקצאת קיבולת. זה מאפשר למפתחים להתמקד בכתיבת קוד במקום בניהול שרתים.

בניית API של נתונים באמצעות Azure Web App עבור גורמים מכילים

כדי לבנות API של נתונים באמצעות Azure Web App for Containers, עליך ליצור יישום גורם מכיל עם תמונת DAB, להקצות את ההרשאות הדרושות, להגדיר Dockerfile ולעדכן את היישום בתמונה ובאישורים החדשים. לבסוף, אחזר את שם הדומיין ובדוק את ה-API.

לפני שתתחיל, ודא שיש לך מנוי Azure, קבוצת משאבים וגישה ל- Azure Cloud Shell.

יצירת יישום גורם מכיל

באפשרותך ליצור אפליקציות מיכל של Azure באמצעות השלבים הבאים.

  1. השתמש כדי az containerapp env create ליצור סביבה חדשה של אפליקציות גורם מכיל של Azure.

    az containerapp env create \ 
      --resource-group $RESOURCE_GROUP_NAME \
      --name $CONTAINER_ENV_NAME \
      --logs-destination none \
      --location $LOCATION
    
  2. השתמש בפקודה az containerapp create כדי ליצור יישום גורם מכיל חדש באמצעות תמונת הגורם המכיל של mcr.microsoft.com/azure-databases/data-api-builder DAB.

    az containerapp create \ 
      --resource-group $RESOURCE_GROUP_NAME \
      --environment $CONTAINER_ENV_NAME \
      --name $API_CONTAINER_NAME \
      --image "mcr.microsoft.com/azure-databases/data-api-builder" \
      --ingress "external" \
      --target-port "5000" \
      --system-assigned
    

לאחר מכן תוכל לקבל את המזהה הראשי של הזהות המנוהלת באמצעות az identity show.

הקצאת הרשאות

הקצה את הרשאות הזהות המנוהלת שהוקצו על-ידי המערכת לקריאת נתונים מ- Azure SQL ולקריאה וכתיבה ב- Azure Container Registry.

az role assignment create \
  --assignee $CURRENT_USER_PRINCIPAL_ID \
  --role $ROLE_ID \
  --scope $RESOURCE_GROUP_ID

יצירת מופע של Azure Container Registry

כדי ליצור מופע חדש של Azure Container Registry, הפעל את הפקודה הבאה.

az acr create \
  --resource-group $RESOURCE_GROUP_NAME \
  --name <CONTAINER_REGISTRY_NAME> \
  --sku "Standard" \
  --location <LOCATION> \
  --admin-enabled false

בנייה ופריסה של תמונת גורם מכיל

  1. עבור שלב הבנייה, השתמש בתמונת הגורם המכיל mcr.microsoft.com/dotnet/sdk .

  2. התקן את DAB CLI.

    RUN dotnet tool install Microsoft.DataApiBuilder
    
  3. צור קובץ תצורה עבור חיבור Azure SQL Database למסד הנתונים המשמש כמקור על-ידי הפעלת RUN dotnet tool run dab -- init.

  4. צור ישויות למיפוי לטבלאות במסד הנתונים המקורי.

    RUN dotnet tool run dab -- add Address --source "SalesLT.Address" --permissions "anonymous:read"
    
  5. העתק את קובץ התצורה לתמונת הגורם המכיל mcr.microsoft.com/azure-databases/data-api-builder הסופית.

  6. בנה את התמונה כמשימת רישום של גורם מכיל של Azure על-ידי הפעלת הלחצן az acr build כדי לבנות את התמונה שלך.

  7. הגדר את אפליקציית הגורם המכיל לשימוש ברישום הגורם המכיל.

    az containerapp registry set \
      --name <container-app-name> \
      --resource-group <resource-group-name> \
      --server <container-registry-login-server> \
      --username <container-registry-username> \
      --password <container-registry-password>
    
  8. צור סוד עם מחרוזת החיבור של Azure SQL.

    az containerapp secret set \
      --name <container-app-name> \
      --resource-group <resource-group-name> \
      --secrets "SQLConnectionString=<your-sql-connection-string>"
    
  9. עדכן את יישום הגורם המכיל עם תמונת הגורם המכיל המותאם אישית החדשה ומחרוזת החיבור.

    az containerapp update \
      --name <container-app-name> \
      --resource-group <resource-group-name> \
      --image <container-registry-login-server>/<image-name>:<tag> \
      --secrets "SQLConnectionString=<your-sql-connection-string>"
    
  10. אחזר את שם התחום המלא של יישום הגורם המכיל.

    az containerapp show \
      --name <container-app-name> \
      --resource-group <resource-group-name> \
      --query "properties.configuration.ingress.fqdn" \
      --output "tsv"
    

שלבים אלה מעדכנים את יישום הגורם המכיל של Azure עם התמונה והאישורים המותאמים אישית החדשים, ומאחזרים את שם התחום המלא של יישום הגורם המכיל.

לבסוף, נווט אל כתובת האתר ובדוק את ה-API כדי לוודא שהכל פועל כהלכה.

הערה

לקבלת שלבים מפורטים כיצד לפרוס את בונה ה- API של נתונים ב- Azure Container Apps עם Azure CLI, ראה מדריך: פריסת בונה API של נתונים ב- Azure Container Apps עם Azure CLI.