openstack/trove
Code Issues Proposed changes

[Doc] Support datastore version number

Browse Source 
Story: 2008358
Task: 41264

Change-Id: I45ba63454f5b9c29d95c67e49b44f8233dda18fb
This commit is contained in:
Lingxian Kong
2020-11-21 23:58:41 +13:00
parent 589e4ec45a
commit c9e27cab76
2 changed files with 11 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
doc/source/admin/datastore.rst
View File

@@ -16,9 +16,9 @@ database, Trove could support 5.7.29, 5.7.30 or 5.8, etc.
.. note:: .. note::
Starting from Victoria, the datastore version name must be the same with the Starting from Victoria, the datastore version number must be the same with
image tag of the specific database. To support MySQL 5.7.29, a new datastore the image tag of the specific database. To support MySQL 5.7.29, a new
version named 5.7.29 based on `mysql docker image datastore version with version number 5.7.29 based on `mysql docker image
<https://hub.docker.com/_/mysql?tab=tags&name=5.7.29>`_ needs to be created. <https://hub.docker.com/_/mysql?tab=tags&name=5.7.29>`_ needs to be created.
A datastore version is always associated with a Glance image, either by image A datastore version is always associated with a Glance image, either by image
@@ -32,7 +32,8 @@ Create datastore version
~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~
When creating a datastore version, Trove will create the datastore first if it When creating a datastore version, Trove will create the datastore first if it
doesn't exist. doesn't exist. Different datastore versions can have the same name but
different version numbers, or same version number but different names.
When using image tags, make sure the image with the tags exists before creating When using image tags, make sure the image with the tags exists before creating
the datastore version. the datastore version.
@@ -52,6 +53,8 @@ To create a datastore version:
#. Register image with Image service #. Register image with Image service
You need to register your guest image with the Image service as cloud admin. You need to register your guest image with the Image service as cloud admin.
In this example, the image is assigned tags that will be used when creating
datastore version.
.. code-block:: console .. code-block:: console
@@ -69,7 +72,8 @@ To create a datastore version:
openstack datastore version create 5.7.29 mysql mysql "" \ openstack datastore version create 5.7.29 mysql mysql "" \
--image-tags trove,mysql \ --image-tags trove,mysql \
--active --default --active --default \
--version-number 5.7.29
#. Load validation rules for configuration groups #. Load validation rules for configuration groups

3
doc/source/admin/run_trove_in_production.rst
View File

@@ -334,7 +334,8 @@ Command examples:
$ # Creating datastore 'mysql' and datastore version 5.7.29. $ # Creating datastore 'mysql' and datastore version 5.7.29.
$ openstack datastore version create 5.7.29 mysql mysql "" \ $ openstack datastore version create 5.7.29 mysql mysql "" \
--image-tags trove,mysql \ --image-tags trove,mysql \
--active --default --active --default \
--version-number 5.7.29
$ # Register configuration parameters for the datastore version $ # Register configuration parameters for the datastore version
$ trove-manage db_load_datastore_config_parameters mysql 5.7.29 ${trove_repo_dir}}/trove/templates/mysql/validation-rules.json $ trove-manage db_load_datastore_config_parameters mysql 5.7.29 ${trove_repo_dir}}/trove/templates/mysql/validation-rules.json