shaka-packager/.github/workflows
Joey Parrish fac8acf5dd
feat: Build c-ares locally (#1285)
c-ares (used on Linux only) was an exception to the rule of only linking
against internally-built libraries. This fixes that, to support a truly
static build of packager.
2023-10-18 16:44:43 -07:00
..
README.md ci: Fix repo settings for self-hosted runners and debugging (#1110) 2022-10-25 08:53:45 -07:00
build-docs.yaml fix: docs build (#1257) 2023-08-21 10:23:39 -07:00
build-matrix.json ci: Enable parallel builds (#1241) 2023-07-17 13:16:03 -07:00
build.yaml feat: Build c-ares locally (#1285) 2023-10-18 16:44:43 -07:00
docker-hub-release.yaml ci: Fix workflow warnings (#1243) 2023-07-17 16:11:52 -07:00
docker-image.yaml ci: Fix workflow warnings (#1243) 2023-07-17 16:11:52 -07:00
github-release.yaml ci: Fix workflow warnings (#1243) 2023-07-17 16:11:52 -07:00
lint.yaml ci: Fix workflow warnings (#1243) 2023-07-17 16:11:52 -07:00
npm-release.yaml ci: Fix workflow warnings (#1243) 2023-07-17 16:11:52 -07:00
pr.yaml ci: Fix repo settings for self-hosted runners and debugging (#1110) 2022-10-25 08:53:45 -07:00
settings.yaml ci: Fix repo settings for self-hosted runners and debugging (#1110) 2022-10-25 08:53:45 -07:00
sync-labels.yaml chore: Sync common workflows (#1120) 2022-10-27 11:20:43 -07:00
test-linux-distros.yaml ci: Fix workflow warnings (#1243) 2023-07-17 16:11:52 -07:00
update-docs.yaml ci: Fix workflow warnings (#1243) 2023-07-17 16:11:52 -07:00
update-issues.yaml chore: Sync common workflows (#1262) 2023-09-01 19:26:57 -07:00
validate-pr-title.yaml chore: Sync common workflows (#1262) 2023-09-01 19:26:57 -07:00

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 image
    • npm-release.yaml, publishes the official NPM package
    • update-docs.yaml:
      • Invoke build-docs.yaml
      • Push the output to the gh-pages branch

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 account
  • DOCKERHUB_CI_TOKEN: An access token for Docker Hub
  • 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 the shaka-bot account
  • 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 failure
  • self_hosted: enable self-hosted runners in the build matrix