mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
ecbf8e933a
* Big testing doc refactor * Combine all the testing documentation in to one place to make it easier to find * Convert everything to RST * Create testing_network guide * Create testing landing page * For each section detail "how to run" and "how to extend testing" * More examples * Lots more detail
72 lines
1.8 KiB
ReStructuredText
72 lines
1.8 KiB
ReStructuredText
**********
|
|
httptester
|
|
**********
|
|
|
|
.. contents:: Topics
|
|
|
|
Overview
|
|
========
|
|
|
|
``httptester`` is a docker container used to host certain resources required by :doc:`testing_integration`. This is to avoid CI tests requiring external resources (such as git or package repos) which, if temporarily unavailable, would cause tests to fail.
|
|
|
|
HTTP Testing endpoint which provides the following capabilities:
|
|
|
|
* httpbin
|
|
* nginx
|
|
* SSL
|
|
* SNI
|
|
|
|
|
|
Source files can be found at `test/utils/docker/httptester/ <https://github.com/ansible/ansible/tree/devel/test/utils/docker/httptester>`_
|
|
|
|
Building
|
|
========
|
|
|
|
Docker
|
|
------
|
|
|
|
Both ways of building ``docker`` utilize the ``nginx:alpine`` image, but can
|
|
be customized for ``Fedora``, ``Red Hat``, ``CentOS``, ``Ubuntu``,
|
|
``Debian`` and other variants of ``Alpine``
|
|
|
|
When utilizing ``packer`` or configuring with ``ansible-playbook``,
|
|
the services will not automatically start on launch, and will have to be
|
|
manually started using::
|
|
|
|
cd test/utils/docker/httptester
|
|
./services.sh
|
|
|
|
Such as when starting a docker container::
|
|
|
|
cd test/utils/docker/httptester
|
|
docker run -ti --rm -p 80:80 -p 443:443 --name httptester ansible/ansible:httptester /services.sh
|
|
|
|
docker build
|
|
------------
|
|
|
|
::
|
|
|
|
cd test/utils/docker/httptester
|
|
docker build -t ansible/ansible:httptester .
|
|
|
|
packer
|
|
------
|
|
|
|
The ``packer`` build will use ``ansible-playbook`` to perform the
|
|
configuration, and will tag the image as ``ansible/ansible:httptester``::
|
|
|
|
cd test/utils/docker/httptester
|
|
packer build packer.json
|
|
|
|
Ansible
|
|
=======
|
|
|
|
::
|
|
cd test/utils/docker/httptester
|
|
ansible-playbook -i hosts -v httptester.yml
|
|
|
|
|
|
Extending httptester
|
|
====================
|
|
|
|
If you have sometime to improve ``httptester`` please add a comment on the `Testing Working Group Agenda <https://github.com/ansible/community/blob/master/MEETINGS.md>`_ to avoid duplicated effort.
|