openstack
/
os-refresh-config
Code Issues Proposed changes
Restart services and coordinate data migration on Heat config changes.
102 Commits 1 Branch 76 Tags 1.3 MiB
Python 68.6%
Shell 31.4%
Go to file
Alex Schultz 4e9ce62c04 Drop baremetal job template 
https://review.openstack.org/#/c/619337/ switched the jobs to a noop for
master and since this file is branched we no longer need to keep this
template definition in this project.

Change-Id: I5c2d30babfbd2c425dc489aa8e47f5420c2f64b8
 		2018-12-13 13:52:19 -07:00
os_refresh_config Adjust test suite for new psutil versions 2017-01-18 20:19:36 +01:00
tests Initial commit 2013-02-06 16:59:40 -08:00
zuul.d Drop baremetal job template 2018-12-13 13:52:19 -07:00
.coveragerc Change ignore-errors to ignore_errors 2015-09-21 14:41:56 +00:00
.gitignore Switch to stestr 2018-07-10 18:41:32 +07:00
.gitreview Update stackforge references to openstack 2013-08-17 23:00:11 -04:00
.stestr.conf Switch to stestr 2018-07-10 18:41:32 +07:00
LICENSE Adding setup.py to make for an easier installation 2013-02-12 07:04:28 -08:00
README.rst Update links in README 2018-03-02 18:05:11 +08:00
requirements.txt Updated from global requirements 2017-09-27 17:18:26 +00:00
setup.cfg Support building wheels (PEP-427) 2013-11-19 10:33:09 +01:00
setup.py Updated from global requirements 2017-03-06 01:16:55 +00:00
test-requirements.txt Switch to stestr 2018-07-10 18:41:32 +07:00
tox.ini Don't quote {posargs} in tox.ini 2018-11-03 03:04:15 +00:00

README.rst

Team and repository tags

image

os-refresh-config

os-refresh-config uses dib-run-parts to run scripts in a pre-defined set of directories:

/opt/stack/os-config-refresh/pre-configure.d
/opt/stack/os-config-refresh/configure.d
/opt/stack/os-config-refresh/post-configure.d
/opt/stack/os-config-refresh/migration.d
/opt/stack/os-config-refresh/error.d

/opt/stack/os-config-refresh is the default base directory. You can set OS_REFRESH_CONFIG_BASE_DIR environment variable to override the default one.

Its intended purpose is to separate scripts execution into 4 phases:

  1. Quiesce(pre-configure.d),
  2. Configure(configure.d),
  3. Activate(post-configure.d).
  4. Migrate(migration.d),

It runs through all the phases above to ensure configuration is applied and enabled on a machine. It will run the scripts in error.d and then exit with a non-zero exit status if any phase has a problem. The scripts in each phase should not depend on each other having worked properly.

Note: Earlier versions of os-refresh-config ran migration before post-configure. This was an oversight in the initial design, as migrations are intended to be online migrations after the host is fully configured.

For things which must happen while the service is quiesced, that should be done in the post-configure scripts which control the service state.