@alchemy.run/docker 0.0.0 → 2.0.0-beta.85

package/lib/RemoteImage.js.map

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

package/lib/Service.d.ts

@@ -0,0 +1,499 @@
+import { Platform, type Main, type PlatformProps } from "alchemy/Platform";
+import * as Provider from "alchemy/Provider";
+import type { Resource } from "alchemy/Resource";
+import { type HostRuntimeContext, type ServerHost } from "alchemy/Runtime/Process";
+import { Stack } from "alchemy/Stack";
+import * as Redacted from "effect/Redacted";
+import type * as rolldown from "rolldown";
+import { Docker } from "./Docker.ts";
+import type { Providers } from "./Providers.ts";
+export interface ServicePropsBase extends PlatformProps {
+    /**
+     * Service name.
+     *
+     * @default Generated from stack, stage, logical id, and instance id.
+     */
+    name?: string;
+    /**
+     * The engine the service is deployed to: a Docker context name, a
+     * `Docker.Context` resource, or a `Docker.Swarm` — passing the swarm also
+     * orders the service after the swarm is initialized.
+     */
+    context?: Docker.EngineRef;
+    /** Entrypoint command passed after the image. */
+    command?: string[];
+    /** Additional args appended after `command`. */
+    args?: string[];
+    /** Environment variables. Use Redacted for secrets. */
+    environment?: Record<string, string | Redacted.Redacted<string>>;
+    /**
+     * Environment variables injected by the platform (bound `Config` values and
+     * future bindings). Merged after `environment`; usually not set directly.
+     */
+    env?: Record<string, any>;
+    /** Overlay networks attached to this service. */
+    networks?: Array<string | Service.NetworkAttachment>;
+    /** Published port mappings. */
+    ports?: Service.PortMapping[];
+    /**
+     * Service discovery endpoint mode.
+     *
+     * @default "vip"
+     */
+    endpointMode?: "vip" | "dnsrr";
+    /**
+     * Desired number of service replicas.
+     *
+     * @default 1
+     */
+    replicas?: number;
+    /** Placement controls for task scheduling. */
+    placement?: Service.Placement;
+    /** Deprecated alias for `placement.constraints`. */
+    constraints?: string[];
+    /** Rolling update strategy for service updates. */
+    updateConfig?: Service.RolloutConfig;
+    /** Rollback strategy applied when updates fail. */
+    rollbackConfig?: Service.RolloutConfig;
+    /** Task restart behavior. */
+    restartPolicy?: Service.RestartPolicy;
+    /** Container healthcheck for service tasks. */
+    healthcheck?: Service.Healthcheck;
+    /** Grace period before force-killing a task during shutdown, e.g. `"30s"`. */
+    stopGracePeriod?: string;
+    /** Volume or bind mounts. */
+    volumes?: Service.VolumeMapping[];
+    /** Swarm secrets mounted into task containers. */
+    secrets?: Service.SecretRef[];
+    /** Swarm configs mounted into task containers. */
+    configs?: Service.ConfigRef[];
+    /**
+     * Mount task root filesystem read-only.
+     *
+     * @default false
+     */
+    readOnlyRootFs?: boolean;
+    /**
+     * Service labels. Alchemy's internal ownership labels are added
+     * automatically.
+     */
+    labels?: Record<string, string>;
+}
+/**
+ * Run a pre-built image: a registry reference or a Docker image resource
+ * (`Docker.Image` / `Docker.RemoteImage`).
+ */
+export interface ImageServiceProps extends ServicePropsBase {
+    /** Docker image reference or Docker image resource. */
+    image: Service.Image;
+    main?: undefined;
+}
+/**
+ * Bundle an inline Effect program (`main`) into a generated image built
+ * against the service's Docker context. The optional `image` is the
+ * environment base (`FROM`) and must be able to run the bun runtime.
+ */
+export interface BundledServiceProps extends ServicePropsBase {
+    /**
+     * Module entrypoint for the bundled program. This should typically be
+     * `import.meta.url` (or `import.meta.filename`) from an inline Effect
+     * program.
+     */
+    main: string;
+    /**
+     * Environment image used as the generated Dockerfile's `FROM`. Must be
+     * able to run the bun runtime.
+     *
+     * @default "oven/bun:1"
+     */
+    image?: string;
+    /**
+     * Container port the bundled HTTP server listens on. Baked into the image
+     * as `ENV PORT` + `EXPOSE`; publish it to the swarm ingress with `ports`.
+     */
+    port?: number;
+    /**
+     * Named export to load from `main`.
+     *
+     * @default "default"
+     */
+    handler?: string;
+    /** Bundler configuration for the entrypoint. */
+    build?: {
+        input?: Partial<rolldown.InputOptions>;
+        output?: Partial<rolldown.OutputOptions>;
+    };
+}
+/**
+ * Service props — the image comes from exactly one of two sources, flat on
+ * the props: `image` (a pre-built reference) or `main` (a bundled Effect
+ * program).
+ */
+export type ServiceProps = ImageServiceProps | BundledServiceProps;
+export declare namespace Service {
+    type Image = string | {
+        imageRef: string;
+    };
+    interface PortMapping {
+        /** Published port on the swarm node. Omit to let Swarm assign one dynamically. */
+        external?: number;
+        /** Container port receiving traffic. */
+        internal: number;
+        /**
+         * Protocol used for the mapping.
+         *
+         * @default "tcp"
+         */
+        protocol?: "tcp" | "udp";
+        /**
+         * Publish through the swarm routing mesh (`ingress`) or directly on each
+         * node (`host`).
+         *
+         * @default "ingress"
+         */
+        mode?: "ingress" | "host";
+    }
+    interface VolumeMapping {
+        /** Host path or named volume source. */
+        hostPath: string;
+        /** Container path. */
+        containerPath: string;
+        /**
+         * Mount read-only.
+         *
+         * @default false
+         */
+        readOnly?: boolean;
+    }
+    interface NetworkAttachment {
+        /** Network name. */
+        name: string;
+        /** Network aliases for the service's tasks. */
+        aliases?: string[];
+    }
+    interface Placement {
+        /** Placement constraints, e.g. `"node.role==worker"`. */
+        constraints?: string[];
+        /** Placement preferences, e.g. `"spread=node.labels.zone"`. */
+        preferences?: string[];
+        /** Maximum number of replicas per swarm node. */
+        maxReplicasPerNode?: number;
+    }
+    interface RolloutConfig {
+        /** Number of tasks updated simultaneously. */
+        parallelism?: number;
+        /** Delay between task updates, e.g. `"10s"`. */
+        delay?: string;
+        /** Duration to monitor each updated task for failure, e.g. `"30s"`. */
+        monitor?: string;
+        /** Action on update failure. */
+        failureAction?: "pause" | "continue" | "rollback";
+        /** Failure ratio tolerated during an update. */
+        maxFailureRatio?: number;
+        /** Operation order during updates. */
+        order?: "stop-first" | "start-first";
+    }
+    interface RestartPolicy {
+        /** Condition under which tasks restart. */
+        condition?: "none" | "on-failure" | "any";
+        /** Delay between restart attempts, e.g. `"5s"`. */
+        delay?: string;
+        /** Maximum restart attempts before giving up. */
+        maxAttempts?: number;
+        /** Window used to evaluate the restart policy, e.g. `"120s"`. */
+        window?: string;
+    }
+    interface Healthcheck {
+        /**
+         * Command to run for health checks. A string runs in the container's
+         * shell. An array follows Docker's healthcheck `Test` form:
+         * `["CMD-SHELL", "pg_isready -U app"]`, `["CMD", "pg_isready", "-U", "app"]`,
+         * or `["NONE"]` to disable the image's healthcheck.
+         */
+        cmd: string[] | string;
+        /** Time between checks, e.g. `"30s"`. */
+        interval?: string;
+        /** Maximum time a check may run, e.g. `"5s"`. */
+        timeout?: string;
+        /** Consecutive failures before unhealthy. */
+        retries?: number;
+        /** Startup grace period, e.g. `"30s"`. */
+        startPeriod?: string;
+    }
+    interface SecretRef {
+        /** Swarm secret name. */
+        source: string;
+        /** Target file name in `/run/secrets/`. Defaults to `source`. */
+        target?: string;
+        /** File owner uid. */
+        uid?: string;
+        /** File owner gid. */
+        gid?: string;
+        /** File mode, e.g. `0o400`. */
+        mode?: number | string;
+    }
+    interface ConfigRef {
+        /** Swarm config name. */
+        source: string;
+        /** Target path in the container. Defaults to `/<source>`. */
+        target?: string;
+        /** File owner uid. */
+        uid?: string;
+        /** File owner gid. */
+        gid?: string;
+        /** File mode, e.g. `0o444`. */
+        mode?: number | string;
+    }
+}
+export interface Service extends Resource<"Docker.Service", ServiceProps, {
+    /** Swarm service id. */
+    id: string;
+    /** Swarm service name. */
+    name: string;
+    /** Docker context the service is deployed to. */
+    context?: string;
+    /** Image reference the service runs. */
+    image: string;
+    /** Desired number of replicas. */
+    replicas: number;
+    /** Network ids the service's tasks attach to. */
+    networks: string[];
+    /** Published port mappings reported by Swarm. */
+    ports: Service.PortMapping[];
+    /** Service labels reported by Swarm. */
+    labels: Record<string, string>;
+    /** Service discovery endpoint mode. */
+    endpointMode: "vip" | "dnsrr";
+    /** Creation timestamp in milliseconds since epoch. */
+    createdAt: number;
+    /** Last update timestamp in milliseconds since epoch. */
+    updatedAt: number;
+    /** Content hash of the bundled program's image (`main` form only). */
+    code?: {
+        /** Content hash of the bundled program's image. */
+        hash: string;
+    };
+}, never, Providers> {
+}
+/** Services available to an effectful `Service` impl at init time. */
+export type ServiceServices = ServerHost;
+/**
+ * The impl shape for an effectful `Service`: a long-running server returning
+ * `{ fetch }` (plus optional RPC methods).
+ */
+export type ServiceShape = Main<ServiceServices>;
+export interface ServiceRuntimeContext extends HostRuntimeContext {
+    readonly Type: "Docker.Service";
+}
+/**
+ * A Docker Swarm service: N replicas of a container kept alive by the swarm,
+ * deployed through the active (or a named) Docker context.
+ *
+ * The target engine must be a swarm manager — `Service` wraps
+ * `docker service`, swarm mode's orchestration API. Declare the swarm with
+ * `Docker.Swarm` and pass it as `context` so the service deploys after the
+ * swarm exists; for a plain single container on a non-swarm daemon use
+ * `Docker.Container` instead.
+ *
+ * The service's image comes from one of two sources:
+ *
+ * - `image` — run a pre-built reference (a registry ref, or a `Docker.Image`
+ *   / `Docker.RemoteImage` resource).
+ * - `main` — bundle an inline Effect program into a generated bun image,
+ *   built directly against the service's Docker context. The impl returns
+ *   `{ fetch }` and may register background loops via `ServerHost.run` —
+ *   the same effectful platform shape as `AWS.ECS.Service`.
+ *
+ * The bundled image is content-addressed and only rebuilt when the program
+ * (or its generated Dockerfile) changes. It is built on the target engine's
+ * local store — single-node swarms run it as-is; multi-node swarms need the
+ * image on a registry every node can reach (build with `Docker.Image` +
+ * `registry` and pass the pushed ref as `image` instead).
+ *
+ * Only replicated services are supported. Changes to the image, replicas,
+ * environment, labels, networks, ports, mounts, secrets, configs, constraints,
+ * healthcheck, and rollout or restart policies are applied in place with
+ * `docker service update`, so swarm rolls tasks over following `updateConfig`.
+ * An update that swarm rolls back or pauses fails the deploy with
+ * `DockerServiceUpdateFailed`. Changing the name, context, command, args,
+ * endpoint mode, placement preferences, or read-only root filesystem, or
+ * removing a policy setting, replaces the service (delete-then-create).
+ * ### Creating Services
+ * **Example:** Replicated Nginx
+ * ```typescript
+ * const swarm = yield* Docker.Swarm("swarm");
+ * const web = yield* Docker.Service("web", {
+ *   context: swarm,
+ *   image: "nginx:alpine",
+ *   replicas: 3,
+ *   ports: [{ external: 8080, internal: 80 }],
+ * });
+ * ```
+ *
+ * **Example:** Run a Built Image
+ * ```typescript
+ * const image = yield* Docker.Image("app-image", {
+ *   build: { context: "./app" },
+ * });
+ * const app = yield* Docker.Service("app", {
+ *   context: swarm,
+ *   image,
+ *   replicas: 2,
+ * });
+ * ```
+ *
+ * ### Effectful Services
+ * **Example:** Inline Effect Server
+ * ```typescript
+ * const swarm = yield* Docker.Swarm("swarm");
+ * const api = yield* Docker.Service(
+ *   "Api",
+ *   {
+ *     context: swarm,
+ *     main: import.meta.url,
+ *     port: 3000,
+ *     ports: [{ external: 8080, internal: 3000 }],
+ *     replicas: 2,
+ *   },
+ *   Effect.gen(function* () {
+ *     return {
+ *       fetch: Effect.gen(function* () {
+ *         return yield* HttpServerResponse.json({ ok: true });
+ *       }),
+ *     };
+ *   }),
+ * );
+ * ```
+ *
+ * **Example:** Background Loops with ServerHost
+ * ```typescript
+ * // Class props may be an Effect, so the service can yield the swarm it
+ * // deploys into (declared once at module level).
+ * const Swarm = Docker.Swarm("swarm");
+ *
+ * export default class Worker extends Docker.Service<Worker>()(
+ *   "Worker",
+ *   Effect.gen(function* () {
+ *     const swarm = yield* Swarm;
+ *     return { context: swarm, main: import.meta.url, port: 3000 };
+ *   }),
+ *   Effect.gen(function* () {
+ *     const host = yield* ServerHost;
+ *     yield* host.run(
+ *       pollQueue.pipe(Effect.repeat(Schedule.spaced("5 seconds")), Effect.asVoid),
+ *     );
+ *     return {
+ *       fetch: Effect.succeed(HttpServerResponse.text("ok")),
+ *     };
+ *   }),
+ * ) {}
+ * ```
+ *
+ * ### Bundling & Tree-shaking
+ * `main` is bundled with rolldown at deploy time. Unused code is
+ * tree-shaken. `effect`, alchemy, and `@distilled.cloud` are marked
+ * pure so unused parts prune more aggressively. Your app is not
+ * marked pure.
+ *
+ * **Example:** Mark additional packages as pure
+ * Only list packages with no top-level side effects.
+ * ```typescript
+ * {
+ *   main: import.meta.url,
+ *   build: {
+ *     pure: { packages: ["my-lib", "@my-scope/*"] },
+ *   },
+ * }
+ * ```
+ *
+ * **Example:** Turn it off
+ * ```typescript
+ * {
+ *   main: import.meta.url,
+ *   build: { pure: false },
+ * }
+ * ```
+ *
+ * ### Docker Contexts
+ * **Example:** Deploy to a Remote Swarm over SSH
+ * ```typescript
+ * const vps = yield* Docker.Context("vps", {
+ *   docker: "host=ssh://deploy@example.com",
+ * });
+ * const swarm = yield* Docker.Swarm("swarm", {
+ *   context: vps,
+ *   advertiseAddr: "10.0.0.1",
+ * });
+ * const app = yield* Docker.Service("app", {
+ *   context: swarm,
+ *   image: "nginx:alpine",
+ *   replicas: 3,
+ * });
+ * ```
+ *
+ * ### Networks & Volumes
+ * **Example:** Overlay Network with Aliases
+ * ```typescript
+ * const network = yield* Docker.Network("app-net", {
+ *   context: swarm,
+ *   driver: "overlay",
+ * });
+ * const db = yield* Docker.Service("db", {
+ *   context: swarm,
+ *   image: "postgres:18-alpine",
+ *   networks: [{ name: network.name, aliases: ["postgres"] }],
+ *   volumes: [{ hostPath: "pg-data", containerPath: "/var/lib/postgresql/data" }],
+ * });
+ * ```
+ *
+ * ### Rollouts & Placement
+ * **Example:** Rolling Update with Rollback
+ * ```typescript
+ * const app = yield* Docker.Service("app", {
+ *   image: "ghcr.io/acme/app:latest",
+ *   replicas: 4,
+ *   updateConfig: {
+ *     parallelism: 1,
+ *     delay: "10s",
+ *     failureAction: "rollback",
+ *     order: "start-first",
+ *   },
+ *   placement: {
+ *     constraints: ["node.role==worker"],
+ *     maxReplicasPerNode: 2,
+ *   },
+ * });
+ * ```
+ *
+ * ### Secrets & Configs
+ * **Example:** Mount Swarm Secrets
+ * ```typescript
+ * const app = yield* Docker.Service("app", {
+ *   image: "ghcr.io/acme/app:latest",
+ *   secrets: [{ source: "db-password", target: "db_password", mode: 0o400 }],
+ *   configs: [{ source: "app-config", target: "/etc/app/config.yaml" }],
+ * });
+ * ```
+ *
+ * @resource
+ * @product Swarm
+ */
+export declare const Service: Platform<Service, ServiceServices, ServiceShape, ServiceRuntimeContext>;
+declare const DockerServiceUpdateFailed_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "DockerServiceUpdateFailed";
+} & Readonly<A>;
+/**
+ * A `docker service update` that swarm rolled back or paused instead of
+ * completing. `--detach=false` exits 0 on a rollback and 1 on a pause, so the
+ * provider reads the service's `UpdateStatus` after the update.
+ */
+export declare class DockerServiceUpdateFailed extends DockerServiceUpdateFailed_base<{
+    readonly service: string;
+    readonly state: string;
+    readonly reason: string;
+}> {
+    get message(): string;
+}
+export declare const ServiceProvider: () => import("effect/Layer").Layer<Provider.Provider<Service>, never, import("alchemy/AlchemyContext").AlchemyContext | Docker | import("effect/FileSystem").FileSystem | import("effect/Path").Path | Stack | import("alchemy/Stage").Stage>;
+export {};
+//# sourceMappingURL=Service.d.ts.map

package/lib/Service.d.ts.map

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