Ensure Top-Level examples/ Directory

.github/workflows/main.yml

@@ -129,7 +129,7 @@ jobs:
         docker/build-push-action@2cdde995de11925a030ce8070c3d77a52ffcf1c0
       with:
         context: .
-        file: ./deployment-examples/docker-compose/Dockerfile
+        file: ./examples/docker-compose/Dockerfile
         build-args: |
           OPT_LEVEL=opt
           OS_VERSION=${{ matrix.os_version }}
@@ -142,7 +142,7 @@ jobs:
         docker/build-push-action@2cdde995de11925a030ce8070c3d77a52ffcf1c0
       with:
         context: .
-        file: ./deployment-examples/docker-compose/Dockerfile
+        file: ./examples/docker-compose/Dockerfile
         build-args: |
           OPT_LEVEL=opt
           OS_VERSION=${{ matrix.os_version }}
@@ -153,7 +153,7 @@ jobs:
     - name: Compile NativeLink with NativeLink
       run: |
         mkdir -p ~/.cache && \
-        cd deployment-examples/docker-compose && \
+        cd examples/docker-compose && \
         (docker-compose up -d || docker compose up -d) && \
         cd ../../ && \
         docker run --rm --net=host -w /root/nativelink -v $PWD:/root/nativelink trace_machina/nativelink:builder sh -c ' \
@@ -193,7 +193,7 @@ jobs:
         docker/build-push-action@2cdde995de11925a030ce8070c3d77a52ffcf1c0
       with:
         context: .
-        file: ./deployment-examples/docker-compose/Dockerfile
+        file: ./examples/docker-compose/Dockerfile
         build-args: |
           OPT_LEVEL=fastbuild
           OS_VERSION=${{ matrix.os_version }}

README.md

@@ -59,7 +59,7 @@ To start, you can deploy NativeLink as a Docker image (as shown below) or by usi
 
 The setups below are **production-grade** installations. See the [contribution docs](https://nativelink.com/docs/contribute/nix/) for instructions on how to build from source with [Bazel](https://nativelink.com/docs/contribute/bazel/), [Cargo](https://nativelink.com/docs/contribute/cargo/), and [Nix](https://nativelink.com/docs/contribute/nix/).
 
-You can find a few example deployments in the [Docs](https://nativelink.com/docs/deployment-examples/kubernetes).
+You can find a few example deployments for Docker, Terraform, and Chromium in the [Docs](https://www.nativelink.com/docs/deployment-examples/on-prem-overview).
 
 ### 📦 Prebuilt images
 

deployment-examples/docker-compose/README.md → examples/docker-compose/README.md

@@ -33,7 +33,7 @@ bazel test //... \
 ## Instances
 
 All instances use the same Docker image, `trace_machina/nativelink:latest`,
-built from the `Dockerfile` located at `./deployment-examples/docker-compose/Dockerfile`.
+built from the `Dockerfile` located at `./examples/docker-compose/Dockerfile`.
 
 ### CAS
 
@@ -46,7 +46,7 @@ NativeLink system. It's configured in the `docker-compose.yml` file under the
     image: trace_machina/nativelink:latest
     build:
       context: ../..
-      dockerfile: ./deployment-examples/docker-compose/Dockerfile
+      dockerfile: ./examples/docker-compose/Dockerfile
       network: host
       args:
         - ADDITIONAL_SETUP_WORKER_CMD=${ADDITIONAL_SETUP_WORKER_CMD:-}
@@ -79,7 +79,7 @@ the `docker-compose.yml` file under the nativelink_scheduler service.
     image: trace_machina/nativelink:latest
     build:
       context: ../..
-      dockerfile: ./deployment-examples/docker-compose/Dockerfile
+      dockerfile: ./examples/docker-compose/Dockerfile
       network: host
       args:
         - ADDITIONAL_SETUP_WORKER_CMD=${ADDITIONAL_SETUP_WORKER_CMD:-}
@@ -105,7 +105,7 @@ Worker instances are responsible for executing tasks. They're configured in the
     image: trace_machina/nativelink:latest
     build:
       context: ../..
-      dockerfile: ./deployment-examples/docker-compose/Dockerfile
+      dockerfile: ./examples/docker-compose/Dockerfile
       network: host
       args:
         - ADDITIONAL_SETUP_WORKER_CMD=${ADDITIONAL_SETUP_WORKER_CMD:-}

deployment-examples/docker-compose/docker-compose.yml → examples/docker-compose/docker-compose.yml

@@ -19,7 +19,7 @@ services:
     image: trace_machina/nativelink:latest
     build:
       context: ../..
-      dockerfile: ./deployment-examples/docker-compose/Dockerfile
+      dockerfile: ./examples/docker-compose/Dockerfile
       network: host
       args:
         - ADDITIONAL_SETUP_WORKER_CMD=${ADDITIONAL_SETUP_WORKER_CMD:-}
@@ -38,7 +38,7 @@ services:
     image: trace_machina/nativelink:latest
     build:
       context: ../..
-      dockerfile: ./deployment-examples/docker-compose/Dockerfile
+      dockerfile: ./examples/docker-compose/Dockerfile
       network: host
       args:
         - ADDITIONAL_SETUP_WORKER_CMD=${ADDITIONAL_SETUP_WORKER_CMD:-}
@@ -57,7 +57,7 @@ services:
     image: trace_machina/nativelink:latest
     build:
       context: ../..
-      dockerfile: ./deployment-examples/docker-compose/Dockerfile
+      dockerfile: ./examples/docker-compose/Dockerfile
       network: host
       args:
         - ADDITIONAL_SETUP_WORKER_CMD=${ADDITIONAL_SETUP_WORKER_CMD:-}

flake.nix

@@ -240,7 +240,7 @@
         build-chromium-tests =
           pkgs.writeShellScriptBin
           "build-chromium-tests"
-          ./deploy/chromium-example/build_chromium_tests.sh;
+          ./examples/chromium/build_chromium_tests.sh;
 
         docs = pkgs.callPackage ./tools/docs.nix {rust = stable-rust.default;};
 

local-remote-execution/README.md

@@ -192,7 +192,7 @@ Let's use NativeLink's Kubernetes example to verify that the setup worked.
 ## 🚢 Testing with local K8s
 
 Start the cluster and set up NativeLink in an LRE configuration. For details on
-this refer to the [Kubernetes example](https://github.com/tracemachina/nativelink/tree/main/deployment-examples/kubernetes):
+this refer to the [Kubernetes example](https://github.com/tracemachina/nativelink/tree/main/examples/kubernetes):
 
 > [!TIP]
 > NativeLink's `native` CLI tool is self-contained and can be imported into
@@ -243,8 +243,8 @@ kind: Kustomization
 bases:
 
 resources:
-  - https://github.com/TraceMachina/nativelink//deployment-examples/kubernetes/base
-  - https://raw.githubusercontent.com/TraceMachina/nativelink/main/deployment-examples/kubernetes/worker-lre-cc.yaml
+  - https://github.com/TraceMachina/nativelink//examples/kubernetes/base
+  - https://raw.githubusercontent.com/TraceMachina/nativelink/main/examples/kubernetes/worker-lre-cc.yaml
 EOF
 
 

run_integration_tests.sh

@@ -64,7 +64,7 @@ if [[ "${#TEST_PATTERNS[@]}" -eq 0 ]]; then
 fi
 
 SELF_DIR=$(realpath $(dirname $0))
-cd "$SELF_DIR/deployment-examples/docker-compose"
+cd "$SELF_DIR/examples/docker-compose"
 
 export UNDER_TEST_RUNNER=1
 

tools/pre-commit-hooks.nix

@@ -47,7 +47,7 @@ in {
       excludes
       ++ [
         # Integration testfiles not intended for production.
-        "deployment-examples/docker-compose/example-do-not-use-in-prod-key.pem"
+        "examples/docker-compose/example-do-not-use-in-prod-key.pem"
         "kubernetes/components/insecure-certs/example-do-not-use-in-prod-key.pem"
       ];
     enable = true;

web/platform/src/content/docs/docs/deployment-examples/chromium.mdx

@@ -96,7 +96,7 @@ The `build-chromium-tests` command simplifies the setup described in
 After preparing the requirements, it runs a Reclient build against the cluster.
 
 :::note
-See [`deploy/chromium-example/build_chromium_tests.sh`](https://github.com/TraceMachina/nativelink/blob/main/deploy/chromium-example/build_chromium_tests.sh)
+See [`examples/chromium/build_chromium_tests.sh`](https://github.com/TraceMachina/nativelink/blob/main/examples/chromium/build_chromium_tests.sh)
 for the script contents.
 :::
 

web/platform/src/content/docs/docs/deployment-examples/kubernetes.mdx

@@ -47,7 +47,7 @@ Next, deploy NativeLink to the cluster:
 
 ```bash
 kubectl apply -k \
-    https://github.com/TraceMachina/nativelink//deploy/kubernetes-example
+    https://github.com/TraceMachina/nativelink/deploy/kubernetes-example
 ```
 
 :::danger

web/platform/src/content/docs/docs/introduction/on-prem.mdx

@@ -21,7 +21,7 @@ To get started with running NativeLink on-premises, we recommend taking a
 look at our example deployments and NativeLink configurations that may suit
 your needs.
 
-- [**On-Prem Example Deployments**](/deployment-examples/on-prem-overview):
+- [**On-Prem Example Deployments**](/examples/on-prem-overview):
 This section provides several examples of deploying NativeLink to an
 on-premises Kubernetes setup. These examples aren't intended for production
 use, but rather to serve as basic, illustrative guides for using NativeLink

web/platform/starlight.conf.ts

@@ -114,15 +114,15 @@ export const starlightConfig = {
       items: [
         {
           label: "On-Prem Overview",
-          link: `${docsRoot}/deployment-examples/on-prem-overview`,
+          link: `${docsRoot}/examples/on-prem-overview`,
         },
         {
           label: "Kubernetes",
-          link: `${docsRoot}/deployment-examples/kubernetes`,
+          link: `${docsRoot}/examples/kubernetes`,
         },
         {
           label: "Chromium",
-          link: `${docsRoot}/deployment-examples/chromium`,
+          link: `${docsRoot}/examples/chromium`,
         },
       ],
     },