2021-04-15 14:41:27 +00:00
|
|
|
---
|
|
|
|
|
title: 'SK CLI Tool'
|
|
|
|
|
linkTitle: 'SK CLI Tool'
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## Introduction
|
|
|
|
|
|
|
|
|
|
`sk` is a command-line tool which provides common functionality useful for
|
|
|
|
|
working on Skia.
|
|
|
|
|
|
|
|
|
|
## Commands
|
|
|
|
|
|
|
|
|
|
The set of supported commands will probably grow or change over time.
|
|
|
|
|
|
|
|
|
|
### asset
|
|
|
|
|
|
|
|
|
|
Used for managing versioned non-code assets used by Skia developers and in CI.
|
|
|
|
|
These are stored in [CIPD](https://chrome-infra-packages.appspot.com/p/skia/bots)
|
|
|
|
|
and their versions are pinned under
|
2021-05-20 20:01:33 +00:00
|
|
|
[//infra/bots/assets](https://skia.googlesource.com/skia/+/main/infra/bots/assets)
|
2021-04-15 14:41:27 +00:00
|
|
|
in Skia.
|
|
|
|
|
|
|
|
|
|
* add - Add an entry for a new asset. This does not create an initial version.
|
|
|
|
|
* remove - Remove the entry for an existing asset. This does not remove uploaded
|
|
|
|
|
versions.
|
|
|
|
|
* download - Download the pinned version of the asset into the given directory.
|
|
|
|
|
* upload - Upload a new version of the asset and update the pinned version. If
|
|
|
|
|
a script exists to automate creation of the asset, `sk` that runs script and
|
|
|
|
|
uploads the resulting files. Otherwise, it expects a target directory to be
|
|
|
|
|
provided.
|
|
|
|
|
* get-version - Print the pinned version of the asset.
|
|
|
|
|
* set-version - Set the pinned version of the asset. `sk` verifies that the
|
|
|
|
|
given version actually exists in CIPD.
|
|
|
|
|
* list-versions - Print all versions of the asset which exist in CIPD.
|
|
|
|
|
|
|
|
|
|
### release-branch
|
|
|
|
|
|
|
|
|
|
This automates the processes involved in creating a new release branch of Skia,
|
|
|
|
|
including creating the Git branch itself, setting up the commit queue on the
|
|
|
|
|
new branch (as well as retiring the commit queue for the oldest release branch),
|
|
|
|
|
and updating the current Skia milestone. This requires administrator rights.
|
|
|
|
|
|
|
|
|
|
### try
|
|
|
|
|
|
|
|
|
|
Trigger try jobs on the current active CL. Accepts zero or more job names or
|
|
|
|
|
regular expressions. If none is provided, `try` lists all of the available try
|
|
|
|
|
jobs and exits.
|
|
|
|
|
|
|
|
|
|
## Development
|
|
|
|
|
|
|
|
|
|
The code for `sk` is located in the
|
|
|
|
|
[Skia Infra repo](https://skia.googlesource.com/buildbot). Development in that
|
|
|
|
|
repo follows similar practices to Skia. See
|
2021-09-27 14:15:39 +00:00
|
|
|
[README.md](https://skia.googlesource.com/buildbot/+/main/README.md) for
|
2021-04-15 14:41:27 +00:00
|
|
|
instructions to get started.
|
|
|
|
|
|
|
|
|
|
Code for the `sk` tool itself is located under
|
2021-09-27 14:15:39 +00:00
|
|
|
[//sk/go/](https://skia.googlesource.com/buildbot/+/main/sk/go/). Each
|
2021-04-15 14:41:27 +00:00
|
|
|
sub-command has an associated package.
|
|
|
|
|
|
|
|
|
|
## Deployment
|
|
|
|
|
|
|
|
|
|
New versions of `sk` are automatically built and uploaded to
|
|
|
|
|
[CIPD](https://chrome-infra-packages.appspot.com/p/skia/tools/sk) as part of
|
|
|
|
|
Skia Infra's CI/CD pipeline. The version used by Skia is pinned in
|
2021-05-20 20:01:33 +00:00
|
|
|
[DEPS](https://skia.googlesource.com/skia/+/main/DEPS) and updated by an
|
2021-04-15 14:41:27 +00:00
|
|
|
[autoroller](https://autoroll.skia.org/r/sk-tool-skia).
|
