cem_acpt 0.2.5 → 0.6.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/.github/workflows/spec.yml +30 -0
- data/Gemfile +4 -3
- data/Gemfile.lock +95 -43
- data/README.md +144 -83
- data/cem_acpt.gemspec +12 -7
- data/exe/cem_acpt +41 -7
- data/lib/cem_acpt/config.rb +340 -0
- data/lib/cem_acpt/core_extensions.rb +17 -61
- data/lib/cem_acpt/goss/api/action_response.rb +175 -0
- data/lib/cem_acpt/goss/api.rb +83 -0
- data/lib/cem_acpt/goss.rb +8 -0
- data/lib/cem_acpt/image_name_builder.rb +0 -9
- data/lib/cem_acpt/logging/formatter.rb +97 -0
- data/lib/cem_acpt/logging.rb +168 -142
- data/lib/cem_acpt/platform/base.rb +26 -37
- data/lib/cem_acpt/platform/gcp.rb +48 -62
- data/lib/cem_acpt/platform.rb +30 -28
- data/lib/cem_acpt/provision/terraform/linux.rb +47 -0
- data/lib/cem_acpt/provision/terraform/os_data.rb +72 -0
- data/lib/cem_acpt/provision/terraform/windows.rb +22 -0
- data/lib/cem_acpt/provision/terraform.rb +193 -0
- data/lib/cem_acpt/provision.rb +20 -0
- data/lib/cem_acpt/puppet_helpers.rb +0 -1
- data/lib/cem_acpt/test_data.rb +23 -13
- data/lib/cem_acpt/test_runner/log_formatter/goss_action_response.rb +104 -0
- data/lib/cem_acpt/test_runner/log_formatter.rb +10 -0
- data/lib/cem_acpt/test_runner.rb +170 -3
- data/lib/cem_acpt/utils/puppet.rb +29 -0
- data/lib/cem_acpt/utils/ssh.rb +197 -0
- data/lib/cem_acpt/utils/terminal.rb +27 -0
- data/lib/cem_acpt/utils.rb +4 -138
- data/lib/cem_acpt/version.rb +1 -1
- data/lib/cem_acpt.rb +73 -23
- data/lib/terraform/gcp/linux/goss/puppet_idempotent.yaml +10 -0
- data/lib/terraform/gcp/linux/goss/puppet_noop.yaml +12 -0
- data/lib/terraform/gcp/linux/main.tf +191 -0
- data/lib/terraform/gcp/linux/systemd/goss-acpt.service +8 -0
- data/lib/terraform/gcp/linux/systemd/goss-idempotent.service +8 -0
- data/lib/terraform/gcp/linux/systemd/goss-noop.service +8 -0
- data/lib/terraform/gcp/windows/.keep +0 -0
- data/sample_config.yaml +22 -21
- metadata +151 -51
- data/lib/cem_acpt/bootstrap/bootstrapper.rb +0 -206
- data/lib/cem_acpt/bootstrap/operating_system/rhel_family.rb +0 -129
- data/lib/cem_acpt/bootstrap/operating_system.rb +0 -17
- data/lib/cem_acpt/bootstrap.rb +0 -12
- data/lib/cem_acpt/context.rb +0 -153
- data/lib/cem_acpt/platform/base/cmd.rb +0 -71
- data/lib/cem_acpt/platform/gcp/cmd.rb +0 -345
- data/lib/cem_acpt/platform/gcp/compute.rb +0 -332
- data/lib/cem_acpt/platform/vmpooler.rb +0 -24
- data/lib/cem_acpt/rspec_utils.rb +0 -242
- data/lib/cem_acpt/shared_objects.rb +0 -537
- data/lib/cem_acpt/spec_helper_acceptance.rb +0 -184
- data/lib/cem_acpt/test_runner/run_handler.rb +0 -187
- data/lib/cem_acpt/test_runner/runner.rb +0 -210
- data/lib/cem_acpt/test_runner/runner_result.rb +0 -103
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 4936d14749b4fc458a1eb938299c091e45c28c69a838efe947edb1510a10f151
|
4
|
+
data.tar.gz: 52b205f0be2bffa478a474c50bd0686e4ba32f2cec69d710b2a89ecde94c45c3
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 96d81ee34960856f0accf22efec6aa3a12f34abf6b9137c43f886102d8a210eca2e907ff2cd2d0d01f6ce37026f9bf6b70c1ba07fd495ff3ad247ae6c3f713fb
|
7
|
+
data.tar.gz: 46a2f685ede232a010f26e8968666011c8ddfdf690f26df1fc11d3aa3e062d021db56df42854964a8b114b2a2d046127c47dba9b1f87334dd18160aeb2ff7367
|
@@ -0,0 +1,30 @@
|
|
1
|
+
name: Unit Tests
|
2
|
+
|
3
|
+
on:
|
4
|
+
workflow_dispatch:
|
5
|
+
pull_request:
|
6
|
+
types:
|
7
|
+
- opened
|
8
|
+
- synchronize
|
9
|
+
branches:
|
10
|
+
- main
|
11
|
+
tags:
|
12
|
+
- v.*
|
13
|
+
|
14
|
+
jobs:
|
15
|
+
tests:
|
16
|
+
name: RSpec tests
|
17
|
+
runs-on: ubuntu-20.04
|
18
|
+
steps:
|
19
|
+
- name: Checkout Source
|
20
|
+
uses: actions/checkout@v3
|
21
|
+
|
22
|
+
- name: Set up Ruby
|
23
|
+
uses: ruby/setup-ruby@v1
|
24
|
+
with:
|
25
|
+
ruby-version: 3.2
|
26
|
+
bundler-cache: true
|
27
|
+
|
28
|
+
- name: Run RSpec
|
29
|
+
run: |
|
30
|
+
bundle exec rake spec
|
data/Gemfile
CHANGED
data/Gemfile.lock
CHANGED
@@ -1,89 +1,141 @@
|
|
1
1
|
PATH
|
2
2
|
remote: .
|
3
3
|
specs:
|
4
|
-
cem_acpt (0.
|
5
|
-
|
6
|
-
|
7
|
-
|
8
|
-
|
9
|
-
|
10
|
-
|
11
|
-
|
4
|
+
cem_acpt (0.6.0)
|
5
|
+
async-http (>= 0.60, < 0.70)
|
6
|
+
bcrypt_pbkdf (>= 1.0, < 2.0)
|
7
|
+
concurrent-ruby (>= 1.1, < 2.0)
|
8
|
+
deep_merge (>= 1.2, < 2.0)
|
9
|
+
ed25519 (>= 1.2, < 2.0)
|
10
|
+
net-ssh (>= 7.1, < 7.2)
|
11
|
+
parallel (~> 1.22)
|
12
|
+
puppet-modulebuilder (>= 0.0.1)
|
13
|
+
ruby-terraform (~> 1.7)
|
14
|
+
serverspec (~> 2.42)
|
12
15
|
|
13
16
|
GEM
|
14
17
|
remote: https://rubygems.org/
|
15
18
|
specs:
|
16
19
|
ast (2.4.2)
|
17
|
-
|
20
|
+
async (2.5.0)
|
21
|
+
console (~> 1.10)
|
22
|
+
io-event (~> 1.1)
|
23
|
+
timers (~> 4.1)
|
24
|
+
async-http (0.60.1)
|
25
|
+
async (>= 1.25)
|
26
|
+
async-io (>= 1.28)
|
27
|
+
async-pool (>= 0.2)
|
28
|
+
protocol-http (~> 0.24.0)
|
29
|
+
protocol-http1 (~> 0.15.0)
|
30
|
+
protocol-http2 (~> 0.15.0)
|
31
|
+
traces (>= 0.8.0)
|
32
|
+
async-io (1.34.3)
|
33
|
+
async
|
34
|
+
async-pool (0.4.0)
|
35
|
+
async (>= 1.25)
|
36
|
+
bcrypt_pbkdf (1.1.0)
|
37
|
+
coderay (1.1.3)
|
38
|
+
concurrent-ruby (1.2.2)
|
39
|
+
console (1.16.2)
|
40
|
+
fiber-local
|
18
41
|
deep_merge (1.2.2)
|
19
42
|
diff-lcs (1.5.0)
|
43
|
+
ed25519 (1.3.0)
|
44
|
+
fiber-local (1.0.0)
|
45
|
+
hamster (3.0.0)
|
46
|
+
concurrent-ruby (~> 1.0)
|
47
|
+
immutable-struct (2.4.1)
|
48
|
+
io-event (1.1.7)
|
49
|
+
json (2.6.3)
|
50
|
+
lino (3.1.0)
|
51
|
+
hamster (~> 3.0)
|
52
|
+
open4 (~> 1.3)
|
53
|
+
method_source (1.0.0)
|
20
54
|
minitar (0.9)
|
21
55
|
multi_json (1.15.0)
|
22
|
-
net-scp (
|
23
|
-
net-ssh (>= 2.6.5, <
|
24
|
-
net-ssh (7.
|
56
|
+
net-scp (4.0.0)
|
57
|
+
net-ssh (>= 2.6.5, < 8.0.0)
|
58
|
+
net-ssh (7.1.0)
|
25
59
|
net-telnet (0.1.1)
|
60
|
+
open4 (1.3.4)
|
26
61
|
parallel (1.22.1)
|
27
|
-
parser (3.1.
|
62
|
+
parser (3.2.1.1)
|
28
63
|
ast (~> 2.4.1)
|
29
|
-
pathspec (1.
|
64
|
+
pathspec (1.1.3)
|
65
|
+
protocol-hpack (1.4.2)
|
66
|
+
protocol-http (0.24.1)
|
67
|
+
protocol-http1 (0.15.0)
|
68
|
+
protocol-http (~> 0.22)
|
69
|
+
protocol-http2 (0.15.1)
|
70
|
+
protocol-hpack (~> 1.4)
|
71
|
+
protocol-http (~> 0.18)
|
72
|
+
pry (0.14.2)
|
73
|
+
coderay (~> 1.1)
|
74
|
+
method_source (~> 1.0)
|
30
75
|
puppet-modulebuilder (0.3.0)
|
31
76
|
minitar (~> 0.9)
|
32
77
|
pathspec (>= 0.2.1, < 2.0.0)
|
33
78
|
rainbow (3.1.1)
|
34
|
-
rake (
|
35
|
-
regexp_parser (2.
|
79
|
+
rake (13.0.6)
|
80
|
+
regexp_parser (2.7.0)
|
36
81
|
rexml (3.2.5)
|
37
|
-
rspec (3.
|
38
|
-
rspec-core (~> 3.
|
39
|
-
rspec-expectations (~> 3.
|
40
|
-
rspec-mocks (~> 3.
|
41
|
-
rspec-core (3.
|
42
|
-
rspec-support (~> 3.
|
43
|
-
rspec-expectations (3.
|
82
|
+
rspec (3.12.0)
|
83
|
+
rspec-core (~> 3.12.0)
|
84
|
+
rspec-expectations (~> 3.12.0)
|
85
|
+
rspec-mocks (~> 3.12.0)
|
86
|
+
rspec-core (3.12.1)
|
87
|
+
rspec-support (~> 3.12.0)
|
88
|
+
rspec-expectations (3.12.2)
|
44
89
|
diff-lcs (>= 1.2.0, < 2.0)
|
45
|
-
rspec-support (~> 3.
|
90
|
+
rspec-support (~> 3.12.0)
|
46
91
|
rspec-its (1.3.0)
|
47
92
|
rspec-core (>= 3.0.0)
|
48
93
|
rspec-expectations (>= 3.0.0)
|
49
|
-
rspec-mocks (3.
|
94
|
+
rspec-mocks (3.12.4)
|
50
95
|
diff-lcs (>= 1.2.0, < 2.0)
|
51
|
-
rspec-support (~> 3.
|
52
|
-
rspec-support (3.
|
53
|
-
rubocop (1.
|
96
|
+
rspec-support (~> 3.12.0)
|
97
|
+
rspec-support (3.12.0)
|
98
|
+
rubocop (1.48.1)
|
99
|
+
json (~> 2.3)
|
54
100
|
parallel (~> 1.10)
|
55
|
-
parser (>= 3.
|
101
|
+
parser (>= 3.2.0.0)
|
56
102
|
rainbow (>= 2.2.2, < 4.0)
|
57
103
|
regexp_parser (>= 1.8, < 3.0)
|
58
104
|
rexml (>= 3.2.5, < 4.0)
|
59
|
-
rubocop-ast (>= 1.
|
105
|
+
rubocop-ast (>= 1.26.0, < 2.0)
|
60
106
|
ruby-progressbar (~> 1.7)
|
61
|
-
unicode-display_width (>=
|
62
|
-
rubocop-ast (1.
|
63
|
-
parser (>= 3.
|
64
|
-
ruby-progressbar (1.
|
65
|
-
|
107
|
+
unicode-display_width (>= 2.4.0, < 3.0)
|
108
|
+
rubocop-ast (1.28.0)
|
109
|
+
parser (>= 3.2.1.0)
|
110
|
+
ruby-progressbar (1.13.0)
|
111
|
+
ruby-terraform (1.7.0)
|
112
|
+
immutable-struct (~> 2.4)
|
113
|
+
lino (~> 3.0)
|
114
|
+
serverspec (2.42.2)
|
66
115
|
multi_json
|
67
116
|
rspec (~> 3.0)
|
68
117
|
rspec-its
|
69
|
-
specinfra (~> 2.
|
118
|
+
specinfra (~> 2.72)
|
70
119
|
sfl (2.3)
|
71
|
-
specinfra (2.
|
120
|
+
specinfra (2.85.0)
|
72
121
|
net-scp
|
73
122
|
net-ssh (>= 2.7)
|
74
123
|
net-telnet (= 0.1.1)
|
75
124
|
sfl
|
76
|
-
|
125
|
+
timers (4.3.5)
|
126
|
+
traces (0.9.1)
|
127
|
+
unicode-display_width (2.4.2)
|
77
128
|
|
78
129
|
PLATFORMS
|
79
|
-
|
80
|
-
x86_64-
|
130
|
+
x86_64-darwin-20
|
131
|
+
x86_64-linux
|
81
132
|
|
82
133
|
DEPENDENCIES
|
83
134
|
cem_acpt!
|
84
|
-
|
85
|
-
|
135
|
+
pry
|
136
|
+
rake (>= 12.0)
|
137
|
+
rspec (>= 3.0)
|
86
138
|
rubocop
|
87
139
|
|
88
140
|
BUNDLED WITH
|
89
|
-
2.
|
141
|
+
2.4.6
|
data/README.md
CHANGED
@@ -1,150 +1,211 @@
|
|
1
1
|
# CemAcpt
|
2
2
|
|
3
|
-
CemAcpt is an acceptance testing library / command line application for running acceptance tests
|
3
|
+
CemAcpt is an acceptance testing library / command line application for running acceptance tests for the CEM modules.
|
4
4
|
|
5
|
-
CemAcpt
|
5
|
+
CemAcpt uses [Terraform](#terraform) for provisioning test nodes, and [Goss](#goss) to execute acceptance tests.
|
6
6
|
|
7
|
-
|
7
|
+
## Installation
|
8
8
|
|
9
|
-
|
10
|
-
|
11
|
-
|
12
|
-
- CemAcpt has it's own CLI for running provisioning of hosts and the test suite and does not use `rake`.
|
13
|
-
- CemAcpt runs everything, including provisioning the test node, creating a temporary manifest on the test node, and running the acceptance test on the test node, in parallel. No matter how many test / host combinations there are, running the test suite will only take as long as the longest running single test / host combo.
|
14
|
-
- CemAcpt is configurable via a YAML file.
|
9
|
+
```bash
|
10
|
+
gem install cem_acpt
|
11
|
+
```
|
15
12
|
|
16
|
-
|
13
|
+
`cem_acpt` was developed using Ruby 3.2.1, but other Ruby versions may work.
|
17
14
|
|
18
|
-
|
15
|
+
## Usage
|
19
16
|
|
20
|
-
###
|
17
|
+
### Quickstart
|
21
18
|
|
22
|
-
|
19
|
+
Make sure Terraform is installed and in your PATH. Instructions for installing Terraform can be found [here](https://learn.hashicorp.com/tutorials/terraform/install-cli).Then, navigate to the root of the `cem_linux` module and run the following command:
|
23
20
|
|
24
|
-
|
21
|
+
```bash
|
22
|
+
cem_acpt --config ./cem_acpt_config.yaml
|
23
|
+
```
|
25
24
|
|
26
|
-
|
25
|
+
### Command-line
|
27
26
|
|
28
|
-
|
27
|
+
```bash
|
28
|
+
cem_acpt -h | --help
|
29
|
+
```
|
29
30
|
|
30
|
-
|
31
|
+
> If you do not delete Gemfile.lock before running `bundle install`, you may encounter dependency version errors. Just delete Gemfile.lock and run `bundle install` again to get past these.
|
31
32
|
|
32
|
-
|
33
|
+
## Test directory structure
|
33
34
|
|
34
|
-
|
35
|
-
|
36
|
-
|
35
|
+
CemAcpt expects a specific directory structure for your acceptance tests. The directory structure is as follows:
|
36
|
+
|
37
|
+
```bash
|
38
|
+
spec
|
39
|
+
└── acceptance
|
40
|
+
└── <framework>_<os>-<version>_firewalld_<profile>_<level>
|
41
|
+
├── goss.yaml # Goss test file
|
42
|
+
└── manifest.pp # Puppet manifest to apply
|
37
43
|
```
|
38
44
|
|
39
|
-
|
45
|
+
For example, the following directory structure would be valid:
|
40
46
|
|
41
|
-
|
47
|
+
```bash
|
48
|
+
spec
|
49
|
+
└── acceptance
|
50
|
+
└── cis_rhel-8_firewalld_server_2
|
51
|
+
├── goss.yaml
|
52
|
+
└── manifest.pp
|
53
|
+
```
|
42
54
|
|
43
|
-
|
55
|
+
The directory name is used to generate test data. See [Test data](#test-data) for more information. The file `goss.yaml` is used as the [Goss](#goss) test file. The file `manifest.pp` is used as the Puppet manifest to apply.
|
44
56
|
|
45
|
-
|
57
|
+
## Configuration
|
46
58
|
|
47
|
-
|
59
|
+
There are several ways to configure CemAcpt which are outlined below in order of precendence. Options specified later in the list will be merged with or override options specified earlier in the list. If an option is specified in multiple places, the last place it is specified will be used.
|
48
60
|
|
49
|
-
|
61
|
+
1. [Environment variables](#environment-variables)
|
62
|
+
2. [User-specific config file](#config-file)
|
63
|
+
3. [Config file specified by `--config` option](#config-file)
|
64
|
+
4. [Command-line options](#command-line-options)
|
50
65
|
|
51
|
-
|
66
|
+
You can view your working config by adding the `-Y` flag to any command. This will print the merged config to STDOUT as a YAML document. You can also use the `-X` flag to print an explanation of how the config was merged.
|
52
67
|
|
53
|
-
|
54
|
-
test_data:
|
55
|
-
for_each:
|
56
|
-
collection:
|
57
|
-
- puppet6
|
58
|
-
- puppet7
|
68
|
+
### Environment variables
|
59
69
|
|
60
|
-
|
61
|
-
|
70
|
+
Environment variables are the most basic way to configure CemAcpt. They are useful for setting sensitive information like API keys or passwords. Environment variables are prefixed with `CEM_ACPT_` and are converted to the nested structure of the config file, if applicable. Double underscores \(`__`\) are used to separate key levels. For example, the environment variable `CEM_ACPT_NODE_DATA__DISK_SIZE=40` would be converted to the following config:
|
71
|
+
|
72
|
+
```yaml
|
73
|
+
node_data:
|
74
|
+
disk_size: 40
|
62
75
|
```
|
63
76
|
|
64
|
-
|
77
|
+
All environment variables are optional. If an environment variable is not set, the value will be taken from the config file or command-line option. If an environment variable is set, it will be overridden by the same value from the config file or command-line option.
|
65
78
|
|
66
|
-
|
79
|
+
### Config file
|
67
80
|
|
68
|
-
|
81
|
+
The most common way is to create a config file and pass it to CemAcpt using the `--config` option. The config file should be a YAML file. See [sample_config.yaml](sample_config.yaml) for an example.
|
69
82
|
|
70
|
-
|
83
|
+
You can also create a user-specific config file at `$HOME/.cem_acpt/config.yaml`. This file will be merged with the config file specified by the `--config` option. This is useful for storing sensitive information or making config changes that you don't want to commit to a repo.
|
71
84
|
|
72
|
-
|
85
|
+
Options set in the user-specific config file will be overridden by options set in the config file specified by the `--config` option. Both config files will override options specified by environment variables.
|
73
86
|
|
74
|
-
|
87
|
+
### Command-line options
|
75
88
|
|
76
|
-
|
89
|
+
CemAcpt can be configured using command-line options. These options are specified using the `--<option>` syntax. For a full list of options, run `cem_acpt -h`. Options specified on the command-line will override options specified in the config file and environment variables.
|
77
90
|
|
78
|
-
|
91
|
+
## Goss
|
79
92
|
|
80
|
-
|
93
|
+
[Goss](https://github.com/goss-org/goss/blob/master/docs/manual.md) is the core infrastructure testing tool used by CemAcpt. The `goss.yaml` file is used to specify the tests to run. Please see the [Goss documentation](https://github.com/goss-org/goss/blob/master/docs/manual.md#goss-test-creation) for more information on how to write Goss tests.
|
81
94
|
|
82
|
-
##
|
95
|
+
## Terraform
|
83
96
|
|
84
|
-
|
97
|
+
CemAcpt uses [Terraform](https://www.terraform.io/) for managing the lifecycle of test nodes. Users don't interact with Terraform directly, but you will need it installed to use CemAcpt.
|
85
98
|
|
86
|
-
|
99
|
+
## Platforms
|
87
100
|
|
88
|
-
|
101
|
+
Platforms are the underlying infrastructure that nodes are provisioned on. Currently, only GCP is supported. Each platform has two parts to it: the [platform](#platform) and the [node data](#node-data).
|
89
102
|
|
90
|
-
###
|
103
|
+
### Platform
|
91
104
|
|
92
|
-
|
105
|
+
A platform represents where nodes are provisioned. Currently, only GCP is supported. Platforms are configured using the top-level key `platform`. For example, the following config would configure a GCP platform:
|
93
106
|
|
94
|
-
```
|
95
|
-
|
107
|
+
```yaml
|
108
|
+
platform:
|
109
|
+
name: gcp
|
110
|
+
project: my-project
|
111
|
+
region: us-west1
|
112
|
+
zone: us-west1-b
|
113
|
+
subnetwork: my-subnetwork
|
96
114
|
```
|
97
115
|
|
98
|
-
|
116
|
+
### Node data
|
99
117
|
|
100
|
-
|
101
|
-
require 'cem_acpt'
|
118
|
+
Node data is a more generic complement to the [platform](#platform) that specifies node-level details for test nodes. Node data is configured using the top-level key `node_data`. For example, the following config would configure node data:
|
102
119
|
|
103
|
-
|
120
|
+
```yaml
|
121
|
+
node_data:
|
122
|
+
disk_size: 40
|
123
|
+
machine_type: e2-small
|
104
124
|
```
|
105
125
|
|
106
|
-
|
126
|
+
### Developing new platforms
|
127
|
+
|
128
|
+
Platforms are defined as Ruby files in the `lib/cem_acpt/platform` directory. Each platform file should define a module called `Platform` that implements the following methods:
|
107
129
|
|
108
130
|
```ruby
|
109
|
-
|
110
|
-
|
111
|
-
|
131
|
+
module Platform
|
132
|
+
# @return [Hash] A hash of platform data
|
133
|
+
def platform_data
|
134
|
+
# Return a hash of platform data
|
135
|
+
end
|
136
|
+
|
137
|
+
# @return [Hash] A hash of node data
|
138
|
+
def node_data
|
139
|
+
# Destroy a node
|
140
|
+
end
|
141
|
+
end
|
112
142
|
```
|
113
143
|
|
114
|
-
|
144
|
+
Both the `#platform_data` and `#node_data` methods should return a hash. Each method should also also ensure the config is queried for values for each key in each hash. This is enabled by the exposed instance variables `@config` and `@test_data` in the `Platform` module. For an example, see the [GCP platform](lib/cem_acpt/platform/gcp.rb).
|
115
145
|
|
116
|
-
|
146
|
+
## Tests
|
117
147
|
|
118
|
-
|
148
|
+
Each acceptance test should be specified in the config under the top-level key `tests`. These tests SHOULD NOT be paths, just the test directory name. For example, if you have an acceptance test directory `spec/acceptance/cis_rhel_acceptance_test/*`, the tests config would look like this:
|
119
149
|
|
120
|
-
|
121
|
-
|
122
|
-
-
|
150
|
+
```yaml
|
151
|
+
tests:
|
152
|
+
- our_acceptance_test
|
153
|
+
```
|
123
154
|
|
124
|
-
|
155
|
+
Aside from ways of manipulating test data outlined below, tests are typically matched one-to-one with a test node.
|
156
|
+
|
157
|
+
## Test data
|
158
|
+
|
159
|
+
Test data is a collection of data about a specific test that persists through the entire acceptance test suite lifecycle. Specifically, test data is implemented as an array of hashes with each hash representing a single run through the acceptance test suite lifecycle. What this means is that each item in the test data array is couple with a single test node that is provisioned and a single test run against that node. Test data is used to store values that are test-specific, as opposed to node data which is generic.
|
160
|
+
|
161
|
+
Test data can be configured using the top-level key `test_data`. There are several supported options for manipulating test data:
|
162
|
+
|
163
|
+
### for_each
|
164
|
+
|
165
|
+
When specified, should be a hash of `key -> Array` pairs. For each of these pairs, a copy of the test data is made for each item in the array, with that item becoming the value of a variable `key`.
|
125
166
|
|
126
|
-
|
167
|
+
Example:
|
127
168
|
|
128
|
-
|
129
|
-
|
130
|
-
|
131
|
-
|
132
|
-
-
|
169
|
+
```yaml
|
170
|
+
test_data:
|
171
|
+
for_each:
|
172
|
+
collection:
|
173
|
+
- puppet6
|
174
|
+
- puppet7
|
133
175
|
|
134
|
-
|
176
|
+
tests:
|
177
|
+
- our_acceptance_test
|
178
|
+
```
|
179
|
+
|
180
|
+
In the above config, instead of test data consisting of a single hash, it will have two hashes that have the `collection` variable set to `puppet6` and `puppet7` respectively. This means that there will be two test nodes provisioned and two runs of the test `our_acceptance_test`, one run against each node.
|
181
|
+
|
182
|
+
### vars
|
135
183
|
|
136
|
-
|
184
|
+
Aribitrary key-value pairs that are injected into the test data hashes. Think of these as constants.
|
137
185
|
|
138
|
-
|
186
|
+
### name_pattern_vars
|
139
187
|
|
140
|
-
|
188
|
+
A Ruby regex pattern that is matched against the test name with the intent of creating variables from named capture groups. See [sample_config.yaml](sample_config.yaml) for an example.
|
141
189
|
|
142
|
-
|
190
|
+
### vars_post_processing
|
143
191
|
|
144
|
-
|
192
|
+
Rules that allow for processing variables after all other test data rules are ran. See [sample_config.yaml](sample_config.yaml) for an example.
|
145
193
|
|
146
|
-
|
194
|
+
## Image name builder
|
147
195
|
|
148
|
-
|
196
|
+
Much like `name_pattern_vars`, specifying the `image_name_builder` top-level key in the config allows you to manipulate acceptance test names to create a special test data variable called `image_name`. This is helpful for when you have multiple platform base images and want to use the correct image with the correct test. See [sample_config.yaml](sample_config.yaml) for an example.
|
149
197
|
|
150
|
-
The
|
198
|
+
## The acceptance test lifecycle
|
199
|
+
|
200
|
+
- Load and merge the config
|
201
|
+
- Create the local test directory under `$HOME/.cem_acpt`
|
202
|
+
- Build the Puppet module. Uses current dir if no `module_dir` is specified in the config
|
203
|
+
- Copy all relevant files into the local test directory
|
204
|
+
- This includes the Terraform files provided by CemAcpt, as well as the files under the specified acceptance test directory, and the built Puppet module
|
205
|
+
- Provision test nodes using Terraform
|
206
|
+
- After the node is created, the contents of the local test directory are copied to the node
|
207
|
+
- Additionally, the Puppet module is installed on the node and Puppet is ran once to apply `manifest.pp`
|
208
|
+
- After, the Goss server endpoints are started and exposed on the node
|
209
|
+
- Once node is provisioned, make HTTP get requests to the Goss server endpoints to run the tests
|
210
|
+
- Destroy the test nodes
|
211
|
+
- Report the results of the tests
|
data/cem_acpt.gemspec
CHANGED
@@ -26,12 +26,17 @@ Gem::Specification.new do |spec|
|
|
26
26
|
spec.bindir = 'exe'
|
27
27
|
spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
|
28
28
|
spec.require_paths = ['lib']
|
29
|
-
spec.
|
30
|
-
spec.add_runtime_dependency '
|
31
|
-
spec.add_runtime_dependency '
|
32
|
-
spec.add_runtime_dependency '
|
33
|
-
spec.add_runtime_dependency '
|
34
|
-
spec.add_runtime_dependency '
|
35
|
-
spec.add_runtime_dependency '
|
29
|
+
#spec.platform = Gem::Platform.local
|
30
|
+
spec.add_runtime_dependency 'async-http', '>= 0.60', '< 0.70'
|
31
|
+
spec.add_runtime_dependency 'concurrent-ruby', '>= 1.1', '< 2.0'
|
32
|
+
spec.add_runtime_dependency 'deep_merge', '>= 1.2', '< 2.0'
|
33
|
+
spec.add_runtime_dependency 'ed25519', '>= 1.2', '< 2.0'
|
34
|
+
spec.add_runtime_dependency 'bcrypt_pbkdf', '>= 1.0', '< 2.0'
|
35
|
+
spec.add_runtime_dependency 'net-ssh', '>= 7.1', '< 7.2'
|
36
|
+
spec.add_runtime_dependency 'parallel', '~> 1.22'
|
37
|
+
spec.add_runtime_dependency 'puppet-modulebuilder', '>= 0.0.1'
|
38
|
+
spec.add_runtime_dependency 'ruby-terraform', '~> 1.7'
|
39
|
+
spec.add_runtime_dependency 'serverspec', '~> 2.42'
|
40
|
+
spec.add_development_dependency 'pry'
|
36
41
|
spec.add_development_dependency 'rubocop'
|
37
42
|
end
|