aboutsummaryrefslogtreecommitdiff
path: root/doc/source/admin
diff options
context:
space:
mode:
authorMichal Arbet <michal.arbet@ultimum.io>2026-05-25 09:56:17 +0200
committerMichal Arbet <michal.arbet@ultimum.io>2026-07-02 17:28:39 +0200
commitebc7eb82969af107f5a54b29b8ef898cd759a997 (patch)
treecc197428c022f7ae1d863b741f1cc6601e331504 /doc/source/admin
parent575baf05c4964d46f0c8f13bcdf193ce5e863c82 (diff)
downloadkolla-ebc7eb82969af107f5a54b29b8ef898cd759a997.tar.gz
kolla-ebc7eb82969af107f5a54b29b8ef898cd759a997.zip
set_configs: Add support for creating files and setting perms
Change-Id: I74a6d05007488b69fa040c40d01a07afae369794 Needed-By: https://review.opendev.org/c/openstack/kolla-ansible/+/989850 Signed-off-by: Michal Arbet <michal.arbet@ultimum.io>
Diffstat (limited to 'doc/source/admin')
-rw-r--r--doc/source/admin/kolla_api.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/source/admin/kolla_api.rst b/doc/source/admin/kolla_api.rst
index b1fd6b140..a34cd819f 100644
--- a/doc/source/admin/kolla_api.rst
+++ b/doc/source/admin/kolla_api.rst
@@ -64,6 +64,17 @@ The `kolla_set_configs`_ script understands the following attributes:
* **perm** (required): the unix permissions to set to the directory.
Must be passed in the numeric octal form.
+* **files**: create empty files inside the container if they do not
+ exist, and set their ownership and permissions. A list of dicts, each
+ containing the following attributes:
+
+ * **path** (required): the path to the file to create. Parent directories
+ must already exist. Glob patterns are not supported.
+ * **owner** (required): the ``user:group`` to change ownership to. ``user``
+ is synonymous to ``user:user``. Must be user and group names, not uid/gid.
+ * **perm** (required): the unix permissions to set to the file.
+ Must be passed in the numeric octal form.
+
* **permissions**: change the permissions and/or ownership of files or
directories inside the container. A list of dicts, each containing the
following attributes: