summaryrefslogtreecommitdiff
path: root/yarns/000.yarn
blob: 12bdea24b87597dd2e4793adf0c2366e22221945 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
<!--

Copyright 2017,2019 Lars Wirzenius

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

-->

---
title: Ick2 integration tests
author: Lars Wirzenius
version: work in progress
...


# Introduction

This is a set of integration tests for [Ick2][], a continuous integration
system. Written for execution by [yarn][].

[Ick2]: http://ick.liw.fi/
[yarn]: https://liw.fi/cmdtest/

## Running this test suite

This test suite tests a deployed Ick2 controller and other components of Ick,
but not the workers. The deployed Ick2 must not have any workers, and
must be "empty", meaning, no project, pipelines, etc, must be defined.
The test suit deletes everything.

The `./check` script runs the tests. It can run only local tests,
which are mainly unit tests and code health.

    EXAMPLE running the test suite in local mode
    ./check

`./check` can be given extra arguments, which it will pass on to
`yarn` to test a remote Ick instance, which may not have workers. The
first argument is the controller URL:

    EXAMPLE running the test suite in local mode
    ./check https://ick-controller
    ./check https://ick-controller -v --tempdir tmp --snapshot

The URL **must** be an `https` URL. `qvisqvetool` must be configured
to suppot the given Ick instance, so that test clients for API use can
be managed by yarn automatically.