From 13222d14412d7d94a17294dfad863941759c3d69 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Mon, 9 Sep 2024 17:01:57 +0200 Subject: [PATCH 01/14] chore(gen): review tutorials MTA-5002 --- tutorials/setup-mongodb-on-ubuntu/index.mdx | 65 +++++++++++++-------- 1 file changed, 40 insertions(+), 25 deletions(-) diff --git a/tutorials/setup-mongodb-on-ubuntu/index.mdx b/tutorials/setup-mongodb-on-ubuntu/index.mdx index cab92e1ebd..e73dc373f4 100644 --- a/tutorials/setup-mongodb-on-ubuntu/index.mdx +++ b/tutorials/setup-mongodb-on-ubuntu/index.mdx @@ -9,11 +9,11 @@ tags: database mysql mongoDB UFW bindIP categories: - instances dates: - validation: 2024-03-05 + validation: 2024-09-09 posted: 2022-03-01 --- -MongoDB is a document-oriented database, available for free as an open-source solution. Renowned for its scalability, robustness, reliability, and user-friendly nature, it is one of the premier choices among NoSQL database engines. +[MongoDB](https://www.mongodb.com/) is a document-oriented database, available for free as an open-source solution. Renowned for its scalability, robustness, reliability, and user-friendly nature, it is one of the premier choices among NoSQL database engines. Diverging from traditional relational databases, MongoDB users no longer need an intricate predefined schema before adding data. This flexibility stems from its ability to modify schemas at any point in time. Embracing the NoSQL philosophy, it employs JSON-like documents for data storage, allowing the insertion of diverse and arbitrary data. @@ -36,7 +36,7 @@ Powerful [Production-Optimized Instance](/compute/instances/reference-content/ch ### Adding MongoDB repository - You should always use the official MongoDB `mongodb-org` packages, to make sure you have the latest, up-to-date major and minor MongoDB releases. + Always use the official MongoDB `mongodb-org` packages, to make sure you have the latest, up-to-date major and minor MongoDB releases. 1. [Connect to your Instance](/compute/instances/how-to/connect-to-instance/) via SSH. @@ -90,6 +90,7 @@ Powerful [Production-Optimized Instance](/compute/instances/reference-content/ch ``` systemctl status mongod ``` + An output similar to the following displays. ``` ● mongod.service - MongoDB Database Server Loaded: loaded (/lib/systemd/system/mongod.service; disabled; vendor prese> @@ -100,10 +101,13 @@ Powerful [Production-Optimized Instance](/compute/instances/reference-content/ch CGroup: /system.slice/mongod.service └─21330 /usr/bin/mongod --config /etc/mongod.conf ``` + Press `q` to exit. +4. Verify that the service has started properly. ``` systemctl status mongod.service ``` + An output similar to the following displays. ``` ● mongod.service - MongoDB Database Server Loaded: loaded (/lib/systemd/system/mongod.service; disabled; vendor prese> @@ -116,7 +120,7 @@ Powerful [Production-Optimized Instance](/compute/instances/reference-content/ch ``` Press `q` to exit. -4. Ensure that it restarts automatically at each boot: +5. Ensure that it restarts automatically at each boot: ``` systemctl enable mongod.service ``` @@ -126,7 +130,7 @@ Powerful [Production-Optimized Instance](/compute/instances/reference-content/ch ### Securing MongoDB -The default installation of MongoDB is vulnerable because no authentication is required to interact with the database. Any user could create and destroy databases, as well as read from and write to their contents by default. To secure MongoDB, we need to create an administrative user and enable authentication. +The default installation of MongoDB is vulnerable because no authentication is required to interact with the database. Any user can create and destroy databases, as well as read from and write to their contents by default. To secure MongoDB, you must create an administrative user and enable authentication. 1. Connect to the [Mongo shell](https://docs.mongodb.com/mongodb-shell/) to add a new user. ``` @@ -136,7 +140,6 @@ The default installation of MongoDB is vulnerable because no authentication is r Connecting to: mongodb://127.0.0.1:27017/?directConnection=true&serverSelectionTimeoutMS=2000&appName=mongosh+1.10.6 Using MongoDB: 7.0.0 Using Mongosh: 1.10.6 - ``` For mongosh info see: https://docs.mongodb.com/mongodb-shell/ ``` @@ -166,13 +169,13 @@ The default installation of MongoDB is vulnerable because no authentication is r ### Enabling authentication -To enforce authentication, we need to enable authentication and restart the MongoDB daemon. +To enforce authentication, you must enable authentication and restart the MongoDB daemon. 1. Open the configuration file. ``` nano /etc/mongod.conf ``` -2. Remove the hash in front of `security` to enable the section. Then, we add the authorization lines (indented with two spaces) as per the following excerpt below: +2. Remove the hash in front of `security` to enable the section, then, add `authorization: "enabled"` (indented with two spaces) on the following line as shown below: ``` security: authorization: "enabled" @@ -227,10 +230,11 @@ To enforce authentication, we need to enable authentication and restart the Mong ### Testing authentication -1. Connect without credentials to verify that our actions are restricted. +1. Connect without credentials to verify that actions are restricted. ``` mongosh ``` + The following output displays. ``` Connecting to: mongodb://127.0.0.1:27017/?directConnection=true&serverSelectionTimeoutMS=2000&appName=mongosh+1.10.6 Using MongoDB: 7.0.0 @@ -241,27 +245,33 @@ To enforce authentication, we need to enable authentication and restart the Mong test> ``` - We are connected to the `test` database. -2. Test that the access is restricted with the `show dbs` command: + You are now connected to the `test` database. +2. Test that the access is restricted with the `show dbs` command. ``` - test> show dbs - MongoServerError: command listDatabases requires authentication + show dbs ``` -3. Exit the shell to proceed. + The following output displays. ``` - > exit - bye + MongoServerError: command listDatabases requires authentication ``` +Type `exit` or press `CTRL+C` to exit. + ### Verifying the administrative user's access -1. Connect as our administrator with the `-u` option to supply a username and `-p` to be prompted for a password. Supply the database where we stored the user's authentication credentials with the `--authenticationDatabase` option. +1. Connect as an administrator with the `-u` option to supply a username and `-p` to be prompted for a password. Supply the database where you stored the user's authentication credentials with the `--authenticationDatabase` option. ``` mongosh -u AdminOce -p --authenticationDatabase admin ``` -2. Once the correct password is entered, we are dropped into the shell, where we can issue the `show dbs` command: + +3. Enter your password. The shell displays. + +2. Run the `show dbs` command to make sure you are logged in properly. + ``` + show dbs + ``` + The following output displays. ``` - test> show dbs admin 135 kB config 61.4 kB local 73.7 kB @@ -287,7 +297,7 @@ Uncomplicated Firewall (UFW), is a front-end to iptables. Its main goal is to ma ``` ufw status ``` -3. Enable UFW, as it is probably inactive. +3. Enable UFW, as it may be inactive. ``` ufw enable ``` @@ -299,6 +309,7 @@ Uncomplicated Firewall (UFW), is a front-end to iptables. Its main goal is to ma ``` ufw status ``` + An output similar to the following displays. ``` Status: active @@ -315,6 +326,7 @@ Uncomplicated Firewall (UFW), is a front-end to iptables. Its main goal is to ma ``` ufw status ``` + An output similar to the following displays. ``` To Action From -- ------ ---- @@ -325,15 +337,17 @@ Uncomplicated Firewall (UFW), is a front-end to iptables. Its main goal is to ma ### Configuring a public bindIP -1. To allow remote connections, add our host's publically routable IP address to the `mongod.conf` file. +1. To allow remote connections, add the host's publically routable IP address to the `mongod.conf` file. ``` nano /etc/mongod.conf ``` 2. In the `net` section, add the MongoHost's IP to the bindIp line. - - Verify your NAT IP with the `ifconfig` command. - +3. Verify your NAT IP with the `ifconfig` command. + ``` + ifconfig + ``` + An output similar to the following displays. ``` net: port: 27017 @@ -347,6 +361,7 @@ Uncomplicated Firewall (UFW), is a front-end to iptables. Its main goal is to ma ``` systemctl status mongod.service ``` + An output similar to the following displays. ``` Active: active (running) since Thu 2018-xx-yy 13:15:35 UTC; 5s ago ``` @@ -357,7 +372,7 @@ Ensure that Mongo is listening on its public interface by adding the `--host` fl ``` mongosh -u AdminOce -p --authenticationDatabase admin --host IP_address_of_MongoHost ``` - +An output similar to the following displays. ``` Connecting to: mongodb://127.0.0.1:27017/?directConnection=true&serverSelectionTimeoutMS=2000&appName=mongosh+1.10.6 Using MongoDB: 7.0.0 From 723d8c5aa69d0b107474b64f9b8804e8e3732482 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Tue, 10 Sep 2024 11:46:08 +0200 Subject: [PATCH 02/14] chore(gen): review --- .../index.mdx | 10 +++++----- tutorials/migrate-data-minio-client/index.mdx | 18 +++++++++--------- 2 files changed, 14 insertions(+), 14 deletions(-) diff --git a/tutorials/add-disk-configure-datastore-esxi/index.mdx b/tutorials/add-disk-configure-datastore-esxi/index.mdx index 55a7953f2f..075aca91bf 100644 --- a/tutorials/add-disk-configure-datastore-esxi/index.mdx +++ b/tutorials/add-disk-configure-datastore-esxi/index.mdx @@ -10,12 +10,12 @@ categories: - dedibox hero: assets/scaleway_add_disk.webp dates: - validation: 2024-02-26 + validation: 2024-09-10 posted: 2020-01-21 --- - Due to VMware's acquisition by Broadcom, the free edition of VMware vSphere Hypervisor is no longer available on the VMware website. For more details, check out [the EOL of free vSphere Hypervisor](https://knowledge.broadcom.com/external/article?legacyId=2107518). Please note that the following content is provided as-is, without any guarantee of functionality. +Due to VMware's acquisition by Broadcom, the free edition of VMware vSphere Hypervisor is no longer available on the VMware website. For more details, check out [the EOL of free vSphere Hypervisor](https://knowledge.broadcom.com/external/article?legacyId=2107518). The following content is provided as-is, without any guarantee of functionality. We suggest considering alternative hypervisors such as Proxmox. You can learn how to [deploy virtual machines with Proxmox on Scaleway Dedibox](/tutorials/configure-failover-proxmox/). @@ -78,7 +78,7 @@ If you find that the newly installed disk does not appear in your ESXi web inter -Depending on the configuration of your Dedibox, the server may come with a [hardware RAID](https://en.wikipedia.org/wiki/Disk_array_controller). On this type of server you cannot configure the datastore directly from ESXi. Instead, you must create a virtual disk from the KVM-over-IP interface of the server before adding the disk to ESXi. To do so, follow these steps: +Depending on the configuration of your Dedibox, the server may come with a [hardware RAID](https://en.wikipedia.org/wiki/Disk_array_controller). On this type of server, you cannot configure the datastore directly from ESXi. Instead, you must create a virtual disk from the KVM-over-IP interface of the server before adding the disk to ESXi. To do so, follow these steps: 1. Launch an iDRAC session from the server overview in the Dedibox console: @@ -104,7 +104,7 @@ Depending on the configuration of your Dedibox, the server may come with a [hard Your machine will be unavailable during the creation of the new virtual disk. We recommend you launch the reboot during the hours of low load on your machine. -After the reboot the new virtual disk shows up in the list of available disks in ESXi: +After rebooting, the new virtual disk shows up in the list of available disks in ESXi: @@ -148,4 +148,4 @@ It is also possible to increase the size of an existing datastore. In this case, The disk is added to the datastore and the total storage capacity of the datastore is increased. -For more information regarding the management of your virtual machines using the ESXi hypervisor, refer to our [dedicated documentation](/tutorials/configure-virtual-machine-esxi/). \ No newline at end of file +For more information on managing your virtual machines using the ESXi hypervisor, refer to our [dedicated documentation](/tutorials/configure-virtual-machine-esxi/). \ No newline at end of file diff --git a/tutorials/migrate-data-minio-client/index.mdx b/tutorials/migrate-data-minio-client/index.mdx index b3dda36760..28e61c722b 100644 --- a/tutorials/migrate-data-minio-client/index.mdx +++ b/tutorials/migrate-data-minio-client/index.mdx @@ -1,20 +1,20 @@ --- meta: - title: Migrating Object Storage data with Minio client - description: This page shows you how to migrate Object Storage data from one region to another with Minio client + title: Migrating Object Storage data with Minio Client + description: This page shows you how to migrate Object Storage data from one region to another with Minio Client content: - h1: Migrating Object Storage data with Minio client - paragraph: This page shows you how to migrate Object Storage data from one region to another with Minio client + h1: Migrating Object Storage data with MinIO Client + paragraph: This page shows you how to migrate Object Storage data from one region to another with MinIO Client categories: - instances - object-storage tags: Minio object-storage s3 dates: - validation: 2024-02-26 + validation: 2024-09-10 posted: 2019-03-20 --- -MinIO client provides a modern alternative to UNIX commands like ls, cat, cp, mirror, diff, etc. It can communicate with any S3-compatible cloud storage provider and can be used to migrate data from one region to another. +The [MinIO Client](https://min.io/docs/minio/linux/reference/minio-mc.html) provides a modern alternative to UNIX commands like ls, cat, cp, mirror, diff, etc. It can communicate with any S3-compatible cloud storage provider and can be used to migrate data from one region to another. @@ -24,7 +24,7 @@ MinIO client provides a modern alternative to UNIX commands like ls, cat, cp, mi - An [Instance](/compute/instances/how-to/create-an-instance/) - [Object Storage buckets](/storage/object/how-to/create-a-bucket/) in two different regions -## Installing the Minio client +## Installing the MinIO Client 1. [Connect to your Instance](/compute/instances/how-to/connect-to-instance/) as `root` via SSH. 2. Update the APT package cache and the software already installed on the Instance: @@ -78,11 +78,11 @@ MinIO client provides a modern alternative to UNIX commands like ls, cat, cp, mi 2. Migrates data from GCS Object Storage to Scaleway's **nl-ams** Object Storage - Note that this migration can incur some cost from the Object Storage you are migrating **from** since they may or may not bill egress bandwidth. + Note that this migration can incur some cost from the Object Storage you are migrating **from** since they may bill egress bandwidth. The Minio Client displays a status bar during the transfer, allowing to observe the status of the migration: -For more information about MinIO client refer to the [official documentation](https://docs.minio.io/docs/minio-client-quickstart-guide.html). \ No newline at end of file +For more information about MinIO Client refer to the [official documentation](https://docs.minio.io/docs/minio-client-quickstart-guide.html). \ No newline at end of file From af360ce9529b56dd7fa4af189330a1eb92dbbd91 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Tue, 10 Sep 2024 11:54:03 +0200 Subject: [PATCH 03/14] chore(gen): review --- tutorials/ark-server/index.mdx | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/tutorials/ark-server/index.mdx b/tutorials/ark-server/index.mdx index 4ed1e13bc9..5448637854 100644 --- a/tutorials/ark-server/index.mdx +++ b/tutorials/ark-server/index.mdx @@ -10,27 +10,27 @@ categories: - instances hero: assets/scaleway_arkserver.webp dates: - validation: 2024-02-26 + validation: 2024-09-10 posted: 2020-11-10 --- -**Ark: Survival Evolved** (stylized as ΛRK) is an action-adventure game released in 2017 by the game development company Studio Wildcard. The game is available for PC, Xbox One, Nintendo Switch, and PS4. Mobile versions of the game exist for Android and iOS. +[ARK: Survival Evolved](https://fr.wikipedia.org/wiki/ARK:_Survival_Evolved) is an action-adventure game released in 2017 by the game development company Studio Wildcard. The game is available for PC, Xbox One, Nintendo Switch, and PS4. Mobile versions of the game exist for Android and iOS. -In the game, you start as a man or woman stranded on the shores of a mysterious island called ARK, populated with roaming dinosaurs and other prehistoric animals. The player has to hunt, harvest resources, craft items, grow crops, research technologies, and build shelters to withstand the elements and survive. There are currently more than 150 creatures that populate the world of Ark, and one of the primary mechanics of the game is taming these creatures using projectiles like tranquilizing darts or weapons. During the game, the player can team up with, or prey upon, hundreds of other players on various ARK servers to survive, dominate - and finally escape from the island! +In the game, you start as a man or woman stranded on the shores of a mysterious island called ARK, populated with roaming dinosaurs and other prehistoric animals. The player has to hunt, harvest resources, craft items, grow crops, research technologies, and build shelters to withstand the elements and survive. There are currently more than 150 creatures that populate the world of ARK, and one of the primary mechanics of the game is taming these creatures using projectiles like tranquilizing darts or weapons. During the game, the player can team up with, or prey upon, hundreds of other players on various ARK servers to survive, dominate - and finally escape from the island! -## What is "Ark: Survival Evolved"? +## What is _ARK: Survival Evolved_? -“Ark: Survival Evolved” is a survival game, as the title indicates, where you are stranded in a hostile world with nothing. You have to hunt, harvest, craft, and gather your way toward bigger and better resources. The game concept is similar to other games like Minecraft, Dayz, and Rust. You can explore the island and its imposing environment, which is composed of many natural and unnatural structures, above-ground, below-ground, and underwater. While doing this, you discover the most exotic procedurally randomized creatures and rare blueprints, allowing you to build structures and level up your character. All your actions require resources, and you have to eat and drink to keep your character alive. +_ARK: Survival Evolved_ is a survival game, as the title indicates, where you are stranded in a hostile world with nothing. You have to hunt, harvest, craft, and gather your way toward bigger and better resources. The game concept is similar to other games like Minecraft, Dayz, and Rust. You can explore the island and its imposing environment, which is composed of many natural and unnatural structures, above-ground, below-ground, and underwater. While doing this, you discover the most exotic procedurally randomized creatures and rare blueprints, allowing you to build structures and level up your character. All your actions require resources, and you have to eat and drink to keep your character alive. -The game supports both single-player local games and massive multi-player games using more than 100 Ark servers. You can create a tribe on the server and invite your friends to join your tribe to be even stronger. In your tribe, all tamed dinosaurs and building structures are usually shared between tribe members, and you can delegate tasks to other members of your tribe. +The game supports both single-player local games and massive multi-player games using more than 100 ARK servers. You can create a tribe on the server and invite your friends to join your tribe to be even stronger. In your tribe, all tamed dinosaurs and building structures are usually shared between tribe members, and you can delegate tasks to other members of your tribe. ## Why should I start an ARK server? -When playing “Ark: Survival Evolved” on one of the existing public servers, you are limited to the constraints and resources available on this server. These predefined ARK maps and assets are an excellent start to get some initial inspiration. Still, they will not allow you to imagine and design your own unique ‘Procedurally Generated ARKs' for infinite replayability and endless surprises. +When playing _ARK: Survival Evolved_ on one of the existing public servers, you are limited to the constraints and resources available on this server. These predefined ARK maps and assets are an excellent start to get some initial inspiration. Still, they will not allow you to imagine and design your own unique 'Procedurally Generated ARKs' for infinite replayability and endless surprises. -By starting your own “Ark: Survival Evolved” server, you can design an ARK map precisely to your creativity and liking. +By starting your own _ARK: Survival Evolved_ server, you can design an ARK map precisely to your creativity and liking. In this tutorial, you will learn how to create an ARK server on a [Scaleway Instance](https://www.scaleway.com/en/virtual-instances/) to design your ARK and invite your friends to play with you on a server tailored to your needs. @@ -44,7 +44,7 @@ In this tutorial, you will learn how to create an ARK server on a [Scaleway Inst - An [Instance](/compute/instances/how-to/create-an-instance/) running Ubuntu Bionic Beaver (18.04) or Ubuntu Focal Fossa (20.04) - A valid [API key](/identity-and-access-management/iam/how-to/create-api-keys/) - `sudo` privileges or access to the root user -- A copy of ["Ark: Survival Evolved"](https://store.steampowered.com/app/346110/ARK_Survival_Evolved/) for your local computer +- A copy of [ARK: Survival Evolved](https://store.steampowered.com/app/346110/ARK_Survival_Evolved/) for your local computer We recommend you follow this tutorial using a [Cost-Optimized Instance](/compute/instances/reference-content/choosing-instance-type/). @@ -53,7 +53,7 @@ In this tutorial, you will learn how to create an ARK server on a [Scaleway Inst Creating an ARK server can be done in a few steps on a [Scaleway Instance](https://www.scaleway.com/en/cost-optimized-instances/). If you do not have an Instance yet, start by [deploying your first Instance](/compute/instances/how-to/create-an-instance/). - The "Ark: Survival Evolved" game server application requires at least 6 GB of RAM to start. Memory requirements increase as the number of connected players increases, as well depending on the activated mods. We recommend that you use at minimum a **DEV1-L** Instance for smooth gameplay. + The ARK: Survival Evolved game server application requires at least 6 GB of RAM to start. Memory requirements increase as the number of connected players increases, as well depending on the activated mods. We recommend that you use at minimum a **DEV1-L** Instance for smooth gameplay. 1. Connect to your Instance using [SSH](/compute/instances/how-to/connect-to-instance/). @@ -99,12 +99,12 @@ Creating an ARK server can be done in a few steps on a [Scaleway Instance](https Steam> ``` -7. Log in as `anonymous` user to the steam service, set the directory for the ARK server files (`/home/steam/servers/ark`), and download the application with the ID `376030` for "Ark: Survival Evolved". Then leave the Steam console using the `quit` command: +7. Log in as `anonymous` user to the steam service, set the directory for the ARK server files (`/home/steam/servers/ark`), and download the application with the ID `376030` for _ARK: Survival Evolved_. Then leave the Steam console using the `quit` command: ``` Steam> login anonymous Steam> force_install_dir /home/steam/servers/ark Steam> app_update 376030 validate - Steam> exit + Steam> quit ``` @@ -194,10 +194,10 @@ Creating an ARK server can be done in a few steps on a [Scaleway Instance](https After completing the installation of your ARK server, you can connect to it by following these three steps: -1. Start the "Ark: Survival Evolved" client on your local computer and click **Join ARK**. +1. Start the _ARK: Survival Evolved_ client on your local computer and click **Join ARK**. 2. Use the server name filter to find your server and select it. 3. Enter the server password and click **Accept** to connect to it. ## Conclusion -You now have created, started and configured an **[Ark: Survival Evolved](https://store.steampowered.com/app/346110/ARK_Survival_Evolved/)** server on a [Scaleway Instance](https://www.scaleway.com/en/virtual-instances/), installed basic protection through UFW and are ready to invite your friends to build your tribe on the server. For more information about customization and additional mods, refer to the official [ARK Community platform](https://survivetheark.com/). \ No newline at end of file +You now have created, started and configured an [_ARK: Survival Evolved_](https://store.steampowered.com/app/346110/ARK_Survival_Evolved/) server on a [Scaleway Instance](https://www.scaleway.com/en/virtual-instances/), installed basic protection through UFW and are ready to invite your friends to build your tribe on the server. For more information about customization and additional mods, refer to the official [ARK Community platform](https://survivetheark.com/). \ No newline at end of file From 6eac765710f46ec76f71f89d35387695d74467de Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Tue, 10 Sep 2024 17:15:24 +0200 Subject: [PATCH 04/14] chore(gen): review --- tutorials/arqbackup-pc-mac/index.mdx | 6 +++--- tutorials/discourse-forum/index.mdx | 21 +++++++++++---------- tutorials/setup-minecraft/index.mdx | 10 +++++----- 3 files changed, 19 insertions(+), 18 deletions(-) diff --git a/tutorials/arqbackup-pc-mac/index.mdx b/tutorials/arqbackup-pc-mac/index.mdx index 4ccc7ed528..f1fb635c6d 100644 --- a/tutorials/arqbackup-pc-mac/index.mdx +++ b/tutorials/arqbackup-pc-mac/index.mdx @@ -10,13 +10,13 @@ categories: hero: assets/scaleway_arqbackup.webp tags: arq-backup object-storage s3 dates: - validation: 2024-02-26 + validation: 2024-09-10 posted: 2019-07-20 --- **Arq Backup** automatically backs up Macs and PCs to cloud storage while encrypting the data in an [open and documented format](https://www.arqbackup.com/arq_data_format.txt). -In this tutorial you learn how to back up your PC or Mac computer to Object Storage using Arq Backup, using version 7 of the application. +This tutorial guides you through backing up your PC or Mac computer to Scaleway Object Storage using Arq Backup version 7. @@ -74,7 +74,7 @@ In this tutorial you learn how to back up your PC or Mac computer to Object Stor ### Restoring Files -1. Go to the **Restore Files** section of Arq +1. Go to the **Restore Files** section of Arq: 2. Expand the menu on the left to see a list of all backups. They are sorted by the time/date of their creation. Click the desired backup, and the contents of the backup appear on the right. - Click the Item to restore, then click the **Restore...** button. diff --git a/tutorials/discourse-forum/index.mdx b/tutorials/discourse-forum/index.mdx index c231f61ed9..0f9b91e94e 100644 --- a/tutorials/discourse-forum/index.mdx +++ b/tutorials/discourse-forum/index.mdx @@ -10,13 +10,13 @@ hero: assets/scaleway-discourse-forum.webp - instances - domains-and-dns dates: - validation: 2024-02-26 + validation: 2024-09-10 posted: 2020-04-21 --- -**Discourse** is an open-source internet forum software application, distinguished by its incorporation of features popularized by major social networks. +[Discourse](https://www.discourse.org/) is an open-source internet forum software application, distinguished by its incorporation of features popularized by major social networks. -Developed with **Ember.js** and **Ruby on Rails**, it offers a modern approach to forum management. Behind the scenes, Discourse relies on PostgreSQL for efficient database management. +Developed with [Ember.js](https://emberjs.com/) and [Ruby on Rails](https://rubyonrails.org/), it offers a modern approach to forum management. Behind the scenes, Discourse relies on PostgreSQL for efficient database management. Released under the GNU General Public License version 2, its source code is freely available on GitHub. For those looking to set up Discourse, using the official [Docker image](https://github.com/discourse/discourse_docker) streamlines the process. This container encapsulates all necessary components, simplifying deployment, administration, and software updates. @@ -56,9 +56,9 @@ For those looking to set up Discourse, using the official [Docker image](https:/ ``` - It is **required** that: - - a valid (sub-)domain is pointed to your instance. **Discourse will not work from an IP address**. If you do not have a domain name yet, you can [order one](https://www.online.net/en/domain) now. Create a subdomain like `discourse.mydomain.com` or `forum.mydomain.com` for your Discourse instance. - - you have an SMTP server available to send out emails from Discourse. You can either configure [an own SMTP server](/tutorials/setup-postfix-ubuntu-bionic/) or use an SMTP service like [SendInBlue](https://www.sendinblue.com) or [Mailjet](https://www.mailjet.com). Make sure that the Instance's [SMTP ports are enabled](https://www.scaleway.com/en/faq/). **Discourse will not work if it can not send emails**. + You must have: + - a valid (sub-)domain pointing to your instance. **Discourse will not work from an IP address**. If you do not have a domain name yet, you can [order one](https://www.online.net/en/domain) now. Create a subdomain like `discourse.mydomain.com` or `forum.mydomain.com` for your Discourse instance. + - an SMTP server available to send out emails from Discourse. You can either configure [your own SMTP server](/tutorials/setup-postfix-ubuntu-bionic/) or use an SMTP service like [SendInBlue](https://www.sendinblue.com) or [Mailjet](https://www.mailjet.com). Make sure that the Instance's [SMTP ports are enabled](https://www.scaleway.com/en/faq/). **Discourse will not work if it can not send emails**. 7. Answer the following questions: ``` @@ -70,8 +70,11 @@ For those looking to set up Discourse, using the official [Docker image](https:/ SMTP password? [pa$$word]: Let's Encrypt account email? (ENTER to skip) [me@example.com]: ``` -8. Once all details are entered, an `app.yml` configuration file is generated on your behalf before bootstrapping the installation. Note that the installation of Discourse may take up to 10 minutes depending on your instance type. +8. Once all details are entered, an `app.yml` configuration file is generated on your behalf before bootstrapping the installation. + + The installation of Discourse may take up to 10 minutes depending on your instance type. + ## Configuring the admin user 1. Once the installation is complete, open your web browser and go to your discourse subdomain (i.e. `https://discourse.example.com`). The configuration wizard displays. Click **Register** to create the first (admin) user: @@ -84,7 +87,5 @@ For those looking to set up Discourse, using the official [Docker image](https:/ 1. Once you have validated your email address, the Discourse configuration wizard displays. Choose the language for the application and click **Next**: -2. Complete the wizard to customize your community towards your needs.1. Once you have validated your email address, the Discourse configuration wizard displays. Choose the language for the application and click **Next**: - -3. Complete the wizard to customize your community to your needs. +2. Complete the wizard to customize your community to your needs. \ No newline at end of file diff --git a/tutorials/setup-minecraft/index.mdx b/tutorials/setup-minecraft/index.mdx index f56c16e238..f36f8f2e3c 100644 --- a/tutorials/setup-minecraft/index.mdx +++ b/tutorials/setup-minecraft/index.mdx @@ -1,15 +1,15 @@ --- meta: title: Creating your own Minecraft server - description: This page shows you what steps are required to host your own Minecraft server on a Scaleway Instance. + description: This page shows you the required steps to host your own Minecraft server on a Scaleway Instance. content: h1: Creating your own Minecraft server - paragraph: This page shows you what steps are required to host your own Minecraft server on a Scaleway Instance. + paragraph: This page shows you the required steps to host your own Minecraft server on a Scaleway Instance. tags: Minecraft gaming ubuntu categories: - instances dates: - validation: 2024-02-26 + validation: 2024-09-10 posted: 2019-11-15 --- @@ -36,7 +36,7 @@ The game supports Multiplayer mode, enabling multiple players to interact and co ## Why should I run my own Minecraft server? -By setting up your own Minecraft server, you can set the game's rules and invite all of your friends to play with you. +By setting up your own Minecraft server, you can set the game's rules and invite all your friends to play with you. You can install all the mods you want and customize your world with elements that were not initially available when the game was programmed. The Minecraft server is a Java application and runs perfectly on [Scaleway Instances](https://www.scaleway.com/en/virtual-instances/), allowing you to deploy your own Minecraft Instance in just a few minutes. @@ -97,7 +97,7 @@ Deploying your own Minecraft server can be done in a few easy steps on a [Scalew ``` - The flags `-Xms` and `-Xmx` define the minimum and maximum amount of RAM that can be used by the Minecraft server application. You may adjust these values to your needs. For best performances, it is recommended to leave the minimum value at `1024M`. + The flags `-Xms` and `-Xmx` define the minimum and maximum amount of RAM that the Minecraft server application can use. You may adjust these values to your needs. For best performance, it is recommended to leave the minimum value at `1024M`. 9. During the first run, the application creates a file `eula.txt`. Open the file in a text editor (for example `nano`) and change the value of `eula` from `false` to `true`: ``` From 041b173d215b3723ecc3d3b1166e1a08130e944b Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Wed, 11 Sep 2024 10:41:05 +0200 Subject: [PATCH 05/14] chore(gen): review --- tutorials/matomo-analytics/index.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/tutorials/matomo-analytics/index.mdx b/tutorials/matomo-analytics/index.mdx index 01770bda27..4b16c73384 100644 --- a/tutorials/matomo-analytics/index.mdx +++ b/tutorials/matomo-analytics/index.mdx @@ -9,13 +9,13 @@ categories: - instances tags: Matomo Ubuntu Focal-Fossa LEMP-Stack analytics dates: - validation: 2024-02-26 + validation: 2024-09-10 posted: 2019-07-24 hero: assets/scaleway-matomo.webp validation_frequency: 24 --- -**Matomo** (former: Piwik) is an open-source web analytics platform designed to evaluate the visitor's behavior for one or multiple websites. +[Matomo](https://matomo.org/) (former: Piwik) is an open-source web analytics platform designed to evaluate the visitor's behavior for one or multiple websites. The tool is written in PHP and stores its data in a MySQL/MariaDB database. @@ -35,7 +35,7 @@ Matomo relies on a web server, for example [Nginx](http://nginx.org/). A working ``` apt update && apt -y upgrade ``` -2. Install the required software via apt. +2. Install the required software via `apt`. ``` apt install -y ufw nginx mariadb-server php-fpm php-mysql php-curl php-gd php-cli php-xml php-mbstring software-properties-common ``` @@ -175,7 +175,7 @@ Matomo relies on a web server, for example [Nginx](http://nginx.org/). A working - **Website name**: Enter the name of the website - **Website URL**: Enter the website URL - **Website time zone**: Set the time zone for the website. This is important so Maotomo can track the visitors with the correct time of their visit - - **Ecommerce**: Enable specific tracking methods if the website is an ecommerce site + - **E-commerce**: Enable specific tracking methods if the website is an e-commerce site Click **Next** to validate the form and to continue with the installation. From ca5ded7503ad7e3cc96f8cb6e12df880521a3c0f Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Wed, 11 Sep 2024 11:44:15 +0200 Subject: [PATCH 06/14] chore(gen): review --- .../index.mdx | 48 +++++++++---------- 1 file changed, 22 insertions(+), 26 deletions(-) diff --git a/tutorials/wordpress-lemp-stack-ubuntu-jammy-jellyfish-22-04/index.mdx b/tutorials/wordpress-lemp-stack-ubuntu-jammy-jellyfish-22-04/index.mdx index 728754f021..e1ee66570c 100644 --- a/tutorials/wordpress-lemp-stack-ubuntu-jammy-jellyfish-22-04/index.mdx +++ b/tutorials/wordpress-lemp-stack-ubuntu-jammy-jellyfish-22-04/index.mdx @@ -9,11 +9,11 @@ tags: WordPress cms php LEMP nginx mysql mariadb categories: - instances dates: - validation: 2024-03-05 + validation: 2024-09-11 posted: 2023-02-24 --- -WordPress is a popular and freely accessible open-source tool that offers a seamless means to craft and manage content on your website. With its intuitive interface and user-friendly features, WordPress has garnered extensive adoption, making it an ideal solution for swiftly launching a website. The web frontend it provides ensures effortless administration, simplifying the process even for those lacking technical expertise. +[WordPress](https://wordpress.com/) is a popular and freely accessible open-source tool that offers a seamless means to craft and manage content on your website. With its intuitive interface and user-friendly features, WordPress has garnered extensive adoption, making it an ideal solution for swiftly launching a website. The web front-end it provides ensures effortless administration, simplifying the process even for those lacking technical expertise. If you are seeking to install WordPress on a newly established Ubuntu 22.04 LTS Instance, this tutorial is tailor-made for your needs. We will meticulously walk you through the installation steps, employing the LEMP stack (Linux + Nginx - pronounced "engine x" + MySQL + PHP). For the sake of this tutorial, we are choosing Nginx, a robust HTTP server that is efficient in resource usage, resulting in faster page delivery, especially for static content. By opting for a Cost-Optimized Instance configured with LEMP, you will gain access to a robust web server that elevates website performance, thus ensuring a seamless WordPress installation experience. @@ -33,7 +33,7 @@ If you are seeking to install WordPress on a newly established Ubuntu 22.04 LTS ## Installing WordPress -We presume that you have already [installed LEMP stack](/tutorials/installation-lemp-ubuntu-bionic/). Let us proceed with the installation of WordPress on your Ubuntu Jammy Instance. +We assume that you have already [installed LEMP stack](/tutorials/installation-lemp-ubuntu-bionic/). Let us proceed with the installation of WordPress on your Ubuntu Jammy Instance. WordPress is equipped to serve dynamic content and manage user authentication and authorization with ease. However, to ensure a secure connection to your site, the implementation of Transport Layer Security/Secure Sockets Layer (TLS/SSL) technology is essential. By encrypting your traffic, TLS/SSL guarantees a secure connection to your site. To configure SSL with Let's Encrypt and complete the last stage of the tutorial, follow the link: [Configuring SSL with Let's Encrypt](/tutorials/installation-lemp-ubuntu-focal/#configuring-ssl-with-lets-encrypt). @@ -41,7 +41,7 @@ We presume that you have already [installed LEMP stack](/tutorials/installation- ### Configuring Nginx -To prepare for the upcoming WordPress installation, it is essential to configure Nginx to handle traffic. In the [LEMP tutorial](/tutorials/installation-lemp-ubuntu-focal/), we previously set up a server block for `example.com`, which served as the default Nginx page for our domain. Now, we will create a new server block called wordpress that will serve our WordPress site from the subdomain `blog.example.com`. +To prepare for the upcoming WordPress installation, it is essential to configure Nginx to handle traffic. In the [LEMP tutorial](/tutorials/installation-lemp-ubuntu-focal/), we previously set up a server block for `example.com`, which served as the default Nginx page for our domain. Now, we will create a new server block called `wordpress` that will serve our WordPress site from the subdomain `blog.example.com`. 1. Create a new server block for Nginx: ``` @@ -115,7 +115,7 @@ To prepare for the upcoming WordPress installation, it is essential to configure nginx -t ``` - which returns + An output similar to the following displays. ``` nginx: the configuration file /etc/nginx/nginx.conf syntax is ok @@ -129,24 +129,20 @@ To prepare for the upcoming WordPress installation, it is essential to configure ``` rm /etc/nginx/sites-enabled/default ``` - - Steps 6 and 7 optimize your Nginx configuration for WordPress: 6. Open the Nginx configuration file: ``` nano /etc/nginx/nginx.conf ``` -7. Edit the following to optimize: - - Ensure the number of worker processes is equal to the number of cores in your Instance. - +7. Edit the following elements: + - Update the number of worker processes to match the number of cores in your Instance to optimize your Nginx configuration. ``` user www-data; worker_processes 1; pid /run/nginx.pid; ``` - - Add `use epoll` to the events block + - Add `use epoll;` to the events block. ``` events { @@ -156,7 +152,7 @@ To prepare for the upcoming WordPress installation, it is essential to configure } ``` - - Add `client_max_body_size` and `server_tokens` off directive. Set `keepalive_timeout` to 30 seconds. + - Add the `client_max_body_size 100m;` and `server_tokens off;` directives, then set `keepalive_timeout` to 30 seconds as shown below. ``` # Basic Settings @@ -176,7 +172,7 @@ To prepare for the upcoming WordPress installation, it is essential to configure default_type application/octet-stream; ``` - - Make sure that the whole Gzip settings block is similar to + - Make sure that the whole Gzip settings block is similar to the following. ``` # Gzip Settings @@ -198,14 +194,14 @@ To prepare for the upcoming WordPress installation, it is essential to configure ## Configuring PHP -To enable the upload of files larger than 2 MB to your WordPress website, you will need to adjust the PHP upload size variables located in the php.ini file. +To enable the upload of files larger than 2 MB to your WordPress website, you must adjust the PHP upload size variables located in the php.ini file. 1. Open the `php.ini` file: ``` nano /etc/php/7.4/fpm/php.ini ``` -2. Press `Ctrl+W` and search for `upload_max_filesize` and set it to 100M. -3. Restart PHP. +2. Press `Ctrl+W` and search for `upload_max_filesize` and set it to `100M`. +3. Restart PHP: ``` sudo service php7.4-fpm restart ``` @@ -214,25 +210,25 @@ To enable the upload of files larger than 2 MB to your WordPress website, you wi In this section, we will create the database user and tables. -1. Log into the MySQL shell using your MySQL root password +1. Log into the MySQL shell using your MySQL root password: ``` mysql -u root -p ``` -2. Create a WordPress database, along with a user in the database. First, let's make the database (feel free to give it whatever name you like): +2. Create a WordPress database and name it as desired: ``` MariaDB [(none)]> CREATE DATABASE wordpress; ``` - The output displays: + The following output displays: ``` Query OK, 1 row affected (0.00 sec) ``` -3. Create a new user. Replace the database, name, and password with whatever you prefer: +3. Create a new user and name it as desired: ``` CREATE USER wordpressuser@localhost; ``` - The output displays: + The following output displays: ``` Query OK, 0 rows affected (0.00 sec) @@ -242,7 +238,7 @@ In this section, we will create the database user and tables. SET PASSWORD FOR wordpressuser@localhost= PASSWORD("password"); ``` - The output displays: + The following output displays: ``` Query OK, 0 rows affected (0.00 sec) @@ -252,7 +248,7 @@ In this section, we will create the database user and tables. GRANT ALL PRIVILEGES ON wordpress.* TO wordpressuser@localhost IDENTIFIED BY 'password'; ``` - The output displays: + The following output displays: ``` Query OK, 0 rows affected (0.00 sec) @@ -262,7 +258,7 @@ In this section, we will create the database user and tables. FLUSH PRIVILEGES; ``` - The output displays: + The following output displays: ``` Query OK, 0 rows affected (0.00 sec) @@ -286,7 +282,7 @@ In this section, we will create the database user and tables. ``` tar -xzvf latest.tar.gz ``` -4. Grant the www-data user permissions to /var/www/wordpress to enable automatic updates of WordPress plugins and file editing with SFTP in the future. +4. Grant the `www-data` user permissions to `/var/www/wordpress` to enable automatic updates of WordPress plugins and file editing with SFTP in the future. ``` chown -R www-data:www-data wordpress/ usermod -a -G www-data www-data From 7cdde3f4444f6c004d1a4833bcdd6e4d03aba712 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Wed, 11 Sep 2024 11:50:37 +0200 Subject: [PATCH 07/14] chore(gen): review --- tutorials/load-testing-vegeta/index.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/tutorials/load-testing-vegeta/index.mdx b/tutorials/load-testing-vegeta/index.mdx index 567a02be07..d2a7e7d793 100644 --- a/tutorials/load-testing-vegeta/index.mdx +++ b/tutorials/load-testing-vegeta/index.mdx @@ -9,7 +9,7 @@ tags: Vegeta Ubuntu categories: - instances dates: - validation: 2024-03-05 + validation: 2024-09-11 posted: 2019-05-20 --- @@ -40,7 +40,7 @@ Before transitioning an application to a production environment, load testing he ## Downloading and installing Vegeta on Ubuntu Linux 1. [Connect to your Instance](/compute/instances/how-to/connect-to-instance/) via SSH. -2. [Download](https://github.com/tsenart/vegeta/releases) the latest binary version to install Vegata on your Ubuntu Linux machine: +2. [Download](https://github.com/tsenart/vegeta/releases) the latest binary version to install Vegeta on your Ubuntu Linux machine: ``` wget https://github.com/tsenart/vegeta/releases/download/v12.11.0/vegeta_12.11.0_linux_amd64.tar.gz ``` @@ -48,7 +48,7 @@ Before transitioning an application to a production environment, load testing he ``` tar xfz vegeta-12.11.0-linux-amd64.tar.gz ``` -4. Move the binary file into `/usr/bin` to make it available system-wide. This step actually installs the Vegata application on your Ubuntu system: +4. Move the binary file into `/usr/bin` to make it available system-wide. This step actually installs the Vegeta application on your Ubuntu system: ``` mv vegeta /usr/bin/vegeta ``` @@ -146,7 +146,7 @@ Vegeta also supports multiple targets to attack an application with multiple end ## Generating a report -Every load test executed to collect data that can be saved in an output file using the -output parameter. +Every load test executed to collect data can be saved in an output file using the `-output` parameter. The data collected during each load test is stored in an output file. From d8772cfcc3ce1c5b1a26c2cca96cbf05d4942d40 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Wed, 11 Sep 2024 11:58:30 +0200 Subject: [PATCH 08/14] chore(gen): review --- tutorials/bash-christmas-tree/index.mdx | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/tutorials/bash-christmas-tree/index.mdx b/tutorials/bash-christmas-tree/index.mdx index 6c1c15757d..0db162eb94 100644 --- a/tutorials/bash-christmas-tree/index.mdx +++ b/tutorials/bash-christmas-tree/index.mdx @@ -1,15 +1,15 @@ --- meta: - title: Using Bash to display a christmas tree - description: This page shows you how to write bash code for a christmas tree and to display it in a shell of your Instance + title: Using Bash to display a Christmas tree + description: This page shows you how to write bash code for a Christmas tree and to display it in a shell of your Instance content: - h1: Using Bash to display a christmas tree - paragraph: This page shows you how to write bash code for a christmas tree and to display it in a shell of your Instance + h1: Using Bash to display a Christmas tree + paragraph: This page shows you how to write bash code for a Christmas tree and to display it in a shell of your Instance tags: bash christmas-tree categories: - instances dates: - validation: 2024-03-05 + validation: 2024-09-11 posted: 2019-11-26 --- @@ -79,7 +79,7 @@ ssh root@ # Write a greeting tput setaf 93; tput bold - tput cup $lin $((c - 15)); echo SCALEWAY wishes you Merry christmas + tput cup $lin $((c - 15)); echo SCALEWAY wishes you Merry Christmas tput cup $((lin + 1)) $((c - 11)); echo And a Happy New Year 2024 let c++ k=1 From 89ff6f8519249f4b28f7d0b31a8841aee306ce1b Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Wed, 11 Sep 2024 14:39:24 +0200 Subject: [PATCH 09/14] chore(gen): review --- tutorials/create-models-django/index.mdx | 47 +++++++++++++----------- 1 file changed, 25 insertions(+), 22 deletions(-) diff --git a/tutorials/create-models-django/index.mdx b/tutorials/create-models-django/index.mdx index 3ed391d069..2a9a18dda6 100644 --- a/tutorials/create-models-django/index.mdx +++ b/tutorials/create-models-django/index.mdx @@ -10,11 +10,11 @@ categories: tags: Django-application API hero: assets/scaleway_django_models.webp dates: - validation: 2024-03-05 + validation: 2024-09-11 posted: 2018-11-02 --- -Django is a web development framework for developing dynamic websites and applications. Django allows the use of less code and eases the creation of complex websites. It provides a very good structure and easy methods that help to do the heavy lifting when writing web applications. +[Django](https://www.djangoproject.com/) is a web development framework for developing dynamic websites and applications. Django allows the use of less code and eases the creation of complex websites. It provides a very good structure and easy methods that help to do the heavy lifting when writing web applications. To follow this tutorial, we assume that you completed the [first tutorial on Django installation and configuration](/tutorials/django-ubuntu-focal-fossa/). @@ -35,14 +35,14 @@ To follow this tutorial, we assume that you completed the [first tutorial on Dja Now that your environment (`my-django`) is set up, we can create a new application. The difference between an application and a project is that an app is a Web application that does something. A project is a collection of configurations and apps for a particular website. A project can contain multiple apps. An app can be in multiple projects. -1. To create your app, make sure you are in the same directory as `manage.py` and type +1. To create your app, access the directory containing your `manage.py` file using a terminal, then run the following command: ``` python manage.py startapp polls ``` We create two models: Question and Choice. A Question has a question and a publication date. A Choice has two fields: the text of the choice and a vote tally. Each Choice is associated with a Question. -2. Edit the `polls/models.py` file so it looks like this +2. Edit the `polls/models.py` file so it looks like the following: ```python from django.db import models @@ -60,11 +60,11 @@ Now that your environment (`my-django`) is set up, we can create a new applicati choice_text = models.CharField(max_length=200) votes = models.IntegerField(default=0) ``` -3. To activate the app, edit the `myDjangoProject/settings.py` file again +3. To activate the app, edit the `myDjangoProject/settings.py` file again: ```python nano myDjangoProject/settings.py ``` -4. Change the `INSTALLED_APPS` setting to include the string `polls` +4. Change the `INSTALLED_APPS` setting to include the string `polls`: ``` # application definition INSTALLED_APPS = [ @@ -77,12 +77,12 @@ Now that your environment (`my-django`) is set up, we can create a new applicati 'polls', ] ``` -5. Run `makemigrations` to indicate Django that you've made some changes to your models +5. Run `makemigrations` to indicate Django that you've made some changes to your models: ``` python manage.py make migrations polls ``` - which returns + The following output displays: ``` Migrations for 'polls': @@ -93,14 +93,14 @@ Now that your environment (`my-django`) is set up, we can create a new applicati ``` - You can read the migration for your new model if you like; it is the file `polls/migrations/0001_initial.py` + You can read the migration for your new model by opening the `polls/migrations/0001_initial.py` file. -6. Run the migrations with the `migrate` command to manage your database schema automatically +6. Run the migrations with the `migrate` command to manage your database schema automatically: ``` python manage.py migrate ``` - which returns + The following output displays: ``` Operations to perform: @@ -113,11 +113,11 @@ Now that your environment (`my-django`) is set up, we can create a new applicati ## Playing with the API -1. Invoke the Python shell +1. Invoke the Python shell: ``` python manage.py shell ``` -2. Paste the following content to the shell +2. Paste the following content to the shell: ``` >>> from polls.models import Question, Choice # Import the model classes we just wrote. @@ -155,17 +155,20 @@ Now that your environment (`my-django`) is set up, we can create a new applicati ]> ``` - Exit the Python shell by pressing Control+D. +4. Press `Control+D` to exit the Python shell. + 3. Edit the `polls/models.py` to add a `__str__()` method to both Question and Choice. - The **str**() method is called whenever you call str() on an object. In Python 3, Django uses str(obj) in a number of places. Most notably, to display an object in the Django admin site and as the value inserted into a template when it displays an object. + The `str()` method is called whenever you call `str()` on an object. In Python 3, Django uses `str(obj)` in a number of places. Most notably, to display an object in the Django admin site and as the value inserted into a template when it displays an object. + - Open the polls model file: + ``` nano polls/models.py ``` - and paste + - Then, copy and paste the following: ```python from django.db import models @@ -190,12 +193,12 @@ Now that your environment (`my-django`) is set up, we can create a new applicati def __str__(self): return self.choice_text ``` -4. Save these changes and start a new Python interactive shell by running python `manage.py` shell again +4. Save these changes and start a new Python interactive shell by running the following commnand: ``` python manage.py shell ``` - and paste the following to make sure our `__str__()` addition worked. + Then, paste the following to make sure our `__str__()` addition worked. ``` >>> from polls.models import Question, Choice @@ -229,9 +232,9 @@ Now that your environment (`my-django`) is set up, we can create a new applicati ``` -## Rendering the application visible in the Console +## Making the application visible in the Console -1. When you are logged in, the `poll` app is not displayed on the admin console. To make it appear, edit the `polls/admin.py` to match the following: +1. When you are logged in, the `poll` app is not displayed on the admin console. To make it appear, edit the `polls/admin.py` file to match the following: ``` from django.contrib import admin from .models import Question @@ -246,7 +249,7 @@ Now that your environment (`my-django`) is set up, we can create a new applicati - If you click `Question`, it displays the list of questions we added to the configuration file. + If you click `Question`, the list of questions added to the configuration file displays. @@ -258,7 +261,7 @@ Now that your environment (`my-django`) is set up, we can create a new applicati Now that we have the questions on the admin page, we need to configure the multiple-choice responses. -1. Edit the `polls/admin.py` to add the following +1. Edit the `polls/admin.py` file to add the following: ``` from django.contrib import admin From 0943c2d534081557e67e88c5f8dad498aa86e81d Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Wed, 11 Sep 2024 15:45:06 +0200 Subject: [PATCH 10/14] chore(gen): review --- tutorials/nvidia-triton/index.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/tutorials/nvidia-triton/index.mdx b/tutorials/nvidia-triton/index.mdx index d071d9510c..cadc7e9432 100644 --- a/tutorials/nvidia-triton/index.mdx +++ b/tutorials/nvidia-triton/index.mdx @@ -11,11 +11,11 @@ categories: - object-storage tags: gpu nvidia triton object-storage dates: - validation: 2024-02-26 + validation: 2024-09-11 posted: 2023-08-23 --- -In this tutorial, we will walk you through the process of deploying machine learning models using NVIDIA Triton Inference Server on Scaleway Object Storage. +In this tutorial, we will walk you through the process of deploying machine learning models using [NVIDIA Triton Inference Server](https://developer.nvidia.com/triton-inference-server) on Scaleway Object Storage. We will cover how to set up Triton Inference Server, store your model in an Object Storage bucket, and enable metric export for monitoring. @@ -120,7 +120,7 @@ Your metrics are now pushed to Cockpit and you can [access Grafana](/observabili ## Conclusion -You have successfully deployed a machine learning model using NVIDIA Triton Inference Server on Scaleway Object Storage and set up metrics monitoring using the monitoring Cockpit. +You have successfully deployed a machine learning model using NVIDIA Triton Inference Server on Scaleway Object Storage and set up metrics monitoring using Cockpit. This tutorial highlights how Scaleway's Object Storage and AI capabilities can be combined to build and deploy powerful AI applications. Remember that this tutorial provides just a basic overview. Refer to the official [Triton Inference Server](https://docs.nvidia.com/deeplearning/triton-inference-server/user-guide/docs/index.html) documentation for more advanced configurations, security settings, and additional features to configure the application to your specific needs. \ No newline at end of file From b31ad43a6a4f3585e3fe99b71887c8db3a3306fc Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Wed, 11 Sep 2024 15:55:36 +0200 Subject: [PATCH 11/14] chore(gen): review --- tutorials/sentry-error-tracking/index.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/tutorials/sentry-error-tracking/index.mdx b/tutorials/sentry-error-tracking/index.mdx index 7c46b65928..807c1e1552 100644 --- a/tutorials/sentry-error-tracking/index.mdx +++ b/tutorials/sentry-error-tracking/index.mdx @@ -10,7 +10,7 @@ categories: - instances hero: assets/scaleway-sentry-hero.webp dates: - validation: 2024-02-26 + validation: 2024-09-11 posted: 2018-06-07 --- @@ -18,7 +18,7 @@ dates: In the rapidly evolving landscape of today's world, applications serve as the backbone of numerous industries. Whether it is engineers, support technicians, or product managers, maintaining vigilance over an application's performance is essential for ensuring uninterrupted functionality. -This is precisely where Sentry steps in. As a robust open-source solution, Sentry is purpose-built for monitoring and tracking errors within applications, enabling timely identification of issues before they escalate. +This is precisely where [Sentry](https://sentry.io/welcome/) steps in. As a robust open-source solution, Sentry is purpose-built for monitoring and tracking errors within applications, enabling timely identification of issues before they escalate. Crafted using Python, Sentry employs a client/server architecture that facilitates real-time error reporting. Through its SDK, seamlessly integrating Sentry into your applications becomes a straightforward task. Moreover, you can configure it to automatically report errors through widely-used messaging platforms such as Slack and IRC. From b4f6d64da1c07657166a28133afd19e350699342 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Wed, 11 Sep 2024 17:02:55 +0200 Subject: [PATCH 12/14] chore(gen): review --- .../rtmp-self-hosted-streaming/index.mdx | 24 ++++++++++--------- 1 file changed, 13 insertions(+), 11 deletions(-) diff --git a/tutorials/rtmp-self-hosted-streaming/index.mdx b/tutorials/rtmp-self-hosted-streaming/index.mdx index 661a1fc117..163444d0bd 100644 --- a/tutorials/rtmp-self-hosted-streaming/index.mdx +++ b/tutorials/rtmp-self-hosted-streaming/index.mdx @@ -10,7 +10,7 @@ categories: hero: assets/scaleway_rtmp.webp tags: streaming RTMP broadcast OBS-Client Multistreaming dates: - validation: 2024-02-26 + validation: 2024-09-11 posted: 2019-05-20 --- @@ -19,7 +19,7 @@ The Internet's fascination with live video streaming continues to soar, with pla However, while these platforms offer basic free options, users often encounter interruptions in the form of advertisements unless they opt for a paid subscription. For individuals craving absolute control over their content, open-source solutions offer a compelling alternative. By configuring a personal live-streaming server, users can gain complete autonomy over their broadcasts. -Using the open-source RTMP protocol on self-hosted streaming servers, users gain autonomy to manage their content free from external constraints and interruptions. +Using the open-source [RTMP protocol](https://en.wikipedia.org/wiki/Real-Time_Messaging_Protocol) on self-hosted streaming servers, users gain autonomy to manage their content free from external constraints and interruptions. We recommend you follow this tutorial using a [Production-Optimized Instance](/compute/instances/reference-content/choosing-instance-type/). @@ -76,13 +76,11 @@ Using the open-source RTMP protocol on self-hosted streaming servers, users gain mkdir -p /var/www/html/recordings chown -R www-data:www-data /var/www/html/recordings/ ``` -6. Open the file `/etc/nginx/sites-enabled/default` in a text editor and add a `location` block to the server configuration: +6. Open the file `/etc/nginx/sites-enabled/default` in a text editor: ``` nano /etc/nginx/sites-enabled/default ``` - - `libnginx-mod-rtmp` does not support authentication by default. To avoid your media being broadcasted by someone with access to the stream key, copy and paste the following content into the server configuration block, under the `server_name` block, to set up a basic authentication mechanism. It will ask for a password when streaming. If the password is not correct, the user will see a `401 - Unauthorized` message: - +7. Add a `location` block to the server configuration under the `server_name` block, and replace `a_secret_password` with a password of your choice, which authenticates against the server for broadcasting streams: ``` location /auth { if ($arg_pwd = 'a_secret_password') { @@ -91,9 +89,11 @@ Using the open-source RTMP protocol on self-hosted streaming servers, users gain return 401; } ``` + + `libnginx-mod-rtmp` does not support authentication by default. To avoid your media being broadcasted by someone with access to the stream key, adding the location block sets up a basic authentication mechanism. It will ask for a password when streaming. If the password is not correct, the user will see a `401 - Unauthorized` message. + - Replace `a_secret_password` with a secret password of your choice which authenticates against the server for broadcasting streams. -7. Restart the Nginx web server: +8. Restart the Nginx web server: ``` systemctl restart nginx.service ``` @@ -121,7 +121,7 @@ To broadcast a stream from a local computer to the streaming server, a broadcast The stream can be viewed in your favorite media player, for example [VLC media player](https://www.videolan.org/vlc/). -1. Start VLC and click **Open Media** +1. Start VLC and click **Open Media**. 2. Click the **Network** tab and enter the URL of your Stream: - URL: `rtmp:///live/` @@ -184,11 +184,13 @@ It is also possible to rebroadcast a stream to platforms like YouTube, Facebook, } } ``` + + You can add additional applications in the same way as the examples above. + - It is possible to add additional applications in the same way as the examples above. 3. Restart Nginx to activate the new configuration: ``` systemctl restart nginx.service ``` -4. Start broadcasting from OBS. You can now either view your stream via a media player like VLC, but also from broadcasting platforms like Twitch: +4. Start broadcasting from OBS. You can now either view your stream via a media player like VLC, and also from broadcasting platforms like Twitch: \ No newline at end of file From 4c44b48bbe4121d756098ef44c5361c75161c354 Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Wed, 11 Sep 2024 17:21:38 +0200 Subject: [PATCH 13/14] chore(gen): review --- tutorials/deploy-remote-desktop-ubuntu-2204/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tutorials/deploy-remote-desktop-ubuntu-2204/index.mdx b/tutorials/deploy-remote-desktop-ubuntu-2204/index.mdx index 8736e1b3e4..f4cb108daa 100644 --- a/tutorials/deploy-remote-desktop-ubuntu-2204/index.mdx +++ b/tutorials/deploy-remote-desktop-ubuntu-2204/index.mdx @@ -9,7 +9,7 @@ categories: - instances tags: remote-desktop xRDP rdp xFCE jammy-jellyfish dates: - validation: 2024-02-26 + validation: 2024-09-11 posted: 2022-05-06 --- From 96b6ec7771d6861ed8280f7747489489d77aed11 Mon Sep 17 00:00:00 2001 From: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> Date: Mon, 16 Sep 2024 13:26:02 +0200 Subject: [PATCH 14/14] fix(gen): reviews Co-authored-by: Jessica <113192637+jcirinosclwy@users.noreply.github.com> --- tutorials/create-models-django/index.mdx | 4 ++-- .../index.mdx | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/tutorials/create-models-django/index.mdx b/tutorials/create-models-django/index.mdx index 2a9a18dda6..26104e0260 100644 --- a/tutorials/create-models-django/index.mdx +++ b/tutorials/create-models-django/index.mdx @@ -77,7 +77,7 @@ Now that your environment (`my-django`) is set up, we can create a new applicati 'polls', ] ``` -5. Run `makemigrations` to indicate Django that you've made some changes to your models: +5. Run `makemigrations` to indicate Django that you have made some changes to your models: ``` python manage.py make migrations polls ``` @@ -232,7 +232,7 @@ Now that your environment (`my-django`) is set up, we can create a new applicati ``` -## Making the application visible in the Console +## Making the application visible in the console 1. When you are logged in, the `poll` app is not displayed on the admin console. To make it appear, edit the `polls/admin.py` file to match the following: ``` diff --git a/tutorials/wordpress-lemp-stack-ubuntu-jammy-jellyfish-22-04/index.mdx b/tutorials/wordpress-lemp-stack-ubuntu-jammy-jellyfish-22-04/index.mdx index e1ee66570c..ec08476455 100644 --- a/tutorials/wordpress-lemp-stack-ubuntu-jammy-jellyfish-22-04/index.mdx +++ b/tutorials/wordpress-lemp-stack-ubuntu-jammy-jellyfish-22-04/index.mdx @@ -41,7 +41,7 @@ We assume that you have already [installed LEMP stack](/tutorials/installation-l ### Configuring Nginx -To prepare for the upcoming WordPress installation, it is essential to configure Nginx to handle traffic. In the [LEMP tutorial](/tutorials/installation-lemp-ubuntu-focal/), we previously set up a server block for `example.com`, which served as the default Nginx page for our domain. Now, we will create a new server block called `wordpress` that will serve our WordPress site from the subdomain `blog.example.com`. +To prepare for the upcoming WordPress installation, it is essential to configure Nginx to handle traffic. In the [LEMP tutorial](/tutorials/installation-lemp-ubuntu-focal/), we previously set up a server block for `example.com`, which served as the default Nginx page for our domain. Now, we will create a new server block called `wordpress` that will serve our WordPress site from the subdomain `blog.example.com`. 1. Create a new server block for Nginx: ```