|
|
|
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^^^ |
|
|
^^^^^^^^^^^^^^^^^^^^^ |
|
|
|
|
|
|
|
|
Gives you SSH access to the instance for manual testing. |
|
|
Gives you SSH access to the instance for manual testing. |
|
|
|
|
|
|
|
|
|
|
|
Testing with Vagrant |
|
|
|
|
|
-------------------- |
|
|
|
|
|
|
|
|
|
|
|
Windows/FreeBSD/OpenBSD testing is done with ``kitchen-salt``. |
|
|
|
|
|
|
|
|
|
|
|
Requirements |
|
|
|
|
|
^^^^^^^^^^^^ |
|
|
|
|
|
|
|
|
|
|
|
* Ruby |
|
|
|
|
|
* Virtualbox |
|
|
|
|
|
* Vagrant |
|
|
|
|
|
|
|
|
|
|
|
Setup |
|
|
|
|
|
^^^^^ |
|
|
|
|
|
|
|
|
|
|
|
.. code-block:: bash |
|
|
|
|
|
|
|
|
|
|
|
$ gem install bundler |
|
|
|
|
|
$ bundle install --with=vagrant |
|
|
|
|
|
$ bin/kitchen test [platform] |
|
|
|
|
|
|
|
|
|
|
|
Where ``[platform]`` is the platform name defined in ``kitchen.vagrant.yml``, |
|
|
|
|
|
e.g. ``windows-81-latest-py3``. |
|
|
|
|
|
|
|
|
|
|
|
Note |
|
|
|
|
|
^^^^ |
|
|
|
|
|
|
|
|
|
|
|
When testing using Vagrant you must set the environment variable ``KITCHEN_LOCAL_YAML`` to ``kitchen.vagrant.yml``. For example: |
|
|
|
|
|
|
|
|
|
|
|
.. code-block:: bash |
|
|
|
|
|
|
|
|
|
|
|
$ KITCHEN_LOCAL_YAML=kitchen.vagrant.yml bin/kitchen test # Alternatively, |
|
|
|
|
|
$ export KITCHEN_LOCAL_YAML=kitchen.vagrant.yml |
|
|
|
|
|
$ bin/kitchen test |
|
|
|
|
|
|
|
|
|
|
|
Then run the following commands as needed. |
|
|
|
|
|
|
|
|
|
|
|
``bin/kitchen converge`` |
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^^^^^^ |
|
|
|
|
|
|
|
|
|
|
|
Creates the Vagrant instance and runs the ``nginx`` main state, ready for testing. |
|
|
|
|
|
|
|
|
|
|
|
``bin/kitchen verify`` |
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^^^^ |
|
|
|
|
|
|
|
|
|
|
|
Runs the ``inspec`` tests on the actual instance. |
|
|
|
|
|
|
|
|
|
|
|
``bin/kitchen destroy`` |
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^^^^^ |
|
|
|
|
|
|
|
|
|
|
|
Removes the Vagrant instance. |
|
|
|
|
|
|
|
|
|
|
|
``bin/kitchen test`` |
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^^ |
|
|
|
|
|
|
|
|
|
|
|
Runs all of the stages above in one go: i.e. ``destroy`` + ``converge`` + ``verify`` + ``destroy``. |
|
|
|
|
|
|
|
|
|
|
|
``bin/kitchen login`` |
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^^^ |
|
|
|
|
|
|
|
|
|
|
|
Gives you RDP/SSH access to the instance for manual testing. |