pentest-distro-builder/filesystem/etc/skel/.vscode/extensions/peterjausovec.vscode-docker-0.3.1/docs/api.md

2 KiB

Azure Docker API (Preview)

The following extension commands are supported for programmatic use. If a parameter is not specified, the user will be prompted for the value. You must list 'PeterJausovec.vscode-docker' under the 'extensionDependencies' section of your package.json to ensure these apis are available to your extension. (Note: the publisher will soon be changing, and although we will attempt to keep this change from affecting dependents, it would be good to contact us if you are using this API so we can inform you of the change.)

NOTE: The docker extension is still in preview and the APIs are subject to change.

Commands:

Configure (Add Docker Files to Workspace)

Command ID: vscode-docker.api.configure

Parameters

Name Type Description
options ConfigureApiOptions Options for the command

Where ConfigureApiOptions and related types are defined as follows:

interface ConfigureApiOptions {
    /**
     * Root folder from which to search for .csproj, package.json, .pom or .gradle files
     */
    rootPath: string;

    /**
     * Output folder for the docker files. This should normally be the same as rootPath or a descendent of it.
     */
    outputFolder: string;

    /**
     * Platform (optional)
     */
    platform?: Platform;

    /**
     * Port to expose (optional)
     */
    port?: string;

    /**
     * The OS for the images (optional). Currently only used for .NET platforms.
     */
    os?: OS;
}

type OS = 'Windows' | 'Linux';

export type Platform =
    'Go' |
    'Java' |
    '.NET Core Console' |
    'ASP.NET Core' |
    'Node.js' |
    'Python' |
    'Ruby' |
    'Other';

Example Usage

await vscode.commands.executeCommand('vscode-docker.api.configure', {
    // (Platform and OS [if needed] will be
    // requested from the user, since they
    // aren't specified)
    rootPath: '/src/myproject',
    outputFolder: '/src/myproject/service1',
    port: '8001'
});