REST Resource: projects.locations.backends.builds

المرجع: إنشاء

يشير ذلك المصطلح إلى إصدار واحد لخلفية مع علامة مرجعية محدّدة لقاعدة رموز نقطة ونقطة زمنية معيّنة. يتضمّن هذا القسم موارد متعددة، بما في ذلك صورة حاوية Artifact Registry واستدعاء Cloud Build الذي ينشئ الصورة، ونسخة Cloud Run التي تستخدم هذه الصورة.

تمثيل JSON 
{
  "name": string,
  "displayName": string,
  "state": enum (State),
  "error": {
    object (Status)
  },
  "environment": string,
  "config": {
    object (Config)
  },
  "image": string,
  "source": {
    object (BuildSource)
  },
  "buildLogsUri": string,
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string
}
الحقول
name

string

المُعرّف. اسم مورد الإصدار.

طبيعة الحضور:

projects/{project}/locations/{locationId}/backends/{backendId}/builds/{buildId}.
displayName

string

هذه السمة اختيارية. اسم يمكن للمستخدمين قراءته عدد الأحرف المسموح به هو 63 حرفًا
state

enum (State)

النتائج فقط. تمثّل هذه السمة حالة الإصدار.
error

object (Status)

النتائج فقط. تشير هذه السمة إلى حالة ورسالة خطأ (يمكن للمستخدمين قراءتها) بشأن الإصدار، إذا كانت في حالة FAILED.
environment

string

النتائج فقط. اسم البيئة الخلفية عند إنشاء هذا الإصدار
config

object (Config)

هذه السمة اختيارية. الإعداد الإضافي للخدمة.
image

string

النتائج فقط. معرّف الموارد المنتظم (URI) لصورة حاوية Artifact Registry، والذي تستخدمه أداة Cloud Run revision في هذا الإصدار
source

object (BuildSource)

مطلوب. غير قابل للتغيير. تمثّل هذه السمة مصدر التصميم.
buildLogsUri

string

النتائج فقط. موقع سجلّات Cloud Build لعملية الإنشاء
reconciling

boolean

النتائج فقط. يشير ذلك المصطلح، إذا كانت القيمة إلى "صحيح"، إلى أنّ الإصدار يتضمّن مهمة LRO جارية.
createTime

string (Timestamp format)

النتائج فقط. وقت إنشاء التصميم

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

النتائج فقط. وقت آخر تحديث للإصدار

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
deleteTime

string (Timestamp format)

النتائج فقط. وقت حذف التصميم

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
labels

map (key: string, value: string)

هذه السمة اختيارية. خريطة غير منظَّمة للقيم الرئيسية يمكن استخدامها لتنظيم العناصر وتصنيفها

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
annotations

map (key: string, value: string)

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

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
uid

string

النتائج فقط. معرّف فريد يحدّده النظام
etag

string

النتائج فقط. المجموع الاختباري الذي احتسبه الخادم استنادًا إلى قيم أخرى عند التحديث أو الحذف لضمان إتمام العملية في المورد المتوقع.

الولاية

تمثّل هذه السمة حالة الإصدار.

تعدادات
STATE_UNSPECIFIED حالة الإصدار غير معروفة.
BUILDING البناء قيد الإنشاء.
BUILT اكتمل الإصدار وبانتظار الخطوة التالية. قد ينتقل ذلك إلى "DEPLOYING" بعد بدء "استضافة التطبيق" في إعداد البنية الأساسية.
DEPLOYING يتم الآن إعداد البنية الأساسية لهذا الإصدار.
READY البنية الأساسية لهذا الإصدار جاهزة. قد يعرض هذا الإصدار زيارات أو لا يعرضه. يمكنك الانتقال إلى Backend.traffic للاطّلاع على الحالة الحالية أو Backend.traffic_statuses لمعرفة الحالة المطلوبة.
FAILED تعذّر الإصدار.

الإعداد

الإعدادات الإضافية للواجهة الخلفية لهذا الإصدار

تمثيل JSON 
{
  "runConfig": {
    object (RunConfig)
  }
}
الحقول
runConfig

object (RunConfig)

هذه السمة اختيارية. الإعدادات الإضافية لـ Cloud Run service

تشغيل الإعداد

سيتم تطبيق الإعدادات الإضافية على رمز التشغيل في السحابة الإلكترونية service.

تمثيل JSON 
{
  "cpu": number,
  "memoryMib": integer,
  "concurrency": integer,
  "maxInstances": integer,
  "minInstances": integer
}
الحقول
cpu

number

هذه السمة اختيارية. عدد وحدات المعالجة المركزية المستخدَمة لكل مثيل عرض.

بشكل تلقائي، يتم ضبط وحدة المعالجة المركزية (CPU) على الإعداد التلقائي 1.0 في Cloud Run.

يمكن ضبط وحدة المعالجة المركزية على القيمة 1 أو 2 أو 4 أو 6 أو 8 وحدات معالجة مركزية (CPU)، وإذا كانت أقل من وحدة معالجة مركزية واحدة، يمكن ضبط القيمة من 0.08 إلى أقل من 1.00 بزيادات 0.01.

في حال ضبط قيمة أقل من وحدة معالجة مركزية واحدة، يجب ضبط التزامن على 1، ولن يتم تخصيص وحدة المعالجة المركزية (CPU) إلا أثناء معالجة الطلب.

قد تؤدي زيادة حد وحدات المعالجة المركزية (CPU) إلى زيادة حدود الذاكرة:

  • 4 وحدات معالجة مركزية (CPU): سعة 2 غيبي بايت على الأقل
  • 6 وحدات معالجة مركزية (CPU): سعة 4 غيبي بايت على الأقل
  • 8 وحدات معالجة مركزية (CPU): سعة 4 غيبي بايت على الأقل
memoryMib

integer

هذه السمة اختيارية. مقدار الذاكرة المخصّصة لكل مثيل عرض بالميبي بايت.

يتم ضبط الذاكرة تلقائيًا على الإعداد التلقائي في Cloud Run حيث يتم تخصيص 512 مبيبايت من الذاكرة لكل مثيل.

يمكن ضبط الذاكرة على أي قيمة عددية تتراوح بين 128 و32768.

قد تتطلب زيادة حد الذاكرة زيادة في حدود وحدات المعالجة المركزية (CPU):

  • أكثر من 4 غيبي بايت: وحدتا معالجة مركزية (CPU) على الأقل
  • أكثر من 8 غيبي بايت: يجب استخدام 4 وحدات معالجة مركزية (CPU) على الأقل
  • أكثر من 16 غيبي بايت: 6 وحدات معالجة مركزية (CPU) على الأقل
  • أكثر من 24 غيبي بايت: يجب استخدام 8 وحدات معالجة مركزية (CPU) على الأقل
concurrency

integer

هذه السمة اختيارية. الحد الأقصى لعدد الطلبات التي يمكن أن يتلقّاها كل مثيل من Cloud Run

بشكل تلقائي، يمكن أن يتلقّى كل مثيل Cloud Run التلقائي ما يصل إلى 80 طلبًا في الوقت نفسه.

يمكن ضبط التزامن على أي قيمة عددية تصل إلى 1000.
maxInstances

integer

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

بشكل تلقائي، يتم توسيع كل تشغيل في السحابة الإلكترونية service وفقًا للإعدادات التلقائية في Cloud Run، وهي 100 نسخة افتراضية كحدّ أقصى. يعتمد الحد الأقصى لـ maxInstances على حصتك. يُرجى الاطّلاع على https://cloud.google.com/run/docs/configring/max-instances#limits.
minInstances

integer

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

بشكل افتراضي، لا يوجد حد أدنى.

وحتى إذا كانت الخدمة تقسم عدد الزيارات على عدة مراجعات، سيتم تقييد إجمالي عدد النُسخ الخاصة بالخدمة بهذه القيمة.

مصدر الإصدار

تمثّل هذه السمة مصدر التصميم.

تمثيل JSON 
{

  // Union field source can be only one of the following:
  "codebase": {
    object (CodebaseSource)
  },
  "container": {
    object (ContainerSource)
  }
  // End of list of possible types for union field source.
}
الحقول
حقل الاتحاد source. مصدر الإدخال الخاص بالإصدار عادةً ما تشير إلى إتمام عملية في مستودع المصدر. قد يشير أيضًا إلى صورة حاوية. يمكن أن يكون source واحدًا فقط مما يلي:
codebase

object (CodebaseSource)

مصدر قاعدة رموز برمجية.
container

object (ContainerSource)

مصدر صورة حاوية Artifact Registry

مصدر CodebaseSource

مصدر قاعدة رموز برمجية يمثّل حالة قاعدة الرموز التي سيتم إنشاء الإصدار فيها.

تمثيل JSON 
{
  "displayName": string,
  "hash": string,
  "commitMessage": string,
  "uri": string,
  "author": {
    object (UserMetadata)
  },
  "commitTime": string,

  // Union field reference can be only one of the following:
  "branch": string,
  "commit": string
  // End of list of possible types for union field reference.
}
الحقول
displayName

string

النتائج فقط. تمثّل هذه السمة الاسم المناسب للمستخدمين والمطلوب استخدامه لقاعدة الرموز هذه عند عرض أحد الإصدارات. نستخدم أول ثمانية أحرف من تجزئة SHA-1 لـ GitHub.com.
hash

string

النتائج فقط. تجزئة SHA-1 الكاملة لعملية Git Commit، إذا توفّرت.
commitMessage

string

النتائج فقط. رسالة تغيير قاعدة الرموز
uri

string

النتائج فقط. معرّف موارد منتظم (URI) يربط بقاعدة الرموز على الموقع الإلكتروني للمستضيف. قد لا يكون هذا الإجراء صالحًا إذا تمت إعادة تأسيس الإجراء أو خروجه من الخدمة في المستودع المرتبط.
author

object (UserMetadata)

النتائج فقط. تم تضمين المؤلف في البيانات الوصفية لتغيير التحكم في الإصدار.
commitTime

string (Timestamp format)

النتائج فقط. وقت إجراء التغيير.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

حقل الاتحاد reference.

يمكن أن يكون reference واحدًا فقط مما يلي:
branch

string

الفرع في قاعدة الرموز البرمجية التي سيتم الإنشاء منه، باستخدام أحدث خطة اشتراك.
commit

string

الالتزام في قاعدة التعليمات البرمجية للإنشاء منها

UserMetadata

البيانات الوصفية للتحكّم في الإصدار لمستخدم مرتبط بقاعدة رموز تم حلها. يفترض حاليًا أن يكون أحد مستخدمي Git.

تمثيل JSON 
{
  "displayName": string,
  "email": string,
  "imageUri": string
}
الحقول
displayName

string

النتائج فقط. 'الاسم' في git.config لمستخدم Git. مطلوب بواسطة Git.
email

string

النتائج فقط. و"البريد الإلكتروني" في git.config لمستخدم Git، إذا كان ذلك متاحًا.
imageUri

string

النتائج فقط. معرّف الموارد المنتظم (URI) الخاص بملف صورة مرتبط بحساب المستخدم في موفِّر عنصر تحكّم خارجي، إذا كان متاحًا

ContainerSource

معرّف الموارد المنتظم (URI) لصورة حاوية Artifact Registry المراد استخدامها كمصدر الإصدار

تمثيل JSON 
{
  "image": string
}
الحقول
image

string

مطلوب. معرّف موارد منتظم (URI) يمثّل حاوية للخلفية التي تريد استخدامها.

الطُرق

create

 ينشئ إصدارًا جديدًا للواجهة الخلفية.

delete

 يؤدي هذا الإجراء إلى حذف إصدار واحد.

get

 الحصول على معلومات حول الإصدار

list

 يتم إنشاء القوائم في مشروع وموقع وخلفية معينة.