History

rabi 0601000e65 Create symlink for dib-run-parts Looks like 'dib-run-parts' is not available in $PATH for 'os-refresh-config' to use. This seems to be installed in the venv for os-refresh-config. Create a symlink in /usr/local/bin like 'os-refresh-config'. Change-Id: Ib6ad331292720ec418a176dd3f2e0df520e6b2bf		2017-08-03 19:59:30 +05:30
..
install.d	Create symlink for dib-run-parts	2017-08-03 19:59:30 +05:30
os-refresh-config	Set correct content-type for o-r-c curl calls	2016-11-14 16:12:34 +02:00
README.md	Correct os-refresh-config README.md typo and format	2013-11-28 09:44:04 +08:00
element-deps	Don't depend on os-collect-config element	2016-11-25 14:03:02 +13:00
package-installs.yaml	Migrate os-*-config to package-installs v2	2015-04-30 16:12:40 -04:00
pkg-map	Add pkg-map for os-*-config	2015-02-09 17:16:50 +09:00

README.md

Install os-refresh-config

os-refresh-config uses dib-run-parts to run scripts in a pre-defined set of directories. Its intended purpose is to quiesce (pre-configure.d), configure (configure.d), migrate (migration.d), and then activate (post-configure.d) a configuration on first boot or in response to Heat Metadata changes.

To cause a script to be run on every os-refresh-config run, install it into one of the following directories:

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

If you want to have os-refresh-config run on any updates to a particular Resource in the heat stack, you will need at the minimum the following snippet of json in this instance's Metadata:

{
    "OpenStack::Config": {
        "heat": {
            "access_key_id": {"Ref": "ApiKeyResource"},
            "secret_key": {"Fn::GetAtt": [ "ApiKeyResource", "SecretAccessKey" ]},
            "refresh": [ {"resource": "SomeResource"} ],
            "stack": {Ref: 'AWS::Stack'},
            "region": {Ref: 'AWS::Region'}
        }
    }
}

If you would like to signal a wait condition at the end of post-configure.d, a generic name of 'completion-handle' can be used like so:

{
    "completion-handle": {"Ref": "CompletionHandleName"}
}