Document build resources

Author: AnouckColson

sites/friday/src/manage-resources/adjust-resources.md

@@ -1,7 +1,7 @@
 ---
 title: Resource configuration
 description: Configure CPU, RAM, and disk storage on a per-environment basis so your apps and services can run smoothly.
-weight: -100
+weight: -200
 keywords:
   - "resources"
   - "flexible resources"

sites/friday/src/manage-resources/build-resources.md

@@ -0,0 +1,26 @@
+---
+title: Build resources
+description: Find out how build resources work on {{% vendor/name %}}.
+weight: -50
+---
+
+When you push changes to your app through Git, your app is built then deployed.
+
+During the build phase, {{% vendor/name %}} collects your entire app configuration and creates a build image into a dedicated build container.
+The duration of the build phase is directly linked to the amount of resources (CPU and RAM) allocated to that build container.
+
+As a user, you get the following fixed amount of resources **per project for free**:
+
+- 2.5 CPU hours
+- 5 RAM hours
+
+If you consume more CPU or RAM, you get charged for them by the hour.
+For more information on the costs incurred, see the [{{% vendor/name %}} pricing page](https://upsun.com/pricing/).
+
+You can set a maximum threshold for build resources through the {{% vendor/name %}} API to mitigate potential overuse.
+To do so, run commands similar to the following:
+
+```bash {location="Terminal"}
+{{% vendor/cli %}} project:curl capabilities -X PATCH -d '{"build_resources": {"enabled": true}}'
+{{% vendor/cli %}} project:curl settings -X PATCH -d '{"build_resources": {"cpu": 4.0, "memory": 2048}}'
+```

sites/friday/src/manage-resources/resource-billing.md

@@ -1,7 +1,7 @@
 ---
 title: Resource billing
 description: Keep an eye on costs related to resource usage.
-weight: -50
+weight: -100
 keywords:
   - "resources"
   - "flexible resources"

sites/friday/src/manage-resources/resource-init.md

@@ -1,7 +1,7 @@
 ---
 title: Resource initialization
 description: Learn how resources are allocated by default upon first deployment, and how you can define a resource initialization strategy that better fits your needs.
-weight: -200
+weight: -300
 keywords:
   - "resources"
   - "flexible resources"

sites/platform/src/create-apps/build-resources.md

@@ -0,0 +1,28 @@
+---
+title: Build resources
+description: Find out how build resources work on {{% vendor/name %}}.
+weight: 14
+---
+
+When you push changes to your app through Git, your app is built then deployed.
+
+During the build phase, {{% vendor/name %}} collects your entire app configuration and creates a build image into a dedicated build container.
+The duration of the build phase is directly linked to the amount of resources (CPU and RAM) allocated to that build container.
+
+To manage those build resources, add the following configuration:
+
+```yaml {configFile="apps"}
+"build_resources": {
+   "enabled": false, #Build resources can only be effectively adjusted once this key is set to true.
+   "max_cpu": 4.0, #The maximum amount of allowed CPU (minimum is a hardcoded 0.1)
+   "max_memory": 10240 #The maximum amount of allowed RAM (minimum is a hardcoded 64)
+}
+```
+
+You can then adjust build resources at any time through the {{% vendor/name %}} API.
+To do so, run commands similar to the following:
+
+```bash {location="Terminal"}
+{{% vendor/cli %}} project:curl capabilities -X PATCH -d '{"build_resources": {"enabled": true}}' 
+{{% vendor/cli %}} project:curl settings -X PATCH -d '{"build_resources": {"cpu": 4.0, "memory": 2048}}'
+```

sites/platform/src/create-apps/hooks/_index.md

@@ -2,6 +2,7 @@
 title: Use build and deploy hooks
 description: Add custom scripts at different stages in the build and deploy process.
 layout: single
+weight: 13
 ---
 
 As your app goes through the [build and deploy process](/learn/overview/build-deploy.md),

sites/platform/src/create-apps/multi-app/_index.md

@@ -6,6 +6,7 @@ banner:
    title: Feature availability
    type: tiered-feature
    body: This page applies to Grid and {{% names/dedicated-gen-3 %}} projects. To ensure you have enough resources to support multiple apps, you need at least a [{{< partial "plans/multiapp-plan-name" >}} plan](/administration/pricing/_index.md#multiple-apps-in-a-single-project). To set up multiple apps on {{% names/dedicated-gen-2 %}} environments, [contact Sales](https://platform.sh/contact/).
+weight: 8
 ---
 
 {{% multi-app-intro %}}

sites/platform/src/create-apps/timezone.md

@@ -1,6 +1,7 @@
 ---
 title: "Timezones"
 description: Learn more about the different timezones on {{% vendor/name %}} and when you can customize them.
+weight: 9
 ---
 
 On {{% vendor/name %}}, there are several timezones you might want to keep in mind.

sites/platform/src/create-apps/troubleshoot-disks.md

@@ -1,5 +1,6 @@
 ---
 title: "Troubleshoot disks"
+weight: 10
 ---
 
 {{% troubleshoot %}}

sites/platform/src/create-apps/troubleshoot-mounts.md

@@ -1,5 +1,6 @@
 ---
 title: "Troubleshoot mounts"
+weight: 11
 ---
 
 {{% troubleshoot %}}

sites/platform/src/create-apps/upgrading.md

@@ -1,5 +1,6 @@
 ---
 title: "Upgrading"
+weight: 12
 ---
 
 ## Changes in version 2022.02

sites/platform/src/create-apps/web/_index.md

@@ -1,5 +1,6 @@
 ---
 title: Configure what's served
+weight: 7
 ---
 
 How you should configure your web server depends a lot on what you want to serve.

sites/platform/src/create-apps/workers.md

@@ -1,6 +1,7 @@
 ---
 title: "Work with workers"
 description: Interact with your worker instances to handle background tasks for your apps.
+weight: 15
 ---
 
 Workers are instances of your code that aren't open to connections from other apps or services or the outside world.