التحقّق من صحة الإعداد

يساعدك هذا الدليل في التأكّد من اكتمال إعداد تفويض Fleet Engine، وأنّه يمكنك إنشاء مركبة تجريبية. يستخدم هذا الدليل الأداة المساعدة لسطر الأوامر gcloud لاختبار توقيع رمز التفويض وإنشاء المركبة.

لإكمال هذه العملية، اتّبِع الخطوات التالية:

1. استبدِل الحقول أدناه بالبيانات التي أنشأتها كجزء من عملية الإعداد:

الحقل	الاستبدال بـ
PROJECT_ID	رقم تعريف مشروعك على السحابة الإلكترونية
SERVICE_ACCOUNT_EMAIL_ADDRESS	عنوان البريد الإلكتروني لحساب الخدمة الذي أنشأته باستخدام دور المشرف لمعرفة التفاصيل، يُرجى الاطّلاع على أدوار حساب خدمة التنقّل.
VEHICLE_ID أو DELIVERY_VEHICLE_ID	رقم تعريف عشوائي للمركبة يمكن أن يحتوي المعرّف على 64 حرفًا كحدّ أقصى.

1. استخدِم الأداة المساعدة gcloud لتسجيل الدخول إلى حساب Google Cloud وضبط المشروع النشط على محطة العمل:

   gcloud auth login
   gcloud config set project PROJECT_ID
   

2. أنشئ مطالبة برمز JSON مميّز للويب (JWT) لإنشاء المركبة:

   الرحلات عند الطلب

       cat > claim.jwt << EOM
       {
         "iss": "SERVICE_ACCOUNT_EMAIL_ADDRESS",
         "sub": "SERVICE_ACCOUNT_EMAIL_ADDRESS",
         "aud": "https://fleetengine.googleapis.com/",
         "iat": $(date +%s),
         "exp": $((`date +%s` + 3600)),
         "authorization": {
           "vehicleid": "VEHICLE_ID"
         }
       }
       EOM
       

   المهام المجدوَلة

       cat > claim.jwt << EOM
       {
         "iss": "SERVICE_ACCOUNT_EMAIL_ADDRESS",
         "sub": "SERVICE_ACCOUNT_EMAIL_ADDRESS",
         "aud": "https://fleetengine.googleapis.com/",
         "iat": $(date +%s),
         "exp": $((`date +%s` + 3600)),
         "authorization": {
           "deliveryvehicleid": "DELIVERY_VEHICLE_ID"
         }
       }
       EOM
       

3. استخدِم gcloud لتوقيع رمز JWT هذا باستخدام أذونات "إدارة الهوية وإمكانية الوصول" المناسبة. :

   gcloud iam service-accounts sign-jwt claim.jwt output.jwt \
     --iam-account=SERVICE_ACCOUNT_EMAIL_ADDRESS
   

   يتم تخزين رمز JWT الموقَّع في output.jwt.

   لمعرفة التفاصيل، يُرجى الاطّلاع على منح الأذونات المطلوبة ودليل سطر أوامر gcloud في مستندات Google Cloud.

4. استخدِم curl لإنشاء مركبة اختبارية في Fleet Engine:

   الرحلات عند الطلب

       curl -X POST "https://fleetengine.googleapis.com/v1/providers/PROJECT_ID/vehicles?vehicleId=VEHICLE_ID" \
         -H "Content-type: application/json" \
         -H "Authorization: Bearer $(cat output.jwt)" \
         --data-binary @- << EOM
       {
         "name": "providers/PROJECT_ID/vehicles/VEHICLE_ID"
       }
       EOM
       {
         "vehicleState": "OFFLINE",
         "supportedTripTypes": ["EXCLUSIVE"],
         "maximumCapacity": 4,
         "vehicleType": {"category": "AUTO"},
         "attributes": [{"key": "on_trip", "value": "false"}]
       }
       

   من المفترض أن يعرض هذا الأمر اسم المركبة كنتيجة. إذا ظهر لك النص التالي، يعني ذلك أنّ عملية الإعداد قد نجحت.

       {
         "name": "providers/PROJECT_ID/vehicles/VEHICLE_ID"
       }
       

   المهام المجدوَلة

       curl -X POST "https://fleetengine.googleapis.com/v1/providers/PROJECT_ID/deliveryVehicles?deliveryVehicleId=DELIVERY_VEHICLE_ID" \
         -H "Content-type: application/json" \
         -H "Authorization: Bearer $(cat output.jwt)" \
         --data-binary @- << EOM
       {
         "name": "providers/PROJECT_ID/deliveryVehicles/DELIVERY_VEHICLE_ID"
       }
       EOM
       

   من المفترض أن يطبع هذا الأمر اسم مركبة التسليم كنتيجة. إذا ظهر لك النص التالي، يعني ذلك أنّ عملية الإعداد قد نجحت.

       {
         "name": "providers/PROJECT_ID/deliveryVehicles/DELIVERY_VEHICLE_ID"
       }
       

   ملاحظة: يزيل Fleet Engine تلقائيًا جميع العناصر (بما في ذلك المركبات) بعد 7 أيام من عدم النشاط، مثل التعديلات.

الخطوات التالية

• تحديد المشاكل الشائعة وحلّها
• إنشاء المركبات واستخدامها