REST Resource: projects.locations.fleetPackages.rollouts

Recurso: Lanzamiento

El recurso Rollout representa una instancia de la operación de lanzamiento de FleetPackage en una flota. Este es un recurso generado por el sistema y será de solo lectura para los usuarios finales. El servicio lo usará principalmente para procesar los cambios en FleetPackage y otros cambios en el entorno.

Representación JSON
{
  "name": string,
  "release": string,
  "rolloutStrategy": {
    object (RolloutStrategy)
  },
  "info": {
    object (RolloutInfo)
  },
  "deletionPropagationPolicy": enum (DeletionPropagationPolicy),
  "createTime": string,
  "updateTime": string
}
Campos
name

string

Es el identificador. Nombre del lanzamiento. El formato es projects/{project}/locations/{location}/fleetPackages/{fleetPackage}/rollouts/[a-z][a-z0-9\-]{0,62}.

release

string

Es la referencia al Release que se está lanzando.

rolloutStrategy

object (RolloutStrategy)

Estrategia de lanzamiento para implementar FleetPackage en los clústeres.

info

object (RolloutInfo)

Son los detalles actuales del lanzamiento.

deletionPropagationPolicy

enum (DeletionPropagationPolicy)

Es la política de propagación de la eliminación del lanzamiento.

createTime

string (Timestamp format)

Solo salida. Es la fecha y hora en que se creó el lanzamiento.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Solo salida. Fecha y hora en la que se actualizó el lanzamiento por última vez.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

RolloutInfo

RolloutInfo representa el estado de FleetPackage en todos los clústeres a los que se dirige el lanzamiento.

Representación JSON
{
  "state": enum (State),
  "startTime": string,
  "endTime": string,
  "message": string,
  "rolloutStrategyInfo": {
    object (RolloutStrategyInfo)
  }
}
Campos
state

enum (State)

Solo salida. El estado contiene el estado general del lanzamiento.

startTime

string (Timestamp format)

Solo salida. Fecha y hora en que comenzó el lanzamiento.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Solo salida. Fecha y hora en que se completó el lanzamiento.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

message

string

Solo salida. Mensaje que contiene información adicional relacionada con el lanzamiento.

rolloutStrategyInfo

object (RolloutStrategyInfo)

Solo salida. La información de la estrategia de lanzamiento representa el estado de ejecución de la estrategia de lanzamiento.

Estado

Estado del lanzamiento

Enums
STATE_UNSPECIFIED Significa que el estado no se especificó.
COMPLETED Se completó el lanzamiento.
SUSPENDED Se suspendió el lanzamiento.
ABORTED Se anuló el lanzamiento. Se detuvo un lanzamiento que ya estaba en ejecución porque cambiaron las membresías de la flota o se borró el paquete de flota.
IN_PROGRESS Lanzamiento en curso.
STALLED Se detuvo el lanzamiento.
CANCELLED Se canceló el lanzamiento. Desde el principio, se consideró que el lanzamiento propuesto no era válido o que no se podía ejecutar debido a problemas con la configuración del paquete, la versión o la variante.
ABORTING Se está anulando el lanzamiento.

RolloutStrategyInfo

RolloutStrategyInfo representa el estado de ejecución de diferentes tipos de estrategias de lanzamiento. Solo se propagará el campo correspondiente a la estrategia de lanzamiento especificada en el recurso de lanzamiento.

Representación JSON
{

  // Union field strategy can be only one of the following:
  "allAtOnceStrategyInfo": {
    object (AllAtOnceStrategyInfo)
  },
  "rollingStrategyInfo": {
    object (RollingStrategyInfo)
  }
  // End of list of possible types for union field strategy.
}
Campos
Campo de unión strategy. Strategy representa el resultado de aplicar una de las estrategias de lanzamiento. strategy puede ser solo uno de los parámetros siguientes:
allAtOnceStrategyInfo

object (AllAtOnceStrategyInfo)

AllAtOnceStrategyInfo representa el estado de la ejecución de la estrategia de lanzamiento AllAtOnce.

rollingStrategyInfo

object (RollingStrategyInfo)

RollingStrategyInfo representa el estado de la ejecución de la estrategia de lanzamiento progresivo.

AllAtOnceStrategyInfo

AllAtOnceStrategyInfo representa el estado de ejecución de la estrategia de lanzamiento AllAtOnce.

Representación JSON
{
  "clusters": [
    {
      object (ClusterInfo)
    }
  ]
}
Campos
clusters[]

object (ClusterInfo)

Lista sin ordenar. Es el estado de la implementación del paquete de recursos para todos los clústeres segmentados.

ClusterInfo

ClusterInfo representa el estado de un lanzamiento de paquete de recursos para un clúster.

Representación JSON
{
  "membership": string,
  "desired": {
    object (ResourceBundleDeploymentInfo)
  },
  "initial": {
    object (ResourceBundleDeploymentInfo)
  },
  "current": {
    object (ResourceBundleDeploymentInfo)
  },
  "state": enum (State),
  "messages": [
    string
  ],
  "startTime": string,
  "endTime": string
}
Campos
membership

string

Solo salida. Membresía de gkehub del clúster de destino

desired

object (ResourceBundleDeploymentInfo)

Solo salida. Es el estado deseado para el paquete de recursos.

initial

object (ResourceBundleDeploymentInfo)

Solo salida. Es el estado inicial del paquete de recursos antes de la implementación.

current

object (ResourceBundleDeploymentInfo)

Solo salida. Es el estado actual del paquete de recursos.

state

enum (State)

Solo salida. Es el estado del lanzamiento del clúster.

messages[]

string

Solo salida. Lista sin ordenar. Los mensajes transmiten información adicional relacionada con la implementación.

startTime

string (Timestamp format)

Solo salida. Es la marca de tiempo en la que comienza la conciliación.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Solo salida. Es la marca de tiempo en la que finaliza la conciliación.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

ResourceBundleDeploymentInfo

ResourceBundleDeploymentInfo representa el estado de la implementación de un paquete de recursos.

Representación JSON
{
  "release": string,
  "version": string,
  "variant": string,
  "syncState": enum (SyncState),
  "messages": [
    string
  ]
}
Campos
release

string

Solo salida. Se refiere a una versión de ResourceBundle.

version

string

Solo salida. Hace referencia a una versión de la actualización de ResourceBundle.

variant

string

Solo salida. Hace referencia a una variante en una versión de ResourceBundle.

syncState

enum (SyncState)

Solo salida. Es el estado de sincronización de la implementación de ResourceBundle.

messages[]

string

Solo salida. Lista sin ordenar. Los mensajes contienen información relacionada con la implementación de ResourceBundle. Por ejemplo, en caso de error, indica el motivo. En el caso de una implementación pendiente, los mensajes contendrán el motivo por el que está pendiente la implementación de la versión nueva.

SyncState

Es el estado de sincronización de la implementación del paquete de recursos.

Enums
SYNC_STATE_UNSPECIFIED Significa que el estado no se especificó.
RECONCILING Estado de conciliación.
STALLED Estado atascado.
SYNCED Estado sincronizado.
PENDING Estado pendiente.
ERROR Estado de error.
DELETION_PENDING Estado de eliminación pendiente.
DELETING Se está borrando el estado.
DELETED Es el estado borrado.

Estado

Es el estado del lanzamiento del clúster.

Enums
STATE_UNSPECIFIED Significa que el estado no se especificó.
WAITING Estado de espera.
IN_PROGRESS Estado en curso.
STALLED Estado atascado.
COMPLETED Estado completado.
ABORTED Estado de anulación. Se detuvo un lanzamiento que ya estaba en ejecución porque cambiaron las membresías de la flota o se borró el paquete de flota.
CANCELLED Estado cancelado. Desde el principio, se consideró que el lanzamiento propuesto no era válido o que no se podía ejecutar debido a problemas con la configuración del paquete, la versión o la variante.
ERROR Estado de error.
UNCHANGED Estado sin cambios.
SKIPPED Estado omitido.

RollingStrategyInfo

RollingStrategyInfo representa el estado de ejecución de la estrategia de lanzamiento progresivo.

Representación JSON
{
  "clusters": [
    {
      object (ClusterInfo)
    }
  ]
}
Campos
clusters[]

object (ClusterInfo)

Lista sin ordenar. Es el estado de la implementación del paquete de recursos para todos los clústeres segmentados.

Métodos

abort

Anula un lanzamiento.

get

Obtiene detalles de un solo lanzamiento.

list

Enumera los lanzamientos en un proyecto, una ubicación y un paquete de flota determinados.

resume

Reanuda un lanzamiento.

suspend

Suspende un lanzamiento.