تطوير InnerLoop باستخدام Cloud Workstations مع لغة بايثون

1. نظرة عامة

يوضّح هذا الدرس التطبيقي الميزات والإمكانات المصمَّمة لتبسيط سير عمل التطوير لمهندسي البرامج المكلّفين بتطوير تطبيقات Python في بيئة تستخدم حاويات. يتطلّب تطوير الحاويات المعتاد أن يفهم المستخدم تفاصيل الحاويات وعملية التصميم. بالإضافة إلى ذلك، على المطوّرين عادةً إيقاف عملية التطوير مؤقتًا والانتقال من بيئة التطوير المتكاملة (IDE) لاختبار تطبيقاتهم وتصحيح الأخطاء فيها في بيئات بعيدة. باستخدام الأدوات والتكنولوجيات المذكورة في هذا البرنامج التعليمي، يمكن للمطوّرين العمل بفعالية مع التطبيقات المستندة إلى حاويات بدون مغادرة بيئة التطوير المتكاملة.

ما ستتعلمه

في هذا الدرس التطبيقي، ستتعرّف على طرق التطوير باستخدام الحاويات في Google Cloud Platform، بما في ذلك:

  • إنشاء تطبيق Python جديد للمبتدئين
  • الخطوات المفصّلة لعملية التطوير
  • تطوير خدمة REST بسيطة لإنشاء البيانات وقراءتها وتعديلها وحذفها
  • النشر على GKE
  • تصحيح حالة الخطأ
  • استخدام نقاط الإيقاف / السجلات
  • إعادة نشر التغييرات على GKE

58a4cdd3ed7a123a.png

2. الإعداد والمتطلبات

إعداد البيئة بوتيرة ذاتية

  1. سجِّل الدخول إلى Google Cloud Console وأنشِئ مشروعًا جديدًا أو أعِد استخدام مشروع حالي. إذا لم يكن لديك حساب على Gmail أو Google Workspace، عليك إنشاء حساب.

b35bf95b8bf3d5d8.png

a99b7ace416376c4.png

bd84a6d3004737c5.png

  • اسم المشروع هو الاسم المعروض للمشاركين في هذا المشروع. وهي سلسلة أحرف لا تستخدمها Google APIs. ويمكنك تعديله في أي وقت.
  • رقم تعريف المشروع هو معرّف فريد في جميع مشاريع Google Cloud ولا يمكن تغييره بعد ضبطه. تنشئ Cloud Console تلقائيًا سلسلة فريدة، ولا يهمّك عادةً ما هي. في معظم دروس البرمجة، عليك الرجوع إلى رقم تعريف المشروع (يتم تحديده عادةً على أنّه PROJECT_ID). إذا لم يعجبك رقم التعريف الذي تم إنشاؤه، يمكنك إنشاء رقم تعريف عشوائي آخر. يمكنك بدلاً من ذلك تجربة اسم مستخدم من اختيارك ومعرفة ما إذا كان متاحًا. لا يمكن تغيير هذا الخيار بعد هذه الخطوة وسيظل ساريًا طوال مدة المشروع.
  • للعلم، هناك قيمة ثالثة، وهي رقم المشروع الذي تستخدمه بعض واجهات برمجة التطبيقات. يمكنك الاطّلاع على مزيد من المعلومات عن كل هذه القيم الثلاث في المستندات.
  1. بعد ذلك، عليك تفعيل الفوترة في Cloud Console لاستخدام موارد/واجهات برمجة تطبيقات Cloud. لن تكلفك تجربة هذا الدرس البرمجي الكثير من المال، إن لم تكلفك شيئًا على الإطلاق. لإيقاف الموارد كي لا يتم تحصيل رسوم منك بعد هذا البرنامج التعليمي، يمكنك حذف الموارد التي أنشأتها أو حذف المشروع بأكمله. يمكن لمستخدمي Google Cloud الجدد الاستفادة من برنامج الفترة التجريبية المجانية بقيمة 300 دولار أمريكي.

بدء Cloudshell Editor

تم تصميم هذا الدرس التطبيقي واختباره لاستخدامه مع "محرّر Google Cloud Shell". للوصول إلى المحرِّر، اتّبِع الخطوات التالية:

  1. الوصول إلى مشروعك على Google من خلال https://console.cloud.google.com
  2. في أعلى يسار الصفحة، انقر على رمز محرر Cloud Shell

8560cc8d45e8c112.png

  1. سيتم فتح لوحة جديدة في أسفل النافذة
  2. انقر على الزر "فتح المحرِّر"

9e504cb98a6a8005.png

  1. سيتم فتح المحرِّر مع مستكشف على اليسار ومحرِّر في المنطقة الوسطى
  2. يجب أن يتوفّر جزء وحدة طرفية أيضًا في أسفل الشاشة
  3. إذا لم تكن النافذة الطرفية مفتوحة، استخدِم مجموعة المفاتيح `ctrl+`` لفتح نافذة طرفية جديدة.

إعداد البيئة

في Cloud Shell، اضبط رقم تعريف مشروعك ورقم المشروع. احفظها كمتغيرات PROJECT_ID وPROJECT_ID.

export PROJECT_ID=$(gcloud config get-value project)
export PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID \
    --format='value(projectNumber)')

توفير البنية الأساسية المستخدَمة في هذا الدرس التطبيقي

في هذا التمرين العملي، ستنفّذ رمزًا برمجيًا على GKE وتصل إلى البيانات المخزّنة في قاعدة بيانات Spanner. ستستخدم أيضًا محطات عمل Cloud كبيئة تطوير متكاملة. يُعدّ برنامج الإعداد النصي أدناه هذه البنية الأساسية لك.

  1. نزِّل نص الإعداد البرمجي واجعله قابلاً للتنفيذ.
wget https://raw.githubusercontent.com/GoogleCloudPlatform/container-developer-workshop/main/labs/python/setup_with_cw.sh
chmod +x setup_with_cw.sh
  1. افتح ملف setup_with_cw.sh وعدِّل قيم كلمات المرور التي تم ضبطها حاليًا على CHANGEME
  2. نفِّذ نص الإعداد لإنشاء مجموعة GKE وقاعدة بيانات Spanner التي ستستخدمها في هذا الدرس التطبيقي.
./setup_with_cw.sh &

مجموعة Cloud Workstations

  1. افتح محطات عمل Cloud في Cloud Console. انتظِر إلى أن تصبح حالة المجموعة READY.

305e1a3d63ac7ff6.png

إنشاء إعدادات "محطات عمل لتعديل المحتوى"

  1. إذا تم قطع اتصال جلسة Cloud Shell، انقر على "إعادة الاتصال" ثم نفِّذ أمر gcloud cli لضبط رقم تعريف المشروع. استبدِل رقم تعريف المشروع النموذجي أدناه برقم تعريف مشروعك على Qwiklabs قبل تنفيذ الأمر.
gcloud config set project qwiklabs-gcp-project-id
  1. نزِّل النص البرمجي أدناه وشغِّله في الوحدة الطرفية لإنشاء إعدادات Cloud Workstations.
wget https://raw.githubusercontent.com/GoogleCloudPlatform/container-developer-workshop/main/labs/python/workstation_config_setup.sh
chmod +x workstation_config_setup.sh
./workstation_config_setup.sh
  1. تحقَّق من النتائج ضمن قسم "الإعدادات". سيستغرق الانتقال إلى الحالة READY دقيقتَين.

2e23c2e9983d1ccf.png

  1. افتح محطات عمل Cloud في "وحدة التحكّم" وأنشئ مثيلاً جديدًا.

a53adeeac81a78c8.png

  1. غيِّر الاسم إلى my-workstation واختَر الإعداد الحالي: codeoss-python.

f052cd47701ec774.png

  1. تحقَّق من النتائج ضمن قسم "محطات العمل".

تشغيل Workstation

  1. بدء محطة العمل وإطلاقها سيستغرق بدء تشغيل Workstation بضع دقائق.

682f8a307032cba3.png

  1. السماح بملفات تعريف الارتباط التابعة لجهات خارجية من خلال النقر على الرمز في شريط العناوين 1b8923e2943f9bc4.png

fcf9405b6957b7d7.png

  1. انقر على "هل تواجهك مشكلة في الموقع الإلكتروني؟".

36a84c0e2e3b85b.png

  1. انقر على "السماح بملفات تعريف الارتباط".

2259694328628fba.png

  1. بعد تشغيل محطة العمل، سيظهر لك بيئة التطوير المتكاملة Code OSS. انقر على "وضع علامة اكتمال" في صفحة "البدء" في بيئة التطوير المتكاملة لمحطة العمل

94874fba9b74cc22.png

3- إنشاء تطبيق Python أوّلي جديد

في هذا القسم، ستنشئ تطبيق Python جديدًا.

  1. افتح نافذة Terminal جديدة.

c31d48f2e4938c38.png

  1. إنشاء دليل جديد وفتحه كمساحة عمل
mkdir music-service && cd music-service

code-oss-cloud-workstations -r --folder-uri="$PWD"

انقر على زر "السماح" إذا ظهرت لك هذه الرسالة، لتتمكّن من نسخ المحتوى ولصقه في محطة العمل.

58149777e5cc350a.png

  1. أنشئ ملفًا باسم requirements.txt وانسخ المحتوى التالي فيه

789e8389170bd900.png

Flask
gunicorn
google-cloud-spanner
ptvsd==4.3.2
  1. أنشئ ملفًا باسم app.py والصِق الرمز التالي فيه
import os
from flask import Flask, request, jsonify
from google.cloud import spanner

app = Flask(__name__)

@app.route("/")
def hello_world():
    message="Hello, World!"
    return message

if __name__ == '__main__':
    server_port = os.environ.get('PORT', '8080')
    app.run(debug=False, port=server_port, host='0.0.0.0')
  1. أنشئ ملفًا باسم Dockerfile والصِق فيه ما يلي
FROM python:3.8
ARG FLASK_DEBUG=0
ENV FLASK_DEBUG=$FLASK_DEBUG
ENV FLASK_APP=app.py
WORKDIR /app
COPY requirements.txt .
RUN pip install --trusted-host pypi.python.org -r requirements.txt
COPY . .
ENTRYPOINT ["python3", "-m", "flask", "run", "--port=8080", "--host=0.0.0.0"]

ملاحظة: يتيح لك FLASK_DEBUG=1 إعادة تحميل تغييرات الرمز تلقائيًا إلى تطبيق Python flask. يتيح لك Dockerfile تمرير هذه القيمة كمعلَمة إنشاء.

إنشاء بيانات

في الوحدة الطرفية، نفِّذ الأمر التالي لإنشاء ملف skaffold.yaml وdeployment.yaml تلقائيين.

  1. ابدأ Skaffold باستخدام الأمر التالي
skaffold init --generate-manifests

عندما يُطلب منك ذلك، استخدِم الأسهم لتحريك المؤشر ومفتاح المسافة لاختيار الخيارات.

اختيار:

  • 8080 للمنفذ
  • y لحفظ الإعدادات

تعديل إعدادات Skaffold

  • تغيير اسم التطبيق التلقائي
  • فتح "skaffold.yaml"
  • اختَر اسم الصورة المضبوطة حاليًا على dockerfile-image
  • انقر بزر الماوس الأيمن واختَر "تغيير كل التكرارات"
  • اكتب الاسم الجديد باللغة python-app
  • عدِّل قسم الإنشاء أكثر من ذلك ليصبح
  • إضافة docker.buildArgs إلى بطاقة FLASK_DEBUG=1
  • مزامنة الإعدادات لتحميل أي تغييرات على ملفات *.py من بيئة التطوير المتكاملة إلى الحاوية قيد التشغيل

بعد التعديلات، سيكون قسم الإنشاء في ملف skaffold.yaml على النحو التالي:

build:
 artifacts:
 - image: python-app
   docker:
     buildArgs:
       FLASK_DEBUG: "1"
     dockerfile: Dockerfile
   sync:
     infer:
     - '**/*.py'

تعديل ملف إعداد Kubernetes

  1. تغيير الاسم التلقائي
  • فتح ملف deployment.yaml
  • اختَر اسم الصورة المضبوطة حاليًا على dockerfile-image
  • انقر بزر الماوس الأيمن واختَر "تغيير كل التكرارات"
  • اكتب الاسم الجديد باللغة python-app

4. التعرّف على عملية التطوير

بعد إضافة منطق النشاط التجاري، يمكنك الآن نشر تطبيقك واختباره. سيعرض القسم التالي كيفية استخدام المكوّن الإضافي Cloud Code. يتكامل هذا المكوّن الإضافي مع Skaffold، من بين أمور أخرى، لتبسيط عملية التطوير. عند النشر إلى GKE في الخطوات التالية، ستنشئ Cloud Code وSkaffold تلقائيًا صورة الحاوية، وتدفعها إلى Container Registry، ثم تنشر تطبيق your إلى GKE. يحدث ذلك وراء الكواليس، حيث يتم تجريد التفاصيل بعيدًا عن مسار المطوّر.

تسجيل الدخول إلى Google Cloud

  1. انقر على رمز Cloud Code واختَر "تسجيل الدخول إلى Google Cloud":

1769afd39be372ff.png

  1. انقر على "متابعة لتسجيل الدخول".

923bb1c8f63160f9.png

  1. تحقَّق من الناتج في "نافذة الأوامر" وافتح الرابط:

517fdd579c34aa21.png

  1. سجِّل الدخول باستخدام بيانات اعتماد الطلاب في Qwiklabs.

db99b345f7a8e72c.png

  1. اختَر "السماح":

a5376553c430ac84.png

  1. انسخ رمز التحقّق وارجع إلى علامة التبويب "محطة العمل".

6719421277b92eac.png

  1. ألصِق رمز التحقّق واضغط على Enter.

e9847cfe3fa8a2ce.png

إضافة مجموعة Kubernetes

  1. إضافة مجموعة

62a3b97bdbb427e5.png

  1. اختَر Google Kubernetes Engine:

9577de423568bbaa.png

  1. اختَر مشروعًا.

c5202fcbeebcd41c.png

  1. اختَر "python-cluster" الذي تم إنشاؤه في عملية الإعداد الأولية.

719c2fc0a7f9e84f.png

  1. يظهر الآن العنقد في قائمة "عناقيد Kubernetes" ضمن Cloud Code. يمكنك التنقّل في المجموعة واستكشافها من هنا.

7e5f50662d4eea3c.png

ضبط رقم تعريف المشروع الحالي باستخدام gcloud cli

  1. انسخ رقم تعريف المشروع لهذا الدرس التطبيقي من صفحة Qwiklabs.

fcff2d10007ec5bc.png

  1. من الوحدة الطرفية، شغِّل أمر gcloud cli لضبط رقم تعريف المشروع. استبدِل رقم تعريف المشروع النموذجي قبل تنفيذ الأمر. استبدِل رقم تعريف المشروع قبل تنفيذ الأمر أدناه.
gcloud config set project qwiklabs-gcp-project-id

النشر على Kubernetes

  1. في اللوحة أسفل "محرّر Cloud Shell"، انقر على Cloud Code 

d99a88992e15fea9.png

  1. في اللوحة التي تظهر في أعلى الصفحة، اختَر التشغيل على Kubernetes. إذا طُلب منك ذلك، اختَر "نعم" لاستخدام سياق Kubernetes الحالي.

bfd65e9df6d4a6cb.png

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

  1. في المرة الأولى التي تنفّذ فيها الأمر، سيظهر طلب في أعلى الشاشة يسألك عمّا إذا كنت تريد سياق Kubernetes الحالي، اختَر "نعم" للقبول واستخدام السياق الحالي.
  2. بعد ذلك، ستظهر رسالة تطلب منك تحديد سجلّ الحاويات الذي تريد استخدامه. اضغط على مفتاح Enter لقبول القيمة التلقائية المقدَّمة
  3. اختَر علامة التبويب "الإخراج" في اللوحة السفلية للاطّلاع على مستوى التقدّم والإشعارات. استخدِم القائمة المنسدلة لاختيار "Kubernetes: تشغيل/تصحيح الأخطاء"

9c87ccbf5d06f50a.png

  1. اختَر "Kubernetes: Run/Debug - Detailed" (Kubernetes: تشغيل/تصحيح الأخطاء - تفصيلي) في القائمة المنسدلة للقناة على اليسار لعرض تفاصيل إضافية وسجلات يتم بثها مباشرةً من الحاويات.

804abc8833ffd571.png

عند اكتمال عملية الإنشاء والاختبارات، ستتضمّن سجلّات علامة التبويب "الإخراج" عنوان URL http://localhost:8080 المُدرَج في العرض "Kubernetes: تشغيل/تصحيح الأخطاء".

  1. في نافذة Cloud Code الطرفية، مرِّر مؤشر الماوس فوق عنوان URL الأول في الناتج (http://localhost:8080)، ثم انقر على Open Web Preview (فتح معاينة الويب) في تلميح الأداة الذي يظهر.
  2. سيتم فتح علامة تبويب جديدة في المتصفّح وعرض الرسالة Hello, World!

إعادة التحميل السريع

  1. افتح ملف app.py
  2. تغيير رسالة الترحيب إلى Hello from Python

لاحظ على الفور أنّه في نافذة Output، في طريقة العرض Kubernetes: Run/Debug، يزامن برنامج المراقبة الملفات المعدَّلة مع الحاوية في Kubernetes.

Update initiated
Build started for artifact python-app
Build completed for artifact python-app

Deploy started
Deploy completed

Status check started
Resource pod/python-app-6f646ffcbb-tn7qd status updated to In Progress
Resource deployment/python-app status updated to In Progress
Resource deployment/python-app status completed successfully
Status check succeeded
...
  1. إذا انتقلت إلى طريقة العرض Kubernetes: Run/Debug - Detailed، ستلاحظ أنّها تتعرّف على تغييرات الملفات ثم تنشئ التطبيق وتعيد نشره.
files modified: [app.py]
Syncing 1 files for gcr.io/veer-pylab-01/python-app:3c04f58-dirty@sha256:a42ca7250851c2f2570ff05209f108c5491d13d2b453bb9608c7b4af511109bd
Copying files:map[app.py:[/app/app.py]]togcr.io/veer-pylab-01/python-app:3c04f58-dirty@sha256:a42ca7250851c2f2570ff05209f108c5491d13d2b453bb9608c7b4af511109bd
Watching for changes...
[python-app] * Detected change in '/app/app.py', reloading
[python-app] * Restarting with stat
[python-app] * Debugger is active!
[python-app] * Debugger PIN: 744-729-662
  1. أعِد تحميل علامة تبويب المتصفح التي ظهرت فيها النتائج السابقة للاطّلاع على النتائج المعدَّلة.

تصحيح الأخطاء

  1. انتقِل إلى "عرض تصحيح الأخطاء" وأوقِف سلسلة المحادثات الحالية 647213126d7a4c7b.png. إذا طُلب منك ذلك، يمكنك اختيار التنظيف بعد كل عملية تشغيل.
  2. 70d6bd947d04d1e6.png
  3. انقر على Cloud Code في القائمة السفلية، ثم اختَر Debug on Kubernetes لتشغيل التطبيق في وضع debug.
  • في طريقة العرض Kubernetes Run/Debug - Detailed لنافذة Output، لاحظ أنّ Skaffold سينشر هذا التطبيق في وضع تصحيح الأخطاء.
  1. عند اكتمال العملية ستلاحظ ربط أداة تصحيح الأخطاء وعلامة التبويب "الإخراج" التي تعرض: Attached debugger to container "python-app-8476f4bbc-h6dsl" successfully.، وسيتم إدراج عنوان URL http://localhost:8080.
Port forwarding pod/python-app-8bd64cf8b-cskfl in namespace default, remote port 5678 -> http://127.0.0.1:5678
  1. يتغيّر لون شريط الحالة السفلي من الأزرق إلى البرتقالي للإشارة إلى أنّه في "وضع تصحيح الأخطاء".
  2. في العرض Kubernetes Run/Debug، لاحظ أنّه تم بدء تشغيل حاوية قابلة للتصحيح
**************URLs*****************
Forwarded URL from service python-app: http://localhost:8080
Debuggable container started pod/python-app-8bd64cf8b-cskfl:python-app (default)
Update succeeded
***********************************

استخدام نقاط الإيقاف

  1. افتح ملف app.py
  2. ابحث عن العبارة التي تقول return message
  3. أضِف نقطة توقّف إلى هذا السطر من خلال النقر على المساحة الفارغة على يمين رقم السطر. سيظهر مؤشر أحمر للإشارة إلى أنّه تم ضبط نقطة الإيقاف.
  4. في المرة الأولى التي يتم فيها تشغيل هذا الإجراء، سيظهر طلب يسأل عن مكان المصدر داخل الحاوية. ترتبط هذه القيمة بالأدلة في Dockerfile.

اضغط على Enter لقبول القيمة التلقائية

fccc866f32b5ed86.png

سيستغرق إنشاء التطبيق ونشره بضع دقائق.

  1. أعِد تحميل المتصفّح ولاحظ أنّ أداة تصحيح الأخطاء توقف العملية عند نقطة التوقف وتتيح لك التحقّق من المتغيرات وحالة التطبيق الذي يتم تشغيله عن بُعد في GKE.
  2. انقر على قسم "المتغيّرات"
  3. انقر على "المتغيرات المحلية"، وستجد المتغير "message".
  4. انقر مرّتين على اسم المتغيّر "message" (الرسالة)، وفي النافذة المنبثقة، غيِّر القيمة إلى قيمة مختلفة مثل "Greetings from Python"
  5. انقر على الزر "متابعة" في لوحة التحكّم في تصحيح الأخطاء 607c33934f8d6b39.png
  6. راجِع الردّ في المتصفّح الذي يعرض الآن القيمة المعدَّلة التي أدخلتها للتو.
  7. أوقِف وضع "تصحيح الأخطاء" من خلال الضغط على زر الإيقاف 647213126d7a4c7b.png وأزِل نقطة التوقف من خلال النقر عليها مرة أخرى.

5- تطوير خدمة REST بسيطة لإنشاء البيانات وقراءتها وتعديلها وحذفها

في هذه المرحلة، يكون تطبيقك قد تم إعداده بالكامل للتطوير ضِمن حاوية، ويكون قد تم إرشادك خلال سير عمل التطوير الأساسي باستخدام Cloud Code. في الأقسام التالية، ستتدرب على ما تعلّمته من خلال إضافة نقاط نهاية لخدمة REST تتصل بقاعدة بيانات مُدارة في Google Cloud.

كتابة رمز خدمة REST

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

  1. أنشئ التطبيق الرئيسي عن طريق استبدال app.py بالمحتويات التالية
import os
from flask import Flask, request, jsonify
from google.cloud import spanner


app = Flask(__name__)


instance_id = "music-catalog"

database_id = "musicians"

spanner_client = spanner.Client()
instance = spanner_client.instance(instance_id)
database = instance.database(database_id)


@app.route("/")
def hello_world():
    return "<p>Hello, World!</p>"

@app.route('/singer', methods=['POST'])
def create():
    try:
        request_json = request.get_json()
        singer_id = request_json['singer_id']
        first_name = request_json['first_name']
        last_name = request_json['last_name']
        def insert_singers(transaction):
            row_ct = transaction.execute_update(
                f"INSERT Singers (SingerId, FirstName, LastName) VALUES" \
                f"({singer_id}, '{first_name}', '{last_name}')"
            )
            print("{} record(s) inserted.".format(row_ct))

        database.run_in_transaction(insert_singers)

        return {"Success": True}, 200
    except Exception as e:
        return e



@app.route('/singer', methods=['GET'])
def get_singer():

    try:
        singer_id = request.args.get('singer_id')
        def get_singer():
            first_name = ''
            last_name = ''
            with database.snapshot() as snapshot:
                results = snapshot.execute_sql(
                    f"SELECT SingerId, FirstName, LastName FROM Singers " \
                    f"where SingerId = {singer_id}",
                    )
                for row in results:
                    first_name = row[1]
                    last_name = row[2]
                return (first_name,last_name )
        first_name, last_name = get_singer()  
        return {"first_name": first_name, "last_name": last_name }, 200
    except Exception as e:
        return e


@app.route('/singer', methods=['PUT'])
def update_singer_first_name():
    try:
        singer_id = request.args.get('singer_id')
        request_json = request.get_json()
        first_name = request_json['first_name']
        
        def update_singer(transaction):
            row_ct = transaction.execute_update(
                f"UPDATE Singers SET FirstName = '{first_name}' WHERE SingerId = {singer_id}"
            )

            print("{} record(s) updated.".format(row_ct))

        database.run_in_transaction(update_singer)
        return {"Success": True}, 200
    except Exception as e:
        return e


@app.route('/singer', methods=['DELETE'])
def delete_singer():
    try:
        singer_id = request.args.get('singer')
    
        def delete_singer(transaction):
            row_ct = transaction.execute_update(
                f"DELETE FROM Singers WHERE SingerId = {singer_id}"
            )
            print("{} record(s) deleted.".format(row_ct))

        database.run_in_transaction(delete_singer)
        return {"Success": True}, 200
    except Exception as e:
        return e

port = int(os.environ.get('PORT', 8080))
if __name__ == '__main__':
    app.run(threaded=True, host='0.0.0.0', port=port)

إضافة إعدادات قاعدة البيانات

للاتصال بـ Spanner بشكل آمن، عليك إعداد التطبيق لاستخدام Workload Identities. يتيح ذلك لتطبيقك العمل كحساب خدمة خاص به والحصول على أذونات فردية عند الوصول إلى قاعدة البيانات.

  1. تعديل deployment.yaml أضِف الرمز التالي في نهاية الملف (احرص على الاحتفاظ بمسافات الجدولة في المثال أدناه)
      serviceAccountName: python-ksa
      nodeSelector:
        iam.gke.io/gke-metadata-server-enabled: "true"

بعد إجراء التغييرات، من المفترض أن يبدو قسم المواصفات على النحو التالي

   spec:
     containers:
     - name: python-app
       image: python-app
     serviceAccountName: python-ksa
     nodeSelector:
       iam.gke.io/gke-metadata-server-enabled: "true"

نشر التطبيق والتحقّق من صحته

  1. في اللوحة أسفل "محرّر Cloud Shell"، انقر على Cloud Code ثم على Debug on Kubernetes في أعلى الشاشة.
  2. عند اكتمال عملية الإنشاء والاختبارات، تعرض علامة التبويب "الإخراج" Resource deployment/python-app status completed successfully، ويتم إدراج عنوان URL: "Forwarded URL from service python-app: http://localhost:8080"
  3. أضِف بضع إدخالات.

من "وحدة Cloudshell الطرفية"، شغِّل الأمر أدناه

curl -X POST http://localhost:8080/singer -H 'Content-Type: application/json' -d '{"first_name":"Cat","last_name":"Meow", "singer_id": 6}'
  1. اختبِر طلب GET من خلال تنفيذ الأمر أدناه في الوحدة الطرفية
curl -X GET http://localhost:8080/singer?singer_id=6
  1. اختبار الحذف: جرِّب الآن حذف إدخال من خلال تنفيذ الأمر التالي. غيِّر قيمة item-id إذا لزم الأمر.
curl -X DELETE http://localhost:8080/singer?singer_id=6

    This throws an error message

500 Internal Server Error

تحديد المشكلة وحلّها

  1. استخدِم وضع تصحيح الأخطاء للعثور على المشكلة. إليك بعض النصائح:
  • ندرك أنّ هناك مشكلة في الأمر DELETE لأنّه لا يعرض النتيجة المطلوبة. لذلك، عليك ضبط نقطة التوقّف في app.py في الطريقة delete_singer.
  • نفِّذ التعليمات البرمجية خطوة بخطوة وراقِب المتغيرات في كل خطوة لملاحظة قيم المتغيرات المحلية في النافذة اليمنى.
  • لمراقبة قيم محدّدة مثل singer_id وrequest.args، أضِف هذه المتغيّرات إلى نافذة "المراقبة".
  1. لاحظ أنّ القيمة المعيّنة لـ singer_id هي None. غيِّر الرمز البرمجي لحلّ المشكلة.

سيبدو مقتطف الرمز الثابت على النحو التالي.

@app.route('/delete-singer', methods=['DELETE', 'GET'])
def delete_singer():
    try:
        singer_id = request.args.get('singer_id')
  1. بعد إعادة تشغيل التطبيق، اختبِر مرة أخرى من خلال محاولة الحذف.
  2. أوقِف جلسة تصحيح الأخطاء من خلال النقر على المربّع الأحمر في شريط أدوات تصحيح الأخطاء 647213126d7a4c7b.png

6. تنظيف

تهانينا! في هذا التمرين المعملي، أنشأت تطبيق Python جديدًا من البداية وأعددته للعمل بفعالية مع الحاويات. بعد ذلك، نشرت تطبيقك وأصلحت أخطاءه في مجموعة GKE بعيدة باتّباع مسار المطوّر نفسه المتوفّر في حِزم التطبيقات التقليدية.

لإجراء عملية تنظيف بعد إكمال الدرس التطبيقي، اتّبِع الخطوات التالية:

  1. حذف الملفات المستخدَمة في المختبر
cd ~ && rm -rf ~/music-service
  1. احذف المشروع لإزالة جميع البنية الأساسية والموارد ذات الصلة