@usine/executor 0.2.1 → 0.4.0

package/dist/ssh/provisioner/machines.d.ts

@@ -0,0 +1,48 @@
+import type { BrainSpec } from "@usine/core/agent/brain";
+import type { AttemptId } from "@usine/core/attempt";
+import type { RunId } from "@usine/core/run";
+import type { MachineId, WorkerName } from "@usine/core/worker";
+import { Effect, FileSystem, Option, Path } from "effect";
+import { type ExecutorError, ExecutorOperationError, MachineGrant, MachineHold, MachineStatus, MachineUnavailableError, type PreflightReport, WorkerCapabilityError } from "../../executor.ts";
+import type { RemoteCommands } from "../../remote/commands.ts";
+import type { MachineGateway, SshExecutorOptions, SshMachine } from "../model.ts";
+import { type PinnedHostKey, type SshWorkerEntry } from "../workers.ts";
+import { type MachineEndpoint } from "./model.ts";
+export interface ProvisionedMachinesOptions {
+    readonly instance: string;
+    readonly commands: RemoteCommands;
+    readonly workerFor: (worker: WorkerName) => Effect.Effect<SshWorkerEntry, ExecutorError>;
+    readonly entries: Effect.Effect<ReadonlyArray<SshWorkerEntry>>;
+    readonly machineAt: (entry: SshWorkerEntry, id: MachineId, endpoint: MachineEndpoint, hostKey: PinnedHostKey) => SshMachine;
+    /** The machine preflight of `sshMachinePreflightFor`. */
+    readonly verifyMachine: (machine: SshMachine, brains: ReadonlyArray<BrainSpec>, maxConcurrentAttempts: number) => Effect.Effect<PreflightReport, ExecutorError>;
+    readonly verifyGatewayAdmin: (worker: WorkerName, gateway: MachineGateway) => Effect.Effect<void, WorkerCapabilityError>;
+    readonly settings: Pick<SshExecutorOptions, "knownHostsDirectory" | "providerEndpoints" | "machineReadyTimeout" | "machinePollInterval">;
+}
+/**
+ * Returns the machines of the SSH executor's provisioned Workers: the `WorkerMachines` port for
+ * the scheduler, the machine of each Attempt for preparation and recovery, and the provisioned
+ * Workers' preflight. Requires Node for the key and host key files.
+ */
+export declare const provisionedMachinesFor: (options: ProvisionedMachinesOptions) => Effect.Effect<{
+    port: {
+        readonly provisions: (worker: WorkerName) => Effect.Effect<boolean>;
+        readonly create: (worker: WorkerName, runId: RunId, brains: ReadonlyArray<BrainSpec>) => Effect.Effect<MachineGrant, MachineUnavailableError | WorkerCapabilityError>;
+        readonly assign: (hold: MachineHold, attemptId: AttemptId) => Effect.Effect<void, ExecutorOperationError>;
+        readonly adopt: (worker: WorkerName, attemptId: AttemptId) => Effect.Effect<Option.Option<MachineHold>>;
+        readonly release: (hold: MachineHold) => Effect.Effect<void>;
+        readonly sweep: Effect.Effect<void>;
+        readonly machines: Effect.Effect<ReadonlyArray<MachineStatus>>;
+    };
+    attemptMachine: (worker: string & import("effect/Brand").Brand<"WorkerName">, attemptId: string & import("effect/Brand").Brand<"AttemptId">) => Effect.Effect<SshMachine, ExecutorOperationError, never>;
+    recoveryMachine: (worker: WorkerName, attemptId: AttemptId) => Effect.Effect<Option.Option<SshMachine>, ExecutorOperationError, never>;
+    recovered: (attemptId: string & import("effect/Brand").Brand<"AttemptId">, succeeded: boolean) => Effect.Effect<void, never, never>;
+    checkoutHeld: (attemptId: string & import("effect/Brand").Brand<"AttemptId">, held: boolean) => Effect.Effect<void, never, never>;
+    verifyProvisioned: (entry: SshWorkerEntry, brains: readonly BrainSpec[], maxConcurrentAttempts: number) => Effect.Effect<{
+        degraded: Option.Option<string>;
+        deferred: Option.Option<string>;
+        containerLimits: Option.Option<import("@usine/core/worker").ContainerLimits>;
+    }, import("../../executor.ts").CredentialUnavailableError | ExecutorOperationError | WorkerCapabilityError, never>;
+    provisions: (worker: WorkerName) => Effect.Effect<boolean, never, never>;
+}, import("effect/PlatformError").PlatformError, FileSystem.FileSystem | import("effect/http/HttpClient").HttpClient | Path.Path | import("effect/Scope").Scope>;
+//# sourceMappingURL=machines.d.ts.map

package/dist/ssh/provisioner/machines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machines.d.ts","sourceRoot":"","sources":["../../../src/ssh/provisioner/machines.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAEV,SAAS,EAET,UAAU,EACX,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAKL,MAAM,EAEN,UAAU,EACV,MAAM,EACN,IAAI,EAIL,MAAM,QAAQ,CAAC;AAEhB,OAAO,EACL,KAAK,aAAa,EAClB,sBAAsB,EAEtB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,KAAK,eAAe,EACpB,qBAAqB,EAEtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,UAAU,EAAkB,MAAM,aAAa,CAAC;AAClG,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAKL,KAAK,eAAe,EAGrB,MAAM,YAAY,CAAC;AA+FpB,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;IACzF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC;IAC/D,QAAQ,CAAC,SAAS,EAAE,CAClB,KAAK,EAAE,cAAc,EACrB,EAAE,EAAE,SAAS,EACb,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,aAAa,KACnB,UAAU,CAAC;IAChB,yDAAyD;IACzD,QAAQ,CAAC,aAAa,EAAE,CACtB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,EAChC,qBAAqB,EAAE,MAAM,KAC1B,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IACnD,QAAQ,CAAC,kBAAkB,EAAE,CAC3B,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,cAAc,KACpB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,IAAI,CACrB,kBAAkB,EAClB,qBAAqB,GAAG,mBAAmB,GAAG,qBAAqB,GAAG,qBAAqB,CAC5F,CAAC;CACH;AAqBD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;8BA+vBA,UAAU,aAAa,SAAS;;;;;;;;yBAuErC,UAAU;gKAuBtC,CAAC"}