From 4bb4ec03834442a9ac1fd3221c32ce05b27e6993 Mon Sep 17 00:00:00 2001 From: Caihui Date: Tue, 7 Jul 2020 23:38:43 -0700 Subject: [PATCH] Add Devstack installation guide in README.rst Add DevStak installation guide for the freezer-api project. Change-Id: I3187b652da0cf9e0b6211d8317d5cf3e50a4aba3 --- devstack/README.rst | 66 ++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 65 insertions(+), 1 deletion(-) diff --git a/devstack/README.rst b/devstack/README.rst index f699b668..9df2adee 100644 --- a/devstack/README.rst +++ b/devstack/README.rst @@ -34,7 +34,27 @@ To use the sqlachemy set the following environment variable:: export FREEZER_BACKEND='sqlalchemy' -This is a sample local.conf file for freezer developer:: +Running Freezer tempest tests +============================= + +Install DevStack step by step +============================= + + +1. Download DevStack:: + + git clone https://git.openstack.org/openstack-dev/devstack.git + cd devstack + +2. Add stack user and change devstack directory user group:: + + ./create_stack_user.sh + + chown -R stack ./devstack/ + chown -R stack.stack ./devstack/ + + +3. Add this repo as an external repository.This is a sample local.conf file for freezer developer:: [[local|localrc]] ADMIN_PASSWORD=stack @@ -56,5 +76,49 @@ This is a sample local.conf file for freezer developer:: export FREEZER_BACKEND='sqlalchemy' +4. Use stack user to run ``stack.sh``:: + + su stack + ./stack.sh + +5.You can source openrc in your shell, and then use the openstack command line tool to manage your devstack.:: + + souce /opt/stack/devstack/openrc admin admin + +Running Freezer tempest tests +============================= +1. Listing Freezer tempest tests:: + + tempest list-plugins + +2. Config the "tempest.conf" file:: + + cd /opt/stack/tempest + tox -e genconfig + cd /opt/stack/tempest/etc + cp tempest.conf.sample tempest.conf + +3. This is a sample "tempest.conf" file:: + + [auth] + admin_username = admin + admin_project_name = admin + admin_password = stack + admin_domain_name = Default + [identity] + uri_v3 = http://172.16.1.108/identity/v3 + +4. Running freezer tempest tests:: + + cd /opt/stack/tempest + tempest run -r freezer_tempest_plugin + +5. Running one tempest test case:: + + cd /opt/stack/tempest + tempest run -r freezer_tempest_plugin.tests.freezer_api.api.test_api_jobs.TestFreezerApiJobs.test_api_jobs_post + + For more information, see: https://docs.openstack.org/devstack/latest/index.html + https://docs.openstack.org/tempest/latest/