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

सिर्फ़ आउटपुट के लिए. Artifact Registry कंटेनर इमेज का यूआरआई, जिसका इस्तेमाल इस बिल्ड के लिए Cloud Run revision करता है.
source

object (BuildSource)

ज़रूरी है. इम्यूटेबल. बिल्ड का सोर्स.
buildLogsUri

string

सिर्फ़ आउटपुट के लिए. बिल्ड प्रोसेस के लिए Cloud Build के लॉग की जगह.
reconciling

boolean

सिर्फ़ आउटपुट के लिए. फ़ील्ड, जो सही होने पर यह बताता है कि बिल्ड में पहले से एलआरओ मौजूद है.
createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. बिल्ड बनाने का समय.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. बिल्ड को आखिरी बार अपडेट करने का समय.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
deleteTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. बिल्ड मिटाने का समय.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "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 का अतिरिक्त कॉन्फ़िगरेशन.

रनकॉन्फ़िगरेशन

Cloud Run service पर लागू करने के लिए अतिरिक्त कॉन्फ़िगरेशन.

JSON के काेड में दिखाना 
{
  "cpu": number,
  "memoryMib": integer,
  "concurrency": integer,
  "maxInstances": integer,
  "minInstances": integer
}
फ़ील्ड
cpu

number

ज़रूरी नहीं. दिखाए जाने वाले हर इंस्टेंस के लिए इस्तेमाल किए गए सीपीयू की संख्या.

डिफ़ॉल्ट रूप से, सीपीयू की वैल्यू Cloud Run की डिफ़ॉल्ट सेटिंग 1.0 पर सेट होती है.

सीपीयू को 1, 2, 4, 6 या 8 सीपीयू पर सेट किया जा सकता है. साथ ही, एक से कम सीपीयू के लिए, 0.08 से 1.00 से कम वैल्यू को 0.01 की बढ़ोतरी के साथ सेट किया जा सकता है.

अगर आपने सीपीयू की वैल्यू को एक से कम पर सेट किया है, तो आपको एक साथ 1 पर सेट करना होगा. इसके अलावा, सीपीयू का इस्तेमाल सिर्फ़ अनुरोध की प्रोसेसिंग के दौरान किया जाएगा.

सीपीयू की सीमा बढ़ाने के लिए, मेमोरी की सीमाओं को बढ़ाना पड़ सकता है:

  • 4 सीपीयू: कम से कम 2 GiB
  • 6 सीपीयू: कम से कम 4 GiB
  • 8 सीपीयू: कम से कम 4 GiB
memoryMib

integer

ज़रूरी नहीं. MiB में दिए गए हर इंस्टेंस के लिए, असाइन की गई मेमोरी.

डिफ़ॉल्ट रूप से, Cloud Run की डिफ़ॉल्ट मेमोरी में हर इंस्टेंस के लिए 512 एमबी मेमोरी होती है.

मेमोरी को 128 से 32768 के बीच के किसी भी पूर्णांक वैल्यू पर सेट किया जा सकता है.

मेमोरी सीमा को बढ़ाने के लिए सीपीयू की सीमाओं को बढ़ाना पड़ सकता है:

  • 4 GiB से ज़्यादा: कम से कम 2 सीपीयू
  • 8 GiB से ज़्यादा: कम से कम 4 सीपीयू
  • 16 से ज़्यादा GiB: कम से कम 6 सीपीयू
  • 24 GiB से ज़्यादा: कम से कम 8 सीपीयू
concurrency

integer

ज़रूरी नहीं. हर Cloud Run इंस्टेंस पर मिलने वाले अनुरोधों की ज़्यादा से ज़्यादा संख्या.

डिफ़ॉल्ट रूप से, हर इंस्टेंस पर Cloud Run की डिफ़ॉल्ट सेटिंग में, एक ही समय पर ज़्यादा से ज़्यादा 80 अनुरोध मिल सकते हैं.

कॉन करंसी को ज़्यादा से ज़्यादा 1,000 पूर्णांक पर सेट किया जा सकता है.
maxInstances

integer

ज़रूरी नहीं. हर बदलाव के लिए, Cloud Run इंस्टेंस की ज़्यादा से ज़्यादा संख्या.

डिफ़ॉल्ट रूप से, Cloud Run service के हर विकल्प को Cloud Run की डिफ़ॉल्ट सेटिंग के तौर पर, ज़्यादा से ज़्यादा 100 इंस्टेंस के हिसाब से स्केल किया जाता है. ज़्यादा से ज़्यादा इंस्टेंस की सीमा, आपके कोटा के हिसाब से तय होती है. https://cloud.google.com/run/docs/configging/max-instances#limits पर जाएं.
minInstances

integer

ज़रूरी नहीं. हर Cloud Run सेवा के लिए, कम से कम Cloud Run इंस्टेंस की संख्या बनाए रखना ज़रूरी है.

डिफ़ॉल्ट रूप से, कोई कम से कम सीमा तय नहीं होती है.

अगर सेवा, ट्रैफ़िक को कई बदलावों के हिसाब से बांटती है, तब भी किसी सेवा के लिए इंस्टेंस की कुल संख्या इस वैल्यू पर ही सीमित होगी.

बिल्डसोर्स

बिल्ड का सोर्स.

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 कंटेनर की इमेज का सोर्स.

कोड बेस सोर्स

कोड बेस सोर्स, कोड बेस की उस स्थिति को दिखाता है जहां बिल्ड बनाया जाएगा.

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

सिर्फ़ आउटपुट के लिए. बिल्ड दिखाते समय इस कोडबेस के लिए इस्तेमाल किया जाने वाला आसान नाम. हम GitHub.com के लिए, SHA-1 हैश के पहले आठ वर्णों का इस्तेमाल करते हैं.
hash

string

सिर्फ़ आउटपुट के लिए. किसी Git कमिट का पूरा SHA-1 हैश, अगर उपलब्ध हो.
commitMessage

string

सिर्फ़ आउटपुट के लिए. कोड बेस बदलने का मैसेज.
uri

string

सिर्फ़ आउटपुट के लिए. यूआरआई, जो सर्वर देने वाली संस्था की वेबसाइट पर कोड बेस से लिंक करता है. ऐसा हो सकता है कि लिंक किए गए डेटा स्टोर करने की जगह में, किए गए बदलाव को फिर से लागू करने या अनइंस्टॉल न किए जा सकने वाले बदलाव के लिए, मान्य न हो.
author

object (UserMetadata)

सिर्फ़ आउटपुट के लिए. वर्शन कंट्रोल में बदलाव के मेटाडेटा में शामिल लेखक.
commitTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. बदलाव करने का समय.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "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 से ज़रूरी.
email

string

सिर्फ़ आउटपुट के लिए. 'email' अगर उपलब्ध हो, तो Git उपयोगकर्ता के git.config में फ़ील्ड को डालें.
imageUri

string

सिर्फ़ आउटपुट के लिए. अगर उपलब्ध हो, तो बाहरी सोर्स कंट्रोल प्रोवाइडर में मौजूद उपयोगकर्ता के खाते से जुड़ी इमेज फ़ाइल का यूआरआई.

कंटेनरसोर्स

बिल्ड सोर्स के तौर पर इस्तेमाल करने के लिए, Artifact Registry की कंटेनर इमेज का यूआरआई.

JSON के काेड में दिखाना 
{
  "image": string
}
फ़ील्ड
image

string

ज़रूरी है. यूआरआई, जो बैकएंड के इस्तेमाल के लिए एक कंटेनर दिखाता है.

तरीके

create

 बैकएंड के लिए एक नया बिल्ड बनाता है.

delete

 एक बिल्ड को मिटाता है.

get

 बिल्ड के बारे में जानकारी मिलती है.

list

 सूचियां किसी दिए गए प्रोजेक्ट, जगह, और बैकएंड में बनाई जाती हैं.