Skip to content

Commit

Permalink
Merge pull request #164 from hubverse-org/znk/config-validation
Browse files Browse the repository at this point in the history
add documenation about validate-config action
  • Loading branch information
nickreich authored Aug 26, 2024
2 parents a22c2f2 + 5361f8d commit 91239d2
Showing 1 changed file with 15 additions and 0 deletions.
15 changes: 15 additions & 0 deletions docs/source/quickstart-hub-admin/continuous-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ remotes::install_github("hubverse-org/hubCI")
The [`hubverse-actions`](https://github.com/hubverse-org/hubverse-actions) repository currently contains directories with templates related to the following workflows:

* [`cache-hubval-deps`](https://github.com/hubverse-org/hubverse-actions/tree/main/cache-hubval-deps)
* [`validate-config`](https://github.com/hubverse-org/hubverse-actions/tree/main/validate-config)
* [`validate-submission`](https://github.com/hubverse-org/hubverse-actions/tree/main/validate-submission)
* [`hubverse-aws-upload`](https://github.com/hubverse-org/hubverse-actions/tree/main/hubverse-aws-upload)

Expand Down Expand Up @@ -55,6 +56,20 @@ The action is triggered by pull requests onto the `main` branch that add or modi

More information can be found [here](https://github.com/hubverse-org/hubverse-actions/tree/main/validate-submission) as well as in the hubValidations vignette on [Validating Pull Requests on GitHub](https://hubverse-org.github.io/hubValidations/articles/validate-pr.html).

### [`validate-config`](https://github.com/hubverse-org/hubverse-actions/tree/main/validate-config)

This hubverse action installs the `hubAdmin` package from GitHub using pak as well as required system dependencies.

It then performs submission validation checks through function `hubAdmin::validate_hub_config()` and assumes you have all three of the required configuration JSON files in your `hub-config/` directory:

- `admin.json`
- `model-metadata-schema.json`
- `tasks.json`

When invalid config files are discovered, a GitHub comment is created (or updated) with a table containing information about the exact locations of the failures using the [`hubAdmin::view_config_val_errors()`](https://hubverse-org.github.io/hubAdmin/reference/view_config_val_errors.html) function.

The action is triggered by pull requests onto the `main` branch which add or modify files in the `hub-config/` directory. For hubs and repositories which differ in configuration, workflow dispatch will need to be customised manually in the hubs workflow file.

### [`hubverse-aws-upload`](https://github.com/hubverse-org/hubverse-actions/tree/main/hubverse-aws-upload)
This action uploads your hub data to hubverse-hosted cloud storage. Currently, the workflow has a single job, `upload`, that pushes data to an Amazon Web Services (AWS) Simple Storage Service (S3) bucket.
The `upload` job inspects the hub's admin config (`admin.json`) for a `cloud` group. If cloud is enabled (i.e., if `cloud.enabled` is set to `true`), the job:
Expand Down

0 comments on commit 91239d2

Please sign in to comment.