npm - @lakutata/docker - Versions diffs - 3.0.0-beta.0 - Mend

@@ -0,0 +1,12 @@
+import { Exception } from '@lakutata/core';
+/**
+ * Thrown when the {@link Docker} component is created and cannot connect to its daemon: the socket or the host cannot be
+ * reached, the daemon does not answer its ping or its version, the TLS handshake fails, or an SSH connection is
+ * configured without the package `ssh2`. Its message is the cause's. Its `errno` is `E_DOCKER_CONNECTION`.
+ */
+export class DockerConnectionException extends Exception {
+    constructor() {
+        super(...arguments);
+        this.errno = 'E_DOCKER_CONNECTION';
+    }
+}

@@ -0,0 +1,12 @@
+import { Exception } from '@lakutata/core';
+/**
+ * Thrown when the daemon has no container with the ID, short ID or name given: by {@link Docker.getContainer}, and by
+ * the operations of a {@link DockerContainer} whose container was removed (HTTP 404 from the daemon). Its message is
+ * the daemon's ("No such container: web"). Its `errno` is `E_DOCKER_CONTAINER_NOT_FOUND`.
+ */
+export class DockerContainerNotFoundException extends Exception {
+    constructor() {
+        super(...arguments);
+        this.errno = 'E_DOCKER_CONTAINER_NOT_FOUND';
+    }
+}

@@ -0,0 +1,12 @@
+import { Exception } from '@lakutata/core';
+/**
+ * Thrown by {@link Docker.buildImage} when the build fails: a step of the Dockerfile failing (its message is BuildKit's
+ * error), the Dockerfile or a file of the context missing, a base image which cannot be pulled with the credentials
+ * given, the daemon unreachable, or the component destroyed during the build. Its `errno` is `E_DOCKER_IMAGE_BUILD`.
+ */
+export class DockerImageBuildException extends Exception {
+    constructor() {
+        super(...arguments);
+        this.errno = 'E_DOCKER_IMAGE_BUILD';
+    }
+}

@@ -0,0 +1,12 @@
+import { Exception } from '@lakutata/core';
+/**
+ * Thrown by {@link Docker.importImage} when the daemon rejects the archive (not an archive of `docker save`, a corrupted
+ * archive), or when the image loaded cannot be known from the daemon's answer nor the archive's manifest. Its `errno` is
+ * `E_DOCKER_IMAGE_IMPORT`.
+ */
+export class DockerImageImportException extends Exception {
+    constructor() {
+        super(...arguments);
+        this.errno = 'E_DOCKER_IMAGE_IMPORT';
+    }
+}

@@ -0,0 +1,13 @@
+import { Exception } from '@lakutata/core';
+/**
+ * Thrown when the daemon has no image with the ID or the name given: by {@link Docker.getImage}, by
+ * {@link Docker.createContainer} and `DockerContainer.update()` (recreating a container whose image was removed), and by
+ * the operations of a {@link DockerImage} which was removed (HTTP 404 from the daemon). Its `errno` is
+ * `E_DOCKER_IMAGE_NOT_FOUND`.
+ */
+export class DockerImageNotFoundException extends Exception {
+    constructor() {
+        super(...arguments);
+        this.errno = 'E_DOCKER_IMAGE_NOT_FOUND';
+    }
+}

@@ -0,0 +1,12 @@
+import { Exception } from '@lakutata/core';
+/**
+ * Thrown by {@link Docker.pullImage} when the pull fails: the image or the registry not found, refused credentials, the
+ * daemon unreachable, or the component destroyed during the pull. Its message is the registry's or the daemon's. Its
+ * `errno` is `E_DOCKER_IMAGE_PULL`.
+ */
+export class DockerImagePullException extends Exception {
+    constructor() {
+        super(...arguments);
+        this.errno = 'E_DOCKER_IMAGE_PULL';
+    }
+}

@@ -0,0 +1,11 @@
+import { Exception } from '@lakutata/core';
+/**
+ * Thrown by {@link DockerImage.push} when the registry refuses the push (refused credentials, a repository not found or
+ * not writable); its message is the registry's. Its `errno` is `E_DOCKER_IMAGE_PUSH`.
+ */
+export class DockerImagePushException extends Exception {
+    constructor() {
+        super(...arguments);
+        this.errno = 'E_DOCKER_IMAGE_PUSH';
+    }
+}

@@ -0,0 +1,12 @@
+import { Exception } from '@lakutata/core';
+/**
+ * Thrown when the daemon has no network with the ID, short ID or name given: by {@link Docker.getNetwork} and
+ * {@link Docker.removeNetwork}, and by the creation of a container connected to a missing network (HTTP 404 from the
+ * daemon). Its `errno` is `E_DOCKER_NETWORK_NOT_FOUND`.
+ */
+export class DockerNetworkNotFoundException extends Exception {
+    constructor() {
+        super(...arguments);
+        this.errno = 'E_DOCKER_NETWORK_NOT_FOUND';
+    }
+}

@@ -0,0 +1,20 @@
+import { Exception } from '@lakutata/core';
+/**
+ * Thrown when the daemon refuses a request and no other exception of the component fits: a container name already used
+ * (HTTP 409), a container not running (HTTP 409), credentials refused by a registry ({@link Docker.loginRepository}),
+ * a network with containers connected, an image used by a container, an invalid parameter (HTTP 400), a failure of the
+ * daemon (HTTP 500). Its message is the daemon's, its `statusCode` the HTTP status of the daemon's answer. Its `errno`
+ * is `E_DOCKER_REQUEST`.
+ */
+export class DockerRequestException extends Exception {
+    /**
+     * Create the exception of a refused request: the component creates it, an application does not.
+     * @param statusCode The HTTP status of the daemon's answer.
+     * @param message The daemon's message.
+     */
+    constructor(statusCode, message) {
+        super(message);
+        this.errno = 'E_DOCKER_REQUEST';
+        this.statusCode = statusCode;
+    }
+}

	@@ -0,0 +1 @@
1	+ export {};

	@@ -0,0 +1 @@
1	+ export {};

	@@ -0,0 +1 @@
1	+ export {};

	@@ -0,0 +1 @@
1	+ export {};

@lakutata/docker 3.0.0-beta.0