REST Resource: projects.locations.backends.builds

Kaynak: Derleme

Belirli bir nokta kod tabanı referans etiketi ve zaman noktasında, arka uç için tek bir derleme. Artifact Registry container görüntüsü, görüntüyü derleyen bir Cloud Build çağrısı ve bu görüntüyü kullanan Cloud Run düzeltmesi gibi çeşitli kaynakları kapsüller.

JSON gösterimi 
{
  "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
}
Alanlar
name

string

Tanımlayıcı. Derlemenin kaynak adı.

Biçim:

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

string

İsteğe bağlı. İnsanlar tarafından okunabilir ad. 63 karakterle sınırlıdır.
state

enum (State)

Yalnızca çıkış. Derlemenin durumu.
error

object (Status)

Yalnızca çıkış. FAILED durumundaysa derleme için durum ve (insan tarafından okunabilir) hata mesajı.
environment

string

Yalnızca çıkış. Bu derleme oluşturulurken arka ucun ortam adı.
config

object (Config)

İsteğe bağlı. Hizmetin ek yapılandırması.
image

string

Yalnızca çıkış. Bu derleme için Cloud Run revision tarafından kullanılan Artifact Registry kapsayıcı görüntüsü URI'si.
source

object (BuildSource)

Zorunlu. Sabit. Derlemenin kaynağı.
buildLogsUri

string

Yalnızca çıkış. Derleme işlemi için Cloud Build günlüklerinin konumu.
reconciling

boolean

Yalnızca çıkış. Doğru ise derlemenin devam eden bir LRO'su olduğunu gösteren alan.
createTime

string (Timestamp format)

Yalnızca çıkış. Derlemenin oluşturulduğu zaman.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Yalnızca çıkış. Derlemenin son güncellendiği zaman.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
deleteTime

string (Timestamp format)

Yalnızca çıkış. Derlemenin silindiği saat.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
labels

map (key: string, value: string)

İsteğe bağlı. Nesneleri düzenlemek ve kategorilere ayırmak için kullanılabilecek yapılandırılmamış anahtar/değer eşlemesi.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
annotations

map (key: string, value: string)

İsteğe bağlı. Rastgele meta verileri depolamak için harici araçlar tarafından ayarlanabilecek yapılandırılmamış anahtar/değer eşlemesi. Bu öğeler sorgulanamaz ve nesneler değiştirilirken korunmalıdır.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid

string

Yalnızca çıkış. Sistem tarafından atanmış, benzersiz tanımlayıcı.
etag

string

Yalnızca çıkış. Diğer değerleri temel alan sunucu tarafından hesaplanan sağlama toplamı; işlemin beklenen kaynak üzerinde yapılmasını sağlamak için güncelleme veya silme sırasında gönderilebilir.

Eyalet

Derlemenin durumu.

Sıralamalar
STATE_UNSPECIFIED Derleme bilinmeyen bir durumda.
BUILDING Yapı oluşturuluyor.
BUILT Derleme tamamlandı ve sonraki adım bekleniyor. Uygulama Barındırma, altyapıyı ayarlamaya başladığında bu durum DEPLOYING (DAĞITIM) bölümüne taşınabilir.
DEPLOYING Bu derlemenin altyapısı oluşturuluyor.
READY Bu derlemenin altyapısı hazır. Derleme trafik sunuyor olabilir veya olmayabilir. Geçerli durum için Backend.traffic, istenen durum için Backend.traffic_statuses adresine bakın.
FAILED Derleme başarısız oldu.

Yapılandırma

Bu derleme için arka ucun ek yapılandırması.

JSON gösterimi 
{
  "runConfig": {
    object (RunConfig)
  }
}
Alanlar
runConfig

object (RunConfig)

İsteğe bağlı. Ek Cloud Run service yapılandırması.

RunConfig

Cloud Run service'a uygulanacak ek yapılandırma.

JSON gösterimi 
{
  "cpu": number,
  "memoryMib": integer,
  "concurrency": integer,
  "maxInstances": integer,
  "minInstances": integer
}
Alanlar
cpu

number

İsteğe bağlı. Her sunum örneği için kullanılan CPU sayısı.

Varsayılan olarak CPU, Cloud Run'ın varsayılan değeri olan 1.0'a ayarlanır.

CPU değeri 1, 2, 4, 6 veya 8 CPU değerine ve 1'den az CPU için 0,01'lik artışlarla 0,08 ila 1,00'dan düşük bir değere ayarlanabilir.

1'den düşük bir CPU değeri belirlerseniz eşzamanlılığı 1 olarak ayarlamanız gerekir. CPU yalnızca istek işleme sırasında tahsis edilir.

CPU sınırının yükseltilmesi, bellek sınırlarının yükseltilmesini gerektirebilir:

  • 4 CPU: en az 2 GiB
  • 6 CPU: en az 4 GiB
  • 8 CPU: en az 4 GiB
memoryMib

integer

İsteğe bağlı. MiB cinsinden her sunum örneğine ayrılan bellek miktarı.

Varsayılan olarak, her örneğin 512 MiB bellek ayrıldığı Cloud Run'ın varsayılan bellek değeri kullanılır.

Bellek, 128 ile 32.768 arasında herhangi bir tam sayı değerine ayarlanabilir.

Bellek sınırının artırılması için CPU sınırlarının artırılması gerekebilir:

  • 4 GiB üzeri: en az 2 CPU
  • 8 GiB üzeri: En az 4 CPU
  • 16 GiB üzeri: En az 6 CPU
  • 24 GiB üzeri: En az 8 CPU
concurrency

integer

İsteğe bağlı. Her Cloud Run örneğinin alabileceği maksimum istek sayısı.

Varsayılan olarak her örnek, Cloud Run'ın aynı anda en fazla 80 isteklik varsayılanını alabilir.

Eşzamanlılık, 1.000'e kadar herhangi bir tam sayı değerine ayarlanabilir.
maxInstances

integer

İsteğe bağlı. Her düzeltme için maksimum korunacak Cloud Run örneklerinin sayısı.

Varsayılan olarak her Cloud Run service, Cloud Run'ın maksimum 100 örneklik varsayılanına ölçeklendirilir. Maksimum maxInstances sınırı kotanıza göre belirlenir. https://cloud.google.com/run/docs/configuring/max-instances#limits adresini ziyaret edin.
minInstances

integer

İsteğe bağlı. Her Cloud Run Hizmeti için minimum düzeyde korunacak Cloud Run örneği sayısı.

Varsayılan olarak, minimum değer yoktur.

Hizmet, trafiği birden fazla düzeltme arasında bölse bile bir hizmetin toplam örnek sayısı bu değerle sınırlandırılır.

Derleme Kaynağı

Derlemenin kaynağı.

JSON gösterimi 
{

  // 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.
}
Alanlar
Birleştirme alanı source. Derlemenin giriş kaynağı. Genellikle kaynak depodaki bir kayda referans verir. Bir container görüntüsüne de referans verebilir. source şunlardan yalnızca biri olabilir:
codebase

object (CodebaseSource)

Kod tabanı kaynağı.
container

object (ContainerSource)

Bir Artifact Registry container görüntüsü kaynağı.

Kod tabanı Kaynağı

Derlemenin oluşturulacağı kod tabanının durumunu temsil eden bir kod tabanı kaynağı.

JSON gösterimi 
{
  "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.
}
Alanlar
displayName

string

Yalnızca çıkış. Bir derleme görüntülenirken bu Codebase'de kullanılacak, insan dostu ad. GitHub.com için SHA-1 karmasının ilk sekiz karakterini kullanırız.
hash

string

Yalnızca çıkış. Varsa Git kaydının tam SHA-1 karması.
commitMessage

string

Yalnızca çıkış. Kod tabanı değişikliğiyle ilgili mesaj.
uri

string

Yalnızca çıkış. Barındırma sağlayıcısının web sitesindeki kod tabanına bağlantı veren URI. Kaydetme yeniden temellenirse veya bağlı depodaki mevcut varlığından zorla çıkarılmışsa geçerli olmayabilir.
author

object (UserMetadata)

Yalnızca çıkış. Bir sürüm kontrolü değişikliğinin meta verilerindeki yazar.
commitTime

string (Timestamp format)

Yalnızca çıkış. Değişikliğin yapıldığı zaman.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

Birleştirme alanı reference.

reference şunlardan yalnızca biri olabilir:
branch

string

Kod tabanındaki, son kaydetme kullanılarak derleme yapılacak dal.
commit

string

Kod tabanındaki, derleme yapılacak kayıt.

UserMetadata

Çözümlenmiş kod tabanıyla ilişkili bir kullanıcı için sürüm kontrolü meta verileri. Şu anda bir Git kullanıcısı varsayılmaktadır.

JSON gösterimi 
{
  "displayName": string,
  "email": string,
  "imageUri": string
}
Alanlar
displayName

string

Yalnızca çıkış. "Ad" alanını kullanın. Git için gereklidir.
email

string

Yalnızca çıkış. "E-posta" alanını Git kullanıcısının git.config dosyasında belirtin.
imageUri

string

Yalnızca çıkış. Varsa kullanıcının harici kaynak kontrol sağlayıcısındaki hesabıyla ilişkilendirilmiş resim dosyasının URI'sı.

Kapsayıcı Kaynağı

Derleme kaynağı olarak kullanılacak Artifact Registry kapsayıcı görüntüsünün URI'sı.

JSON gösterimi 
{
  "image": string
}
Alanlar
image

string

Zorunlu. Arka ucun kullanması için bir kapsayıcıyı temsil eden URI.

Yöntemler

create

 Arka uç için yeni bir derleme oluşturur.

delete

 Tek bir derlemeyi siler.

get

 Bir derleme hakkında bilgi alır.

list

 Belirli bir proje, konum ve arka uçtaki derlemeleri listeler.