2017-03-09 22:12:01 +02:00
|
|
|
# Overview - Scripts and Commands
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This is an overview of the available scripts and commands.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Scripts
|
|
|
|
|
The scripts are located inside `<aio-builds-setup-dir>/scripts/`. The following scripts are
|
|
|
|
|
available:
|
|
|
|
|
|
2017-05-12 11:15:08 +03:00
|
|
|
- `create-image.sh`:
|
2017-03-09 22:12:01 +02:00
|
|
|
Can be used for creating a preconfigured docker image.
|
|
|
|
|
See [here](vm-setup--create-docker-image.md) for more info.
|
|
|
|
|
|
|
|
|
|
- `test.sh`
|
|
|
|
|
Can be used for running the tests for `<aio-builds-setup-dir>/dockerbuild/scripts-js/`. This is
|
|
|
|
|
useful for CI integration. See [here](misc--integrate-with-ci.md) for more info.
|
|
|
|
|
|
|
|
|
|
- `travis-preverify-pr.sh`
|
|
|
|
|
Can be used for "preverifying" a PR before uploading the artifacts to the server. It checks that
|
2017-05-12 11:15:08 +03:00
|
|
|
the author of the PR is a member of one of the specified GitHub teams and therefore allowed to
|
|
|
|
|
upload build artifacts. This is useful for CI integration. See [here](misc--integrate-with-ci.md)
|
|
|
|
|
for more info.
|
2017-03-09 22:12:01 +02:00
|
|
|
|
2017-05-17 17:09:53 +03:00
|
|
|
- `update-preview-server.sh`
|
|
|
|
|
Can be used for updating the docker container (and image) based on the latest changes checked out
|
|
|
|
|
from a git repository. See [here](vm-setup--update-docker-container.md) for more info.
|
2017-03-09 22:12:01 +02:00
|
|
|
|
|
|
|
|
## Commands
|
|
|
|
|
The following commands are available globally from inside the docker container. They are either used
|
|
|
|
|
by the container to perform its various operations or can be used ad-hoc, mainly for testing
|
|
|
|
|
purposes. Each command is backed by a corresponding script inside
|
|
|
|
|
`<aio-builds-setup-dir>/dockerbuild/scripts-sh/`.
|
|
|
|
|
|
|
|
|
|
- `aio-clean-up`:
|
|
|
|
|
Cleans up the builds directory by removing the artifacts that do not correspond to an open PR.
|
|
|
|
|
_It is run as a daily cronjob._
|
|
|
|
|
|
|
|
|
|
- `aio-health-check`:
|
|
|
|
|
Runs a basic health-check, verifying that the necessary services are running, the servers are
|
|
|
|
|
responding and there is a working internet connection.
|
|
|
|
|
_It is used periodically by docker for determining the container's health status._
|
|
|
|
|
|
|
|
|
|
- `aio-init`:
|
|
|
|
|
Initializes the container (mainly by starting the necessary services).
|
|
|
|
|
_It is run (by default) when starting the container._
|
|
|
|
|
|
|
|
|
|
- `aio-upload-server-prod`:
|
|
|
|
|
Spins up a Node.js upload-server instance.
|
|
|
|
|
_It is used in `aio-init` (see above) during initialization._
|
|
|
|
|
|
|
|
|
|
- `aio-upload-server-test`:
|
|
|
|
|
Spins up a Node.js upload-server instance for tests.
|
|
|
|
|
_It is used in `aio-verify-setup` (see below) for running tests._
|
|
|
|
|
|
|
|
|
|
- `aio-verify-setup`:
|
|
|
|
|
Runs a suite of e2e-like tests, mainly verifying the correct (inter)operation of nginx and the
|
|
|
|
|
Node.js upload-server.
|
