Skip to content

Update some cloud-init documentation #331

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rohityadavcloud merged 2 commits into from
Sep 14, 2023
Merged

Update some cloud-init documentation #331

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
65b1fd7
Update some cloud-init documentation.
TheRealFalcon Jul 10, 2023
c76165e
Ensure existing set-password and set_password work
TheRealFalcon Jul 25, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 10 additions & 18 deletions source/adminguide/templates/_cloud_init.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,17 +54,7 @@ These features can be implemented in `“Linux template creation process” <_cr

Configure cloud-init to detect Cloudstack data source during runtime.

~ CentOS

CentOS cloud-init looks for datasources in /etc/cloud/ds-indetify.cfg during boot. Add the following config in that file.

.. code:: bash

datasource: CloudStack

~ Ubuntu

Ubuntu cloud-init data sources can be specified in /etc/cloud/cloud.cfg.d/ directory. Add the following config in /etc/cloud/cloud.cfg.d/99_cloudstack.cfg.
Cloud-init data sources can be specified in /etc/cloud/cloud.cfg.d/ directory. Add the following config in /etc/cloud/cloud.cfg.d/99_cloudstack.cfg.

.. code:: bash

Expand All @@ -75,15 +65,15 @@ These features can be implemented in `“Linux template creation process” <_cr

#. **Password management**

Cloudstack integration with cloud-init `set-passwords module <https://cloudinit.readthedocs.io/en/latest/topics/modules.html?highlight=ssh_pwauth#set-passwords>`_ will enable the platform to set a password for each instance created from the Main Template. Additionally it will allow to reset the user password through the GUI.
Cloudstack integration with cloud-init `set_passwords module <https://cloudinit.readthedocs.io/en/latest/topics/modules.html?highlight=ssh_pwauth#set-passwords>`_ will enable the platform to set a password for each instance created from the Main Template. Additionally it will allow to reset the user password through the GUI.

- **Enable set-passwords module on every boot**
- **Enable set_passwords module on every boot**

By default the set-passwords module runs only on first boot of the instance, change that to run on every boot.
By default the set_passwords module runs only on first boot of the instance, change that to run on every boot.

.. code:: bash

sudo sed -i s/" - set-passwords"/" - [set-passwords, always]"/g /etc/cloud/cloud.cfg
sudo sed -i s/" - set[_|-]passwords"/" - [set_passwords, always]"/g /etc/cloud/cloud.cfg

- **Specify the managed user**

Expand Down Expand Up @@ -113,13 +103,15 @@ These features can be implemented in `“Linux template creation process” <_cr

.. warning::

Cloud-init ssh module runs on every boot and will regenerate the certificate fingerprint of the host. This will cause a warning to anyone that logs in the system and also bring trouble to anyone trying to automate ssh access.
If the cloud-init ssh module is set to run every boot, it will regenerate the certificate fingerprint of the host. This will cause a warning to anyone that logs in the system and also bring trouble to anyone trying to automate ssh access.

Disable cloud-init regenerating host certificates on boot. If template certificates are deleted they will be regenerated by the OS on instnace first boot.
Disable cloud-init regenerating host certificates on boot. If template certificates are deleted they will be regenerated by the OS on instance first boot.

.. code:: bash

echo "ssh_deletekeys: false" > /etc/cloud/cloud.cfg.d/49_hostkeys.cfg

Note that if this instance is moved or snapshotted, it will be vulnerable to man-in-the-middle attacks if the behavior is not re-enabled first.

#. **Partition management**

Expand Down Expand Up @@ -173,7 +165,7 @@ These features can be implemented in `“Linux template creation process” <_cr

- **Extend Physical volume, Volume group and root lvm**

After parition is extended the upper layers should also be resized. This can be automated with cloud-init `runcmd module <https://cloudinit.readthedocs.io/en/latest/topics/modules.html?highlight=runcmd#runcmd>`_ . Set the configuration below in /etc/cloud/cloud.cfg.d/51_extend_volume.cfg.
After partition is extended the upper layers should also be resized. This can be automated with cloud-init `runcmd module <https://cloudinit.readthedocs.io/en/latest/topics/modules.html?highlight=runcmd#runcmd>`_ . Set the configuration below in /etc/cloud/cloud.cfg.d/51_extend_volume.cfg.

~ CentOS

Expand Down