# velocirepo upload-archive


Store archived runs as assets of the data repository's monthly raw-YYYY-MM release, a pre-release that's never the latest release. Uploads can be repeated: assets that are stored already are skipped. With `--pending`, the archives of earlier runs whose upload failed, saved as workflow artifacts, are uploaded too; one that has waited six days is an error, since its artifact is about to expire. With `--output`, a failed upload isn't an error: the archive's path and artifact name are written as step outputs, so the workflow can save it.


``` bash
velocirepo upload-archive [OPTIONS]
```


<span class="gd-details-chevron" aria-hidden="true"></span>Full --help output


    Store archived runs as assets of the data repository's monthly raw-YYYY-MM release, a pre-release that's never the latest release. Uploads can be repeated: assets that are stored already are skipped.

    With --pending, the archives of earlier runs whose upload failed, saved as workflow artifacts, are uploaded too; one that has waited six days is an error, since its artifact is about to expire. With --output, a failed upload isn't an error: the archive's path and artifact name are written as step outputs, so the workflow can save it.

    Usage:
      velocirepo upload-archive [run-dir...] [flags]

    Flags:
      -h, --help                help for upload-archive
          --output string       on a failed upload, write the archive's path to this GitHub Actions output file
          --pending             also upload the archives saved as workflow artifacts
          --repo string         the data repository, owner/name (default: $GITHUB_REPOSITORY)
          --repo-token string   a token for the data repository (default: $VELOCIREPO_REPO_TOKEN)

    Global Flags:
          --config string   config file (default: walk up for velocirepo.toml)
      -q, --quiet           suppress progress output
      -v, --verbose         enable debug logging


## Options


`-h, --help`  
help for upload-archive

`--output: string`  
on a failed upload, write the archive's path to this GitHub Actions output file

`--pending`  
also upload the archives saved as workflow artifacts

`--repo: string = $GITHUB_REPOSITORY`  
the data repository, owner/name

`--repo-token: string = $VELOCIREPO_REPO_TOKEN`  
a token for the data repository

`--config: string = walk up for velocirepo.toml`  
config file

`-q, --quiet`  
suppress progress output

`-v, --verbose`  
enable debug logging