@softvisio/core/lib/api/docker/engine.js

Softisio core

import ContainersMixin from "#lib/api/docker/engine/containers";
import ImagesMixin from "#lib/api/docker/engine/images";
import ServicesMixin from "#lib/api/docker/engine/services";
import SystemMixin from "#lib/api/docker/engine/system";
import fetch from "#lib/fetch";
import mixins from "#lib/mixins";
import { pipeline } from "#lib/stream";
import * as jsonStream from "#lib/stream/json";

// NOTE https://docs.docker.com/engine/api/latest/

const API_VERSION = "1.46",
    DEFAULT_SOCKET_PATH = "/var/run/docker.sock",
    DISPATCHER = new fetch.Dispatcher( {
        "connect": {
            "socketPath": DEFAULT_SOCKET_PATH,
        },
    } );

export default class DockerEngine extends mixins( ContainersMixin, ImagesMixin, ServicesMixin, SystemMixin ) {

    // protected
    async _getImageAuth ( image, credentials ) {
        if ( typeof credentials === "function" ) {
            credentials = await credentials();
        }

        const domain = image.split( "/" )[ 0 ];

        return credentials[ domain ] || credentials[ "https://index.docker.io/v1/" ];
    }

    async _doRequest ( method, path, { stream, signal, params, body, registryAuth, registryConfig } = {} ) {
        const url = new URL( "http://local/v" + API_VERSION + "/" + path );

        if ( params ) {
            for ( const name in params ) {
                if ( params[ name ] === undefined ) continue;

                if ( typeof params[ name ] === "object" ) {
                    url.searchParams.set( name, JSON.stringify( params[ name ] ) );
                }
                else {
                    url.searchParams.set( name, params[ name ] );
                }
            }
        }

        var headers = {};

        if ( registryAuth ) {
            headers[ "x-registry-auth" ] = Buffer.from( JSON.stringify( registryAuth ) ).toString( "base64" );
        }

        if ( registryConfig ) {
            headers[ "x-registry-config" ] = Buffer.from( JSON.stringify( registryConfig ) ).toString( "base64" );
        }

        const res = await fetch( url, {
            method,
            headers,
            body,
            "dispatcher": DISPATCHER,
            "bodyTimeout": stream
                ? 0
                : null,
            signal,
        } );

        var data;

        if ( res.ok ) {

            // stream
            if ( stream ) {
                const jsonStreamParse = new jsonStream.Parse();

                pipeline( res.body, jsonStreamParse, () => {} );

                return result( 200, jsonStreamParse );
            }

            // json data
            else {
                try {
                    data = await res.json();
                }
                catch ( e ) {
                    return result.catch( e );
                }

                return result( 200, data );
            }
        }

        // error
        else {
            try {
                data = await res.json();
            }
            catch ( e ) {
                return result.catch( e );
            }

            return result( [ res.status, data?.message || res.statusText ] );
        }
    }
}