1. مقدمة
تاريخ آخر تعديل: 2024-11-01
كيف يمكننا تحديث تطبيق PHP قديم إلى Google Cloud؟
(📽️ شاهِد فيديو تمهيديًا مدته 7 دقائق حول هذا الدرس التطبيقي حول الترميز)
من الشائع أن تكون هناك تطبيقات قديمة تعمل في المؤسسة وتحتاج إلى تحديث. وهذا يعني جعلها قابلة للتوسّع وآمنة وقابلة للنشر في بيئات مختلفة.
في ورشة العمل هذه، ستتعرّف على ما يلي:
- تحويل تطبيق PHP إلى حاوية
- الانتقال إلى خدمة قاعدة بيانات مُدارة (Cloud SQL)
- انشر التطبيق على Cloud Run (وهو بديل لا يتطلّب عمليات تشغيل لـ GKE/Kubernetes).
- تأمين التطبيق باستخدام "إدارة الهوية وإمكانية الوصول" (IAM) وSecret Manager
- تحديد مسار CI/CD من خلال Cloud Build يمكن ربط Cloud Build بمستودع Git المستضاف على مزوّدي Git المعروفين، مثل GitHub أو GitLab، وتشغيله عند إجراء أي عملية دفع إلى الفرع الرئيسي، على سبيل المثال.
- استضافة صور التطبيق على Cloud Storage ويتم ذلك من خلال التثبيت، ولا يلزم استخدام بدون استخدام رمز لتغيير التطبيق.
- تقديم وظائف الذكاء الاصطناعي التوليدي من خلال Gemini، والتي يتم تنظيمها عبر Cloud Functions (بدون خادم)
- تعرَّف على أهداف مستوى الخدمة وتشغيل تطبيقك الذي تم تحديثه مؤخرًا.
باتّباع هذه الخطوات، يمكنك تحديث تطبيق PHP تدريجيًا، ما يحسّن من قابلية التوسّع والأمان ومرونة النشر. بالإضافة إلى ذلك، يتيح لك الانتقال إلى Google Cloud الاستفادة من بنيتها الأساسية وخدماتها الفعّالة لضمان تشغيل تطبيقك بسلاسة في بيئة مستندة إلى السحابة الإلكترونية.
نعتقد أنّ ما ستتعلّمه من خلال اتّباع هذه الخطوات البسيطة يمكن تطبيقه على تطبيقك ومؤسستك باستخدام لغة أو حزمة مختلفة وحالات استخدام مختلفة.
لمحة عن التطبيق
التطبيق (الرمز البرمجي، بموجب ترخيص MIT) الذي ستنشئ نسخة منه هو تطبيق PHP 5.7 أساسي مع مصادقة MySQL. تتمثل الفكرة الرئيسية للتطبيق في توفير منصة يمكن للمستخدمين من خلالها تحميل الصور، ويتمتع المشرفون بالقدرة على وضع علامة على الصور غير اللائقة. يحتوي التطبيق على جدولين:
- المستخدمون: يأتي مُجمَّعًا مسبقًا مع المشرفين. يمكن لمستخدمين جدد التسجيل.
- الصور: يتضمّن بعض الصور النموذجية. يمكن للمستخدمين الذين سجّلوا الدخول تحميل صور جديدة. سنضيف بعض الأفكار هنا.
هدفك
نريد تحديث التطبيق القديم ليكون متاحًا في Google Cloud. سنستفيد من أدواتها وخدماتها لتحسين قابلية التوسع وتعزيز الأمان وأتمتة إدارة البنية الأساسية ودمج الميزات المتقدّمة، مثل معالجة الصور والمراقبة وتخزين البيانات باستخدام خدمات مثل Cloud SQL وCloud Run وCloud Build وSecret Manager والمزيد.

والأهم من ذلك هو أنّنا نريد تنفيذ ذلك خطوة بخطوة حتى تتمكّن من معرفة عملية التفكير وراء كل خطوة، وعادةً ما تفتح كل خطوة إمكانيات جديدة للخطوات التالية (على سبيل المثال: الوحدتان 2 -> 3 و6 -> 7).
ألم تقتنع بعد؟ يمكنك مشاهدة هذا الفيديو الذي تبلغ مدته 7 دقائق على YouTube.
المتطلبات
- جهاز كمبيوتر مزوّد بمتصفّح ومتصل بالإنترنت
- بعض أرصدة Google Cloud Platform يُرجى الاطّلاع على الخطوة التالية.
- ستستخدم Cloud Shell. وتتضمّن جميع الأوامر المثبّتة مسبقًا التي ستحتاج إليها وبيئة تطوير متكاملة (IDE).
- حساب GitHub ستحتاج إلى ذلك لإنشاء فرع من الرمز الأصلي 🧑🏻💻 gdgpescara/app-mod-workshop باستخدام مستودع git الخاص بك. هذا الإجراء مطلوب لإنشاء مسار CI/CD خاص بك (الالتزام التلقائي -> الإنشاء -> النشر)
يمكن العثور على نماذج الحلول هنا:
- مستودع المؤلف: https://github.com/Friends-of-Ricc/app-mod-workshop
- مستودع ورشة العمل الأصلي ضمن مجلدات
.solutions/، لكل فصل
تم تصميم ورشة العمل هذه ليتم إكمالها على Cloud Shell (على متصفّح).
ومع ذلك، يمكن أيضًا محاولة ذلك من جهاز الكمبيوتر المحلي.
2. إعداد الرصيد وFork

تحصيل قيمة رصيد Google Cloud Platform وإعداد بيئة Google Cloud Platform [اختياري]
لإجراء ورشة العمل هذه، تحتاج إلى حساب فوترة يتضمّن بعض الرصيد. استخدِم الأرصدة من البانر في أعلى هذا الدرس التطبيقي حول الترميز للبدء. إذا كنت مرتبطًا بحساب فوترة، يمكنك تخطّي هذه الخطوة.
بعد الانتهاء، افتح Google Cloud Console وأنشئ مشروعًا جديدًا بالنقر على "أداة اختيار المشروع" (Project Selector) في القائمة المنسدلة أعلى يمين الصفحة حيث تظهر عبارة "ما مِن مؤسسة" (No organization). انظر أدناه

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

تأكَّد من ربط المشروع الجديد بحساب الفوترة التجريبي على Google Cloud Platform على النحو التالي.

يمكنك الآن استخدام Google Cloud Platform. إذا كنت مبتدئًا أو تريد تنفيذ كل شيء في بيئة Cloud، يمكنك الوصول إلى Cloud Shell ومحرّرها من خلال الزر التالي في أعلى يمين الصفحة كما هو موضّح أدناه.

تأكَّد من اختيار مشروعك الجديد في أعلى يمين الصفحة:
غير محدَّد (سيئ):

تم اختيار (جيد):

تفرُّع التطبيق من GitHub
- انتقِل إلى التطبيق التجريبي: https://github.com/gdgpescara/app-mod-workshop
- انقر على 🍴 "تفرُّع".
- إذا لم يكن لديك حساب على GitHub، عليك إنشاء حساب جديد.
- عدِّل ما تريده.

- استنسِخ رمز التطبيق باستخدام
git clonehttps://github.com/YOUR-GITHUB-USER/YOUR-REPO-NAME
- افتح مجلد المشروع المستنسَخ باستخدام المحرِّر المفضّل لديك. إذا اخترت Cloud Shell، يمكنك إجراء ذلك من خلال النقر على "فتح المحرِّر" كما هو موضّح أدناه.

يتوفّر لديك كل ما تحتاجه في "محرِّر Google Cloud Shell" كما هو موضّح في الشكل التالي

يمكن تحقيق ذلك بصريًا من خلال النقر على "فتح المجلد" واختيار المجلد، على الأرجح app-mod-workshop في المجلد الرئيسي.
3- الوحدة 1: إنشاء مثيل SQL
إنشاء مثيل Google Cloud SQL
سيتصل تطبيق PHP بقاعدة بيانات MySQL، وبالتالي نحتاج إلى نسخها إلى Google Cloud لإجراء عملية نقل سلسة. Cloud SQL هي الخيار المثالي لأنّها تتيح لك تشغيل قاعدة بيانات MySQL مُدارة بالكامل في السحابة الإلكترونية. في ما يلي الخطوات التي يجب اتّباعها:
- انتقِل إلى صفحة Cloud SQL: https://console.cloud.google.com/sql/instances
- انقر على "إنشاء مثيل" (Create Instance)
- فعِّل واجهة برمجة التطبيقات (إذا لزم الأمر). قد يستغرق ذلك بضع ثوانٍ.
- اختَر MySQL.
- (نحاول الحصول على أرخص إصدار، ليدوم لفترة أطول):
- الإصدار: Enterprise
- الإعداد المسبق: development (جرّبنا Sandbox ولم ينجح معنا)
- إصدار Mysql: 5.7 (يا له من إصدار قديم!)
- رقم تعريف المثيل: اختَر
appmod-phpapp(إذا غيّرت هذا الرقم، تذكَّر تغيير النصوص البرمجية والحلول المستقبلية أيضًا وفقًا لذلك). - كلمة المرور: أي كلمة مرور تريدها، ولكن دوِّنها باسم CLOUDSQL_INSTANCE_PASSWORD
- المنطقة: يجب أن تكون هي نفسها التي اخترتها لبقية التطبيق (مثلاً، ميلان =
europe-west8) - التوفّر في منطقة محدّدة: منطقة واحدة (نوفّر المال للعرض التوضيحي)
انقر على الزر "إنشاء مثيل" (Create Instance) لنشر قاعدة بيانات Cloud SQL. ⌛ يستغرق إكمال هذه العملية حوالي 10 دقائق⌛. في هذه الأثناء، يمكنك مواصلة قراءة المستندات، كما يمكنك البدء في حلّ الوحدة التالية ("تحويل تطبيق PHP إلى حاوية") لأنّها لا تعتمد على هذه الوحدة في الجزء الأول (إلى أن يتم إصلاح اتصال قاعدة البيانات).
ملاحظة: من المفترض أن تبلغ تكلفة هذا المثيل حوالي 7 دولار أمريكي في اليوم. تأكد من فصلها بعد ورشة العمل.
إنشاء قاعدة بيانات image_catalog ومستخدم في Cloud SQL
يأتي مشروع التطبيق مع مجلد db/ يحتوي على ملفَي sql:
- 01_schema.sql: يحتوي على رمز SQL لإنشاء جدولَين يتضمّنان بيانات المستخدمين والصور.
- 02_seed.sql: يحتوي على رمز SQL لإدخال البيانات في الجداول التي تم إنشاؤها سابقًا.
سيتم استخدام هذه الملفات لاحقًا بعد إنشاء قاعدة بيانات image_catalog. يمكنك إجراء ذلك من خلال اتّباع الخطوات التالية:
- افتح المثيل وانقر على علامة التبويب "قواعد البيانات" (Databases):
- انقر على "إنشاء قاعدة بيانات" (Create Database)
- وسمِّه
image_catalog(كما هو الحال في إعدادات تطبيق PHP).

بعد ذلك، ننشئ مستخدم قاعدة البيانات. باستخدام هذا، يمكننا المصادقة في قاعدة بيانات image_catalog.
- انقر الآن على علامة التبويب المستخدمون
- انقر على "إضافة حساب مستخدم".
- المستخدم: لننشئ واحدة:
- اسم المستخدم:
appmod-phpapp-user - كلمة المرور: اختَر كلمة مرور يمكنك تذكّرها، أو انقر على "إنشاء"
- احتفِظ بالإعداد السماح لأي مضيف (%).
- انقر على "إضافة".
افتح قاعدة البيانات لعناوين IP المعروفة.
يُرجى العِلم أنّ جميع قواعد البيانات في Cloud SQL تكون "معزولة" عند إنشائها. يجب إعداد شبكة بشكل صريح ليتم الوصول إليها من خلالها.
- انقر على المثيل
- افتح قائمة "الاتصالات" (Connections)
- انقر على علامة التبويب "الشبكات" (Networking).
- انقر على "الشبكات المعتمَدة". أضِف الآن شبكة (أي شبكة فرعية).
- في الوقت الحالي، لنختَر إعدادات سريعة ولكنها غير آمنة للسماح للتطبيق بالعمل، وقد تحتاج إلى حصرها لاحقًا بعناوين IP التي تثق بها:
- الاسم: "الجميع في العالم - غير آمن".
- الشبكة: "
0.0.0.0/0"(ملاحظة: هذا هو الجزء غير الآمن) - انقر على "تم".
- انقر على "حفظ".
ينبغي أن تظهر لك على النحو التالي:

ملاحظة: هذا الحل هو حل وسط جيد لإنهاء ورشة العمل في O(hours). ومع ذلك، يُرجى مراجعة مستند الأمان للمساعدة في تأمين الحلّ الخاص بك للإصدار العلني.
حان الوقت لاختبار اتصال قاعدة البيانات.
لنرى ما إذا كان مستخدم image_catalog الذي أنشأناه سابقًا يعمل.
انتقِل إلى Cloud SQL Studio داخل المثيل وأدخِل قاعدة البيانات والمستخدم وكلمة المرور للمصادقة كما هو موضّح أدناه:

الآن بعد أن دخلت، يمكنك فتح محرر SQL والمتابعة إلى القسم التالي.
استيراد قاعدة البيانات من قاعدة الرموز البرمجية
استخدِم محرِّر SQL لاستيراد جداول image_catalog مع بياناتها. انسخ رمز SQL من الملفات في المستودع (01_schema.sql ثم 02_seed.sql) ونفِّذها واحدًا تلو الآخر بترتيب تسلسلي.
بعد ذلك، من المفترض أن يظهر لك جدولان في image_catalog، وهما users وimages كما هو موضّح أدناه:

يمكنك اختبار ذلك من خلال تشغيل ما يلي في المحرِّر: select * from images;
احرص أيضًا على تدوين عنوان IP العلني لمثيل Cloud SQL، لأنّك ستحتاج إليه لاحقًا. للحصول على عنوان IP، انتقِل إلى الصفحة الرئيسية لمثيل Cloud SQL ضمن صفحة نظرة عامة. (Overview > Connect to this Instance > Public IP Address) (نظرة عامة > الاتصال بهذا المثيل > عنوان IP العام).
4. الوحدة 2: وضع تطبيق PHP في حاوية

نريد إنشاء هذا التطبيق للسحابة الإلكترونية.
وهذا يعني تجميع الرمز في نوع من ملفات ZIP التي تحتوي على جميع المعلومات لتشغيله في السحابة الإلكترونية.
هناك بضع طرق لتجميعها:
- Docker: إنّها شائعة جدًا، ولكنّ إعدادها بشكل صحيح معقّد للغاية.
- حِزم الإنشاء: أقل شيوعًا، ولكنها تميل إلى "التخمين التلقائي" لما يجب إنشاؤه وما يجب تشغيله. غالبًا ما تنجح هذه الطريقة.
في سياق ورشة العمل هذه، سنفترض أنّك تستخدم Docker.
إذا اخترت استخدام Cloud Shell، فهذا هو الوقت المناسب لإعادة فتحه (انقر على أعلى يسار وحدة تحكّم Cloud).

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

Docker
إذا أردت التحكّم في الإعلانات، هذا هو الحلّ المناسب لك. هذا منطقي عندما تحتاج إلى ضبط مكتبات معيّنة، وإدخال سلوكيات معيّنة غير واضحة (chmod في عمليات التحميل، أو ملف تنفيذي غير عادي في تطبيقك، ..)
بما أنّنا نريد في النهاية نشر تطبيقنا المحفوظ في حاويات على Cloud Run، يُرجى الاطّلاع على المستندات التالية. كيف يمكنك نقلها من PHP 8 إلى PHP 5.7؟ يمكنك استخدام Gemini لإنجاز هذه المهمة. بدلاً من ذلك، يمكنك استخدام هذا الإصدار المُعدّ مسبقًا:
# Use the official PHP image: https://hub.docker.com/_/php
FROM php:5.6-apache
# Configure PHP for Cloud Run.
# Precompile PHP code with opcache.
# Install PHP's extension for MySQL
RUN docker-php-ext-install -j "$(nproc)" opcache mysqli pdo pdo_mysql && docker-php-ext-enable pdo_mysql
RUN set -ex; \
{ \
echo "; Cloud Run enforces memory & timeouts"; \
echo "memory_limit = -1"; \
echo "max_execution_time = 0"; \
echo "; File upload at Cloud Run network limit"; \
echo "upload_max_filesize = 32M"; \
echo "post_max_size = 32M"; \
echo "; Configure Opcache for Containers"; \
echo "opcache.enable = On"; \
echo "opcache.validate_timestamps = Off"; \
echo "; Configure Opcache Memory (Application-specific)"; \
echo "opcache.memory_consumption = 32"; \
} > "$PHP_INI_DIR/conf.d/cloud-run.ini"
# Copy in custom code from the host machine.
WORKDIR /var/www/html
COPY . .
# Setup the PORT environment variable in Apache configuration files: https://cloud.google.com/run/docs/reference/container-contract#port
ENV PORT=8080
# Tell Apache to use 8080 instead of 80.
RUN sed -i 's/80/${PORT}/g' /etc/apache2/sites-available/000-default.conf /etc/apache2/ports.conf
# Note: This is quite insecure and opens security breaches. See last chapter for hardening ideas.
# Uncomment at your own risk:
#RUN chmod 777 /var/www/html/uploads/
# Configure PHP for development.
# Switch to the production php.ini for production operations.
# RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"
# https://github.com/docker-library/docs/blob/master/php/README.md#configuration
RUN mv "$PHP_INI_DIR/php.ini-development" "$PHP_INI_DIR/php.ini"
# Expose the port
EXPOSE 8080
يتوفّر أحدث إصدار من "Dockerfile" هنا.
لاختبار تطبيقنا محليًا، نحتاج إلى تغيير ملف config.php بطريقة تتيح لتطبيق PHP الاتصال بقاعدة بيانات MYSQL المتاحة على Google CloudSQL. استنادًا إلى ما أعددته سابقًا، املأ الفراغات:
<?php
// Database configuration
$db_host = '____________';
$db_name = '____________';
$db_user = '____________';
$db_pass = '____________';
try {
$pdo = new PDO("mysql:host=$db_host;dbname=$db_name", $db_user, $db_pass);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
die("Errore di connessione: " . $e->getMessage());
}
session_start();
?>
-
DB_HOSTهو عنوان IP العلني لخدمة Cloud SQL، ويمكنك العثور عليه في وحدة تحكّم SQL:

- يجب عدم تغيير
DB_NAME:image_catalog - يجب أن يكون
DB_USERappmod-phpapp-user DB_PASSهو خيار حدّدته. اضبطه بعلامات اقتباس مفردة وتخطّيه حسب الحاجة.
يمكنك أيضًا ترجمة بعض المقاطع باللغة 🇮🇹 الإيطالية إلى الإنجليزية بمساعدة Gemini.
الآن بعد أن حصلت على Dockerfile وضبطت تطبيق PHP للاتصال بقاعدة البيانات، لنجرّب ذلك.
ثبِّت Docker إذا لم يكن مثبّتًا لديك بعد (الرابط). ولن تحتاج إلى ذلك إذا كنت تستخدم Cloud Shell (أليس هذا رائعًا؟).
الآن، حاوِل إنشاء تطبيق PHP ضمن حاوية وتشغيله باستخدام أوامر الإنشاء والتشغيل المناسبة في Docker.
# Build command - don't forget the final . This works if Dockerfile is inside the code folder:
$ docker build -t my-php-app-docker .
# Local Run command: most likely ports will be 8080:8080
$ docker run -it -p <CONTAINER_PORT>:<LOCAL_MACHINE_PORT> my-php-app-docker
إذا كان كل شيء يعمل بشكل صحيح، من المفترض أن تتمكّن من رؤية صفحة الويب التالية عند الاتصال بالمضيف المحلي. يعمل تطبيقك الآن على المنفذ 8080، انقر على رمز "معاينة الويب" (متصفّح مع عين) ثم معاينة على المنفذ 8080 (أو "تغيير المنفذ" لأي منفذ آخر)

اختبار النتيجة على المتصفّح
من المفترض أن يظهر تطبيقك الآن على النحو التالي:

وإذا سجّلت الدخول باستخدام Admin/admin123، من المفترض أن يظهر لك ما يلي:

رائع! باستثناء النص الإيطالي، كل شيء يعمل بشكل صحيح. 🎉🎉🎉
إذا كانت عملية التحويل إلى Docker جيدة ولكن بيانات اعتماد قاعدة البيانات خاطئة، فقد تحصل على شيء مثل هذا:

أعِد المحاولة، لقد اقتربت من الإجابة الصحيحة.
الحفظ في Artifact Registry [اختياري]
الآن، من المفترض أن يكون لديك تطبيق PHP ضمن حاوية جاهز للنشر على السحابة الإلكترونية. بعد ذلك، نحتاج إلى مكان في السحابة الإلكترونية لتخزين نسخة Docker وإتاحة الوصول إليها لنشرها في خدمات Google Cloud، مثل Cloud Run. يُطلق على حلّ التخزين هذا اسم Artifact Registry، وهو خدمة مُدارة بالكامل من Google Cloud مصمَّمة لتخزين عناصر التطبيقات، بما في ذلك نُسخ حاويات Docker وحِزم Maven ووحدات npm والمزيد.
لننشئ مستودعًا في Google Cloud Artifact Registry باستخدام الزر المناسب.

اختَر اسمًا صالحًا والتنسيق والمنطقة المناسبة لتخزين العناصر.

ارجع إلى علامة بيئة التطوير المحلية وأرسِل صورة حاوية التطبيق إلى مستودع Artifact Registry الذي تم إنشاؤه للتو. أكمِل الأوامر التالية لإجراء ذلك.
- docker tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG]
- docker push TARGET_IMAGE[:TAG]
من المفترض أن تظهر النتيجة كما في لقطة الشاشة التالية.

رائع 🎉🎉🎉 يمكنك الانتقال إلى المستوى التالي. قبل ذلك، يمكنك قضاء دقيقتين في محاولة التحميل/تسجيل الدخول/تسجيل الخروج والتعرّف على نقاط نهاية التطبيق.ستحتاج إليها لاحقًا.
الأخطاء التي يُحتمل حدوثها
إذا ظهرت لك أخطاء في عملية الحاويات، جرِّب استخدام Gemini لشرح الخطأ وإصلاحه، مع تقديم ما يلي:
- ملف Dockerfile الحالي
- الخطأ الذي تم تلقّيه
- [if needed] the PHP code being executed.
أذونات التحميل: يُرجى أيضًا تجربة نقطة النهاية /upload.php ومحاولة تحميل صورة. قد يظهر لك الخطأ أدناه. إذا كان الأمر كذلك، عليك إجراء بعض الإصلاحات في chmod/chown في Dockerfile.
تحذير: move_uploaded_file(uploads/image (3).png): تعذّر فتح البث: تم رفض الإذن في /var/www/html/upload.php في السطر 11
PDOException "could not find driver" (أو "Errore di connessione: could not find driver"). تأكَّد من أنّ ملف Dockerfile يحتوي على مكتبات PDO المناسبة لـ mysql (pdo_mysql) للاتصال بقاعدة البيانات. يمكنك الحصول على أفكار من الحلول المتاحة هنا.
يتعذّر إعادة توجيه طلبك إلى الخلفية. تعذّر الاتصال بخادم على المنفذ 8080. هذا يعني أنّك على الأرجح تعرض المنفذ غير الصحيح. تأكَّد من عرض المنفذ الذي يقدّم منه Apache/Nginx الخدمة فعليًا. هذا ليس بالأمر السهل. إذا كان ذلك ممكنًا، حاوِل استخدام المنفذ 8080 (يسهّل ذلك استخدام Cloud Run). إذا أردت الاحتفاظ بالمنفذ 80 (على سبيل المثال، لأنّ Apache يتطلّب ذلك)، استخدِم أمرًا مختلفًا لتشغيله:
$ docker run -it -p 8080:80 # force 80
# Use the PORT environment variable in Apache configuration files.
# https://cloud.google.com/run/docs/reference/container-contract#port
RUN sed -i 's/80/${PORT}/g' /etc/apache2/sites-available/000-default.conf /etc/apache2/ports.conf
5- الوحدة 3: نشر التطبيق على Cloud Run

ما هي أسباب اختيار Cloud Run؟
سؤال وجيه. قبل سنوات، كنت ستختار بالتأكيد Google App Engine.
باختصار، تستخدم Cloud Run اليوم حزمة تكنولوجيا أحدث، وهي أسهل في النشر وأقل تكلفة، ويمكن تقليصها إلى 0 عند عدم استخدامها. بفضل مرونتها في تشغيل أي حاوية عديمة الحالة وتكاملها مع خدمات Google Cloud المختلفة، تُعدّ هذه الخدمة مثالية لنشر الخدمات المصغّرة والتطبيقات الحديثة بأقل قدر من النفقات العامة وأقصى قدر من الكفاءة.
بشكل أكثر تحديدًا، Cloud Run هي منصة مُدارة بالكامل من Google Cloud تتيح لك تشغيل التطبيقات ضِمن الحاويات التي لا يتم تسجيل بياناتها في بيئة بدون خادم. وتتعامل هذه الخدمة تلقائيًا مع جميع البنى الأساسية، وتتوسّع من الصفر لتلبية عدد الزيارات الواردة وتنخفض عند عدم النشاط، ما يجعلها فعّالة من حيث التكلفة والكفاءة. تتيح خدمة Cloud Run استخدام أي لغة أو مكتبة طالما أنّها مجمّعة في حاوية، ما يوفّر مرونة كبيرة في التطوير. تتكامل هذه الخدمة بشكل جيد مع خدمات Google Cloud الأخرى، وهي مناسبة لإنشاء الخدمات المصغّرة وواجهات برمجة التطبيقات والمواقع الإلكترونية والتطبيقات المستندة إلى الأحداث بدون الحاجة إلى إدارة البنية الأساسية للخوادم.
المتطلبات الأساسية
لإنجاز هذه المهمة، يجب تثبيت gcloud على جهازك المحلي. وإذا لم تظهر، يمكنك الاطّلاع على التعليمات هنا. أما إذا كنت تستخدم Google Cloud Shell، فليس عليك اتّخاذ أي إجراء.
قبل النشر...
إذا كنت تعمل في بيئتك المحلية، يمكنك المصادقة على Google Cloud باستخدام ما يلي:
$ gcloud auth login –update-adc # not needed in Cloud Shell
من المفترض أن تتم مصادقتك من خلال تسجيل الدخول إلى OAuth على المتصفّح. تأكَّد من تسجيل الدخول من خلال Chrome باستخدام المستخدم نفسه (مثلاً vattelapesca@gmail.com) الذي سجّل الدخول إلى Google Cloud مع تفعيل الفوترة.
فعِّل Cloud Run API باستخدام الأمر التالي:
$ gcloud services enable run.googleapis.com cloudbuild.googleapis.com
في هذه المرحلة، يصبح كل شيء جاهزًا للنشر في Cloud Run.
نشر تطبيقك على Cloud Run من خلال gcloud
الأمر الذي يتيح لك نشر التطبيق على Cloud Run هو gcloud run deploy. هناك عدة خيارات يمكنك ضبطها لتحقيق هدفك. في ما يلي الحد الأدنى من الخيارات (التي يمكنك تقديمها من خلال سطر الأوامر أو ستطلبها منك الأداة من خلال رسالة تفاعلية):
- اسم خدمة Cloud Run التي تريد نشرها لتطبيقك: ستعرض لك خدمة Cloud Run عنوان URL يوفّر نقطة نهاية لتطبيقك.
- منطقة Google Cloud التي سيتم تشغيل تطبيقك فيها (
--regionREGION) - صورة الحاوية التي تغلّف تطبيقك
- متغيّرات البيئة التي يحتاج تطبيقك إلى استخدامها أثناء تنفيذه
- علامة Allow-Unauthenticated التي تسمح للجميع بالوصول إلى تطبيقك بدون مصادقة إضافية
يُرجى الرجوع إلى المستندات (أو الانتقال للأسفل للاطّلاع على حلّ محتمل) لمعرفة كيفية تطبيق هذا الخيار على سطر الأوامر.
ستستغرق عملية النشر بضع دقائق. إذا كان كل شيء صحيحًا، من المفترض أن يظهر لك شيء مشابه في Google Cloud Console.


انقر على عنوان URL الذي يوفّره Cloud Run واختبِر تطبيقك. بعد المصادقة، من المفترض أن يظهر لك شيء مثل هذا.

"gcloud run deploy" بدون وسيطات
ربما لاحظت أنّ "gcloud run deploy" يطرح عليك الأسئلة المناسبة ويملأ الفراغات التي تركتها. هذا مدهش.
ومع ذلك، سنضيف هذا الأمر في بعض الوحدات إلى مشغّل Cloud Build، لذا لا يمكننا تحمّل تكلفة الأسئلة التفاعلية. علينا ملء كل خيار في الأمر. إذًا، تريدون صنع gcloud run deploy --option1 blah --foo bar --region your-fav-region الذهبي. كيف تنفّذ ذلك؟
- كرِّر الخطوات 2 و3 و4 إلى أن يتوقف gcloud عن طرح الأسئلة:
- [LOOP] تم العثور على
gcloud run deployمع خيارات حتى الآن - [LOOP] systems ask for option X
- [LOOP] Search in public docs how to set up X from CLI adding option
--my-option [my-value]. - لنعد الآن إلى الخطوة 2، ما لم تكتمل عملية gcloud بدون طرح أي أسئلة أخرى.
- هذا الأمر gcloud run deploy BLAH BLAH BLAH رائع! احفظ الأمر في مكان ما، لأنّك ستحتاج إليه لاحقًا في خطوة Cloud Build.
يمكنك الاطّلاع على حلّ محتمل هنا. يمكنك الاطّلاع على المستندات هنا.
تهانينا 🎉🎉🎉 لقد نجحت في نشر تطبيقك في Google Cloud، وبذلك تكون قد أكملت الخطوة الأولى من عملية التحديث.
6. الوحدة 4: تنظيف كلمة المرور باستخدام Secret Manager

في الخطوة السابقة، تمكّنا من نشر تطبيقنا وتشغيله بنجاح في Cloud Run. ومع ذلك، نفّذنا ذلك من خلال ممارسة سيئة في مجال الأمان: توفير بعض الأسرار في نص غير مرمّز.
التكرار الأول: تعديل ملف config.php لاستخدام ENV
ربما لاحظت أننا وضعنا كلمة مرور قاعدة البيانات مباشرة في الرمز في ملف config.php. هذا الإجراء مناسب لأغراض الاختبار ومعرفة ما إذا كان التطبيق يعمل. ولكن لا يمكنك تنفيذ/استخدام رمز مثل هذا في بيئة التشغيل الفعلي. يجب قراءة كلمة المرور (ومعلَمات اتصال قاعدة البيانات الأخرى) ديناميكيًا وتقديمها إلى التطبيق أثناء التشغيل. غيِّر ملف config.php ليقرأ مَعلمات قاعدة البيانات من متغيّرات ENV. إذا تعذّر ذلك، ننصحك بضبط القيم التلقائية. هذا مفيد في حال تعذّر تحميل ENV، لذا سيخبرك ناتج الصفحة إذا كان يستخدم القيم التلقائية. املأ الفراغات واستبدِل الرمز في ملف config.php.
<?php
// Database configuration with ENV variables. Set default values as well
$db_host = getenv('DB_HOST') ?: 'localhost';
$db_name = getenv('DB_NAME') ?: 'image_catalog';
$db_user = getenv('DB_USER') ?: 'appmod-phpapp-user';
$db_pass = getenv('DB_PASS') ?: 'wrong_password';
// Note getenv() is PHP 5.3 compatible
try {
$pdo = new PDO("mysql:host=$db_host;dbname=$db_name", $db_user, $db_pass);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
die("Errore di connessione: " . $e->getMessage());
}
session_start();
?>
بما أنّ تطبيقك في حاوية، عليك توفير طريقة لتزويد التطبيق بمتغيّرات ENV. ويمكن إجراء ذلك بعدة طرق:
- في وقت الإنشاء، في ملف Dockerfile. أضِف إلى ملف Dockerfile السابق المَعلمات الأربع باستخدام البنية ENV DB_VAR=ENV_VAR_VALUE. سيؤدي ذلك إلى إعداد القيم التلقائية التي يمكن إلغاؤها في وقت التشغيل. على سبيل المثال، يمكن ضبط "DB_NAME" و"DB_USER" هنا وليس في أي مكان آخر.
- في وقت التشغيل يمكنك إعداد هذه المتغيّرات لخدمة Cloud Run، سواء من واجهة سطر الأوامر أو من واجهة المستخدم. هذا هو المكان المناسب لوضع جميع المتغيرات الأربعة (ما لم تكن تريد الاحتفاظ بالإعدادات الافتراضية المحددة في Dockerfile).
في localhost، قد تحتاج إلى وضع متغيرات ENV في ملف .env (راجع مجلد solutions).
تأكَّد أيضًا من إضافة .env إلى .gitignore، لأنّك لا تريد إرسال بياناتك السرية إلى Github.
echo .env >> .gitignore
بعد ذلك، يمكنك اختبار المثيل محليًا:
docker run -it -p 8080:8080 --env-file .env my-php-app-docker
لقد حققت الآن ما يلي:
- سيقرأ تطبيقك المتغيّر ديناميكيًا من ENV
- لقد حسّنت مستوى الأمان لأنّك أزلت كلمة مرور قاعدة البيانات من الرمز البرمجي)
يمكنك الآن نشر نسخة جديدة في Cloud Run. لننتقل إلى واجهة المستخدم ونضبط متغيّرات البيئة يدويًا:
- انتقِل إلى https://console.cloud.google.com/run
- انقر على تطبيقك
- انقر على "تعديل نسخة جديدة ونشرها"
- في علامة التبويب الأولى "الحاويات"، انقر على علامة التبويب السفلية "المتغيّرات والرموز السرية"
- انقر على "+ إضافة متغيّر" وأضِف جميع المتغيّرات المطلوبة. من المفترض أن تظهر النتيجة على النحو التالي:


هل هذه الإجابة مثالية؟ لا، سيظلّ رقم PASS ظاهرًا لمعظم المشغّلين. ويمكن التخفيف من تأثير ذلك باستخدام Google Cloud Secret Manager.
التكرار الثاني: Secret Manager
لقد اختفت كلمات المرور من الرمز الخاص بك: لقد نجحت! ولكن مهلاً، هل نحن في أمان؟
ستظل كلمات المرور ظاهرة لأي مستخدم لديه إذن الوصول إلى Google Cloud Console. في الواقع، إذا تم الوصول إلى ملف YAML الخاص بنشر Cloud Run، سيكون من الممكن استرداد المفتاح. أو إذا حاولت تعديل نسخة جديدة من Cloud Run أو نشرها، فستظهر كلمة المرور في قسم "المتغيّرات والرموز السرية" (Variables & Secrets) كما هو موضّح في لقطات الشاشة أدناه.
Secret Manager في Google Cloud هي خدمة مركزية آمنة لإدارة المعلومات الحساسة، مثل مفاتيح واجهة برمجة التطبيقات وكلمات المرور والشهادات وغيرها من البيانات السرية.
تتيح لك هذه الخدمة تخزين البيانات السرية وإدارتها والوصول إليها باستخدام أذونات دقيقة وتشفير قوي. يتكامل Secret Manager مع "إدارة الهوية وإمكانية الوصول" (IAM) في Google Cloud، ما يتيح لكم التحكّم في المستخدمين الذين يمكنهم الوصول إلى بيانات سرية معيّنة، وضمان أمان البيانات والامتثال التنظيمي.
وتتيح أيضًا تدوير البيانات السرية وإصدارها تلقائيًا، ما يسهّل إدارة مراحل نشاط البيانات السرية ويعزّز الأمان في التطبيقات على مستوى خدمات Google Cloud.
للوصول إلى Secret Manager، انتقِل من قائمة الخطوط الثلاثة إلى خدمات الأمان وابحث عنها ضمن قسم حماية البيانات كما هو موضّح في لقطة الشاشة أدناه.

فعِّل واجهة Secret Manager API بعد الوصول إليها كما هو موضّح في الصورة التالية.

- انقر الآن على "إنشاء رمز سرّي" (Create a secret): لنسمِّه بشكل منطقي:
- الاسم:
php-amarcord-db-pass - قيمة المفتاح السرّي: "your DB password" (تجاهَل جزء "تحميل الملف").
- يجب إضافة تعليق توضيحي إلى هذا الرابط السري، ويجب أن يظهر على النحو التالي:
projects/123456789012/secrets/php-amarcord-db-pass. هذا هو المؤشر الفريد لبياناتك السرية (لـ Terraform وCloud Run وغيرهما). هذا الرقم هو رقم مشروعك الفريد.
ملاحظة: حاوِل استخدام اصطلاحات تسمية متّسقة لبيانات الاعتماد، مع التخصيص من اليسار إلى اليمين، على سبيل المثال: cloud-devrel-phpamarcord-dbpass
- المؤسسة (مع الشركة)
- فريق (داخل المؤسسة)
- التطبيق (داخل الفريق)
- اسم المتغيّر (داخل التطبيق)
سيتيح لك ذلك استخدام تعبيرات نمطية سهلة للعثور على جميع بياناتك السرية لتطبيق واحد.
إنشاء نسخة جديدة من Cloud Run
بعد أن أصبح لدينا رمز سرّي جديد، علينا التخلّص من متغيّر البيئة DB_PASS واستبداله بالرمز السرّي الجديد. وبالتالي:
- الوصول إلى Cloud Run باستخدام Google Cloud Console
- اختَر التطبيق.
- انقر على "تعديل نسخة جديدة ونشرها " (Edit& Deploy a New Revision)
- ابحث عن علامة التبويب "المتغيّرات والمفاتيح السرية " (Variables& Secrets).
- استخدِم الزر "+ Reference a Secret" (إضافة مرجع إلى رمز سرّي) لإعادة ضبط متغيّر DB_PASS ENV.
- استخدِم "DB_PASS" نفسه للبيانات السرية المُشار إليها واستخدِم أحدث إصدار.

بعد الانتهاء، من المفترض أن يظهر لك الخطأ التالي

حاول معرفة كيفية حل مشكلة. لحلّ هذه المشكلة، عليك الانتقال إلى قسم إدارة الهوية وإمكانية الوصول (IAM) والمشرف وتغيير أذونات المنح. نتمنى لك تجربة تصحيح أخطاء ممتعة.
بعد معرفة السبب، ارجع إلى Cloud Run وأعِد نشر نسخة جديدة. من المفترض أن تظهر النتيجة كما في الشكل التالي:

ملاحظة: تُعدّ Developer Console (واجهة المستخدم) رائعة في الإشارة إلى مشاكل الأذونات. ننصحك بتخصيص بعض الوقت لتصفُّح جميع الروابط الخاصة بكياناتك على Cloud.
7. الوحدة 5: إعداد عملية التكامل المستمر والنشر المستمر (CI/CD) باستخدام Cloud Build

ما أهمية مسار التكامل المستمر والنشر المستمر؟
من المفترض أنّك كتبت عبارة "gcloud run deploy" عدة مرات حتى الآن، ربما للإجابة عن السؤال نفسه مرارًا وتكرارًا.
هل سئمت من نشر تطبيقك يدويًا باستخدام الأمر gcloud run deploy؟ أليس من الرائع أن يتم نشر تطبيقك تلقائيًا في كل مرة تُجري فيها تغييرًا جديدًا على مستودع Git؟
لاستخدام مسار CI/CD، ستحتاج إلى ما يلي:
- مستودع Git شخصي: من المفترض أنّك قد أنشأت نسخة من مستودع ورشة العمل في حسابك على GitHub في الخطوة 2. إذا لم يكن الأمر كذلك، فارجع وأكمل هذه الخطوة. يُفترض أن يظهر المستودع المتفرّع على النحو التالي:
https://github.com/<YOUR_GITHUB_USER>/app-mod-workshop - Cloud Build: تتيح لك هذه الخدمة الرائعة والمنخفضة التكلفة ضبط عمليات التشغيل الآلي لإنشاء كل شيء تقريبًا: Terraform والتطبيقات التي تستخدم Docker، ..
سيركّز هذا القسم على إعداد Cloud Build.
تعرَّف على Cloud Build
سنستخدم Cloud Build لإجراء ذلك:
- إنشاء المصدر (باستخدام ملف Dockerfile) يمكنك اعتبار ذلك "ملف ZIP كبير" يحتوي على كل ما تحتاج إليه لإنشاء التطبيق وتشغيله ("أداة الإنشاء").
- إرسال هذا العنصر إلى Artifact Registry (AR).
- بعد ذلك، يمكنك إصدار عملية نشر من Artifact Registry إلى Cloud Run للتطبيق "php-amarcord"
- سيؤدي ذلك إلى إنشاء نسخة جديدة ("مراجعة") من التطبيق الحالي (مثل طبقة تحتوي على الرمز الجديد)، وسنضبطها لتحويل عدد الزيارات إلى النسخة الجديدة في حال نجاح عملية النشر.
في ما يلي مثال على بعض الإصدارات لتطبيق "php-amarcord":

كيف يمكننا تحقيق ذلك؟
- من خلال إنشاء ملف YAML واحد مثالي:
cloudbuild.yaml - من خلال إنشاء مشغِّل Cloud Build
- من خلال الربط بمستودع GitHub عبر واجهة مستخدم Cloud Build
إنشاء مشغّل (وربط المستودع)
- انتقِل إلى https://console.cloud.google.com/cloud-build/triggers
- انقر على "إنشاء عامل تشغيل".
- التجميع:
- الاسم: اسم ذو معنى مثل
on-git-commit-build-php-app - الحدث: الدفع إلى الفرع
- المصدر: "ربط مستودع جديد"

- سيؤدي ذلك إلى فتح نافذة على يسار الشاشة: "ربط المستودع" (Connect repository)
- مقدّم المصدر: "Github" (أولاً)
- "متابعة"
- سيؤدي النقر على "المصادقة" (Authenticate) إلى فتح نافذة على GitHub لإجراء مصادقة متبادلة. انسجِم مع الحركة وتحلَّ بالصبر. إذا كان لديك العديد من المستودعات، فقد يستغرق الأمر بعض الوقت.
- "اختيار المستودع" (Select repo): اختَر حسابك أو مستودعك وضَع علامة في المربّع "أفهم..." (I understand...).
- إذا ظهر لك الخطأ: لم يتم تثبيت تطبيق GitHub على أي من مستودعاتك، انقر على "تثبيت Google Cloud Build" واتّبِع التعليمات.
انقر على "ربط"
- هكذا! تم ربط المستودع الآن.
- لنعد إلى الجزء الخاص بالمُشغِّل...
- الإعداد: تم التعرّف عليه تلقائيًا (*)
- إعدادات متقدّمة: اختَر حساب الخدمة "[PROJECT_NUMBER]- compute@developer.gserviceaccount.com"
- xxxxx هو رقم تعريف مشروعك
- حساب خدمة Compute Engine التلقائي مناسب لنهج التمرين المعملي، ولكن لا تستخدِمه في بيئة الإنتاج. (مزيد من المعلومات)
- واترك كل شيء آخر كما هو.
- انقر على الزر "إنشاء".
(*) هذه هي أبسط طريقة لأنّها تتحقّق من ملف Dockerfile أو cloudbuild.yaml. ومع ذلك، يمنحك cloudbuild.yaml القدرة على تحديد الإجراء الذي يجب اتّخاذه في كل خطوة.
أنا أملك القوة
لن يعمل المشغّل الآن إلا إذا منحت حساب خدمة Cloud Build (ما هو حساب الخدمة؟ عنوان البريد الإلكتروني لـ "روبوت" ينوب عنك في تنفيذ مهمة، وفي هذه الحالة، إنشاء عناصر في السحابة الإلكترونية.
سيفشل مهندس الحلول في إنشاء الحلول ونشرها ما لم تمنحه الصلاحية لإجراء ذلك. لحسن الحظ، الأمر سهل.
- انتقِل إلى "Cloud Build" > " الإعدادات".
- "[PROJECT_NUMBER]- compute@developer.gserviceaccount.com" service account
- ضَع علامة في المربّعات التالية:
- Cloud Run
- Secret Manager
- حسابات الخدمة
- Cloud Build
- ضَع علامة أيضًا في المربّع "ضبطه كحساب خدمة مفضّل" (Set as preferred service account).

أين ملف YAML الخاص بـ Cloud Build؟
ننصحك بشدة بقضاء بعض الوقت في إنشاء ملف YAML الخاص بك في Cloud Build.
ومع ذلك، إذا لم يكن لديك الوقت، أو لا تريد تخصيص وقت، يمكنك الحصول على بعض الإلهام في مجلد الحلول هذا: .solutions
يمكنك الآن إرسال تغيير إلى GitHub ومراقبة Cloud Build لتنفيذ دوره.
قد يكون إعداد Cloud Build صعبًا. توقَّع بعض المناقشات من خلال:
- جارٍ التحقّق من السجلّات في https://console.cloud.google.com/cloud-build/builds;region=global
- جارٍ البحث عن الخطأ.
- Fixing in the code, and re-issuing git commit / git push.
- في بعض الأحيان، لا يكون الخطأ في الرمز، ولكن في بعض الإعدادات. في هذه الحالة، يمكنك إصدار نسخة جديدة من واجهة المستخدم (Cloud Build > "المشغّلات" > تشغيل)

يُرجى العِلم أنّه في حال استخدام هذا الحلّ، سيظلّ هناك بعض العمل الذي يجب إنجازه، مثل ضبط متغيّرات ENV لنقاط النهاية التي تم إنشاؤها حديثًا للتطوير/الإنتاج:

هناك طريقتان لإجراء ذلك:
- من خلال واجهة المستخدم: من خلال ضبط متغيّرات ENV مرة أخرى
- من خلال CLI عبر إنشاء النص البرمجي "المثالي" لك يمكنك الاطّلاع على مثال هنا: gcloud-run-deploy.sh. يجب تعديل بعض العناصر، مثل نقطة النهاية ورقم المشروع. يمكنك العثور على رقم مشروعك في نظرة عامة على Cloud.
كيف يمكنني تنفيذ الرمز البرمجي في GitHub؟
لا تهدف ورشة العمل هذه إلى تعليمك أفضل طريقة git push إلى GitHub. ومع ذلك، في حال واجهتك مشكلة وكنت في Cloud Shell، هناك طريقتان:
- CLI. أضِف مفتاح SSH محليًا وأضِف جهازًا عن بُعد باستخدام git@github.com:YOUR_USER/app-mod-workshop.git (بدلاً من http)
- VSCode: إذا كنت تستخدم محرّر Cloud Shell، يمكنك استخدام علامة التبويب "التحكّم في المصدر" (ctrl-shift-G)، والنقر على "مزامنة التغييرات" واتّباع التعليمات. من المفترض أن تتمكّن من مصادقة حسابك على GitHub في vscode، وستصبح عملية السحب/الدفع من هناك سهلة للغاية.

تذكَّر أن تضع git add clodubuild.yaml بين الملفات الأخرى، وإلا لن يعمل.
Deep vs Shallow "dev/prod parity" [optional]
إذا نسخت إصدار النموذج من هنا، سيكون لديك إصداران متطابقان من DEV وPROD. هذا أمر رائع، ويتماشى مع القاعدة 10 من "التطبيق ذي العوامل الاثني عشر".
ومع ذلك، نستخدم نقطتَي نهاية مختلفتَين على الويب لكي يشير التطبيق إلى قاعدة البيانات نفسها. هذا كافٍ لورشة عمل، ولكن في الواقع، عليك تخصيص بعض الوقت لإنشاء بيئة إنتاج مناسبة. يعني ذلك توفُّر قاعدتَي بيانات (إحداهما للتطوير والأخرى للإنتاج) واختيار مكان حفظهما لاستعادة البيانات عند حدوث كوارث أو لضمان أعلى مستوى من توفُّر الخدمة. يتجاوز هذا نطاق ورشة العمل هذه، ولكنه يمثّل بعض الأفكار التي يجب التفكير فيها.
إذا كان لديك الوقت لإنشاء نسخة "عميقة" من الإنتاج، يُرجى مراعاة جميع الموارد التي تحتاج إلى تكرارها، مثل:
- قاعدة بيانات Cloud SQL (وربما مثيل SQL)
- حزمة GCS
- دالة Cloud.
- يمكنك استخدام Gemini 1.5 Flash كنموذج في مرحلة التطوير (أرخص وأسرع)، وGemini 1.5 Pro (أكثر فعالية).
بشكل عام، في كل مرة تفعل فيها شيئًا ما بشأن التطبيق، فكّر بشكل نقدي: هل يجب أن يكون للإنتاج نفس القيمة أم لا؟ وإذا لم يكن الأمر كذلك، فكرر جهدك. وهذا بالطبع أسهل بكثير مع Terraform، حيث يمكنك إدخال بيئتك (-dev، -prod) كلاحقة لمواردك.
8. الوحدة 6: الانتقال إلى Google Cloud Storage

مساحة التخزين

يخزّن التطبيق حاليًا الحالة في حاوية Docker. إذا تعطّل الجهاز أو توقّف التطبيق عن العمل أو إذا أرسلت نسخة جديدة، ستتم جدولة نسخة جديدة بمساحة تخزين جديدة فارغة: 🙈
كيف يمكننا حلّ هذه المشكلة؟ هناك عدد من الطرق.
- تخزين الصور في قاعدة البيانات هذا ما انتهى بي الأمر إلى فعله مع تطبيق PHP السابق. إنه الحل الأبسط لأنه لا يضيف تعقيدًا إليه. ولكنّها تزيد من وقت الاستجابة والتحميل في قاعدة البيانات بالتأكيد.
- نقل تطبيق Cloud Run إلى حلّ متوافق مع مساحة التخزين: GCE + قرص دائم؟ ربما GKE + Storage؟ ملاحظة: ما تكتسبه في التحكّم، تفقده في المرونة.
- انتقِل إلى GCS. يقدّم Google Cloud Storage أفضل مساحة تخزين في فئته لخدمة Google Cloud بأكملها، وهو الحلّ الأكثر ملاءمةً للسحابة الإلكترونية. ومع ذلك، يتطلب الأمر منا التعمق في مكتبات PHP. هل تتوفّر لدينا مكتبات PHP 5.7 لخدمة GCS؟ هل يتوافق
PHP 5.7معComposer(يبدو أنّ PHP 5.3.2 هو أقدم إصدار يتوافق مع Composer)؟ - يمكنك استخدام حاوية Docker Sidecar.
- أو يمكنك استخدام عمليات تثبيت وحدات تخزين Cloud Run في GCS. يبدو ذلك رائعًا.
🤔 نقل مساحة التخزين (سؤال مفتوح)
[سؤال مفتوح] في هذا التمرين، نريد منك العثور على حلّ لنقل صورك بطريقة تضمن حفظها.
اختبار القبول
لا أريد أن أخبرك بالحل، لكنني أريد أن يحدث هذا:
- تحميل
newpic.jpgستظهر لك في التطبيق. - ترقية التطبيق إلى إصدار جديد
- لا يزال "
newpic.jpg" ظاهرًا.
💡 الحلّ المحتمل (تثبيت وحدات تخزين Cloud Run في GCS)
هذا حل أنيق للغاية يسمح لنا بتحقيق عمليات تحميل ملفات ذات حالة مع عدم لمس الرمز على الإطلاق (بصرف النظر عن إظهار وصف الصورة، ولكن هذا أمر تافه ومجرد لإرضاء العين).
من المفترض أن يتيح لك ذلك تحميل مجلد من Cloud Run إلى GCS، وبالتالي:
- ستظهر جميع عمليات التحميل إلى GCS في تطبيقك.
- سيتم تحميل جميع الملفات إلى تطبيقك في GCS
- ستحدث المعجزات في العناصر التي تم تحميلها في GCS (الفصل 7).
ملاحظة: يُرجى قراءة التفاصيل الدقيقة لبرنامج FUSE. هذا ليس جيدًا إذا كان الأداء يمثل مشكلة.
إنشاء حزمة على Google Cloud Storage
GCS هي خدمة التخزين الشاملة في Google Cloud. وقد تم اختباره في المعارك، ويتم استخدامه من قِبل كل خدمة من خدمات GCP التي تحتاج إلى مساحة تخزين.
يُرجى العِلم أنّ Cloud Shell يصدّر PROJECT_ID على أنّه GOOGLE_CLOUD_PROJECT:
$ export PROJECT_ID=$GOOGLE_CLOUD_PROJECT
#!/bin/bash
set -euo pipefail
# Your Cloud Run Service Name, eg php-amarcord-dev
SERVICE_NAME='php-amarcord-dev'
BUCKET="${PROJECT_ID}-public-images"
GS_BUCKET="gs://${BUCKET}"
# Create bucket
gsutil mb -l "$GCP_REGION" -p "$PROJECT_ID" "$GS_BUCKET/"
# Copy original pictures there - better if you add an image of YOURS before.
gsutil cp ./uploads/*.png "$GS_BUCKET/"
ضبط Cloud Run لتحميل الحزمة في المجلد /uploads/
لننتقل الآن إلى الجزء الأنيق. ننشئ وحدة تخزين php_uploads ونطلب من Cloud Run إجراء عملية تثبيت FUSE على MOUNT_PATH (مثل /var/www/html/uploads/):
#!/bin/bash
set -euo pipefail
# .. keep variables from previous script..
# Uploads folder within your docker container.
# Tweak it for your app code.
MOUNT_PATH='/var/www/html/uploads/'
# Inject a volume mount to your GCS bucket in the right folder.
gcloud --project "$PROJECT_ID" beta run services update "$SERVICE_NAME" \
--region $GCP_REGION \
--execution-environment gen2 \
--add-volume=name=php_uploads,type=cloud-storage,bucket="$BUCKET" \
--add-volume-mount=volume=php_uploads,mount-path="$MOUNT_PATH"
الآن، كرِّر هذه الخطوة لجميع نقاط النهاية التي تريد توجيهها إلى Cloud Storage.
يمكنك أيضًا تحقيق ذلك من واجهة المستخدم
- ضمن علامة التبويب "وحدات التخزين"، أنشئ نقطة تثبيت وحدة تخزين تشير إلى حزمتك، من النوع "حزمة Cloud Storage"، على سبيل المثال باسم "php_uploads".
- ضمن "الحاويات" > "عمليات تحميل وحدات التخزين"، حمِّل وحدة التخزين التي أنشأتها للتو على نقطة وحدة التخزين التي يطلبها تطبيقك. يعتمد ذلك على ملف dockerfile، ولكن قد يظهر على النحو التالي:
var/www/html/uploads/.
في كلتا الحالتين، إذا نجحت العملية، من المفترض أن يظهر لك ما يلي عند تعديل نسخة Cloud Run الجديدة:

والآن، اختبِر التطبيق الجديد من خلال تحميل صورة جديدة إلى نقطة النهاية /upload.php.
يجب أن تتدفق الصور بسلاسة على GCS دون كتابة سطر واحد من PHP:

ما الذي حدث للتو؟
حدث شيء سحري للغاية.
لا يزال التطبيق القديم الذي يحتوي على رمز قديم يؤدي وظيفته. تتيح لنا حزمة جديدة وحديثة الحصول على جميع الصور في تطبيقنا بشكل مريح في حزمة سحابية ذات حالة. والآن، لا حدود لما يمكنك تحقيقه:
- هل تريد إرسال رسالة إلكترونية في كل مرة تصل فيها صورة تحتوي على "محتوى خطير" أو "عُري"؟ ويمكنك إجراء ذلك بدون تعديل رمز PHP.
- هل تريد استخدام نموذج Gemini متعدّد الوسائط في كل مرة يتم فيها إدخال صورة لوصفها، وتحميل قاعدة البيانات مع وصفها؟ ويمكنك إجراء ذلك بدون تعديل رمز PHP. ألا تصدقني؟ واصِل القراءة في الفصل 7.
لقد فتحنا للتو مساحة كبيرة من الفرص هنا.
9. الوحدة 7: تعزيز قدرات تطبيقك باستخدام Google Gemini

أصبح لديك الآن تطبيق PHP جديد رائع وحديث (مثل Fiat 126 لعام 2024) مع مساحة تخزين مستندة إلى السحابة الإلكترونية.
ما استخداماته؟
المتطلبات الأساسية
في الفصل السابق، سمح لنا حلّ نموذجي بتحميل الصور /uploads/ على GCS، بحكم الواقع، وفصل منطق التطبيق عن مساحة تخزين الصور.
يتطلب منك هذا التمرين ما يلي:
- أكملت التمرين في الفصل 6 (التخزين) بنجاح.
- أن يكون لديك حزمة GCS تحتوي على الصور التي تم تحميلها، حيث يحمّل المستخدمون الصور على تطبيقك وتتدفق الصور إلى حزمتك.
إعداد دالة Cloud (بلغة Python)
هل تساءلت يومًا عن كيفية تنفيذ تطبيق مستند إلى الأحداث؟ على سبيل المثال:
- عند حدوث <الحدث> => إرسال رسالة إلكترونية
- عند حدوث <event> => إذا كان <condition> صحيحًا، يتم تعديل قاعدة البيانات.
يمكن أن يكون الحدث أي شيء، بدءًا من سجلّ جديد متاح في BigQuery، أو عنصر جديد تم تغييره في مجلد في GCS، أو رسالة جديدة في قائمة انتظار في Pub/Sub.
تتيح Google Cloud نماذج متعددة لتحقيق ذلك. وأبرزها:
- EventArc: كيفية تلقّي أحداث GCS رائع لإنشاء DAGs وتنظيم الإجراءات بناءً على if-then-else في السحابة.
- Cloud Scheduler: وهي رائعة لمهمة cron في منتصف الليل في السحابة الإلكترونية، على سبيل المثال.
- Cloud Workflows على غرار Event Arc، تتيح لك هذه الخدمة
- دوال Cloud Run (المعروفة باسم
lambdas). - Cloud Composer: هو في الأساس إصدار Google من Apache Airflow، وهو رائع أيضًا لـ DAG.
في هذا التمرين، سنتعمّق في Cloud Function لتحقيق نتيجة مذهلة. وسنقدّم لك تمارين اختيارية.
يُرجى العِلم أنّ الرمز النموذجي متوفّر بموجب ترخيص .solutions/
إعداد دالة Cloud (🐍 python)
نحاول إنشاء منتدى منشئي المحتوى في Google طموح للغاية.
- عند إنشاء صورة جديدة على GCS.. (ربما لأنّ أحد المستخدمين حمّله على التطبيق، ولكن ليس هذا السبب الوحيد)
- .. call Gemini to describe it and get a textual description of the image .. (سيكون من المفيد التحقّق من نوع MIME والتأكّد من أنّه صورة وليس ملف PDF أو MP3 أو نصًا)
- .. وتعديل قاعدة البيانات بهذا الوصف. (قد يتطلّب ذلك تصحيح قاعدة البيانات لإضافة عمود
descriptionإلى جدولimages).
تصحيح قاعدة البيانات لإضافة description إلى الصور
- افتح Cloud SQL Studio:

- أدخِل اسم المستخدم وكلمة المرور لقاعدة بيانات الصور
- أدخِل رمز SQL هذا الذي يضيف عمودًا لوصف الصورة:
ALTER TABLE images ADD COLUMN description TEXT;

وهذا كل شيء. جرِّب الآن لمعرفة ما إذا نجحت العملية:
SELECT * FROM images;
من المفترض أن يظهر عمود الوصف الجديد:

كتابة دالة Gemini f(x)
ملاحظة: تم إنشاء هذه الدالة بمساعدة Gemini Code Assist.
ملاحظة: قد يؤدي إنشاء هذه الدالة إلى حدوث أخطاء في أذونات "إدارة الهوية وإمكانية الوصول" (IAM). وتم توثيق بعضها أدناه ضمن فقرة "الأخطاء المحتملة".
- تفعيل واجهات برمجة التطبيقات
- انتقِل إلى https://console.cloud.google.com/functions/list
- انقر على "إنشاء دالة" (Create Function)
- تفعيل واجهات برمجة التطبيقات من معالج واجهة برمجة التطبيقات:

يمكنك إنشاء GCF من واجهة المستخدم أو من سطر الأوامر. سنستخدم هنا سطر الأوامر.
يمكن العثور على رمز محتمل ضمن .solutions/
- أنشئ مجلدًا لاستضافة الرمز البرمجي، مثل "gcf/". افتح المجلد.
- أنشئ ملف
requirements.txt:
google-cloud-storage
google-cloud-aiplatform
pymysql
- أنشئ دالة Python. يمكنك الاطّلاع على الرمز النموذجي هنا: gcf/main.py.
#!/usr/bin/env python
"""Complete this"""
from google.cloud import storage
from google.cloud import aiplatform
import vertexai
from vertexai.generative_models import GenerativeModel, Part
import os
import pymysql
import pymysql.cursors
# Replace with your project ID
PROJECT_ID = "your-project-id"
GEMINI_MODEL = "gemini-1.5-pro-002"
DEFAULT_PROMPT = "Generate a caption for this image: "
def gemini_describe_image_from_gcs(gcs_url, image_prompt=DEFAULT_PROMPT):
pass
def update_db_with_description(image_filename, caption, db_user, db_pass, db_host, db_name):
pass
def generate_caption(event, context):
"""
Cloud Function triggered by a GCS event.
Args:
event (dict): The dictionary with data specific to this type of event.
context (google.cloud.functions.Context): The context parameter contains
event metadata such as event ID
and timestamp.
"""
pass
- اضغط على الدالة. يمكنك استخدام نص برمجي مشابه لهذا: gcf/push-to-gcf.sh.
الملاحظة 1: تأكَّد من تحديد القيم الصحيحة لمتغيرات البيئة (ENV)، أو أضِفها في الأعلى (GS_BUCKET=blah، ..):
الملاحظة 2: سيؤدي ذلك إلى إرسال كل الرموز البرمجية المحلية (.)، لذا تأكَّد من وضع الرمز البرمجي في مجلد محدّد واستخدام .gcloudignore باحترافية لتجنُّب إرسال مكتبات ضخمة. (مثال)
#!/bin/bash
set -euo pipefail
# add your logic here, for instance:
source .env || exit 2
echo "Pushing ☁️ f(x)☁ to 🪣 $GS_BUCKET, along with DB config.. (DB_PASS=$DB_PASS)"
gcloud --project "$PROJECT_ID" functions deploy php_amarcord_generate_caption \
--runtime python310 \
--region "$GCP_REGION" \
--trigger-event google.cloud.storage.object.v1.finalized \
--trigger-resource "$BUCKET" \
--set-env-vars "DB_HOST=$DB_HOST,DB_NAME=$DB_NAME,DB_PASS=$DB_PASS,DB_USER=$DB_USER" \
--source . \
--entry-point generate_caption \
--gen2
ملاحظة: في هذا المثال، ستكون generate_caption هي الطريقة التي يتم استدعاؤها، وستمرّر Cloud Function حدث GCS إليها مع جميع المعلومات ذات الصلة (اسم الحزمة واسم العنصر وما إلى ذلك). يُرجى تخصيص بعض الوقت لتصحيح أخطاء قاموس Python الخاص بهذا الحدث.
اختبار الدالة
اختبارات الوحدات
تتضمّن الدالة العديد من الأجزاء المتحركة. قد ترغب في أن تكون قادرًا على اختبار كل منها على حدة.
يمكنك الاطّلاع على مثال في gcf/test.py.
واجهة مستخدم Cloud Functions
خصِّص أيضًا بعض الوقت لاستكشاف الدالة في واجهة المستخدم. يجب استكشاف كل علامة تبويب، لا سيما Source (المفضّلة لديّ) وVariables وTrigger وLogs. ستقضي الكثير من الوقت في Logs لتحديد الأخطاء وحلّها (يمكنك أيضًا الاطّلاع على الأخطاء المحتملة في أسفل هذه الصفحة). تأكَّد أيضًا من مراجعة Permissions.

اختبار E2E
حان الوقت لاختبار الدالة يدويًا.
- انتقِل إلى تطبيقك وسجِّل الدخول
- حمِّل صورة (ليست كبيرة جدًا، فقد واجهنا مشاكل في الصور الكبيرة)
- تحقَّق من واجهة المستخدم للتأكّد من تحميل الصورة.
- تحقَّق من Cloud SQL Studio من أنّه تم تعديل الوصف. سجِّل الدخول وشغِّل طلب البحث التالي:
SELECT * FROM images.

وهذا ينجح! قد نريد أيضًا تعديل الواجهة الأمامية لعرض هذا الوصف.
تعديل PHP لعرض [اختياري]
لقد أثبتنا أنّ التطبيق يعمل. ومع ذلك، سيكون من الجيد أن يتمكن المستخدمون أيضًا من رؤية هذا الوصف.
لا نحتاج إلى أن نكون خبراء في PHP لإضافة الوصف إلى index.php. من المفترض أن ينفّذ هذا الرمز ما يلي (نعم، كتبه Gemini لي أيضًا):
<?php if (!empty($image['description'])): ?>
<p class="font-bold">Gemini Caption:</p>
<p class="italic"><?php echo $image['description']; ?></p>
<?php endif; ?>
ضَع هذا الرمز داخل foreach حسب ذوقك.
في الخطوات التالية، سنرى أيضًا إصدارًا أكثر جاذبية لواجهة المستخدم، بفضل Gemini Code Assist. قد تبدو النسخة المنسَّقة على النحو التالي:

الخاتمة
لديك دالة Cloud Function يتم تشغيلها على العناصر الجديدة التي تصل إلى GCS، وهي قادرة على إضافة تعليقات توضيحية إلى محتوى الصورة كما يفعل الإنسان، وتعديل قاعدة البيانات تلقائيًا. رائع!
ما هي الخطوات التالية؟ يمكنك اتّباع المنطق نفسه لتحقيق وظيفتَين رائعتَين.
[optional] Add further Cloud Functions [open ended]
تتبادر إلى الذهن بعض الميزات الإضافية.
📩 Email Trigger
مشغّل بريد إلكتروني يرسل إليك رسالة إلكترونية في كل مرة يرسل فيها مستخدم صورة
- هل يتم عرضها كثيرًا؟ أضِف قيدًا آخر: صورة كبيرة أو صورة يحتوي محتوى Gemini الخاص بها على الكلمات "عُري/عُري/عنيف".
- ننصحك بالتحقّق من
EventArcلمعرفة السبب.
🚫 الإشراف التلقائي على الصور غير الملائمة
في الوقت الحالي، يبلّغ مشرف بشري عن الصور "غير الملائمة". ما رأيك في أن يتولّى Gemini المهام الصعبة والإشراف على المساحة؟ أضِف اختبارًا للإبلاغ عن المحتوى غير الملائم الذي يؤدي إلى ظهور الإشعارات وعدِّل قاعدة البيانات كما تعلّمنا في الدالة السابقة. يعني هذا بشكل أساسي استخدام الدالة السابقة وتغيير الطلب وتعديل قاعدة البيانات استنادًا إلى الإجابة.
تنبيه: يقدّم الذكاء الاصطناعي التوليدي نتائج غير متوقّعة. تأكَّد من أنّ "النتائج الإبداعية" من Gemini "مقيَّدة". يمكنك طلب إجابة حتمية، مثل درجة ثقة من 0 إلى 1، أو ملف JSON، أو غير ذلك. ويمكنك تحقيق ذلك بعدة طرق، على سبيل المثال: * استخدام مكتبات Python، مثل pydantic وlangchain وغيرهما * استخدام النتائج المنظَّمة في Gemini
ملاحظة: يمكنك استخدام دوال متعددة أو طلب واحد يفرض إجابة JSON (يعمل بشكل رائع مع "مخرجات Gemini المنظَّمة" كما هو موضّح أعلاه) مثل:
ما هو الطلب الذي يجب إدخاله لإنشاء هذا المحتوى؟
{
"description": "This is the picture of an arrosticino",
"suitable": TRUE
}
يمكنك إضافة حقول إضافية في الطلب للحصول على إحصاءات مثل: هل هناك شيء جيد في هذا المنتج؟ ما الذي لا يعجبك فيه؟ هل تعرف هذا المكان؟ هل هناك نص (أصبحت تقنية التعرّف البصري على الأحرف أسهل من أي وقت مضى):
goods: "يبدو أنّه طعام لذيذ"bads: "يبدو أنّه طعام غير صحي"-
OCR: "Da consumare preferibilmente prima del 10 Novembre 2024" location: "Pescara, Lungomare"
على الرغم من أنّه من الأفضل عادةً أن يكون لديك دالة N لنتائج N، من المفيد جدًا إنشاء دالة واحدة تؤدي 10 مهام. يمكنك الاطّلاع على هذه المقالة التي كتبها "ريكاردو" لمعرفة كيفية إجراء ذلك.
الأخطاء المحتملة (معظمها في "إدارة الهوية وإمكانية الوصول" / الأذونات)
عندما طوّرتُ هذا الحلّ لأول مرة، واجهتُ بعض المشاكل في أذونات "إدارة الهوية وإمكانية الوصول". سأضيفها هنا للتعاطف ولتقديم بعض الأفكار حول كيفية حلها.
خطأ: لا تتوفّر أذونات كافية لحساب الخدمة
- يُرجى العِلم أنّه لتفعيل وظيفة GCF تستمع إلى حزمة GCS، عليك إعداد الأذونات المناسبة لحساب الخدمة الذي تستخدمه للمهمة، كما هو موضّح في الشكل:

قد تحتاج أيضًا إلى تفعيل واجهات برمجة تطبيقات EventArc، والانتظار بضع دقائق قبل أن تصبح متاحة بالكامل.
خطأ: لم يتم العثور على مُستدعي Cloud Run
- هناك تعليق آخر من واجهة المستخدم بشأن منح أذونات GCF (دور Cloud Run Invoker):

يمكن إصلاح هذا الخطأ من خلال تشغيل الأمر في الصورة، وهو مشابه لـ fix-permissions.sh
يمكنك الاطّلاع على وصف لهذه المشكلة هنا: https://cloud.google.com/functions/docs/securing/authenticating
خطأ: تم تجاوز الحدّ الأقصى للذاكرة
في المرة الأولى التي شغّلتُ فيها الرمز، ظهرت لي رسالة في السجلّات: "تم تجاوز الحدّ الأقصى للذاكرة البالغ 244 ميغابايت، حيث تم استخدام 270 ميغابايت. ننصحك بزيادة الحدّ الأقصى للذاكرة، راجِع https://cloud.google.com/functions/docs/configuring/memory'". مرة أخرى، أضِف ذاكرة الوصول العشوائي إلى GCF. يمكن إجراء ذلك بسهولة في واجهة المستخدم. إليك مشكلة محتملة:

بدلاً من ذلك، يمكنك أيضًا إصلاح نص نشر Cloud Run لزيادة الذاكرة أو وحدة المعالجة المركزية. يستغرق هذا الإجراء وقتًا أطول.
خطأ: تم نشر PubSub
أدّى إنشاء مشغّل باستخدام الإصدار 1 من GCF إلى ظهور هذا الخطأ مرة واحدة:

يمكن حلّ هذه المشكلة بسهولة من خلال الانتقال إلى إدارة الهوية وإمكانية الوصول ومنح حساب الخدمة دور "ناشر Pub/Sub".
خطأ: لم يتم استخدام Vertex AI
إذا ظهرت لك رسالة الخطأ هذه:
Permission Denied: 403 Vertex AI API has not been used in project YOUR_PROJECT before or it is disabled. يمكنك تفعيلها من خلال الانتقال إلى https://console.developers.google.com/apis/api/aiplatform.googleapis.com/overview?project=YOR_PROJECT
ما عليك سوى تفعيل واجهات برمجة تطبيقات Vertex AI. أسهل طريقة لتفعيل جميع واجهات برمجة التطبيقات المطلوبة هي:
- https://console.cloud.google.com/vertex-ai
- انقر على "تفعيل جميع واجهات برمجة التطبيقات المقترَحة".

خطأ: لم يتم العثور على مشغّل EventArc.
إذا ظهرت لك هذه الرسالة، يُرجى إعادة نشر الدالة.

الخطأ: 400 يتم توفير وكلاء الخدمة
400 يتم توفير وكلاء الخدمة ( https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents ). وكلاء الخدمة مطلوبون لقراءة ملف Cloud Storage المقدَّم. لذا يُرجى إعادة المحاولة بعد بضع دقائق.
في هذه الحالة، يُرجى الانتظار لبعض الوقت أو التواصل مع موظف في Google.
10. الوحدة 8: إنشاء أهداف مستوى الخدمة (SLO) الخاصة بالتوفّر
في هذا الفصل، نحاول تحقيق ما يلي:
- إنشاء مؤشرات مستوى الخدمة
- إنشاء أهداف مستوى الخدمة استنادًا إلى مؤشرات مستوى الخدمة
- إنشاء تنبيهات استنادًا إلى أهداف مستوى الخدمة

هذا الموضوع مهم جدًا للمؤلف، لأنّ ريكاردو يعمل في مجال هندسة موثوقية الموقع (SRE) / عمليات DevOps في Google Cloud.
(سؤال مفتوح) أنشئ مؤشرات مستوى الخدمة وأهداف مستوى الخدمة لهذا التطبيق
ما فائدة التطبيق إذا لم تتمكّن من معرفة وقت تعطّله؟
ما هو هدف مستوى الخدمة؟
هذا أمر شاق. ابتكرت Google أهداف مستوى الخدمة (SLO). لمزيد من المعلومات حول هذا الموضوع، يمكنني اقتراح ما يلي:
- كتاب SRE - الفصل 2 - تنفيذ أهداف مستوى الخدمة ( 👉 المزيد من كتب هندسة موثوقية المواقع)
- Art of SLOs ( فيديو رائع). إنّه تدريب رائع لمعرفة المزيد حول كيفية صياغة هدف مستوى خدمة مثالي لخدمتك.
- دورة هندسة موثوقية الموقع (SRE) على Coursera لقد ساهمتُ في ذلك.
الخطوة 1: إنشاء مؤشر/هدف مستوى خدمة التوفّر
لنبدأ بأهداف مستوى الخدمة الخاصة بالتوفّر، لأنّها الأسهل وربما الأهم من بين ما تريد قياسه.
لحسن الحظ، تتوفّر في Cloud Run ميزة SLO مدمجة مسبقًا، وذلك بفضل Istio.
بعد أن يصبح تطبيقك على Cloud Run، يصبح من السهل جدًا تحقيق ذلك، ويستغرق الأمر 30 ثانية.
- انتقِل إلى صفحة Cloud Run.
- انقر على تطبيقك أو اختَره.
- انقر على علامة التبويب "
SLOs". - انقر على "+ إنشاء هدف مستوى الخدمة".
- مدى التوفّر: حسب الطلب
- متابعة
- شهر تقويمي واحد / %99
- انقر على "إنشاء هدف مستوى الخدمة".

الخطوة 2: إعداد التنبيهات بشأن هدف مستوى الخدمة هذا
أقترح إنشاء تنبيهَين:
- أحدهما بمعدل استهلاك منخفض ("استهلاك بطيء") لتنبيهك عبر البريد الإلكتروني (يحاكي تذكرة ذات أولوية منخفضة).
- الأول بمعدل استهلاك مرتفع ("استهلاك سريع") لتنبيهك عبر رسالة قصيرة SMS (يحاكي طلب دعم ذي أولوية عالية / جهاز نداء)
انتقِل إلى SLO tab السابق.
كرِّر ذلك مرتين:

- انقر على "إنشاء تنبيه بشأن SLO" (الزر 🔔 الذي يحتوي على علامة زائد في الداخل، على اليسار)
- فترة المراجعة وحدّ معدّل الاستنفاد:
- [FAST]. أولاً:
60دقيقة /10مرة - [SLOW]. الثاني:
720دقيقة /2مرة - قناة الإشعارات: انقر على "إدارة قنوات الإشعارات"
- أولاً، "البريد الإلكتروني" -> إضافة جديد -> ..
- ثانيًا، "رسالة قصيرة" -> إضافة رقم جديد -> إثبات الملكية على الهاتف.
- ملاحظة: أحب استخدام الإيموجي في الأسماء. إنّها ممتعة للعروض التوضيحية.
- عند الانتهاء، انقر على علامة X الكبيرة في أعلى يسار الصفحة.
- اختَر الهاتف أولاً (سريع)، ثم البريد الإلكتروني (بطيء).
- أضِف بعض المستندات النموذجية مثل:
[PHP Amarcord] Riccardo told me to type sudo reboot or to check documentation in http://example.com/playbooks/1.php but I guess he was joking.
هكذا!
النتيجة النهائية
يمكننا اعتبار هذا التمرين منتهيًا بمجرد حصولك على هدف مستوى خدمة واحد عامل + تنبيهين لمدى التوفر، ويتم التنبيه إلى بريدك الإلكتروني وإلى هاتفك.
يمكنك إضافة وقت استجابة (وننصحك بشدة بذلك) أو حتى وقت استجابة أكثر تعقيدًا. بالنسبة إلى وقت الاستجابة، اختَر وقت استجابة تراه معقولاً، وإذا لم تكن متأكدًا، اختَر 200 ملي ثانية.
11. الخطوات التالية
لقد أكملت كل شيء، فما الذي ينقصك؟
إليك بعض الأفكار:
التفاعل مع Gemini
يمكنك استخدام Gemini بطريقتَين:
- Vertex AI: "طريقة Enterprise"، المرتبطة بـ GCP، والتي تناولناها في الفصل 7 (GCF+Gemini). تعمل جميع عمليات المصادقة بشكل سحري، وتترابط الخدمات بشكل جميل.
- ذكاء Google الاصطناعي "طريقة المستهلك" يمكنك الحصول على مفتاح Gemini API من هنا والبدء في إنشاء نصوص برمجية صغيرة يمكن ربطها بأي مهام لديك (عمل خاص، أو خدمات سحابية أخرى، أو مضيف محلي، وما إلى ذلك). ما عليك سوى استبدال مفتاح واجهة برمجة التطبيقات وسيبدأ الرمز في العمل بشكل سحري.
ننصحك بتجربة استكشاف (2) من خلال مشاريعك الشخصية.
UI Lifting
لستُ بارعًا في واجهات المستخدم. لكنّ Gemini يمكنه ذلك. يمكنك استخدام صفحة PHP واحدة، وكتابة ما يلي:
I have a VERY old PHP application. I want to touch it as little as possible. Can you help me:
1. add some nice CSS to it, a single static include for tailwind or similar, whatever you prefer
2. Transform the image print with description into cards, which fit 4 per line in the canvas?
Here's the code:
-----------------------------------
[Paste your PHP page, for instance index.php - mind the token limit!]
يمكنك الحصول على ذلك بسهولة في أقل من 5 دقائق، من خلال Cloud Build. :)
كان ردّ Gemini مثاليًا (أي لم أضطر إلى تغيير أي شيء):

وإليك التنسيق الجديد في تطبيق المؤلف الشخصي:

ملاحظة: يتم لصق الرمز كصورة لأنّنا لا نريد تشجيعك على أخذ الرمز، بل نريد أن يكتب Gemini الرمز نيابةً عنك، مع قيود واجهة المستخدم/الواجهة الأمامية الإبداعية الخاصة بك. صدقني، لن يتبقّى لك سوى تغييرات بسيطة جدًا بعد ذلك.
الأمان
إنّ تأمين هذا التطبيق بشكل صحيح ليس هدفًا لهذه الورشة التي تستغرق 4 ساعات، لأنّ ذلك سيزيد من الوقت اللازم لإكمال هذه الورشة بمقدار مرة أو مرتين.
ومع ذلك، فإن هذا الموضوع مهم للغاية! لقد جمعنا بعض الأفكار في SECURITY.
12. تهانينا!
تهانينا 🎉🎉🎉، لقد نجحت في تحديث تطبيق PHP القديم باستخدام Google Cloud.

باختصار، تعرّفت في هذا الدرس التطبيقي حول الترميز على ما يلي:
- كيفية نشر قاعدة بيانات في Google Cloud SQL وكيفية نقل قاعدة بياناتك الحالية إليها
- كيفية وضع تطبيق PHP في حاوية باستخدام Docker وBuildpacks وتخزين صورته في Google Cloud Artifact Registry
- كيفية نشر تطبيقك ضِمن حاوية على Cloud Run وتشغيله باستخدام Cloud SQL
- كيفية تخزين/استخدام مَعلمات الإعدادات الحساسة (مثل كلمة مرور قاعدة البيانات) بشكل سرّي باستخدام Google Secret Manager
- كيفية إعداد مسارَي التعلّم "الدمج المستمر" (CI) أو "النشر المستمر" (CD) باستخدام Google Cloud Build لإنشاء تطبيق PHP ونشره تلقائيًا عند إرسال أي رمز برمجي إلى مستودع GitHub.
- كيفية استخدام Cloud Storage لتحويل موارد تطبيقك إلى موارد سحابية
- كيفية الاستفادة من تكنولوجيات الحوسبة بدون خادم لإنشاء سير عمل مذهل على Google Cloud بدون لمس رمز تطبيقك
- استخدِم إمكانات Gemini المتعدّدة الوسائط في حالة استخدام مناسبة.
- تطبيق مبادئ هندسة موثوقية المواقع (SRE) في Google Cloud
هذه بداية رائعة لرحلتك في تحديث التطبيقات باستخدام Google Cloud.
🔁 الملاحظات
إذا أردت إخبارنا عن تجربتك في ورشة العمل هذه، يُرجى ملء نموذج استطلاع الآراء والتقييم هذا.
يسرّنا تلقّي ملاحظاتك بالإضافة إلى طلبات السحب لأجزاء من الرموز البرمجية التي تفتخر بها بشكل خاص.
🙏 شكرًا
يودّ المؤلّف أن يشكر ميركو جيليولي وماوريتسيو إيبسالي من Datatonic على المساعدة في كتابة الحلّ واختباره.
