From 2dadea98ad1eecdc2a56cb463d1a56b7cc3aee99 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Tue, 24 Jun 2025 12:13:48 +0200 Subject: [PATCH 1/7] docs(blk): reuse concepts from Instances doc MTA-6210 --- macros/concepts/availability-zone.mdx | 7 +++++++ macros/concepts/block-snapshot.mdx | 5 +++++ macros/concepts/block-volumes.mdx | 5 +++++ macros/concepts/region.mdx | 7 +++++++ pages/block-storage/concepts.mdx | 16 ++++++++++++++-- pages/instances/concepts.mdx | 12 ++++-------- tutorials/index.mdx | 8 -------- 7 files changed, 42 insertions(+), 18 deletions(-) create mode 100644 macros/concepts/availability-zone.mdx create mode 100644 macros/concepts/block-snapshot.mdx create mode 100644 macros/concepts/block-volumes.mdx create mode 100644 macros/concepts/region.mdx delete mode 100644 tutorials/index.mdx diff --git a/macros/concepts/availability-zone.mdx b/macros/concepts/availability-zone.mdx new file mode 100644 index 0000000000..9946c78283 --- /dev/null +++ b/macros/concepts/availability-zone.mdx @@ -0,0 +1,7 @@ +--- +macro: availability-zone +--- + +An Availability Zone refers to an isolated location within a specific region. Each Availability Zone provides its own services and infrastructure. For example, `fr-par-1`, `fr-par-2`, and `fr-par-3` are Availability Zones within the Paris region. + +For an extensive list of which regions and AZ a resource is available in, refer to our [Product availability guide](/account/reference-content/products-availability/) \ No newline at end of file diff --git a/macros/concepts/block-snapshot.mdx b/macros/concepts/block-snapshot.mdx new file mode 100644 index 0000000000..b9a38a1cd6 --- /dev/null +++ b/macros/concepts/block-snapshot.mdx @@ -0,0 +1,5 @@ +--- +macro: block-snapshot +--- + +A snapshot takes a picture of a specific volume at one point in time. For example, you may have a server with one volume containing the OS and another containing the application data and want to use different snapshot strategies on both volumes. [Creating snapshots of your volumes](/block-storage/how-to/create-a-snapshot/) gives you total freedom of which volumes you want to back up, while [images](#image) are more convenient for full backups of your Instance. \ No newline at end of file diff --git a/macros/concepts/block-volumes.mdx b/macros/concepts/block-volumes.mdx new file mode 100644 index 0000000000..dfcf4cfac8 --- /dev/null +++ b/macros/concepts/block-volumes.mdx @@ -0,0 +1,5 @@ +--- +macro: block-volumes +--- + +Block volumes provide network-attached storage you can plug in/out of Instances like a virtual hard drive. From a user's point of view, block volumes behave like regular disks and can be used to increase the storage of an Instance. \ No newline at end of file diff --git a/macros/concepts/region.mdx b/macros/concepts/region.mdx new file mode 100644 index 0000000000..b47fe64c90 --- /dev/null +++ b/macros/concepts/region.mdx @@ -0,0 +1,7 @@ +--- +macro: region +--- + +A region is a geographical area such as France (Paris: fr-par), the Netherlands (Amsterdam: nl-ams), or Poland (Warsaw: pl-waw) in which Scaleway products and resources are located. Each region contains multiple Availability Zones. + +For an extensive list of which regions and AZ a resource is available in, refer to our [Product availability guide](/account/reference-content/products-availability/) \ No newline at end of file diff --git a/pages/block-storage/concepts.mdx b/pages/block-storage/concepts.mdx index f2a294d0c0..1980d38a98 100644 --- a/pages/block-storage/concepts.mdx +++ b/pages/block-storage/concepts.mdx @@ -14,9 +14,13 @@ categories: - storage --- -## Block device +## Availability Zone -A block device is a storage volume on a network-connected storage system that is exposed to the guest operating system as if it were a physical disk. + + +## Block volumes + + ## IOPS @@ -31,6 +35,14 @@ Scaleway Block Storage Low Latency offers two IOPS limits: The local volume of an Instance is an all SSD-based storage solution, using a RAID array for redundancy and performance, that is hosted on the local hypervisor. +## Region + + + +## Snapshot + + + ## Storage Area Networks (SANs) A Storage Area Network (SAN) consists of interconnected machines, network infrastructure and storage devices designed for performance and high-availability. Unlike a Network Attached Storage (NAS) which stores all data on a [file level](https://www.scaleway.com/en/blog/understanding-the-different-types-of-storage/#what-is-file-storage), the SAN stores all data on [block level](https://www.scaleway.com/en/blog/understanding-the-different-types-of-storage/#what-is-block-storage), this makes SAN a perfect solution for business critical applications and input/output intense operations like relational databases. The SAN is a network-connected solution, that operates independently from the local hypervisor hosting the virtual Instance. The storage capacity of the block devices on the SAN can be tailored towards your requirements. diff --git a/pages/instances/concepts.mdx b/pages/instances/concepts.mdx index 3a04bcd2e1..24754177ac 100644 --- a/pages/instances/concepts.mdx +++ b/pages/instances/concepts.mdx @@ -14,13 +14,11 @@ categories: ## Availability Zone -An Availability Zone refers to an isolated location within a specific region. Each Availability Zone provides its own services and infrastructure. For example, `fr-par-1`, `fr-par-2`, and `fr-par-3` are Availability Zones within the Paris region. - -For an extensive list of which regions and AZ a resource is available in, refer to our [Product availability guide](/account/reference-content/products-availability/) + ## Block volumes -Block volumes provide network-attached storage you can plug in/out of Instances like a virtual hard drive. From a user's point of view, block volumes behave like regular disks and can be used to increase the storage of an Instance. + ## Boot-on-block @@ -128,9 +126,7 @@ Public IP addresses are routed on the internet. You can enter the public IP addr ## Region -A region is a geographical area such as France (Paris: fr-par), the Netherlands (Amsterdam: nl-ams), or Poland (Warsaw: pl-waw) in which Scaleway products and resources are located. Each region contains multiple Availability Zones. - -For an extensive list of which regions and AZ a resource is available in, refer to our [Product availability guide](/account/reference-content/products-availability/) + ## Rescue mode @@ -154,7 +150,7 @@ Security groups allow you to [create rules to drop or allow public traffic comin ## Snapshot -A snapshot takes a picture of a specific volume at one point in time. For example, you may have a server with one volume containing the OS and another containing the application data and want to use different snapshot strategies on both volumes. [Creating snapshots of your volumes](/block-storage/how-to/create-a-snapshot/) gives you total freedom of which volumes you want to back up, while [images](#image) are more convenient for full backups of your Instance. + ## Snapshot type diff --git a/tutorials/index.mdx b/tutorials/index.mdx deleted file mode 100644 index ae706fb2b7..0000000000 --- a/tutorials/index.mdx +++ /dev/null @@ -1,8 +0,0 @@ ---- -meta: - title: Tutorials - description: Explore Scaleway tutorials for Instances, Kubernetes, dedicated servers, Managed Databases, Serverless, Inference, DNS, and more cloud solutions. -content: - h1: Tutorials - paragraph: Explore Scaleway tutorials for Instances, Kubernetes, dedicated servers, Managed Databases, Serverless, Inference, DNS, and more cloud solutions. ---- From de798de2c8722a5f456b54d74df83b8ac14d66a7 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Tue, 24 Jun 2025 12:15:16 +0200 Subject: [PATCH 2/7] docs(blk): fix missing tuto index --- tutorials/index.mdx | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 tutorials/index.mdx diff --git a/tutorials/index.mdx b/tutorials/index.mdx new file mode 100644 index 0000000000..47129f4666 --- /dev/null +++ b/tutorials/index.mdx @@ -0,0 +1,8 @@ +--- +meta: + title: Tutorials + description: Explore Scaleway tutorials for Instances, Kubernetes, dedicated servers, Managed Databases, Serverless, Inference, DNS, and more cloud solutions. +content: + h1: Tutorials + paragraph: Explore Scaleway tutorials for Instances, Kubernetes, dedicated servers, Managed Databases, Serverless, Inference, DNS, and more cloud solutions. +--- \ No newline at end of file From 6306291d4c2c8ad9a4994ce12627389fddaae0c8 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Tue, 24 Jun 2025 12:15:38 +0200 Subject: [PATCH 3/7] docs(blk): fix missing tuto index --- tutorials/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tutorials/index.mdx b/tutorials/index.mdx index 47129f4666..ae706fb2b7 100644 --- a/tutorials/index.mdx +++ b/tutorials/index.mdx @@ -5,4 +5,4 @@ meta: content: h1: Tutorials paragraph: Explore Scaleway tutorials for Instances, Kubernetes, dedicated servers, Managed Databases, Serverless, Inference, DNS, and more cloud solutions. ---- \ No newline at end of file +--- From c2ee0faf344925c1698f8e3b3db7b5dd5937f7cc Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Tue, 24 Jun 2025 12:22:44 +0200 Subject: [PATCH 4/7] docs(blk): make more macros --- macros/concepts/local-volumes.mdx | 5 +++++ macros/concepts/volumes.mdx | 9 +++++++++ pages/block-storage/concepts.mdx | 6 +++++- pages/instances/concepts.mdx | 8 ++------ pages/local-storage/concepts.mdx | 13 +++++-------- 5 files changed, 26 insertions(+), 15 deletions(-) create mode 100644 macros/concepts/local-volumes.mdx create mode 100644 macros/concepts/volumes.mdx diff --git a/macros/concepts/local-volumes.mdx b/macros/concepts/local-volumes.mdx new file mode 100644 index 0000000000..0eb360ea70 --- /dev/null +++ b/macros/concepts/local-volumes.mdx @@ -0,0 +1,5 @@ +--- +macro: local-volumes +--- + +The local volume of an Instance is an all-SSD-based storage solution, using a RAID array for redundancy and performance, hosted on the local hypervisor. On Scaleway Instances, the size of the local volume is fixed and depends on the Instance type. Some Instance types do not use local volumes and [boot directly on block volumes](#boot-on-block). In any case, it is always possible to increase the storage of an Instance by adding additional block volumes. \ No newline at end of file diff --git a/macros/concepts/volumes.mdx b/macros/concepts/volumes.mdx new file mode 100644 index 0000000000..64d109f88c --- /dev/null +++ b/macros/concepts/volumes.mdx @@ -0,0 +1,9 @@ +--- +macro: volumes +--- + +Volumes are the storage space of your Instances. Two types of volumes exist: + +* **[Local volumes](/local-storage/)**: The local volume of an Instance is an all-SSD-based storage solution, using a RAID array for redundancy and performance, hosted on the local hypervisor. On Scaleway Instances, the size of the local volume is fixed and depends on the Instance type. Some Instance types do not use local volumes and [boot directly on block volumes](/instances/concepts/#boot-on-block). + +* **[Block volumes*](/block-storage/)**: Block volumes provide network-attached storage you can plug in and out of Instances like a virtual hard drive. Block volumes behave like regular disks and can be used to increase the storage of an Instance. \ No newline at end of file diff --git a/pages/block-storage/concepts.mdx b/pages/block-storage/concepts.mdx index 1980d38a98..7748d517d9 100644 --- a/pages/block-storage/concepts.mdx +++ b/pages/block-storage/concepts.mdx @@ -22,6 +22,10 @@ categories: +## Boot-on-block + + + ## IOPS IOPS or Input/Ouptut Operations Per Second, is a unit of measurement that indicates how many read/write operations a storage device is performing per second. @@ -33,7 +37,7 @@ Scaleway Block Storage Low Latency offers two IOPS limits: ## Local volume -The local volume of an Instance is an all SSD-based storage solution, using a RAID array for redundancy and performance, that is hosted on the local hypervisor. + ## Region diff --git a/pages/instances/concepts.mdx b/pages/instances/concepts.mdx index 24754177ac..62564768cc 100644 --- a/pages/instances/concepts.mdx +++ b/pages/instances/concepts.mdx @@ -86,7 +86,7 @@ With IP mobility, there are no NAT IPs anymore. The public IP is entirely routed ## Local volumes -The local volume of an Instance is an all-SSD-based storage solution, using a RAID array for redundancy and performance, hosted on the local hypervisor. On Scaleway Instances, the size of the local volume is fixed and depends on the Instance type. Some Instance types do not use local volumes and [boot directly on block volumes](#boot-on-block). In any case, it is always possible to increase the storage of an Instance by adding additional block volumes. + ## Placement groups @@ -174,8 +174,4 @@ Tags allow you to organize, sort, filter, and monitor your cloud resources using ## Volumes -Volumes are the storage space of your Instances. Two types of volumes exist: - -* **[Local volumes](/local-storage/)**: The local volume of an Instance is an all-SSD-based storage solution, using a RAID array for redundancy and performance, hosted on the local hypervisor. On Scaleway Instances, the size of the local volume is fixed and depends on the Instance type. Some Instance types do not use local volumes and [boot directly on block volumes](#boot-on-block). - -* **[Block volumes*](/block-storage/)**: Block volumes provide network-attached storage you can plug in and out of Instances like a virtual hard drive. Block volumes behave like regular disks and can be used to increase the storage of an Instance. \ No newline at end of file + \ No newline at end of file diff --git a/pages/local-storage/concepts.mdx b/pages/local-storage/concepts.mdx index 3517999cc4..f05e9e02bd 100644 --- a/pages/local-storage/concepts.mdx +++ b/pages/local-storage/concepts.mdx @@ -14,15 +14,15 @@ categories: ## Block volumes -Block volumes provide network-attached storage you can plug in and out of Instances like a virtual hard drive. From a user's point of view, block volumes behave like regular disks and can be used to increase the storage of an Instance. + -## Boot-on-Block +## Boot-on-block -Some Instance types do not use local volumes and instead boot directly on block volumes. + ## Local volumes -The local volume of an Instance is an all-SSD-based storage solution, using a RAID array for redundancy and performance, hosted on the local hypervisor. On Scaleway Instances, the size of the local volume is fixed and depends on the Instance type. Some Instance types do not use local volumes and [boot directly on block volumes](#boot-on-block). In any case, it is always possible to increase the storage of an Instance by adding additional block volumes. + ## Power-off mode @@ -34,7 +34,4 @@ Standby mode is a way to stop an Instance temporarily. When you put an Instance ## Volumes -Volumes are the storage space of your Instances. Two types of volumes exist: - -- **[Local volumes](/local-storage/)**: The local volume of an Instance is an all-SSD-based storage solution, using a RAID array for redundancy and performance, hosted on the local hypervisor. On Scaleway Instances, the size of the local volume is fixed and depends on the Instance type. Some Instance types do not use local volumes and [boot directly on block volumes](#boot-on-block). -- **[Block volumes](/block-storage/)**: Block volumes provide network-attached storage you can plug in and out of Instances like a virtual hard drive. Block volumes behave like regular disks and can be used to increase the storage of an Instance. + \ No newline at end of file From 05ed66be62310f4c98b983873fbe1222d4817dab Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Tue, 24 Jun 2025 13:47:49 +0200 Subject: [PATCH 5/7] docs(blk): fix --- macros/concepts/volumes.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/macros/concepts/volumes.mdx b/macros/concepts/volumes.mdx index 64d109f88c..55e94172dc 100644 --- a/macros/concepts/volumes.mdx +++ b/macros/concepts/volumes.mdx @@ -6,4 +6,4 @@ Volumes are the storage space of your Instances. Two types of volumes exist: * **[Local volumes](/local-storage/)**: The local volume of an Instance is an all-SSD-based storage solution, using a RAID array for redundancy and performance, hosted on the local hypervisor. On Scaleway Instances, the size of the local volume is fixed and depends on the Instance type. Some Instance types do not use local volumes and [boot directly on block volumes](/instances/concepts/#boot-on-block). -* **[Block volumes*](/block-storage/)**: Block volumes provide network-attached storage you can plug in and out of Instances like a virtual hard drive. Block volumes behave like regular disks and can be used to increase the storage of an Instance. \ No newline at end of file +* **[Block volumes](/block-storage/)**: Block volumes provide network-attached storage you can plug in and out of Instances like a virtual hard drive. Block volumes behave like regular disks and can be used to increase the storage of an Instance. \ No newline at end of file From 8957fa8f010afbda4311c7e61d3ad86bd8e43883 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Tue, 24 Jun 2025 15:03:01 +0200 Subject: [PATCH 6/7] Update macros/concepts/availability-zone.mdx Co-authored-by: Jessica <113192637+jcirinosclwy@users.noreply.github.com> --- macros/concepts/availability-zone.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/macros/concepts/availability-zone.mdx b/macros/concepts/availability-zone.mdx index 9946c78283..756c3c14ae 100644 --- a/macros/concepts/availability-zone.mdx +++ b/macros/concepts/availability-zone.mdx @@ -4,4 +4,4 @@ macro: availability-zone An Availability Zone refers to an isolated location within a specific region. Each Availability Zone provides its own services and infrastructure. For example, `fr-par-1`, `fr-par-2`, and `fr-par-3` are Availability Zones within the Paris region. -For an extensive list of which regions and AZ a resource is available in, refer to our [Product availability guide](/account/reference-content/products-availability/) \ No newline at end of file +For an extensive list of which regions and AZ a resource is available in, refer to our [Product availability guide](/account/reference-content/products-availability/). \ No newline at end of file From 2a772f059eba311983ab950317b3557585775b34 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Tue, 24 Jun 2025 15:03:24 +0200 Subject: [PATCH 7/7] Apply suggestions from code review Co-authored-by: Jessica <113192637+jcirinosclwy@users.noreply.github.com> --- macros/concepts/local-volumes.mdx | 2 +- macros/concepts/region.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/macros/concepts/local-volumes.mdx b/macros/concepts/local-volumes.mdx index 0eb360ea70..f6d7852412 100644 --- a/macros/concepts/local-volumes.mdx +++ b/macros/concepts/local-volumes.mdx @@ -2,4 +2,4 @@ macro: local-volumes --- -The local volume of an Instance is an all-SSD-based storage solution, using a RAID array for redundancy and performance, hosted on the local hypervisor. On Scaleway Instances, the size of the local volume is fixed and depends on the Instance type. Some Instance types do not use local volumes and [boot directly on block volumes](#boot-on-block). In any case, it is always possible to increase the storage of an Instance by adding additional block volumes. \ No newline at end of file +The local volume of an Instance is an all-SSD-based storage solution, using a RAID array for redundancy and performance, hosted on the local hypervisor. On Scaleway Instances, the size of the local volume is fixed and depends on the Instance type. Some Instance types do not use local volumes and [boot directly on block volumes](#boot-on-block). In any case, it is always possible to increase the storage of an Instance by adding extra block volumes. \ No newline at end of file diff --git a/macros/concepts/region.mdx b/macros/concepts/region.mdx index b47fe64c90..1a863f470b 100644 --- a/macros/concepts/region.mdx +++ b/macros/concepts/region.mdx @@ -4,4 +4,4 @@ macro: region A region is a geographical area such as France (Paris: fr-par), the Netherlands (Amsterdam: nl-ams), or Poland (Warsaw: pl-waw) in which Scaleway products and resources are located. Each region contains multiple Availability Zones. -For an extensive list of which regions and AZ a resource is available in, refer to our [Product availability guide](/account/reference-content/products-availability/) \ No newline at end of file +For an extensive list of which regions and AZs a resource is available in, refer to our [Product availability guide](/account/reference-content/products-availability/). \ No newline at end of file