beaker-docker 0.8.2 → 0.8.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +23 -29
- data/beaker-docker.gemspec +11 -6
- data/lib/beaker-docker/version.rb +1 -1
- metadata +16 -13
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 334f12192e1c187506529fd753491a8aba885ccf5512d2f681b7b659f4b7f525
|
|
4
|
+
data.tar.gz: ee99cc4537be2eb938639fd4078aa1f95eba859b338531ba206c4035587e103a
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 9df1580cf398c8b43641d9b06e53be3090d2141fd9a9172c1f1a6290f362b5d02819e720ee05046e024c4051a8201001569663feb7716263616f578b0d66fbac
|
|
7
|
+
data.tar.gz: 9e1d910176b66e2576cb170f31b80a97491274248a698c89c5925413c35165afc96cd9da9e4ba2acd4fcd1dea548cec5753211ed796ff0e84a91edce9719ce49
|
data/README.md
CHANGED
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
|
|
3
3
|
Beaker library to use docker hypervisor
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
## How to use this wizardry
|
|
6
6
|
|
|
7
|
-
This gem that allows you to use hosts with [docker](docker.md) hypervisor with [beaker](https://github.com/
|
|
7
|
+
This gem that allows you to use hosts with [docker](docker.md) hypervisor with [beaker](https://github.com/voxpupuli/beaker).
|
|
8
8
|
|
|
9
9
|
Beaker will automatically load the appropriate hypervisors for any given hosts
|
|
10
10
|
file, so as long as your project dependencies are satisfied there's nothing else
|
|
@@ -14,20 +14,20 @@ In order to use a specific hypervisor or DSL extension library in your project,
|
|
|
14
14
|
you will need to include them alongside Beaker in your Gemfile or
|
|
15
15
|
project.gemspec. E.g.
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
```ruby
|
|
18
18
|
# Gemfile
|
|
19
19
|
gem 'beaker', '~> 4.0'
|
|
20
20
|
gem 'beaker-docker'
|
|
21
21
|
# project.gemspec
|
|
22
22
|
s.add_runtime_dependency 'beaker', '~> 4.0'
|
|
23
23
|
s.add_runtime_dependency 'beaker-docker'
|
|
24
|
-
|
|
24
|
+
```
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
### Nodeset Options
|
|
27
27
|
|
|
28
28
|
The following is a sample nodeset:
|
|
29
29
|
|
|
30
|
-
|
|
30
|
+
```yaml
|
|
31
31
|
HOSTS:
|
|
32
32
|
el8:
|
|
33
33
|
platform: el-8-x86_64
|
|
@@ -51,21 +51,21 @@ HOSTS:
|
|
|
51
51
|
CONFIG:
|
|
52
52
|
docker_cap_add:
|
|
53
53
|
- AUDIT_WRITE
|
|
54
|
-
|
|
54
|
+
```
|
|
55
55
|
|
|
56
|
-
|
|
56
|
+
### Privileged containers
|
|
57
57
|
|
|
58
|
-
Containers are
|
|
58
|
+
Containers are run in privileged mode by default unless capabilities are set.
|
|
59
59
|
|
|
60
|
-
If you wish to
|
|
60
|
+
If you wish to disable privileged mode, simply set the following in your node:
|
|
61
61
|
|
|
62
|
-
|
|
62
|
+
```yaml
|
|
63
63
|
dockeropts:
|
|
64
64
|
HostConfig:
|
|
65
|
-
Privileged:
|
|
66
|
-
|
|
65
|
+
Privileged: false
|
|
66
|
+
```
|
|
67
67
|
|
|
68
|
-
|
|
68
|
+
### Cleaning up after tests
|
|
69
69
|
|
|
70
70
|
Containers created by this plugin may not be destroyed unless the tests complete
|
|
71
71
|
successfully. Each container created is prefixed by `beaker-` to make filtering
|
|
@@ -73,11 +73,11 @@ for clean up easier.
|
|
|
73
73
|
|
|
74
74
|
A quick way to clean up all nodes is as follows:
|
|
75
75
|
|
|
76
|
-
|
|
76
|
+
```sh
|
|
77
77
|
podman rm -f $( podman ps -q -f name="beaker-*" )
|
|
78
|
-
|
|
78
|
+
```
|
|
79
79
|
|
|
80
|
-
|
|
80
|
+
## Working with `podman`
|
|
81
81
|
|
|
82
82
|
If you're using a version of `podman` that has API socket support then you
|
|
83
83
|
should be able to simply set `DOCKER_HOST` to your socket and connect as usual.
|
|
@@ -94,14 +94,15 @@ See the
|
|
|
94
94
|
[HostConfig](https://any-api.com/docker_com/engine/docs/Definitions/HostConfig)
|
|
95
95
|
portion of the docker API for more information.
|
|
96
96
|
|
|
97
|
-
|
|
97
|
+
## Spec tests
|
|
98
98
|
|
|
99
99
|
Spec test live under the `spec` folder. There are the default rake task and therefore can run with a simple command:
|
|
100
|
+
|
|
100
101
|
```bash
|
|
101
102
|
bundle exec rake test:spec
|
|
102
103
|
```
|
|
103
104
|
|
|
104
|
-
|
|
105
|
+
## Acceptance tests
|
|
105
106
|
|
|
106
107
|
There is a simple rake task to invoke acceptance test for the library:
|
|
107
108
|
|
|
@@ -109,17 +110,10 @@ There is a simple rake task to invoke acceptance test for the library:
|
|
|
109
110
|
bundle exec rake test:acceptance
|
|
110
111
|
```
|
|
111
112
|
|
|
112
|
-
|
|
113
|
+
## Contributing
|
|
113
114
|
|
|
114
115
|
Please refer to puppetlabs/beaker's [contributing](https://github.com/puppetlabs/beaker/blob/master/CONTRIBUTING.md) guide.
|
|
115
116
|
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
To release new versions of beaker-docker, please use this [jenkins job](https://cinext-jenkinsmaster-sre-prod-1.delivery.puppetlabs.net/view/all/job/qe_beaker-docker_init-multijob_master/). This job
|
|
119
|
-
lives on Puppet-internal infrastructure, so you'll need to be a part of the Puppet org to do this.
|
|
117
|
+
## Releasing
|
|
120
118
|
|
|
121
|
-
To
|
|
122
|
-
sure you check the box next to `PUBLIC` and enter the appropriate version. The
|
|
123
|
-
version should adhere to [semantic version standards](https://semver.org).
|
|
124
|
-
When in doubt, consult the [maintainers of Beaker](https://github.com/puppetlabs/beaker/blob/master/CODEOWNERS)
|
|
125
|
-
for guidance.
|
|
119
|
+
To release new versions of beaker-docker, please use update `lib/beaker-docker/version.rb` with the new version number. The version should adhere to [semantic version standards](https://semver.org). When in doubt, ask in the `#voxpupuli` channel of the Puppet community Slack or in `#voxpupuli` on irc.freenode.net ([Webinterface](https://webchat.freenode.net/?channels=%23voxpupuli)).
|
data/beaker-docker.gemspec
CHANGED
|
@@ -5,12 +5,17 @@ require 'beaker-docker/version'
|
|
|
5
5
|
Gem::Specification.new do |s|
|
|
6
6
|
s.name = "beaker-docker"
|
|
7
7
|
s.version = BeakerDocker::VERSION
|
|
8
|
-
s.authors = [
|
|
9
|
-
|
|
10
|
-
|
|
8
|
+
s.authors = [
|
|
9
|
+
"Vox Pupuli",
|
|
10
|
+
"Rishi Javia",
|
|
11
|
+
"Kevin Imber",
|
|
12
|
+
"Tony Vu"
|
|
13
|
+
]
|
|
14
|
+
s.email = ["voxpupuli@groups.io"]
|
|
15
|
+
s.homepage = "https://github.com/voxpupuli/beaker-docker"
|
|
11
16
|
s.summary = %q{Beaker DSL Extension Helpers!}
|
|
12
17
|
s.description = %q{For use for the Beaker acceptance testing tool}
|
|
13
|
-
s.license = '
|
|
18
|
+
s.license = 'Apache-2.0'
|
|
14
19
|
|
|
15
20
|
s.files = `git ls-files`.split("\n")
|
|
16
21
|
s.test_files = `git ls-files -- {test,spec,features}/*`.split("\n")
|
|
@@ -19,10 +24,10 @@ Gem::Specification.new do |s|
|
|
|
19
24
|
|
|
20
25
|
# Testing dependencies
|
|
21
26
|
s.add_development_dependency 'rspec', '~> 3.0'
|
|
22
|
-
s.add_development_dependency 'rspec-its'
|
|
27
|
+
s.add_development_dependency 'rspec-its', '~> 1.3'
|
|
23
28
|
s.add_development_dependency 'fakefs', '~> 1.3'
|
|
24
29
|
s.add_development_dependency 'rake', '~> 13.0'
|
|
25
|
-
s.add_development_dependency 'simplecov'
|
|
30
|
+
s.add_development_dependency 'simplecov', '~> 0.18'
|
|
26
31
|
s.add_development_dependency 'pry', '~> 0.10'
|
|
27
32
|
|
|
28
33
|
# Run time dependencies
|
metadata
CHANGED
|
@@ -1,10 +1,13 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: beaker-docker
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.8.
|
|
4
|
+
version: 0.8.3
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
|
-
-
|
|
7
|
+
- Vox Pupuli
|
|
8
|
+
- Rishi Javia
|
|
9
|
+
- Kevin Imber
|
|
10
|
+
- Tony Vu
|
|
8
11
|
autorequire:
|
|
9
12
|
bindir: bin
|
|
10
13
|
cert_chain: []
|
|
@@ -28,16 +31,16 @@ dependencies:
|
|
|
28
31
|
name: rspec-its
|
|
29
32
|
requirement: !ruby/object:Gem::Requirement
|
|
30
33
|
requirements:
|
|
31
|
-
- - "
|
|
34
|
+
- - "~>"
|
|
32
35
|
- !ruby/object:Gem::Version
|
|
33
|
-
version: '
|
|
36
|
+
version: '1.3'
|
|
34
37
|
type: :development
|
|
35
38
|
prerelease: false
|
|
36
39
|
version_requirements: !ruby/object:Gem::Requirement
|
|
37
40
|
requirements:
|
|
38
|
-
- - "
|
|
41
|
+
- - "~>"
|
|
39
42
|
- !ruby/object:Gem::Version
|
|
40
|
-
version: '
|
|
43
|
+
version: '1.3'
|
|
41
44
|
- !ruby/object:Gem::Dependency
|
|
42
45
|
name: fakefs
|
|
43
46
|
requirement: !ruby/object:Gem::Requirement
|
|
@@ -70,16 +73,16 @@ dependencies:
|
|
|
70
73
|
name: simplecov
|
|
71
74
|
requirement: !ruby/object:Gem::Requirement
|
|
72
75
|
requirements:
|
|
73
|
-
- - "
|
|
76
|
+
- - "~>"
|
|
74
77
|
- !ruby/object:Gem::Version
|
|
75
|
-
version: '0'
|
|
78
|
+
version: '0.18'
|
|
76
79
|
type: :development
|
|
77
80
|
prerelease: false
|
|
78
81
|
version_requirements: !ruby/object:Gem::Requirement
|
|
79
82
|
requirements:
|
|
80
|
-
- - "
|
|
83
|
+
- - "~>"
|
|
81
84
|
- !ruby/object:Gem::Version
|
|
82
|
-
version: '0'
|
|
85
|
+
version: '0.18'
|
|
83
86
|
- !ruby/object:Gem::Dependency
|
|
84
87
|
name: pry
|
|
85
88
|
requirement: !ruby/object:Gem::Requirement
|
|
@@ -124,7 +127,7 @@ dependencies:
|
|
|
124
127
|
version: 3.0.0
|
|
125
128
|
description: For use for the Beaker acceptance testing tool
|
|
126
129
|
email:
|
|
127
|
-
-
|
|
130
|
+
- voxpupuli@groups.io
|
|
128
131
|
executables:
|
|
129
132
|
- beaker-docker
|
|
130
133
|
extensions: []
|
|
@@ -149,9 +152,9 @@ files:
|
|
|
149
152
|
- lib/beaker/hypervisor/docker.rb
|
|
150
153
|
- spec/beaker/hypervisor/docker_spec.rb
|
|
151
154
|
- spec/spec_helper.rb
|
|
152
|
-
homepage: https://github.com/
|
|
155
|
+
homepage: https://github.com/voxpupuli/beaker-docker
|
|
153
156
|
licenses:
|
|
154
|
-
-
|
|
157
|
+
- Apache-2.0
|
|
155
158
|
metadata: {}
|
|
156
159
|
post_install_message:
|
|
157
160
|
rdoc_options: []
|