@alchemy.run/effect-cluster 0.0.0-stage → 2.0.0-beta.86

package/lib/GCP/ComputeEnginePool.js

@@ -0,0 +1,172 @@
+import * as Compute from "@alchemy.run/gcp/Compute";
+import * as IAM from "@alchemy.run/gcp/IAM";
+import * as Storage from "@alchemy.run/gcp/Storage";
+import * as Output from "alchemy/Output";
+import * as Effect from "effect/Effect";
+import { GATEWAY_PORT, RUNNER_PORT } from "../internal/Gateway.js";
+import { makePoolLayer } from "../internal/PoolHost.js";
+import { COS_IMAGE } from "./Database.js";
+const NODE_IMAGE = "node:26-slim";
+const APP_PATH = "/var/lib/cluster-runner";
+const ENV_KEY = "cluster-runner-env";
+const HASH_KEY = "cluster-runner-hash";
+/**
+ * Fetch the runner program from the bucket and run it on the host network.
+ * When the instance's metadata changes (a new program, new environment), run
+ * this script again, so every runner picks the change up.
+ */
+const startupScript = (options) => `#!/bin/bash
+set -uo pipefail
+MD=http://metadata.google.internal/computeMetadata/v1
+mkdir -p ${APP_PATH}
+# Container-Optimized OS drops inbound traffic except SSH: open the runner's ports.
+for PORT in ${RUNNER_PORT} ${GATEWAY_PORT}; do
+  iptables -C INPUT -p tcp --dport $PORT -j ACCEPT 2>/dev/null || iptables -A INPUT -p tcp --dport $PORT -j ACCEPT
+done
+fetch() {
+  TOKEN="$(curl -sf -H 'Metadata-Flavor: Google' "$MD/instance/service-accounts/default/token" | sed -E 's/.*"access_token":"([^"]+)".*/\\1/')"
+  curl -sf -H "Authorization: Bearer $TOKEN" -o ${APP_PATH}/$1.next \\
+    "https://storage.googleapis.com/storage/v1/b/${options.bucket}/o/$1?alt=media" \\
+    && mv ${APP_PATH}/$1.next ${APP_PATH}/$1
+}
+start() {
+  fetch runner.mjs
+  curl -sf -H 'Metadata-Flavor: Google' "$MD/instance/attributes/${ENV_KEY}" > ${APP_PATH}/env.list
+  docker rm -f cluster-runner >/dev/null 2>&1 || true
+  docker run -d --name cluster-runner --restart always --network host \\
+    --env-file ${APP_PATH}/env.list -v ${APP_PATH}:/app:ro -w /app ${NODE_IMAGE} node /app/runner.mjs
+}
+etag() {
+  curl -sf -H 'Metadata-Flavor: Google' -D - -o /dev/null "$MD/instance/attributes/?recursive=true$1" \\
+    | grep -i '^etag:' | awk '{print $2}' | tr -d '\\r'
+}
+start
+(
+  ETAG="$(etag "")"
+  while true; do
+    NEXT="$(etag "&wait_for_change=true&timeout_sec=3600&last_etag=$ETAG")"
+    if [ -n "$NEXT" ] && [ "$NEXT" != "$ETAG" ]; then
+      curl -sf -H 'Metadata-Flavor: Google' "$MD/instance/attributes/startup-script" > ${APP_PATH}/startup.sh \\
+        && exec setsid bash ${APP_PATH}/startup.sh
+    fi
+    sleep 5
+  done
+) >/dev/null 2>&1 < /dev/null &
+# The runner's logs on the serial console (\`gcloud compute instances get-serial-port-output\`).
+pgrep -f "docker logs -f cluster-runner" >/dev/null || setsid sh -c 'while true; do docker logs -f cluster-runner 2>&1 | sed -u "s/^/cluster-runner: /"; sleep 2; done > /dev/ttyS0' >/dev/null 2>&1 < /dev/null &
+`;
+/**
+ * Run a pool of Effect Cluster runners on Compute Engine: instances in the
+ * database's VPC, spread across zones, each running every class given these
+ * runners from a Cloud Storage bucket, behind a regional load balancer on a
+ * static address that serves their gateway to callers anywhere. Runners
+ * reach each other and the database through the cluster's network tag.
+ * Requires a database on a GCP network — `ClusterGCP.Database`.
+ *
+ * Cloud Run can't host runners: runners take connections from each other.
+ *
+ * ### Running on Compute Engine
+ * **Example:** Two runners
+ * ```typescript
+ * export const Database = ClusterGCP.Database("Cluster");
+ * export const Default = ClusterGCP.ComputeEnginePool("Default", { replicas: 2 }).pipe(
+ *   Layer.provide(Database),
+ * );
+ * ```
+ *
+ * @primitive
+ */
+export const ComputeEnginePool = (id, options = {}) => makePoolLayer({
+    label: "ClusterGCP.ComputeEnginePool",
+    id,
+    settings: options,
+    expected: "a GCP network (ClusterGCP.Database)",
+    network: (database) => (database.network?.kind === "gcp" ? database.network : undefined),
+    // A static address, before the instances, so the URL never depends on it.
+    gateway: (_name, network) => Effect.gen(function* () {
+        const address = yield* Compute.Address(`${id}GatewayAddress`, { region: network.region });
+        return {
+            url: Output.interpolate `http://${address.address}:${GATEWAY_PORT}`,
+            address: address.address,
+        };
+    }),
+    nodes: ({ network, gateway, program, environment }) => Effect.gen(function* () {
+        const zones = options.zones ?? [
+            `${network.region}-a`,
+            `${network.region}-b`,
+            `${network.region}-c`,
+        ];
+        // The gateway checks every call's token; the passthrough load
+        // balancer keeps the caller's address.
+        yield* Compute.Firewall(`${id}GatewayFirewall`, {
+            network: network.network,
+            direction: "INGRESS",
+            allowed: [{ protocol: "tcp", ports: [String(GATEWAY_PORT)] }],
+            sourceRanges: ["0.0.0.0/0"],
+            targetTags: [network.tag],
+        });
+        const bucket = yield* Storage.Bucket(`${id}Program`, {
+            location: network.region,
+            forceDestroy: true,
+            uniformBucketLevelAccess: true,
+        });
+        const runner = yield* Storage.Object(`${id}RunnerObject`, {
+            bucketName: bucket.bucketName,
+            key: "runner.mjs",
+            file: program.pipe(Output.map((p) => `${p.dir}/runner.mjs`)),
+            contentType: "text/javascript",
+        });
+        const account = yield* IAM.ServiceAccount(`${id}RunnerAccount`, {
+            displayName: "Effect Cluster runners",
+        });
+        const grant = yield* IAM.Member(`${id}ProgramGrant`, {
+            kind: "storage.bucket",
+            name: bucket.bucketName,
+            role: "roles/storage.objectViewer",
+            member: Output.interpolate `serviceAccount:${account.email}`,
+        });
+        // A Docker env file: one `NAME=value` per line. Each runner finds its
+        // own address in the subnetwork's range.
+        const envFile = environment.pipe(Output.map((env) => Object.entries({ ...env, CLUSTER_RUNNER_NETWORK: network.cidr })
+            .map(([name, value]) => `${name}=${String(value).replaceAll("\n", " ")}`)
+            .join("\n")));
+        const metadata = Output.all(bucket.bucketName, runner.md5Hash, envFile, grant.role).pipe(Output.map(([bucketName, hash, env]) => ({
+            "startup-script": startupScript({ bucket: bucketName }),
+            [HASH_KEY]: hash ?? "",
+            [ENV_KEY]: env,
+        })));
+        const instances = [];
+        for (let i = 0; i < (options.replicas ?? 2); i++) {
+            instances.push(yield* Compute.Instance(`${id}Runner${i}`, {
+                zone: zones[i % zones.length],
+                machineType: options.machineType ?? "e2-small",
+                sourceImage: COS_IMAGE,
+                network: Output.interpolate `global/networks/${network.network}`,
+                subnetwork: Output.interpolate `regions/${network.region}/subnetworks/${network.subnetwork}`,
+                associatePublicIp: true,
+                tags: [network.tag],
+                serviceAccount: account.email,
+                oauthScopes: ["https://www.googleapis.com/auth/cloud-platform"],
+                metadata: metadata,
+            }));
+        }
+        const health = yield* Compute.HttpHealthCheck(`${id}GatewayHealth`, {
+            port: GATEWAY_PORT,
+            requestPath: "/health",
+        });
+        const pool = yield* Compute.TargetPool(`${id}Gateway`, {
+            region: network.region,
+            healthChecks: [health.selfLink],
+            instances: instances.map((instance) => instance.selfLink),
+        });
+        yield* Compute.ForwardingRule(`${id}GatewayRule`, {
+            region: network.region,
+            ipAddress: gateway.address,
+            ipProtocol: "TCP",
+            portRange: String(GATEWAY_PORT),
+            target: pool.selfLink,
+            loadBalancingScheme: "EXTERNAL",
+        });
+    }),
+});
+//# sourceMappingURL=ComputeEnginePool.js.map

package/lib/GCP/ComputeEnginePool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComputeEnginePool.js","sources":["../../src/GCP/ComputeEnginePool.ts"],"names":[],"mappings":"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"}

package/lib/GCP/Database.d.ts

@@ -0,0 +1,48 @@
+import { GcpEnvironment } from "@alchemy.run/gcp/Environment";
+import * as Layer from "effect/Layer";
+import { Database as ClusterDatabase } from "../Database.ts";
+import type { Providers } from "../Providers.ts";
+export declare const COS_IMAGE = "projects/cos-cloud/global/images/family/cos-stable";
+export interface DatabaseProps {
+    /**
+     * Zone of the database instance.
+     * @default the region's `-a` zone
+     */
+    zone?: string;
+    /**
+     * Machine type of the database instance.
+     * @default "e2-small"
+     */
+    machineType?: string;
+    /**
+     * Size of the database's disk, in GB.
+     * @default 20
+     */
+    diskSize?: number;
+    /**
+     * Postgres image.
+     * @default "postgres:17-alpine"
+     */
+    image?: string;
+    /**
+     * IPv4 range of the cluster's subnetwork.
+     * @default "10.47.0.0/20"
+     */
+    cidrBlock?: string;
+}
+/**
+ * The database an Effect Cluster coordinates through, on Compute Engine,
+ * as a `Cluster.Database` Layer: Postgres on an instance with a persistent
+ * disk, in a VPC of its own that the pool's runners join. Only the runners reach
+ * it; runners reach each other on the runner port.
+ *
+ * ### Running the database on GCP
+ * **Example:** Postgres on Compute Engine
+ * ```typescript
+ * export const Database = ClusterGCP.Database("Cluster");
+ * ```
+ *
+ * @primitive
+ */
+export declare const Database: (id: string, props?: DatabaseProps) => Layer.Layer<ClusterDatabase, never, GcpEnvironment | Providers | import("@alchemy.run/gcp/Providers").Providers | import("alchemy").Stack>;
+//# sourceMappingURL=Database.d.ts.map

package/lib/GCP/Database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.d.ts","sources":["../../src/GCP/Database.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAI9D,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAsB,QAAQ,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,eAAO,MAAM,SAAS,uDAAuD,CAAC;AAI9E,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsBD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ,OAAQ,MAAM,UAAS,aAAa,+IAyFtD,CAAC"}

package/lib/GCP/Database.js

@@ -0,0 +1,115 @@
+import * as Compute from "@alchemy.run/gcp/Compute";
+import { GcpEnvironment } from "@alchemy.run/gcp/Environment";
+import * as Output from "alchemy/Output";
+import { Random } from "alchemy/Random";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import { clusterShardGroups, Database as ClusterDatabase } from "../Database.js";
+import { RUNNER_PORT } from "../internal/Gateway.js";
+import { stackDnsLabel } from "../internal/Naming.js";
+export const COS_IMAGE = "projects/cos-cloud/global/images/family/cos-stable";
+const DISK_DEVICE = "cluster-data";
+const MOUNT_PATH = "/mnt/disks/postgres";
+const shellQuote = (value) => `'${value.replaceAll("'", `'"'"'`)}'`;
+/** Mount the data disk, then run Postgres on the host network. */
+const startupScript = (options) => `#!/bin/bash
+set -euo pipefail
+DEVICE=/dev/disk/by-id/google-${DISK_DEVICE}
+blkid "$DEVICE" >/dev/null || mkfs.ext4 -F "$DEVICE"
+mkdir -p ${MOUNT_PATH}
+mountpoint -q ${MOUNT_PATH} || mount "$DEVICE" ${MOUNT_PATH}
+# Container-Optimized OS drops inbound traffic except SSH: open Postgres.
+iptables -C INPUT -p tcp --dport 5432 -j ACCEPT 2>/dev/null || iptables -A INPUT -p tcp --dport 5432 -j ACCEPT
+docker rm -f postgres >/dev/null 2>&1 || true
+docker run -d --name postgres --restart always --network host \\
+  -v ${MOUNT_PATH}:/var/lib/postgresql/data \\
+  -e PGDATA=/var/lib/postgresql/data/pgdata \\
+  -e POSTGRES_DB=cluster \\
+  -e POSTGRES_PASSWORD=${shellQuote(options.password)} \\
+  ${shellQuote(options.image)}
+`;
+/**
+ * The database an Effect Cluster coordinates through, on Compute Engine,
+ * as a `Cluster.Database` Layer: Postgres on an instance with a persistent
+ * disk, in a VPC of its own that the pool's runners join. Only the runners reach
+ * it; runners reach each other on the runner port.
+ *
+ * ### Running the database on GCP
+ * **Example:** Postgres on Compute Engine
+ * ```typescript
+ * export const Database = ClusterGCP.Database("Cluster");
+ * ```
+ *
+ * @primitive
+ */
+export const Database = (id, props = {}) => Layer.effect(ClusterDatabase, Effect.gen(function* () {
+    if (globalThis.__ALCHEMY_RUNTIME__) {
+        // Runners read their database from their own environment at runtime.
+        return { url: Redacted.make(""), shardGroups: undefined };
+    }
+    const region = yield* GcpEnvironment.current.pipe(Effect.map((env) => env.region), Effect.orDie);
+    const zone = props.zone ?? `${region}-a`;
+    const cidr = props.cidrBlock ?? "10.47.0.0/20";
+    const poolTag = yield* stackDnsLabel(`${id}-pool`, 63);
+    const databaseTag = yield* stackDnsLabel(`${id}-db`, 63);
+    const network = yield* Compute.Network(`${id}Network`, { autoCreateSubnetworks: false });
+    const subnet = yield* Compute.Subnetwork(`${id}Subnet`, {
+        network: network.networkName,
+        region,
+        ipCidrRange: cidr,
+    });
+    yield* Compute.Firewall(`${id}DatabaseFirewall`, {
+        network: network.networkName,
+        direction: "INGRESS",
+        allowed: [{ protocol: "tcp", ports: ["5432"] }],
+        sourceTags: [poolTag],
+        targetTags: [databaseTag],
+    });
+    // Runners send each other messages for the shards they own.
+    yield* Compute.Firewall(`${id}RunnerFirewall`, {
+        network: network.networkName,
+        direction: "INGRESS",
+        allowed: [{ protocol: "tcp", ports: [String(RUNNER_PORT)] }],
+        sourceTags: [poolTag],
+        targetTags: [poolTag],
+    });
+    const password = yield* Random(`${id}Password`, { bytes: 24 });
+    const disk = yield* Compute.Disk(`${id}Disk`, {
+        zone,
+        type: "pd-balanced",
+        sizeGb: props.diskSize ?? 20,
+    });
+    const instance = yield* Compute.Instance(`${id}Postgres`, {
+        zone,
+        machineType: props.machineType ?? "e2-small",
+        sourceImage: COS_IMAGE,
+        network: Output.interpolate `global/networks/${network.networkName}`,
+        subnetwork: Output.interpolate `regions/${region}/subnetworks/${subnet.subnetworkName}`,
+        // Pulls the Postgres image.
+        associatePublicIp: true,
+        tags: [databaseTag],
+        attachedDisks: [
+            { source: disk.selfLink, deviceName: DISK_DEVICE },
+        ],
+        metadata: {
+            "startup-script": password.text.pipe(Output.map((text) => startupScript({
+                image: props.image ?? "postgres:17-alpine",
+                password: Redacted.value(text),
+            }))),
+        },
+    });
+    return {
+        url: Output.all(instance.networkIP, password.text).pipe(Output.map(([ip, text]) => Redacted.make(`postgres://postgres:${encodeURIComponent(text.pipe(Redacted.value))}@${ip}:5432/cluster`))),
+        network: {
+            kind: "gcp",
+            network: network.networkName,
+            subnetwork: subnet.subnetworkName,
+            region,
+            cidr,
+            tag: poolTag,
+        },
+        shardGroups: yield* clusterShardGroups(id),
+    };
+}));
+//# sourceMappingURL=Database.js.map

package/lib/GCP/Database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.js","sources":["../../src/GCP/Database.ts"],"names":[],"mappings":"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"}

package/lib/GCP/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @alchemy.run/effect-cluster/GCP — run an Effect Cluster's database and runners
+ * on Compute Engine. Requires `@alchemy.run/gcp`.
+ */
+export * from "./ComputeEnginePool.ts";
+export * from "./Database.ts";
+//# sourceMappingURL=index.d.ts.map

package/lib/GCP/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sources":["../../src/GCP/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC"}

package/lib/GCP/index.js

@@ -0,0 +1,7 @@
+/**
+ * @alchemy.run/effect-cluster/GCP — run an Effect Cluster's database and runners
+ * on Compute Engine. Requires `@alchemy.run/gcp`.
+ */
+export * from "./ComputeEnginePool.js";
+export * from "./Database.js";
+//# sourceMappingURL=index.js.map

package/lib/GCP/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/GCP/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC"}

package/lib/Hetzner/Database.d.ts

@@ -0,0 +1,48 @@
+import * as Hetzner from "@alchemy.run/hetzner";
+import * as Layer from "effect/Layer";
+import { Database as ClusterDatabase } from "../Database.ts";
+import type { Providers } from "../Providers.ts";
+export interface DatabaseProps {
+    /**
+     * Hetzner location of the database and the cluster's Network.
+     * @default "nbg1"
+     */
+    location?: string;
+    /**
+     * Server type of the database.
+     * @default "cx23"
+     */
+    serverType?: string;
+    /**
+     * Size of the database's Volume, in GB (at least 10).
+     * @default 10
+     */
+    diskSize?: number;
+    /**
+     * Postgres image.
+     * @default "postgres:17-alpine"
+     */
+    image?: string;
+    /**
+     * IPv4 range of the cluster's private Network.
+     * @default "10.46.0.0/16"
+     */
+    ipRange?: string;
+}
+/**
+ * The database an Effect Cluster coordinates through, on Hetzner Cloud, as
+ * a `Cluster.Database` Layer: Postgres on a Server with a Volume, on a
+ * private Network that the pool's Servers attach to. A firewall drops every
+ * inbound connection on the Server's public address; runners reach it
+ * over the Network.
+ *
+ * ### Running the database on Hetzner
+ * **Example:** Postgres in Nuremberg
+ * ```typescript
+ * export const Database = ClusterHetzner.Database("Cluster");
+ * ```
+ *
+ * @primitive
+ */
+export declare const Database: (id: string, props?: DatabaseProps) => Layer.Layer<ClusterDatabase, never, Providers | Hetzner.Providers>;
+//# sourceMappingURL=Database.d.ts.map

package/lib/Hetzner/Database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.d.ts","sources":["../../src/Hetzner/Database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC;AAIhD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAsB,QAAQ,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAiCD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ,OAAQ,MAAM,UAAS,aAAa,uEA0DtD,CAAC"}

package/lib/Hetzner/Database.js

@@ -0,0 +1,91 @@
+import * as Hetzner from "@alchemy.run/hetzner";
+import * as Output from "alchemy/Output";
+import { Random } from "alchemy/Random";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import { clusterShardGroups, Database as ClusterDatabase } from "../Database.js";
+/** The network zone a location belongs to. */
+const networkZoneOf = (location) => location.startsWith("ash")
+    ? "us-east"
+    : location.startsWith("hil")
+        ? "us-west"
+        : location.startsWith("sin")
+            ? "ap-southeast"
+            : "eu-central";
+const shellQuote = (value) => `'${value.replaceAll("'", `'"'"'`)}'`;
+/** Mount the Volume and run Postgres on it, on the Server's own network. */
+const userData = (options) => `#!/bin/bash
+set -euo pipefail
+DEVICE=/dev/disk/by-id/scsi-0HC_Volume_${options.volumeId}
+for _ in $(seq 1 60); do [ -e "$DEVICE" ] && break; sleep 2; done
+blkid "$DEVICE" >/dev/null || mkfs.ext4 -F "$DEVICE"
+mkdir -p /mnt/postgres
+grep -q " /mnt/postgres " /etc/fstab || echo "$DEVICE /mnt/postgres ext4 discard,nofail,defaults 0 0" >> /etc/fstab
+mountpoint -q /mnt/postgres || mount /mnt/postgres
+until docker info >/dev/null 2>&1; do sleep 2; done
+docker rm -f postgres >/dev/null 2>&1 || true
+docker run -d --name postgres --restart always --network host \\
+  -v /mnt/postgres:/var/lib/postgresql/data \\
+  -e PGDATA=/var/lib/postgresql/data/pgdata \\
+  -e POSTGRES_DB=cluster \\
+  -e POSTGRES_PASSWORD=${shellQuote(options.password)} \\
+  ${shellQuote(options.image)}
+`;
+/**
+ * The database an Effect Cluster coordinates through, on Hetzner Cloud, as
+ * a `Cluster.Database` Layer: Postgres on a Server with a Volume, on a
+ * private Network that the pool's Servers attach to. A firewall drops every
+ * inbound connection on the Server's public address; runners reach it
+ * over the Network.
+ *
+ * ### Running the database on Hetzner
+ * **Example:** Postgres in Nuremberg
+ * ```typescript
+ * export const Database = ClusterHetzner.Database("Cluster");
+ * ```
+ *
+ * @primitive
+ */
+export const Database = (id, props = {}) => Layer.effect(ClusterDatabase, Effect.gen(function* () {
+    if (globalThis.__ALCHEMY_RUNTIME__) {
+        // Runners read their database from their own environment at runtime.
+        return { url: Redacted.make(""), shardGroups: undefined };
+    }
+    const location = props.location ?? "nbg1";
+    const ipRange = props.ipRange ?? "10.46.0.0/16";
+    const password = yield* Random(`${id}Password`, { bytes: 24 });
+    const network = yield* Hetzner.Network(`${id}Network`, {
+        ipRange,
+        subnets: [{ type: "cloud", networkZone: networkZoneOf(location) }],
+    });
+    // No inbound rules: only the Network reaches Postgres.
+    const firewall = yield* Hetzner.Firewall(`${id}Firewall`, {});
+    const volume = yield* Hetzner.Volume(`${id}Data`, {
+        size: props.diskSize ?? 10,
+        format: "ext4",
+        location,
+    });
+    const server = yield* Hetzner.Server(`${id}Postgres`, {
+        serverType: props.serverType ?? "cx23",
+        // Hetzner's Ubuntu image with Docker preinstalled.
+        image: "docker-ce",
+        location,
+        // IPv4 pulls the Postgres image; IPv6 would only spend an address.
+        enableIpv6: false,
+        networks: [network],
+        firewalls: [firewall],
+        volumes: [volume],
+        userData: Output.all(volume.id, password.text).pipe(Output.map(([volumeId, text]) => userData({
+            volumeId,
+            image: props.image ?? "postgres:17-alpine",
+            password: Redacted.value(text),
+        }))),
+    });
+    return {
+        url: Output.all(server.privateIps, password.text).pipe(Output.map(([ips, text]) => Redacted.make(`postgres://postgres:${encodeURIComponent(text.pipe(Redacted.value))}@${ips[0]}:5432/cluster`))),
+        network: { kind: "hetzner", networkId: network.networkId, ipRange, location },
+        shardGroups: yield* clusterShardGroups(id),
+    };
+}));
+//# sourceMappingURL=Database.js.map

package/lib/Hetzner/Database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.js","sources":["../../src/Hetzner/Database.ts"],"names":[],"mappings":"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"}

package/lib/Hetzner/ServerPool.d.ts

@@ -0,0 +1,35 @@
+import * as Hetzner from "@alchemy.run/hetzner";
+import { type PoolSettings } from "../internal/PoolHost.ts";
+export interface ServerPoolOptions extends PoolSettings {
+    /**
+     * Number of runners, one Server each.
+     * @default 2
+     */
+    replicas?: number;
+    /**
+     * Server type of each runner.
+     * @default "cx23"
+     */
+    serverType?: string;
+}
+/**
+ * Run a pool of Effect Cluster runners on Hetzner Cloud: Servers on the
+ * database's private Network, each running every class given these
+ * runners as a `Hetzner.Service`, behind a Load Balancer that serves their
+ * gateway to callers anywhere. Runners talk to each other and the database
+ * over the Network; their firewall only lets SSH in, which deploys them.
+ * Requires a database on a Hetzner Network — `ClusterHetzner.Database`.
+ *
+ * ### Running on Hetzner
+ * **Example:** Two runners
+ * ```typescript
+ * export const Database = ClusterHetzner.Database("Cluster");
+ * export const Default = ClusterHetzner.ServerPool("Default", { replicas: 2 }).pipe(
+ *   Layer.provide(Database),
+ * );
+ * ```
+ *
+ * @primitive
+ */
+export declare const ServerPool: (id: string, options?: ServerPoolOptions) => import("effect/Layer").Layer<import("../internal/PoolHostService.ts").PoolHost, never, import("../Database.ts").Database | import("../Providers.ts").Providers | Hetzner.Providers | import("alchemy").Stack>;
+//# sourceMappingURL=ServerPool.d.ts.map

package/lib/Hetzner/ServerPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerPool.d.ts","sources":["../../src/Hetzner/ServerPool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC;AAIhD,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE3E,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,UAAU,OAAQ,MAAM,YAAW,iBAAiB,kNA0E7D,CAAC"}