An open API service indexing awesome lists of open source software.

https://github.com/nuxt/ecosystem-ci

Nuxt Ecosystem CI
https://github.com/nuxt/ecosystem-ci

Last synced: 3 months ago
JSON representation

Nuxt Ecosystem CI

Awesome Lists containing this project

README

          

# nuxt-ecosystem-ci

This repository is used to run integration tests for Nuxt ecosystem projects

## via github workflow

### scheduled

Workflows are scheduled to run automatically every Monday, Wednesday and Friday

### manually

- open [workflow](../../actions/workflows/ecosystem-ci-selected.yml)
- click 'Run workflow' button on top right of the list
- select suite to run in dropdown
- start workflow

## via shell script

- clone this repo
- run `pnpm i`
- run `pnpm test` to run all suites
- or `pnpm test ` to select a suite

You can pass `--tag v3.4.0-beta.1`, `--branch somebranch` or `--commit abcd1234` option to select a specific nuxt version to build.
If you pass `--release 3.4.1`, Nuxt build will be skipped and Nuxt is fetched from the registry instead

The repositories are checked out into `workspace` subdirectory as shallow clones

## via comment on PR

- comment `/ecosystem-ci run` on a PR
- or `/ecosystem-ci run ` to select a suite

Users with triage permission to nuxt/nuxt repository can only use this.

See [docs/pr-comment-setup.md](./docs/pr-comment-setup.md) for how to setup this feature.

# how to add a new integration test

- check out the existing [tests](./tests) and add one yourself. Thanks to some utilities it is really easy
- once you are confident the suite works, add it to the lists of suites in the [workflows](../../actions/)

# reporting results

## Discord

Results are posted automatically to `#ecosystem-ci` on [Nuxt discord](https://discord.nuxtjs.org/)

### on your own server

- Go to `Server settings > Integrations > Webhooks` and click `New Webhook`
- Give it a name, icon and a channel to post to
- copy the webhook url
- get in touch with admins of this repo so they can add the webhook

#### how to add a discord webhook here

- Go to `/settings/secrets/actions` and click on `New repository secret`
- set `Name` as `DISCORD_WEBHOOK_URL`
- paste the discord webhook url you copied from above into `Value`
- Click `Add secret`