Updating protocol 4: lists, nextfp and version
This change removes explicit list nodes and moves nextfp and version from the pipeline nodes to the updatecheck node. Bug: 393153877 Change-Id: I22646be95328d9bc58dba401a4ee00a62cd0ef76 Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/6214973 Reviewed-by: Sorin Jianu <sorin@chromium.org> Reviewed-by: Joshua Pawlicki <waffles@chromium.org> Commit-Queue: Joshua Pawlicki <waffles@chromium.org> Cr-Commit-Position: refs/heads/main@{#1415031}
This commit is contained in:

committed by
Chromium LUCI CQ

parent
936e446e0f
commit
d2e79a4f40
@ -665,17 +665,19 @@ the following members:
|
|||||||
* "error-inexpressible": The server finds that it is unable to produce a
|
* "error-inexpressible": The server finds that it is unable to produce a
|
||||||
list of pipelines for the given product using the set of operations
|
list of pipelines for the given product using the set of operations
|
||||||
provided in `acceptformat`.
|
provided in `acceptformat`.
|
||||||
* `pipelines`: A list of `pipeline` objects.
|
|
||||||
|
The following members are only present if the `status` is "ok":
|
||||||
|
* `nextversion`: The expected version of the product, if any pipeline is
|
||||||
|
able to complete all operations successfully.
|
||||||
|
* `nextfp`: A `fingerprint` object representing the package fingerprint
|
||||||
|
associated with the all `pipeline` objects.
|
||||||
|
* `pipeline`: A list of `pipeline` objects.
|
||||||
|
|
||||||
#### `pipeline` Objects (Update Check Response)
|
#### `pipeline` Objects (Update Check Response)
|
||||||
A pipeline object describes a pipeline process that may be applied in order to
|
A pipeline object describes a pipeline process that may be applied in order to
|
||||||
update the current binary. A pipeline is represented as a series of operations.
|
update the current binary. A pipeline is represented as a series of operations.
|
||||||
A pipeline object has the following members:
|
A pipeline object has the following members:
|
||||||
* `operations`: A list of `operation` objects.
|
* `operation`: A list of `operation` objects.
|
||||||
* `nextversion`: The expected version of the product, if this pipeline is
|
|
||||||
able to complete all operations successfully.
|
|
||||||
* `nextfp`: A `fingerprint` object representing the package fingerprint
|
|
||||||
associated with the package file that this pipeline installs.
|
|
||||||
|
|
||||||
#### `operation` Objects (Update Check Response)
|
#### `operation` Objects (Update Check Response)
|
||||||
A operation object describes one of many operations to be performed in order to
|
A operation object describes one of many operations to be performed in order to
|
||||||
@ -691,7 +693,7 @@ For `type == "download"`: Download a payload.
|
|||||||
* `size`: The size in bytes of the payload requested for download.
|
* `size`: The size in bytes of the payload requested for download.
|
||||||
* `outhash_sha256`: The SHA256 hash of the payload downloaded, encoded as a
|
* `outhash_sha256`: The SHA256 hash of the payload downloaded, encoded as a
|
||||||
lowercase hexadecimal string.
|
lowercase hexadecimal string.
|
||||||
* `urls`: The ordered list of url objects from which this payload may be
|
* `url`: The ordered list of url objects from which this payload may be
|
||||||
obtained. Clients must attempt to download from each URL of the appropriate
|
obtained. Clients must attempt to download from each URL of the appropriate
|
||||||
type in the specified order, falling back to the next URL if a TCP or HTTP
|
type in the specified order, falling back to the next URL if a TCP or HTTP
|
||||||
error is encountered. A 4xx or 5xx HTTP response qualifies as an error that
|
error is encountered. A 4xx or 5xx HTTP response qualifies as an error that
|
||||||
@ -741,8 +743,8 @@ A url object describes a fully-qualified URL. It has the following members:
|
|||||||
|
|
||||||
## Downloads
|
## Downloads
|
||||||
Download requests occur when an application update is needed, as a result of a
|
Download requests occur when an application update is needed, as a result of a
|
||||||
`response.app.updatecheck.pipelines.operations.urls` member. Download requests
|
`response.app.updatecheck.pipeline.operation.url` list element. Download
|
||||||
are HTTP GET requests and can use any HTTP implementation.
|
requests are HTTP GET requests and can use any HTTP implementation.
|
||||||
|
|
||||||
### Request Headers
|
### Request Headers
|
||||||
In addition to the regular HTTP headers, this protocol defines the following
|
In addition to the regular HTTP headers, this protocol defines the following
|
||||||
|
Reference in New Issue
Block a user