REST Resource: projects.locations.backends.builds

Ресурс: Построить

Одна сборка для серверной части в определенный момент времени, тег ссылки на кодовую базу. Инкапсулирует несколько ресурсов, включая образ контейнера реестра артефактов, вызов 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 образа контейнера реестра артефактов, используемый revision Cloud Run для этой сборки.

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 Инфраструктура для этого здания находится в стадии создания.
READY Инфраструктура для этой сборки готова. Сборка может обслуживать или не обслуживать трафик — см. Backend.traffic для текущего состояния или Backend.traffic_statuses для желаемого состояния.
FAILED Сборка не удалась.

Конфигурация

Дополнительная настройка бэкенда для этой сборки.

JSON-представление 
{
  "runConfig": {
    object (RunConfig)
  }
}
Поля
runConfig

object ( RunConfig )

Необязательный. Дополнительная настройка service Cloud Run.

Запуститьконфигурацию

Дополнительная конфигурация для применения к service Cloud Run.

JSON-представление 
{
  "cpu": number,
  "memoryMib": integer,
  "concurrency": integer,
  "maxInstances": integer,
  "minInstances": integer
}
Поля
cpu

number

Необязательный. Количество ЦП, используемых для каждого обслуживающего экземпляра.

По умолчанию для процессора установлено значение по умолчанию Cloud Run, равное 1.0.

Для ЦП можно установить значение 1, 2, 4, 6 или 8 ЦП, а для ЦП менее 1 — значение от 0,08 до менее 1,00 с шагом 0,01.

Если вы установили значение менее 1 ЦП, необходимо установить для параллелизма значение 1, и ЦП будет выделяться только во время обработки запроса.

Увеличение лимита процессоров может потребовать увеличения лимита памяти:

  • 4 процессора: не менее 2 ГиБ
  • 6 процессоров: не менее 4 ГиБ
  • 8 процессоров: не менее 4 ГиБ
memoryMib

integer

Необязательный. Объем памяти, выделенный для каждого обслуживающего экземпляра в МиБ.

По умолчанию для памяти используется значение по умолчанию Cloud Run, где каждому экземпляру выделяется 512 МБ памяти.

Память может быть установлена ​​на любое целое значение от 128 до 32768.

Увеличение лимита памяти может потребовать увеличения лимита процессоров:

  • Более 4 ГиБ: минимум 2 процессора
  • Более 8 ГиБ: минимум 4 процессора
  • Более 16 ГиБ: минимум 6 процессоров
  • Более 24 ГиБ: минимум 8 процессоров
concurrency

integer

Необязательный. Максимальное количество запросов, которые может получить каждый экземпляр Cloud Run.

По умолчанию каждый экземпляр может получать до 80 запросов Cloud Run одновременно.

Параллелизму может быть присвоено любое целое значение до 1000.

maxInstances

integer

Необязательный. Максимальное количество экземпляров Cloud Run для каждой версии.

По умолчанию каждая service Cloud Run масштабируется до уровня Cloud Run по умолчанию, составляющего максимум 100 экземпляров. Максимальный предел maxInstances зависит от вашей квоты. См . https://cloud.google.com/run/docs/configuring/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 )

Источник образа контейнера реестра артефактов.

Источник кодовой базы

Источник кодовой базы, представляющий состояние кодовой базы, в которой будет создана сборка.

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, если доступен.

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

Фиксация в кодовой базе, на основе которой выполняется сборка.

Пользовательские метаданные

Метаданные управления версиями для пользователя, связанного с решенной базой кода. В настоящее время предполагается пользователь Git.

JSON-представление 
{
  "displayName": string,
  "email": string,
  "imageUri": string
}
Поля
displayName

string

Только вывод. Поле «имя» в файле git.config пользователя Git. Требуется Git.

email

string

Только вывод. Поле «электронная почта» в git.config пользователя Git, если оно доступно.

imageUri

string

Только вывод. URI файла изображения, связанного с учетной записью пользователя во внешнем поставщике системы управления версиями, если он доступен.

КонтейнерИсточник

URI образа контейнера реестра артефактов, который будет использоваться в качестве источника сборки.

JSON-представление 
{
  "image": string
}
Поля
image

string

Необходимый. URI, представляющий контейнер для использования серверной частью.

Методы

create

 Создает новую сборку для серверной части.

delete

 Удаляет одну сборку.

get

 Получает информацию о сборке.

list

 Перечисляет сборки в данном проекте, местоположении и серверной части.