Add Docker AIO demo image docs

Change-Id: I33c3d026eef1efca715d1438b3d0edd2fca175f7
This commit is contained in:
Robert Putt 2018-08-20 15:33:13 +01:00
parent ada2c0340d
commit 6d3907430d
2 changed files with 41 additions and 0 deletions

40
doc/source/docker_env.rst Normal file
View File

@ -0,0 +1,40 @@
=================
Docker All In One
=================
Whilst Nemesis is in early development we have created a Docker All In One (AIO) image which contains a fully functional
self contained Nemesis environment to play with including:
* Ubuntu Base OS
* MySQL
* RabbitMQ
* Memcached
* Swift
* Keystone
* Nemesis API
* Nemesis Worker with ClamAV and EXIF plugins
*Warning: It is only recommended to run the Docker AIO image for dev / test purposes. If you wish to deploy Nemesis
properly to your environment please read the docs and deploy a suitable highly redundant configuration to avoid
dissapointment.*
To run the Docker AIO simply::
docker run -it --privileged=true robputt796/nemesis-aio
Why privileged? This is the only way I could work out how to get mknod to work in a container to create a loop device for Swift.
If someone can let me know via a blueprint (https://blueprints.launchpad.net/python-nemesis) just how to enable this one capability
that would be awesome!
Once in the bash shell run the start script, source the openstack_user.rc file and generate a token using the OpenStack CLI,
once you have a token you can start using the local Nemesis API on port 9000::
./start.sh
source openstack_user.rc
openstack token issue
curl -H 'X-Auth-Token: $TOKEN' http://localhost:9000/v1/file
If you'd like to perform any administrative functions then you may source the openstack_admin.rc file for a user with the
administrative role::
source openstack_admin.rc

View File

@ -13,6 +13,7 @@ Contents:
about
installation
docker_env
usage
plugins
contributing