feat(ins): network hot-autoconfig

Author: bene2k1

compute/instances/reference-content/add-instance-specific-ssh-keys-using-tags.mdx

@@ -10,7 +10,7 @@ categories:
 dates:
   validation: 2024-10-08
   posted: 2024-10-08
-tags: Instance ssh-key ssh tag
+tags: instance ssh-key ssh tag
 ---
 
 In cloud environments, managing SSH keys across multiple Instances is key to keeping your infrastructure secure and easy to access.

compute/instances/reference-content/understanding-automatic-network-hot-reconfiguration.mdx

@@ -0,0 +1,87 @@
+---
+meta:
+  title: Understanding automatic network hot-reconfiguration for Scaleway Instances
+  description: Find out how to configure automatic network hot-reconfiguration for Scaleway Instances.
+content:
+  h1: Understanding automatic network hot-reconfiguration for Scaleway Instances
+  paragraph: Find out how to configure automatic network hot-reconfiguration for Scaleway Instances.
+categories:
+  - compute
+dates:
+  validation: 2024-10-29
+  posted: 2024-10-29
+tags: instance network hot-reconfiguration
+---
+
+The Scaleway Instances product includes a feature called **automatic network hot-reconfiguration**.
+
+This mechanism automatically configures or deconfigures a [flexible IP address](/compute/instances/concepts/#flexible-ip) in the guest operating system when it is attached to or detached from an Instance.
+
+This guide explains how to enable or disable the automatic network hot-reconfiguration mechanism on your Instance.
+
+<Message type="note">
+  This documentation page does not apply to Instances running the Microsoft Windows operating system.
+</Message>
+
+## Supported configurations
+
+Before proceeding, ensure that your operating system supports the target network configuration: refer to Scaleway’s compatibility guidelines on [OS images and flexible IP type combinations](/compute/instances/reference-content/comaptibility-scw-os-images-flexible-ip/).
+
+Starting from **October 10th, 2024**, all GNU/Linux-based operating systems and InstantApp images for Scaleway Instances have automatic network hot-reconfiguration enabled by default.
+
+To verify that the feature is active on your Instance, use the following command:
+
+```bash
+# systemctl is-active scw-net-reconfig.path
+```
+
+If the output is `active`, the feature is enabled and ready to use. If the output is `inactive`, you have to enable it first.
+
+
+### Enabling network hot-reconfiguration
+
+Follow these steps to enable automatic network hot-reconfiguration on a Scaleway Instance where the feature is currently inactive.
+
+1. Enable the QEMU Guest Agent. Refer to Scaleway’s documentation on [enabling the QEMU Guest Agent (GQA)](compute/instances/reference-content/understanding-qemu-guest-agent/#opting-in) for further details.
+
+2. Install the latest Scaleway Ecosystem package.
+
+   - **Fedora / AlmaLinux / RockyLinux / CentOS**
+     ```bash
+     # yum -y --best install scaleway-ecosystem
+     ```
+
+   - **Debian / Ubuntu**
+     ```bash
+     # apt-get update
+     # apt-get -y install scaleway-ecosystem
+     ```
+
+     <Message type="note">
+       Ensure you install version `0.0.7-1` or higher of the `scaleway-ecosystem` package.
+     </Message>
+
+3. Enable the Automatic Network Reconfiguration Mechanism.
+
+
+   On Debian and Ubuntu systems, the mechanism typically activates automatically after installing or upgrading the `scaleway-ecosystem` package. However, RedHat-based distributions may require a manual start:
+
+   ```bash
+   # systemctl enable --now scw-net-reconfig.path
+   ```
+
+   <Message type="note">
+     Rebooting your Instance will also activate the mechanism during boot.
+   </Message>
+
+---
+
+### Disabling network hot-reconfiguration
+
+If you prefer to prevent automatic network reconfiguration when a flexible IP is attached or detached, follow these steps:
+
+1. Run the following command to disable the feature:
+
+   ```bash
+   # systemctl disable --now scw-net-reconfig.path
+   ```

compute/instances/reference-content/understanding-qemu-guest-agent.mdx

@@ -24,7 +24,7 @@ This page provides essential insights into this mechanism.
 
 Running the QEMU Guest Agent (QGA) on your Instance currently enables the following feature:
 
-- **Automatic network reconfiguration** upon flexible IP attachment or detachment.
+- **Automatic network reconfiguration** upon flexible IP attachment or detachment [Learn how to enable/disable this feature]().
 
 Additional features may be added in the future.
 

menu/navigation.json

@@ -1357,6 +1357,10 @@
                     "label": "Understanding QEMU Guest Agent",
                     "slug": "understanding-qemu-guest-agent"
                   },
+                  {
+                    "label": "Understanding automatic network hot-reconfiguration",
+                    "slug": "understanding-automatic-network-hot-reconfiguration"
+                  },
                   {
                     "label": "Understanding Instance pricing",
                     "slug": "understanding-instance-pricing"