You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: source/adminguide/api.rst
+24-1Lines changed: 24 additions & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -12,7 +12,7 @@
12
12
KIND, either express or implied. See the License for the
13
13
specific language governing permissions and limitations
14
14
under the License.
15
-
15
+
16
16
17
17
The CloudStack API is a low level API that has been used to implement
18
18
the CloudStack web UIs. It is also a good basis for implementing other
@@ -181,6 +181,29 @@ VMdata - a list of String arrays representing [“directory”, “filename”,
181
181
182
182
- default: config-2
183
183
184
+
Virtual machine password via ConfigDrive
185
+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
186
+
187
+
The ConfigDrive metadata provider delivers the virtual machine password simultaneously in two variants, leaving which one to use to the user discretion:
188
+
189
+
1. As the ``<mountdir>/cloudstack/password/vm_password.txt`` file.
190
+
191
+
This file is intended to be used by an external script that runs inside the virtual machine every boot, and changes the password if needed.
192
+
The init-script that implements this functionality can be found in the `Cloudstack source <https://github.com/apache/cloudstack/blob/main/setup/bindir/cloud-set-guest-password-configdrive.in>`_.
193
+
194
+
.. note::
195
+
The ``vm_password.txt`` file is not compatible with cloud-init password module, so the cloud-init will ignore it.
196
+
It is up to Cloudstack administrator to include the script processing it in the virtual machines and/or their templates.
197
+
198
+
2. As the ``<mountdir>/openstack/latest/vendor_data.json``.
199
+
This is a standard password location supported by cloud-init's both ConfigDrive datasource and the password module.
200
+
Therefore, this variant allows using cloud-init as the only tool for provisioning a virtual machine, without using external scripts.
201
+
202
+
.. warning::
203
+
Cloud-init password module is designed to only perform the initial virtual machine password setup.
204
+
It will ignore the changes in ``vendor_data.json`` after the first run. Therefore, resetting the virtual machine password from Cloudstack will not work with this variant.
205
+
206
+
184
207
For more detailed information about the Config Drive implementation refer to
0 commit comments