Zasób: Build
Pojedyncza kompilacja dla backendu w określonym punkcie odniesienia do bazy kodu w określonym punkcie w czasie. Obejmuje kilka zasobów, w tym obraz kontenera Artifact Registry, wywołanie Cloud Build, które skompilowało obraz, oraz wersję Cloud Run, która używa tego obrazu.
Zapis JSON |
---|
{ "name": string, "displayName": string, "state": enum ( |
Pola | |
---|---|
name |
Identyfikator. Nazwa zasobu kompilacji. Format:
|
displayName |
Opcjonalnie. Nazwa zrozumiała dla człowieka. Limit to 63 znaki. |
state |
Tylko dane wyjściowe. Stan kompilacji. |
error |
Tylko dane wyjściowe. Komunikat o stanie i komunikat o błędzie kompilacji w stanie |
environment |
Tylko dane wyjściowe. Nazwa środowiska backendu podczas tworzenia tej kompilacji. |
config |
Opcjonalnie. Dodatkowa konfiguracja usługi. |
image |
Tylko dane wyjściowe. Identyfikator URI obrazu kontenera w Artifact Registry używany przez Cloud Run |
source |
Wymagane. Stały. Źródło kompilacji. |
buildLogsUri |
Tylko dane wyjściowe. Lokalizacja logów Cloud Build związanych z procesem kompilacji. |
reconciling |
Tylko dane wyjściowe. Pole, które (jeśli ma wartość true) wskazuje, że kompilacja ma trwającą LRO. |
createTime |
Tylko dane wyjściowe. Czas utworzenia kompilacji. Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
updateTime |
Tylko dane wyjściowe. Czas ostatniej aktualizacji kompilacji. Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
deleteTime |
Tylko dane wyjściowe. Czas usunięcia kompilacji. Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
labels |
Opcjonalnie. Nieustrukturyzowana mapa par klucz-wartość, której można używać do porządkowania i kategoryzowania obiektów. Obiekt zawierający listę par |
annotations |
Opcjonalnie. Mapa wartości klucza nieuporządkowanego, która może być ustawiana przez narzędzia zewnętrzne do przechowywania i arbitralnych metadanych. Nie można ich tworzyć zapytań i należy je zachować podczas modyfikowania obiektów. Obiekt zawierający listę par |
uid |
Tylko dane wyjściowe. Przypisany przez system, unikalny identyfikator. |
etag |
Tylko dane wyjściowe. suma kontrolna obliczona przez serwer na podstawie innych wartości; mogą być wysyłane przy aktualizacji lub usunięcia w celu zapewnienia, że operacja zostanie wykonana na oczekiwanym zasobie. |
Stan
Stan kompilacji.
Wartości w polu enum | |
---|---|
STATE_UNSPECIFIED |
Stan kompilacji jest nieznany. |
BUILDING |
Budujemy. |
BUILT |
Kompilacja została ukończona i czeka na następny krok. Może ona zostać przeniesiona do WDROŻENIE, gdy App Hosting rozpocznie konfigurowanie infrastruktury. |
DEPLOYING |
Konfiguruję infrastrukturę tej kompilacji. |
READY |
Infrastruktura tej kompilacji jest gotowa. Kompilacja może, ale nie musi obsługiwać ruch – zobacz Backend.traffic , aby sprawdzić bieżący stan, lub Backend.traffic_statuses , aby zobaczyć, jaki jest stan. |
FAILED |
Nie udało się utworzyć kompilacji. |
Konfiguracja
Dodatkowa konfiguracja backendu dla tej kompilacji.
Zapis JSON |
---|
{
"runConfig": {
object ( |
Konfiguracja RunConfig
Dodatkowa konfiguracja do zastosowania w Cloud Run service
.
Zapis JSON |
---|
{ "cpu": number, "memoryMib": integer, "concurrency": integer, "maxInstances": integer, "minInstances": integer } |
Pola | |
---|---|
cpu |
Opcjonalnie. Liczba procesorów używanych przez każdą instancję obsługującą. Domyślnie procesor używa domyślnej wartości Cloud Run 1.0. Procesor może mieć wartość 1, 2, 4, 6 lub 8, a w przypadku mniej niż 1 CPU – wartość z zakresu od 0, 08 do 1, 00 w przyrostach co 0, 01. Jeśli ustawisz wartość mniejszą niż 1 procesor, musisz ustawić równoczesność na 1. Procesor będzie przydzielany tylko podczas przetwarzania żądań. Zwiększenie limitu procesorów może wymagać zwiększenia limitów pamięci:
|
memoryMib |
Opcjonalnie. Ilość pamięci przydzielonej do każdej instancji obsługującej (w MiB). Domyślnie pamięć jest ustawiona na wartość domyślną w Cloud Run, gdzie każda instancja jest przydzielona 512 MiB pamięci. Pamięć może mieć dowolną wartość całkowitą z zakresu od 128 do 32 768. Zwiększenie limitu pamięci może wymagać zwiększenia limitów procesorów:
|
concurrency |
Opcjonalnie. Maksymalna liczba żądań, które może odebrać każda instancja Cloud Run. Domyślnie każda instancja może odbierać domyślnie maksymalnie 80 żądań Cloud Run jednocześnie. Równoczesność może mieć dowolną wartość całkowitą nie większą niż 1000. |
maxInstances |
Opcjonalnie. Liczba instancji Cloud Run, które mają zostać zachowane na maksymalnym poziomie dla każdej wersji. Domyślnie każde rozwiązanie Cloud Run |
minInstances |
Opcjonalnie. Liczba instancji Cloud Run do utrzymywania co najmniej dla każdej usługi Cloud Run. Domyślnie nie ma minimalnej wartości. Nawet jeśli usługa dzieli ruch na wiele wersji, łączna liczba instancji usługi będzie ograniczona do tej wartości. |
Źródło kompilacji
Źródło kompilacji.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy source . Źródło wejściowe kompilacji. Zwykle będzie odwoływać się do zatwierdzenia w repozytorium źródłowym. Może też odwoływać się do obrazu kontenera. source może mieć tylko jedną z tych wartości: |
|
codebase |
Źródło bazy kodu. |
container |
Źródło obrazu kontenera Artifact Registry. |
Źródło bazy kodu
Źródło bazy kodu reprezentujące stan bazy kodu, w którym zostanie utworzona kompilacja.
Zapis JSON |
---|
{ "displayName": string, "hash": string, "commitMessage": string, "uri": string, "author": { object ( |
Pola | |
---|---|
displayName |
Tylko dane wyjściowe. Przyjazna dla człowieka nazwa, która ma być używana dla tej bazy kodu podczas wyświetlania kompilacji. W przypadku witryny GitHub.com używamy pierwszych 8 znaków skrótu SHA-1. |
hash |
Tylko dane wyjściowe. Pełny hasz SHA-1 zatwierdzenia Git, jeśli jest dostępny. |
commitMessage |
Tylko dane wyjściowe. Komunikat o zmianie bazy kodu. |
uri |
Tylko dane wyjściowe. Identyfikator URI łączący z bazą kodu w witrynie dostawcy usług hostingowych. Może nie być prawidłowy, jeśli zatwierdzenie zostało zmienione lub wymuszone na dłużej w połączonym repozytorium. |
author |
Tylko dane wyjściowe. Autor określony w metadanych zmiany kontroli wersji. |
commitTime |
Tylko dane wyjściowe. Godzina wprowadzenia zmiany. Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
Pole sumy
|
|
branch |
Gałąź w bazie kodu, na podstawie której ma być skompilowana, przy użyciu najnowszego zatwierdzenia. |
commit |
Zatwierdzenie w bazie kodu, na podstawie którego tworzona jest kompilacja. |
UserMetadata
Metadane kontroli wersji dotyczące użytkownika powiązane z rozpoznaną bazą kodu. Obecnie zakłada użytkownika Git.
Zapis JSON |
---|
{ "displayName": string, "email": string, "imageUri": string } |
Pola | |
---|---|
displayName |
Tylko dane wyjściowe. Nazwa w pliku git.config użytkownika Git. Wymagane przez Git. |
email |
Tylko dane wyjściowe. Parametr „email” w pliku git.config użytkownika Git, jeśli jest dostępny. |
imageUri |
Tylko dane wyjściowe. Identyfikator URI pliku graficznego powiązanego z kontem użytkownika w systemie zewnętrznego dostawcy kontroli źródła (jeśli jest dostępny). |
Źródło kontenera
Identyfikator URI obrazu kontenera Artifact Registry, który ma być używany jako źródło kompilacji.
Zapis JSON |
---|
{ "image": string } |
Pola | |
---|---|
image |
Wymagane. Identyfikator URI reprezentujący kontener, który ma być używany przez backend. |