kitchen-rackspace 0.21.2 → 0.22.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5d9f0cfda1b6fe90dea83cb1122c21a7faf73ae011bc04853326875b0655018
-  data.tar.gz: a2ec7b058022a9b8af978504e7e4e836f2951d9aae241db3fa1d08e4357fc90e
+  metadata.gz: e15a887394d3ed26e459527e63a809e9cc8e0ac881c831eab8b71a9a585d5833
+  data.tar.gz: 23b98c7da4db1e2361bf0734069a6303ed1d976334977e296bb6e2935420d2b5
 SHA512:
-  metadata.gz: 8e70ff48c1b0874fc139b22869b3acea10d46727a038ef294f731aa22955238f71afa30480c9ed4fcfa24cd4bba2c360076967a4ac16f7561c9d95d1a5669c78
-  data.tar.gz: 0b1d5316304df8961bf18fda87f2bddad50f9d3e19b0da9905c6f13a9773e0807c075aa57da978961417cb12ba84d6d1241c6dfeb152cf1fd5ae2d43abee6a43
+  metadata.gz: '059d13472f0a85ce909b4ca0ad5b14873f19c88e7b8709d4181e9980d2e0663735d3512e9d61ca1e366a6bce1b0d96599b8e4975f242275e7b6779ca5d035a3f'
+  data.tar.gz: 365fead87993ea3f203f48de1512e747eb6cbe8d5de7746db9a025fce7ee570065d3eba539535978823391115b84f199f07ab809e2e0427db267f01b4819caa9

data/.github/workflows/publish.yaml

@@ -9,7 +9,7 @@ jobs:
   release-please:
     runs-on: ubuntu-latest
     steps:
-      - uses: googleapis/release-please-action@v4
+      - uses: googleapis/release-please-action@v5
         id: release
         with:
           token: ${{ secrets.PORTER_GITHUB_TOKEN }}

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.21.2"
+  ".": "0.22.1"
 }

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/.rubocop.yml

@@ -1,11 +1,9 @@
 ---
 require:
-  - chefstyle
+  - cookstyle/chefstyle
 
 AllCops:
   TargetRubyVersion: 3.1
-  Include:
-    - "**/*.rb"
   Exclude:
     - "vendor/**/*"
     - "spec/**/*"

data/.yamllint

@@ -0,0 +1,6 @@
+---
+extends: default
+rules:
+  line-length:
+    max: 256
+    level: warning

data/.yardopts

@@ -0,0 +1,11 @@
+--markup markdown
+--output-dir doc
+--readme README.md
+--title "kitchen-rackspace"
+--protected
+--private
+lib/**/*.rb
+-
+CHANGELOG.md
+CONTRIBUTING.md
+LICENSE

data/CHANGELOG.md

@@ -1,14 +1,47 @@
 # Kitchen-rackspace Changelog
 
-## [0.21.2](https://github.com/test-kitchen/kitchen-rackspace/compare/v0.21.1...v0.21.2) (2026-01-22)
+## Unreleased
+
+* Update actions/checkout action to v7 ([#118](https://github.com/test-kitchen/kitchen-rackspace/pull/118)) ([ffe0696](https://github.com/test-kitchen/kitchen-rackspace/commit/ffe0696))
+* Update googleapis/release-please-action action to v5 ([#117](https://github.com/test-kitchen/kitchen-rackspace/pull/117)) ([836d55b](https://github.com/test-kitchen/kitchen-rackspace/commit/836d55b))
+* Require Ruby 3.1+ and modernize CI ([#119](https://github.com/test-kitchen/kitchen-rackspace/pull/119)) ([d277ba1](https://github.com/test-kitchen/kitchen-rackspace/commit/d277ba1))
+* Let cookstyle decide which files to lint ([#120](https://github.com/test-kitchen/kitchen-rackspace/pull/120)) ([80d515c](https://github.com/test-kitchen/kitchen-rackspace/commit/80d515c))
+* Docs: rewrite README for new users and split contributor docs ([#121](https://github.com/test-kitchen/kitchen-rackspace/pull/121)) ([638440a](https://github.com/test-kitchen/kitchen-rackspace/commit/638440a))
+* Remove dependabot config in favor of renovate ([#122](https://github.com/test-kitchen/kitchen-rackspace/pull/122)) ([92dcec9](https://github.com/test-kitchen/kitchen-rackspace/commit/92dcec9))
+
+## [0.22.1](https://github.com/test-kitchen/kitchen-rackspace/compare/v0.22.0...v0.22.1) (2026-08-30)
 
 
+### Bug Fixes
+
+* check credentials with a call fog-rackspace actually implements ([#133](https://github.com/test-kitchen/kitchen-rackspace/issues/133)) ([a3b35fb](https://github.com/test-kitchen/kitchen-rackspace/commit/a3b35fb72290a2372d32f9b2e1156d49742ebaef))
+
+## [0.22.0](https://github.com/test-kitchen/kitchen-rackspace/compare/v0.21.2...v0.22.0) (2026-08-24)
+
+
+### Features
+
+* implement the driver api version, plugin version, status, and doctor hooks ([#128](https://github.com/test-kitchen/kitchen-rackspace/issues/128)) ([5dcd484](https://github.com/test-kitchen/kitchen-rackspace/commit/5dcd484b352f0394feea9a634525a50d5e15b01c))
+
+
+### Bug Fixes
+
+* default to the general1-2 flavor instead of the retired performance1-1 ([#130](https://github.com/test-kitchen/kitchen-rackspace/issues/130)) ([5228814](https://github.com/test-kitchen/kitchen-rackspace/commit/52288148a5d177c67be1cdeb98d06aef94a5bf97))
+* require test-kitchen 3.0 or newer ([#125](https://github.com/test-kitchen/kitchen-rackspace/issues/125)) ([37c1753](https://github.com/test-kitchen/kitchen-rackspace/commit/37c1753de5e63d5d2bb3772c19912b443328a41b))
+
+## [0.21.2](https://github.com/test-kitchen/kitchen-rackspace/compare/v0.21.1...v0.21.2) (2026-01-22)
+
 ### Bug Fixes
 
 * bump tk dep to allow tk 4 ([#115](https://github.com/test-kitchen/kitchen-rackspace/issues/115)) ([c6bc76c](https://github.com/test-kitchen/kitchen-rackspace/commit/c6bc76c10f4b4cd66c8b429ae50a713ff63dbe46))
 
-## [0.21.1](https://github.com/test-kitchen/kitchen-rackspace/compare/v0.21.0...v0.21.1) (2024-07-01)
+### Other Changes
 
+* chore(deps): update actions/checkout action to v5 ([#113](https://github.com/test-kitchen/kitchen-rackspace/pull/113)) ([76a0e97](https://github.com/test-kitchen/kitchen-rackspace/commit/76a0e97))
+* Update fog-core requirement from >= 1.35, < 2.1.1 to >= 1.35, < 2.6.1 ([#112](https://github.com/test-kitchen/kitchen-rackspace/pull/112)) ([f2765bb](https://github.com/test-kitchen/kitchen-rackspace/commit/f2765bb))
+* chore(deps): update actions/checkout action to v6 ([#114](https://github.com/test-kitchen/kitchen-rackspace/pull/114)) ([c1e87f1](https://github.com/test-kitchen/kitchen-rackspace/commit/c1e87f1))
+
+## [0.21.1](https://github.com/test-kitchen/kitchen-rackspace/compare/v0.21.0...v0.21.1) (2024-07-01)
 
 ### Features
 
@@ -19,11 +52,42 @@
 
 * release please configs ([#108](https://github.com/test-kitchen/kitchen-rackspace/issues/108)) ([e8773c1](https://github.com/test-kitchen/kitchen-rackspace/commit/e8773c18e89d8dde724bfa06028678fb43da18a0))
 
+### Other Changes
+
+* Image data update and script fixes ([#72](https://github.com/test-kitchen/kitchen-rackspace/pull/72)) ([8048e4a](https://github.com/test-kitchen/kitchen-rackspace/commit/8048e4a))
+* Add support for setting region via ENV ([#62](https://github.com/test-kitchen/kitchen-rackspace/pull/62)) ([da415e9](https://github.com/test-kitchen/kitchen-rackspace/commit/da415e9))
+* Add support for user_data and config_drive options ([#75](https://github.com/test-kitchen/kitchen-rackspace/pull/75)) ([569de68](https://github.com/test-kitchen/kitchen-rackspace/commit/569de68))
+* Drop Ruby 1.9/2.0 support and get the build green ([#77](https://github.com/test-kitchen/kitchen-rackspace/pull/77)) ([169da5d](https://github.com/test-kitchen/kitchen-rackspace/commit/169da5d))
+* Remove gemnasium badge ([#76](https://github.com/test-kitchen/kitchen-rackspace/pull/76)) ([564dd7b](https://github.com/test-kitchen/kitchen-rackspace/commit/564dd7b))
+* Update README.md ([d954a2d](https://github.com/test-kitchen/kitchen-rackspace/commit/d954a2d))
+* Unpin the bundler dev dep ([#82](https://github.com/test-kitchen/kitchen-rackspace/pull/82)) ([c0ca2b6](https://github.com/test-kitchen/kitchen-rackspace/commit/c0ca2b6))
+* Test on modern ruby releases ([#83](https://github.com/test-kitchen/kitchen-rackspace/pull/83)) ([0f3ba1e](https://github.com/test-kitchen/kitchen-rackspace/commit/0f3ba1e))
+* Update test-kitchen requirement from ~> 1.1 to >= 1.1, < 3.0 ([#78](https://github.com/test-kitchen/kitchen-rackspace/pull/78)) ([4c0a9a2](https://github.com/test-kitchen/kitchen-rackspace/commit/4c0a9a2))
+* Update rake requirement from ~> 11.0 to ~> 12.3 ([#79](https://github.com/test-kitchen/kitchen-rackspace/pull/79)) ([2335fc7](https://github.com/test-kitchen/kitchen-rackspace/commit/2335fc7))
+* Optimize our requires ([#84](https://github.com/test-kitchen/kitchen-rackspace/pull/84)) ([7e2f55e](https://github.com/test-kitchen/kitchen-rackspace/commit/7e2f55e))
+* Upgrade to GitHub-native Dependabot ([#85](https://github.com/test-kitchen/kitchen-rackspace/pull/85)) ([3dbf701](https://github.com/test-kitchen/kitchen-rackspace/commit/3dbf701))
+* Support Test Kitchen 3.0 and require Ruby 2.5+ ([#86](https://github.com/test-kitchen/kitchen-rackspace/pull/86)) ([f64d95a](https://github.com/test-kitchen/kitchen-rackspace/commit/f64d95a))
+* Update rake requirement from ~> 12.3 to ~> 13.0 ([#88](https://github.com/test-kitchen/kitchen-rackspace/pull/88)) ([a964c1c](https://github.com/test-kitchen/kitchen-rackspace/commit/a964c1c))
+* Update rubocop requirement from ~> 0.57.2 to ~> 1.18.2 ([#87](https://github.com/test-kitchen/kitchen-rackspace/pull/87)) ([5c255ad](https://github.com/test-kitchen/kitchen-rackspace/commit/5c255ad))
+* Update rubocop requirement from ~> 1.18.2 to ~> 1.19.0 ([#89](https://github.com/test-kitchen/kitchen-rackspace/pull/89)) ([ecf7239](https://github.com/test-kitchen/kitchen-rackspace/commit/ecf7239))
+* Update rubocop requirement from ~> 1.19.0 to ~> 1.22.0 ([#92](https://github.com/test-kitchen/kitchen-rackspace/pull/92)) ([a6db161](https://github.com/test-kitchen/kitchen-rackspace/commit/a6db161))
+* Update rubocop requirement from ~> 1.22.0 to ~> 1.25.0 ([#96](https://github.com/test-kitchen/kitchen-rackspace/pull/96)) ([aedff22](https://github.com/test-kitchen/kitchen-rackspace/commit/aedff22))
+* Update rubocop requirement from ~> 1.25.0 to ~> 1.26.0 ([#97](https://github.com/test-kitchen/kitchen-rackspace/pull/97)) ([f08f440](https://github.com/test-kitchen/kitchen-rackspace/commit/f08f440))
+* Update rubocop requirement from ~> 1.26.0 to ~> 1.27.0 ([#98](https://github.com/test-kitchen/kitchen-rackspace/pull/98)) ([c5ec7a8](https://github.com/test-kitchen/kitchen-rackspace/commit/c5ec7a8))
+* Update rubocop requirement from ~> 1.27.0 to ~> 1.28.2 ([#100](https://github.com/test-kitchen/kitchen-rackspace/pull/100)) ([b97a0f4](https://github.com/test-kitchen/kitchen-rackspace/commit/b97a0f4))
+* Reuse the exising workflows ([#101](https://github.com/test-kitchen/kitchen-rackspace/pull/101)) ([d9d983b](https://github.com/test-kitchen/kitchen-rackspace/commit/d9d983b))
+* Remove old badges ([12fc6ef](https://github.com/test-kitchen/kitchen-rackspace/commit/12fc6ef))
+* Delete .travis.yml ([19e58bc](https://github.com/test-kitchen/kitchen-rackspace/commit/19e58bc))
+* Remove travis badge ([8c154d6](https://github.com/test-kitchen/kitchen-rackspace/commit/8c154d6))
+
 ## 0.21.0 / 2016-05-31
 
 * PR [#67] - Update image IDS; via [@martinb3]
 * PR [#65] - Add Ubuntu 16.04; via [@coderanger]
 
+* Fix rubocop ([#66](https://github.com/test-kitchen/kitchen-rackspace/pull/66)) ([3908cec](https://github.com/test-kitchen/kitchen-rackspace/commit/3908cec))
+* Adding Ubuntu 16.04. ([#68](https://github.com/test-kitchen/kitchen-rackspace/pull/68)) ([e1884a2](https://github.com/test-kitchen/kitchen-rackspace/commit/e1884a2))
+
 ## 0.20.0 / 2016-01-15
 
 * PR [#63] - Update image IDs, add Ubuntu 15.10, drop Ubuntu 15.04; via
@@ -35,6 +99,9 @@
 * PR [#57] - Add `servicelevel_wait` option; via [@martinb3]
 * PR [#56] - Add `no_passwd_lock` option; via [@martinb3]
 
+* Update image list ([#53](https://github.com/test-kitchen/kitchen-rackspace/pull/53)) ([735aadd](https://github.com/test-kitchen/kitchen-rackspace/commit/735aadd))
+* Drop the Ruby 1.9 CI build ([#58](https://github.com/test-kitchen/kitchen-rackspace/pull/58)) ([14a5b8b](https://github.com/test-kitchen/kitchen-rackspace/commit/14a5b8b))
+
 ## 0.18.0 / 2015-08-28
 
 * PR [#53] - Update image IDs, update Arch to 2015.7, drop Fedora 20, add
@@ -50,17 +117,26 @@ drop Ubuntu 14.10
 * PR [#50] - Update image IDs, support 'centos-7.0' in addition to
 'centos-7'; via [@martinb3]
 
+* Update badge URLs ([8edf7d0](https://github.com/test-kitchen/kitchen-rackspace/commit/8edf7d0))
+
 ## 0.15.1 / 2015-04-03
 
 * PR [#49] - Update image IDs, re-add CentOS point release numbers; via
 [@martinb3]
 
+* Enable Travis containers and gemset caching ([8cad60c](https://github.com/test-kitchen/kitchen-rackspace/commit/8cad60c))
+
 ## 0.15.0 / 2015-04-02
 
 * PR [#48] - Drop references to retired Ubuntu 10.04 image
 * PR [#46] - Update all image IDs, add Scientific 7, remove references to
 point releases that Rackspace no longer uses in image names; via [@martinb3]
 
+* Fix unit tests ([#47](https://github.com/test-kitchen/kitchen-rackspace/pull/47)) ([23de895](https://github.com/test-kitchen/kitchen-rackspace/commit/23de895))
+* s/2014/2015 ([4ee45e1](https://github.com/test-kitchen/kitchen-rackspace/commit/4ee45e1))
+* Fix bad syntax in gemspec ([9883188](https://github.com/test-kitchen/kitchen-rackspace/commit/9883188))
+* Add dev dep gem constraints to satisfy warnings ([46540ad](https://github.com/test-kitchen/kitchen-rackspace/commit/46540ad))
+
 ## 0.14.0 / 2014-12-09
 
 * PR [#45] - Add Ubuntu 14.10 and Fedora 21
@@ -109,6 +185,10 @@ drivers, with all its bug fixes; update image IDs
 
 * PR [#35] - Add option to wait on RackConnect, via [@martinb3]
 
+### Other Changes
+
+* Drop support for Ruby 1.9.2 ([52cb429](https://github.com/test-kitchen/kitchen-rackspace/commit/52cb429))
+
 ## 0.7.0 / 2014-07-09
 
 ### New Features
@@ -117,6 +197,13 @@ drivers, with all its bug fixes; update image IDs
 * PR [#29] - Support using a sleep instead of TCP check in cases where new
 servers might fail the TCP; via [@martinb3]
 
+### Other Changes
+
+* Some documentation clarification. ([#28](https://github.com/test-kitchen/kitchen-rackspace/pull/28)) ([2ed61cd](https://github.com/test-kitchen/kitchen-rackspace/commit/2ed61cd))
+* Fix #18 ([#30](https://github.com/test-kitchen/kitchen-rackspace/pull/30)) ([ff365a8](https://github.com/test-kitchen/kitchen-rackspace/commit/ff365a8))
+* Add two new configuration options, RE: TCP checks ([#32](https://github.com/test-kitchen/kitchen-rackspace/pull/32)) ([475841f](https://github.com/test-kitchen/kitchen-rackspace/commit/475841f))
+* Support custom networks ([#33](https://github.com/test-kitchen/kitchen-rackspace/pull/33)) ([11bbbb8](https://github.com/test-kitchen/kitchen-rackspace/commit/11bbbb8))
+
 ## 0.6.1 / 2014-06-03
 
 ### Bug Fixes
@@ -133,6 +220,11 @@ servers might fail the TCP; via [@martinb3]
 
 * PR [#24] - Error out immediately when trying to install in Ruby 1.8
 
+### Other Changes
+
+* Remove reference to TK 1.0--it's 1.1.x now ([482add8](https://github.com/test-kitchen/kitchen-rackspace/commit/482add8))
+* Update version for release ([9b33f85](https://github.com/test-kitchen/kitchen-rackspace/commit/9b33f85))
+
 ## 0.5.0 / 2014-05-01
 
 ### Improvements
@@ -141,6 +233,15 @@ servers might fail the TCP; via [@martinb3]
 * PR [#22] - Update all the images with new IDs
 * PR [#21] - Add Ubuntu 14.04 to the list of known images; via [@pezholio]
 
+### Other Changes
+
+* Fix #13 - Rename 'name' option to 'server_name' ([#15](https://github.com/test-kitchen/kitchen-rackspace/pull/15)) ([bca9e15](https://github.com/test-kitchen/kitchen-rackspace/commit/bca9e15))
+* Bump for 0.3.0 release ([43266dc](https://github.com/test-kitchen/kitchen-rackspace/commit/43266dc))
+* Add Coveralls support, maybe ([#16](https://github.com/test-kitchen/kitchen-rackspace/pull/16)) ([d3d2e85](https://github.com/test-kitchen/kitchen-rackspace/commit/d3d2e85))
+* Improve defaults ([#17](https://github.com/test-kitchen/kitchen-rackspace/pull/17)) ([e320b29](https://github.com/test-kitchen/kitchen-rackspace/commit/e320b29))
+* README and CHANGELOG updates ([3d04c23](https://github.com/test-kitchen/kitchen-rackspace/commit/3d04c23))
+* Update URLs to test-kitchen org ([#19](https://github.com/test-kitchen/kitchen-rackspace/pull/19)) ([7c31774](https://github.com/test-kitchen/kitchen-rackspace/commit/7c31774))
+
 ## 0.4.0 / 2014-01-27
 
 ### New Features
@@ -177,6 +278,14 @@ boot times, via [@coderanger]
 * PR [#7] - Clean up/refactor to pass style checks
 * PR [#9] - Add some (probably overkill) RSpec tests
 
+### Other Changes
+
+* First draft, seems to be working ([a084294](https://github.com/test-kitchen/kitchen-rackspace/commit/a084294))
+* Update README ([580d9c9](https://github.com/test-kitchen/kitchen-rackspace/commit/580d9c9))
+* Ignore .kitchen ([d3e6891](https://github.com/test-kitchen/kitchen-rackspace/commit/d3e6891))
+* Fog doesn't actually need a private key ([4f103f3](https://github.com/test-kitchen/kitchen-rackspace/commit/4f103f3))
+* Update date for release ([873a2be](https://github.com/test-kitchen/kitchen-rackspace/commit/873a2be))
+
 ## 0.1.0 / 2013-03-12
 
 * Initial release! Woo!
@@ -216,7 +325,6 @@ boot times, via [@coderanger]
 [#9]: https://github.com/test-kitchen/kitchen-rackspace/pull/9
 [#8]: https://github.com/test-kitchen/kitchen-rackspace/pull/8
 [#7]: https://github.com/test-kitchen/kitchen-rackspace/pull/7
-
 [@marcoamorales]: https://github.com/marcoamorales
 [@steve-jansen]: https://github.com/steve-jansen
 [@hhoover]: https://github.com/hhoover

data/CONTRIBUTING.md

@@ -0,0 +1,207 @@
+# Contributing to kitchen-rackspace
+
+> **This project is no longer under active development** and has no active
+> maintainers. Issues filed on GitHub will most likely not be triaged. Pull
+> requests are still welcome. If you are interested in maintaining the project,
+> come and talk to us in `#test-kitchen` on
+> [Chef Community Slack](https://community-slack.chef.io/).
+
+## Reporting issues
+
+Report bugs and request features on the [issue tracker](https://github.com/test-kitchen/kitchen-rackspace/issues), keeping the note above in mind. For bugs, please include:
+
+- the version of kitchen-rackspace and Test Kitchen you are using
+- your `kitchen.yml` with credentials removed
+- the output of the failing command, ideally with `-l debug`
+
+## Development setup
+
+Clone the repository and install the dependencies:
+
+```sh
+git clone https://github.com/test-kitchen/kitchen-rackspace.git
+cd kitchen-rackspace
+bundle install
+```
+
+## Running the tests
+
+Run the unit tests:
+
+```sh
+bundle exec rspec
+```
+
+Or through Rake, which adds colour and honours `SEED`, `VERBOSE`, and a
+`--tag` argument:
+
+```sh
+bundle exec rake test
+```
+
+And the style check:
+
+```sh
+bundle exec cookstyle --chefstyle
+```
+
+**Pass `--chefstyle`.** CI runs it that way. Without the flag, cookstyle falls
+back to stock RuboCop defaults, disagrees with this codebase about string
+quoting, and reports over a hundred offenses that are not real.
+
+### How the specs are laid out
+
+There is one spec file per area of the driver, so the file you need to open is
+the one named after the thing you changed:
+
+| File | Covers |
+| --- | --- |
+| `spec/kitchen/driver/rackspace/plugin_spec.rb` | API version and plugin version |
+| `spec/kitchen/driver/rackspace/configuration_spec.rb` | `default_config` values, overrides, credentials from the environment |
+| `spec/kitchen/driver/rackspace/image_spec.rb` | platform-name to image-ID resolution and the bundled `data/images.json` |
+| `spec/kitchen/driver/rackspace/server_name_spec.rb` | the generated server name |
+| `spec/kitchen/driver/rackspace/create_spec.rb` | `#create`, the RackConnect and service level waits, ServiceNet |
+| `spec/kitchen/driver/rackspace/tcp_check_spec.rb` | waiting for the instance to accept a login |
+| `spec/kitchen/driver/rackspace/destroy_spec.rb` | `#destroy` |
+| `spec/kitchen/driver/rackspace/status_spec.rb` | `#status` and `#doctor` |
+| `spec/kitchen/driver/rackspace/compute_spec.rb` | the fog connection, `#create_server`, and the network list |
+
+`spec/support/` holds the shared setup:
+
+- `driver_context.rb` — the `"a driver for an instance"` shared context, which
+  gives an example group a logger, a fake Test Kitchen instance, and a driver
+  built from `config`. Nearly every group includes it. `"a built server"` adds
+  a server double that has finished building.
+- `rackspace_environment.rb` — clears `RACKSPACE_*` and `OS_*` out of the
+  environment around every example and puts your own back afterwards, so
+  credentials in your shell cannot make a spec pass or fail.
+
+When you stub a fog object, reach for `instance_double` rather than `double`.
+A plain double will happily answer a method fog does not have, which is how a
+`kitchen doctor` that called a nonexistent `servers.summary` shipped with a
+green test suite.
+
+Many style offenses can be corrected automatically:
+
+```sh
+bundle exec cookstyle --chefstyle -a
+```
+
+The unit tests stub the Rackspace API, so they do not build servers and do not
+require an account.
+
+The YARD documentation has its own tasks:
+
+```sh
+bundle exec rake doc            # build the docs
+bundle exec rake doc_coverage   # list anything in lib/ still undocumented
+```
+
+### Manual testing against Rackspace
+
+Changes that touch server creation should also be exercised against a real
+account, since the stubbed tests cannot catch API-level regressions. **This
+builds billable servers.** Export `RACKSPACE_USERNAME`, `RACKSPACE_API_KEY` and
+`RACKSPACE_REGION`, run `kitchen test`, then confirm in the Rackspace control
+panel that no servers were left behind — a run that fails partway through can
+leave one running.
+
+## Submitting changes
+
+1. Fork the repository.
+2. Create a feature branch off `main`.
+3. Make your change, adding or updating tests to cover it.
+4. Make sure `bundle exec rake test` and `bundle exec cookstyle --chefstyle` pass.
+5. Push the branch to your fork and open a pull request.
+
+Please keep pull requests focused on a single change — it makes review much
+faster. Update the documentation in `README.md` when you add or change a
+configuration option.
+
+### Commit messages
+
+This project uses [Conventional Commits](https://www.conventionalcommits.org/).
+release-please reads the commit subjects on `main` to decide the next version
+and to write the changelog, so the prefix matters:
+
+| Prefix | Effect |
+| --- | --- |
+| `fix:` | patch release |
+| `feat:` | minor release |
+| `docs:`, `chore:`, `style:`, `test:` | no release |
+| `feat!:`, or a `BREAKING CHANGE:` footer | major release |
+
+Pull requests are squash-merged, so it is the PR title that lands on `main` and
+gets parsed. Write it as a Conventional Commit.
+
+## Maintaining the bundled data
+
+### data/images.json
+
+The driver maps a Test Kitchen platform name to a Rackspace image ID using
+`data/images.json`. **That table has not been regenerated since 2016** — its
+newest entries are Ubuntu 16.04, CentOS 7, Debian 8, and Fedora 25 — so modern
+platform names do not resolve and users have to set `image_id` by hand.
+
+Refreshing it is the most useful contribution available here. It needs a
+Rackspace account:
+
+```sh
+export RACKSPACE_USERNAME="myuser"
+export RACKSPACE_API_KEY="myapikey"
+export RACKSPACE_REGION="ord"
+
+bundle exec ruby helpers/dump_image_list.rb          # review what the account sees
+bundle exec ruby helpers/dump_image_list.rb --json > data/images.json
+```
+
+Image IDs are per-region, so regenerate from the region most users build in.
+The helper derives platform names from each image's OpenStack metadata:
+`ubuntu-22.04` and `ubuntu-22` from the version, plus the bare `ubuntu` for the
+newest version of that distro. Images without that metadata — custom snapshots,
+mostly — are skipped.
+
+A refresh also needs the platform-resolution specs updated, since they assert
+against the current table.
+
+### helpers/dump_flavor_list.rb
+
+Lists the flavors an account can build, for checking the flavor tables in the
+README against reality:
+
+```sh
+bundle exec ruby helpers/dump_flavor_list.rb
+```
+
+### Running the helpers
+
+Both helpers must run under Bundler:
+
+```sh
+bundle exec ruby helpers/dump_image_list.rb
+```
+
+Outside Bundler they resolve a newer fog-core, and `require "fog/rackspace"`
+raises `NameError: wrong constant name CDN v2`. fog-rackspace registers a
+service with a space in its name that newer fog-core cannot constantize, which
+is why the gemspec pins `fog-core < 2.3`.
+
+## Release process
+
+Releases are automated by [release-please](.github/workflows/publish.yaml), and
+maintainers only have to merge a pull request.
+
+1. Every push to `main` updates a standing release pull request titled
+   `chore(main): release X.Y.Z`. It accumulates the changes since the last
+   release and derives the version from their commit prefixes.
+2. Merging that pull request tags the release and publishes the gem to RubyGems
+   and GitHub Packages.
+
+**Do not hand-edit `CHANGELOG.md` or
+`lib/kitchen/driver/rackspace_version.rb`.** release-please owns both — they are
+its `changelog-path` and `version-file` in
+[release-please-config.json](release-please-config.json) — and editing them
+directly conflicts with the release pull request.
+
+The release pull request does not resolve its own conflicts. If it picks one up,
+rebase it by hand, keeping `main`'s content and the bot's version bump.

data/Gemfile

@@ -1,13 +1,15 @@
 source "https://rubygems.org"
 
-gemspec
-
+gemspec development_group: :test
 group :test do
-  gem "bundler"
   gem "rake"
   gem "rspec", "~> 3.2"
 end
 
-group :chefstyle do
-  gem "chefstyle", "2.2.3"
+group :docs do
+  gem "yard"
+end
+
+group :cookstyle do
+  gem "cookstyle"
 end