[Docs] Updated the AWS example under Clusters

peterschmidt85 · peterschmidt85 · commit 7fe929df2508 · 2025-12-16T12:19:48.000+01:00
diff --git a/docs/blog/posts/changelog-07-25.md b/docs/blog/posts/changelog-07-25.md
@@ -144,7 +144,7 @@ resources:
 
 #### AWS EFA
 
-EFA is a network interface for EC2 that enables low-latency, high-bandwidth communication between nodes—crucial for scaling distributed deep learning. With `dstack`, EFA is automatically enabled when using supported instance types in fleets. Check out our [example](../../examples/clusters/efa/index.md)
+EFA is a network interface for EC2 that enables low-latency, high-bandwidth communication between nodes—crucial for scaling distributed deep learning. With `dstack`, EFA is automatically enabled when using supported instance types in fleets. Check out our [example](../../examples/clusters/aws/index.md)
 
 #### Default Docker images
 
diff --git a/docs/docs/concepts/fleets.md b/docs/docs/concepts/fleets.md
@@ -107,7 +107,7 @@ This ensures all instances are provisioned with optimal inter-node connectivity.
     Note, EFA requires the `public_ips` to be set to `false` in the `aws` backend configuration.
     Otherwise, instances are only connected by the default VPC subnet.
 
-    Refer to the [EFA](../../examples/clusters/efa/index.md) example for more details.
+    Refer to the [AWS](../../examples/clusters/aws/index.md) example for more details.
 
 ??? info "GCP"
     When you create a fleet with GCP, `dstack` automatically configures [GPUDirect-TCPXO and GPUDirect-TCPX](https://cloud.google.com/kubernetes-engine/docs/how-to/gpu-bandwidth-gpudirect-tcpx-autopilot) networking for the A3 Mega and A3 High instance types, as well as RoCE networking for the A4 instance type.
diff --git a/docs/docs/guides/clusters.md b/docs/docs/guides/clusters.md
@@ -22,7 +22,7 @@ For cloud fleets, fast interconnect is currently supported only on the `aws`, `g
     
     !!! info "Backend configuration"    
         Note, EFA requires the `public_ips` to be set to `false` in the `aws` backend configuration.
-        Refer to the [EFA](../../examples/clusters/efa/index.md) example for more details.
+        Refer to the [AWS](../../examples/clusters/aws/index.md) example for more details.
 
 === "GCP"
     When you create a cloud fleet with GCP, `dstack` automatically configures [GPUDirect-TCPXO and GPUDirect-TCPX](https://cloud.google.com/kubernetes-engine/docs/how-to/gpu-bandwidth-gpudirect-tcpx-autopilot) networking for the A3 Mega and A3 High instance types, as well as RoCE networking for the A4 instance type.
diff --git a/docs/examples.md b/docs/examples.md
@@ -113,7 +113,7 @@ hide:
     <a href="/examples/clusters/efa"
        class="feature-cell sky">
         <h3>
-            AWS EFA
+            AWS
         </h3>
 
         <p>
diff --git a/docs/examples/clusters/aws/index.md b/docs/examples/clusters/aws/index.md
diff --git a/examples/clusters/aws/README.md b/examples/clusters/aws/README.md
@@ -1,4 +1,4 @@
-# AWS EFA
+# AWS
 
 In this guide, we’ll walk through how to run high-performance distributed training on AWS using [Amazon Elastic Fabric Adapter (EFA)](https://aws.amazon.com/hpc/efa/) with `dstack`.
 
@@ -37,11 +37,11 @@ projects:
 
 Once your backend is ready, define a fleet configuration.
 
-<div editor-title="examples/clusters/efa/fleet.dstack.yml">
+<div editor-title="examples/clusters/aws/efa-fleet.dstack.yml">
     
     ```yaml
     type: fleet
-    name: my-efa-fleet
+    name: efa-fleet
     
     nodes: 2
     placement: cluster
@@ -57,14 +57,14 @@ Provision the fleet with `dstack apply`:
 <div class="termy">
 
 ```shell
-$ dstack apply -f examples/clusters/efa/fleet.dstack.yml
+$ dstack apply -f examples/clusters/aws/efa-fleet.dstack.yml
 
 Provisioning...
 ---> 100%
 
- FLEET         INSTANCE  BACKEND          INSTANCE TYPE  GPU          PRICE   STATUS  CREATED 
- my-efa-fleet  0         aws (us-west-2)  p4d.24xlarge   H100:8:80GB  $98.32  idle    3 mins ago      
-               1         aws (us-west-2)  p4d.24xlarge   H100:8:80GB  $98.32  idle    3 mins ago    
+ FLEET      INSTANCE  BACKEND          INSTANCE TYPE  GPU          PRICE   STATUS  CREATED 
+ efa-fleet  0         aws (us-west-2)  p4d.24xlarge   H100:8:80GB  $98.32  idle    3 mins ago      
+            1         aws (us-west-2)  p4d.24xlarge   H100:8:80GB  $98.32  idle    3 mins ago    
 ```
 
 </div>
@@ -76,7 +76,7 @@ Provisioning...
 
     ```yaml
     type: fleet
-    name: my-efa-fleet
+    name: efa-fleet
     
     nodes: 2
     placement: cluster
diff --git a/examples/clusters/aws/fleet.dstack.yml b/examples/clusters/aws/fleet.dstack.yml
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -149,7 +149,7 @@ plugins:
         'blog/monitoring-gpu-usage.md': 'blog/posts/dstack-metrics.md'
         'blog/inactive-dev-environments-auto-shutdown.md': 'blog/posts/inactivity-duration.md'
         'blog/data-centers-and-private-clouds.md': 'blog/posts/gpu-blocks-and-proxy-jump.md'
-        'blog/distributed-training-with-aws-efa.md': 'examples/clusters/efa/index.md'
+        'blog/distributed-training-with-aws-efa.md': 'examples/clusters/aws/index.md'
         'blog/dstack-stats.md': 'blog/posts/dstack-metrics.md'
         'docs/concepts/metrics.md': 'docs/guides/metrics.md'
         'docs/guides/monitoring.md': 'docs/guides/metrics.md'
@@ -166,7 +166,7 @@ plugins:
         'examples/deployment/trtllm/index.md': 'examples/inference/trtllm/index.md'
         'examples/fine-tuning/trl/index.md': 'examples/single-node-training/trl/index.md'
         'examples/fine-tuning/axolotl/index.md': 'examples/single-node-training/axolotl/index.md'
-        'blog/efa.md': 'examples/clusters/efa/index.md'
+        'blog/efa.md': 'examples/clusters/aws/index.md'
         'docs/concepts/repos.md': 'docs/concepts/dev-environments.md#repos'
         'examples/clusters/a3high/index.md': 'examples/clusters/gcp/index.md'
         'examples/clusters/a3mega/index.md': 'examples/clusters/gcp/index.md'
@@ -326,7 +326,7 @@ nav:
         - NCCL tests: examples/clusters/nccl-tests/index.md
         - RCCL tests: examples/clusters/rccl-tests/index.md
         - GCP: examples/clusters/gcp/index.md
-        - AWS EFA: examples/clusters/efa/index.md
+        - AWS: examples/clusters/aws/index.md
         - Crusoe: examples/clusters/crusoe/index.md
     - Inference:
         - SGLang: examples/inference/sglang/index.md
