beaker-docker 0.8.2 → 0.8.3
Sign up to get free protection for your applications and to get access to all the features.
- 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: []
|