112f8c0402
Change-Id: I0f74e087d42f84c554c7e05389bc82210bf237fd Story: 2001694 Task: 29755 Depends-On: https://review.openstack.org/649242
66 lines
1.8 KiB
ReStructuredText
66 lines
1.8 KiB
ReStructuredText
===============================
|
|
Docker image for Monasca Client
|
|
===============================
|
|
The Monasca Client image is based on the monasca-base image.
|
|
|
|
|
|
Building monasca-base image
|
|
===========================
|
|
See https://github.com/openstack/monasca-common/tree/master/docker/README.rst
|
|
|
|
|
|
Building Monasca Client image
|
|
=============================
|
|
|
|
Example:
|
|
$ ./build_image.sh <repository_version> <upper_constains_branch> <common_version>
|
|
|
|
|
|
Requirements from monasca-base image
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
health_check.py
|
|
This file will be used for checking the status of the Monasca API
|
|
application.
|
|
|
|
|
|
Scripts
|
|
~~~~~~~
|
|
start.sh
|
|
In this starting script provide all steps that lead to the proper service
|
|
start. Including usage of wait scripts and templating of configuration
|
|
files. You also could provide the ability to allow running container after
|
|
service died for easier debugging.
|
|
|
|
build_image.sh
|
|
Please read detailed build description inside the script.
|
|
|
|
|
|
Docker Compose
|
|
~~~~~~~~~~~~~~
|
|
When you want to use docker-compose add it as a new service and be sure that
|
|
property 'tty' is set to true to avoid exiting of container after startup.
|
|
Example:
|
|
|
|
* monasca-client:
|
|
* image: monasca/client:master
|
|
* tty: true
|
|
|
|
Running
|
|
~~~~~~~
|
|
If you don't want to use docker-compose mechanism, you can run container manually
|
|
and connect it to existing docker Monasca network.
|
|
Example:
|
|
docker network --network=<network-name> <container_name>
|
|
|
|
You can also use docker run option to start a container and connect it to a network immediately:
|
|
Example:
|
|
docker run -itd --network=<network-name> <container-name>
|
|
|
|
Inside of container it is possible to run 'monasca' shell commands, e.g. to list all metrics.
|
|
Example:
|
|
monasca metric-list
|
|
|
|
Links
|
|
~~~~~
|
|
https://docs.openstack.org/python-monascaclient/latest/
|