868a8c5d8e
All gtest-based tests should now use add_gtest. Results from these tests will be surfaced more prominently in GitHub Actions. Before this, it was hard to find test failures in the log. |
||
---|---|---|
.. | ||
README.md | ||
build-docs.yaml | ||
build-matrix.json | ||
build.yaml | ||
docker-hub-release.yaml | ||
docker-image.yaml | ||
github-release.yaml | ||
lint.yaml | ||
npm-release.yaml | ||
pr.yaml | ||
settings.yaml | ||
sync-labels.yaml | ||
test-linux-distros.yaml | ||
update-docs.yaml | ||
update-issues.yaml | ||
validate-pr-title.yaml |
README.md
GitHub Actions CI
Reusable workflows
-
build.yaml
: Build and test all combinations of OS & build settings. Also builds docs on Linux. -
build-docs.yaml
: Build Packager docs. Runs only on Linux. -
docker-image.yaml
: Build the official Docker image. -
lint.yaml
: Lint Shaka Packager. -
test-linux-distros.yaml
: Test the build on all Linux distros via docker.
Composed workflows
-
On PR (
pr.yaml
), invoke:lint.yaml
build.yaml
build-docs.yaml
docker-image.yaml
test-linux-distros.yaml
-
On release tag (
github-release.yaml
):- Create a draft release
- Invoke:
lint.yaml
build.yaml
test-linux-distros.yaml
- Publish the release with binaries from
build.yaml
attached
-
On release published:
docker-hub-release.yaml
, publishes the official Docker imagenpm-release.yaml
, publishes the official NPM packageupdate-docs.yaml
:- Invoke
build-docs.yaml
- Push the output to the
gh-pages
branch
- Invoke
Common workflows from shaka-project
sync-labels.yaml
update-issues.yaml
validate-pr-title.yaml
Required Repo Secrets
DOCKERHUB_CI_USERNAME
: The username of the Docker Hub CI accountDOCKERHUB_CI_TOKEN
: An access token for Docker Hub- To generate, visit https://hub.docker.com/settings/security
DOCKERHUB_PACKAGE_NAME
: Not a true "secret", but stored here to avoid someone pushing bogus packages to Docker Hub during CI testing from a fork- In a fork, set to a private name which differs from the production one
NPM_CI_TOKEN
: An "Automation"-type access token for NPM for theshaka-bot
account- To generate, visit https://www.npmjs.com/settings/shaka-bot/tokens and select the "Automation" type
NPM_PACKAGE_NAME
: Not a true "secret", but stored here to avoid someone pushing bogus packages to NPM during CI testing from a fork- In a fork, set to a private name which differs from the production one
Repo Settings
Each of these workflow features can be enabled by creating a "GitHub Environment" with the same name in your repo settings. Forks will not have these enabled by default.
debug
: enable debugging via SSH after a failureself_hosted
: enable self-hosted runners in the build matrix