1. نظرة عامة
من خلال هذه الدراسة التطبيقية حول الترميز، سنوضّح طريقة بسيطة وسهلة لإعداد AlloyDB.

ما ستنشئه
وكجزء من ذلك، ستنشئ مثيلاً ومجموعة من AlloyDB مع جميع إعدادات الشبكة المطلوبة من خلال عملية تثبيت بنقرة واحدة، وستتعلّم كيفية إعدادها بسرعة في مشاريعك المستقبلية أيضًا.
المتطلبات
2. قبل البدء
إنشاء مشروع
- في Google Cloud Console، في صفحة اختيار المشروع، اختَر أو أنشِئ مشروعًا على Google Cloud.
- تأكَّد من تفعيل الفوترة لمشروعك على السحابة الإلكترونية. كيفية التحقّق من تفعيل الفوترة في مشروع
تفعيل Cloud Shell
- ستستخدم Cloud Shell، وهي بيئة سطر أوامر تعمل في Google Cloud. انقر على "تفعيل Cloud Shell" في أعلى "وحدة تحكّم Google Cloud".

- بعد الاتصال بـ Cloud Shell، يمكنك التأكّد من أنّك قد تم التحقّق من هويتك وأنّه تم ضبط المشروع على رقم تعريف مشروعك باستخدام الأمر التالي:
gcloud auth list
- إذا لم يتم إثبات الهوية، شغِّل الأمر التالي:
gcloud auth login
- نفِّذ الأمر التالي في Cloud Shell للتأكّد من أنّ أمر gcloud يعرف مشروعك.
gcloud config list project
- إذا لم يتم ضبط مشروعك، استخدِم الأمر التالي لضبطه:
gcloud config set project <YOUR_PROJECT_ID>
تفعيل واجهات برمجة التطبيقات ومنح الأذونات
- فعِّل واجهات برمجة التطبيقات المطلوبة:
اتّبِع الرابط وفعِّل واجهات برمجة التطبيقات.
بدلاً من ذلك، يمكنك استخدام أمر gcloud لهذا الغرض. راجِع المستندات لمعرفة أوامر gcloud وطريقة استخدامها.
- منح الأدوار المطلوبة لإنشاء مثيل AlloyDB وإعداده
إذا كنت في بيئة التطوير الخاصة بك أو كان لديك إذن الوصول إلى المشروع بصفتك المالك أو المشرف، لن تحتاج إلى تنفيذ هذه الخطوة، لأنّ حسابك الأساسي (بصفتك المالك) سيكون لديه هذه الأذونات. إذا لم يكن الأمر كذلك، اتّبِع هذه الخطوة.
للحصول على الأذونات اللازمة لإنشاء قاعدة بيانات AlloyDB والاتصال بها، عليك منح أدوار "إدارة الهوية وإمكانية الوصول" التالية في مشروعك:
- مشرف شبكة Cloud Compute (
roles/compute.networkAdmin) - AlloyDB Admin (
roles/alloydb.admin)
في ما يلي الأذونات المطلوبة بالضبط وراء الكواليس لإنشاء قاعدة بيانات AlloyDB والاتصال بها:
- compute.networks.list
- compute.networks.addPeering
- compute.addresses.create
- servicenetworking.services.addPeering
- Alloydb.clusters.create
- Alloydb.instances.create
- Alloydb.instances.login
حسنًا، لننتقل الآن إلى عملية الإعداد.
3- إعداد AlloyDB
لننشئ مجموعة ومثيل AlloyDB مع إعدادات الشبكة.
- نفِّذ الأوامر التالية من "وحدة Google Cloud Shell الطرفية" لاستنساخ المستودع في دليل الجذر والانتقال إلى مجلد المشروع المستنسخ:
# 1. Clone the repository
git clone https://github.com/GoogleCloudPlatform/devrel-demos.git
# 2. Navigate to the project directory
cd devrel-demos/infrastructure/easy-alloydb-setup
- بعد إكمال هذه الخطوة، سيتم استنساخ المستودع إلى محرّر Cloud Shell المحلي، وستتمكّن من تنفيذ الأمر أدناه من داخل مجلد المشروع (من المهم التأكّد من أنّك في دليل المشروع):
sh run.sh
- استخدِم الآن واجهة المستخدم (يمكنك العثور على الرابط في سجلات الجهاز الطرفي، أو يمكنك النقر عليه أو الانتقال إليه من خلال النقر على الرابط "معاينة على الويب" في الجهاز الطرفي).
- أدخِل تفاصيل معرّف المشروع واسمَي المجموعة والآلة الافتراضية لبدء الاستخدام.

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