Skip to content
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.

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

fix(ins): boot modes MTA-3658 #2130

Merged
merged 2 commits into from
Sep 12, 2023
Merged
Changes from all commits
Commits
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
49 changes: 17 additions & 32 deletions compute/instances/how-to/use-boot-modes.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ content:
tags: boot-mode boot mode boot instance bootscript
dates:
validation: 2023-06-16
posted: 2021-05-26
posted: 2021-05-26
categories:
- compute
---
Expand All @@ -33,52 +33,37 @@ Local boot allows you to start your Instance with a local configuration and a sp

1. Click **Instances** in the **Compute** section of the side menu. The Instances page displays.
2. Click the Instance you wish to start with a local boot.
3. Click the **Advanced settings** tab.
3. Use the toggle <Icon name="toggle" /> in the top right corner of the screen to **power off** your Instance.
4. Click the **Advanced settings** tab.
<Lightbox src="scaleway-boot-modes.webp" alt=""/>
4. In the **Boot mode** section, select **Use local boot**.
5. Click **Save**.
6. Click **Reboot** in the top right corner of the page, and confirm the reboot of your Instance when prompted.
5. In the **Boot mode** section, select **Use local boot**.
6. Click **Save**.
7. Use the toggle <Icon name="toggle" /> in the top right corner of the screen to **power on** your Instance.

Your Instance is rebooted using local boot.
Your Instance starts using local boot.

## How to use rescue mode

Rescue mode restarts your Instance via the network on a minimal operating system. You can use rescue mode to debug your Instance and recover your system data.

1. Click **Instances** in the **Compute** section of the side menu. The Instances page displays.
2. Click the Instance you wish to boot into Rescue Mode.
3. Click the **Advanced settings** tab.
4. In the **Boot mode** section, select **Use rescue image**.
5. Click **Save**.
6. Click **Reboot** in the top right corner of the page, and confirm the reboot of your Instance when prompted.

Your Instance is rebooted into Rescue mode.


## How to use a bootscript

<Message type="important">
This feature is **deprecated** and may be removed in the future. It is not recommended to use it any longer for production Instances.
</Message>

A bootscript allows you to choose a pre-built configuration script to boot your Instance.

1. Click **Instances** in the **Compute** section of the side menu. The Instances page displays.
2. Click the Instance you wish to use a bootscript with.
3. Click the **Advanced settings** tab.
4. In the **Boot mode** section, select **Use bootscript**.
5. Select a bootscript from the drop-down menu.
3. Use the toggle <Icon name="toggle" /> in the top right corner of the screen to **power off** your Instance.
4. Click the **Advanced settings** tab.
5. In the **Boot mode** section, select **Use rescue image**.
6. Click **Save**.
7. Click **Reboot** in the top right corner of the page, and confirm the reboot of your Instance when prompted.
7. Use the toggle <Icon name="toggle" /> in the top right corner of the screen to **power on** your Instance.

Your Instance starts in Rescue mode.

## How to use cloud-init

[Cloud-init](/compute/instances/concepts/#cloud-init) enables automatic configuration of an Instance as it boots into the cloud, turning it from a generic Ubuntu image into a configured server in a few seconds.
[Cloud-init](/compute/instances/concepts/#cloud-init) enables automatic configuration of an Instance as it boots into the cloud, turning it from a generic Ubuntu image into a configured server in a few seconds.

The cloud-init program that is able to consume and execute data from the user-data field of the Scaleway console. The process then behaves differently depending on the format of the information it finds. One of the most popular formats for scripts within user-data is the cloud-config file format. Cloud-config files are special scripts designed to be run by the cloud-init process.
These are generally used for initial configuration on the very first boot of a server. **Cloud-init is available for all Scaleway Instances OS images.**

Follow the instructions below to reboot an existing Instance using cloud-init.
Follow the instructions below to reboot an existing Instance using cloud-init.

1. Click **Instances** in the **Compute** section of the side menu. The Instances page displays.
2. Click the Instance you wish to use with cloud-init.
Expand Down Expand Up @@ -106,9 +91,9 @@ Follow the instructions below to reboot an existing Instance using cloud-init.

## How to change the boot volume

The [boot-on-block](/compute/instances/concepts/#boot-on-block) feature allows Instances to boot from attached [Block Storage](/compute/instances/concepts/#block-volumes) volumes instead of local volumes. When [creating an Instance](/compute/instances/how-to/create-an-instance), you can select Block Storage as a boot volume.
The [boot-on-block](/compute/instances/concepts/#boot-on-block) feature allows Instances to boot from attached [Block Storage](/compute/instances/concepts/#block-volumes) volumes instead of local volumes. When [creating an Instance](/compute/instances/how-to/create-an-instance), you can select Block Storage as a boot volume.

Once the Instance is created, you can select a different volume to boot from.
Once the Instance is created, you can select a different volume to boot from.

1. Click **Instances** in the **Compute** section of the side menu. The Instances page displays.
2. Click the Instance you wish to change the boot volume for.
Expand Down