Skip to content

Commit 6b3b522

Browse files
committed
Document network support for configdrive
1 parent 5640e12 commit 6b3b522

File tree

3 files changed

+26
-4
lines changed

3 files changed

+26
-4
lines changed

source/adminguide/api.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -169,7 +169,7 @@ VMdata - a list of String arrays representing [“directory”, “filename”,
169169

170170
- meta_data.json
171171

172-
- Network_data.json
172+
- network_data.json
173173

174174
- label, which is configurable in global settings:
175175

source/adminguide/networking/dns_and_dhcp.rst

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,13 @@
1717
DNS and DHCP
1818
------------
1919

20-
The Virtual Router provides DNS and DHCP services to the guests. It
21-
proxies DNS requests to the DNS server configured on the Availability
22-
Zone.
20+
The Virtual Router & ConfigDrive (since Apache CloudStack 4.20) provides
21+
DNS and DHCP services to the guests. It proxies DNS requests to the DNS
22+
server configured on the Availability Zone.
23+
24+
.. note::
25+
In case of a network with ConfigDrive, adding/removing nic to/from an
26+
instance or updating the ip address of a nic will not be reflected in the
27+
instance if the instance is already running. To do so, run
28+
`cloud-init clean --machine-id -s` to clean the machine id and seed data.
29+
Then reboot the instance to apply the changes.

source/adminguide/templates/_cloud_init.rst

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -215,6 +215,21 @@ These features can be implemented in `“Linux Template creation process” <_cr
215215

216216
Cloud-init can parse and execute user-data form Cloud-stack during Instance creation. This feature works as is without additional configuration.
217217

218+
#. **Network configuration with ConfigDrive**
219+
220+
Cloud-init can fetch network configuration from ConfigDrive. To enable this,
221+
ensure network configuration is not disabled in cloud-init configuration.
222+
223+
.. code:: bash
224+
225+
echo -e "\nnetwork: {}" >> /etc/cloud/cloud.cfg
226+
227+
.. note::
228+
Adding/removing nic to/from an instance or updating the ip address of a nic
229+
will not be reflected in the instance if the instance is already running. To
230+
do so, run `cloud-init clean --machine-id -s` to clean the machine id and
231+
seed data. Then reboot the instance to apply the changes.
232+
218233
#. **Cleanup**
219234

220235
Once desired cloud-init features are implemented, clean cloud-init tracker files.

0 commit comments

Comments
 (0)