Skip to main content

Class: DockerContainersDataSource

dg.DockerContainersDataSource

Functionality to work with Docker containers. See help: https://datagrok.ai/help/develop/how-to/docker_containers.

Hierarchy

Constructors

constructor

new DockerContainersDataSource(s)

Parameters

NameType
sany

Overrides

HttpDataSource.constructor

Defined in

src/dapi.ts:890

Properties

clsName

clsName: string

Inherited from

HttpDataSource.clsName

Defined in

src/dapi.ts:249


dart

dart: any

Inherited from

HttpDataSource.dart

Defined in

src/dapi.ts:248

Methods

allPackageVersions

allPackageVersions(): HttpDataSource<DockerContainer>

Turns off package versions isolation. This DataSource will return all entities in all versions, not only the current one *

Returns

HttpDataSource<DockerContainer>

Inherited from

HttpDataSource.allPackageVersions

Defined in

src/dapi.ts:305


by

by(i): HttpDataSource<DockerContainer>

Parameters

NameType
inumber

Returns

HttpDataSource<DockerContainer>

Inherited from

HttpDataSource.by

Defined in

src/dapi.ts:310


count

count(): Promise<number>

Counts entities that satisfy the filtering criteria (see filter). See examples: https://public.datagrok.ai/js/samples/dapi/projects-list Smart filter: https://datagrok.ai/help/datagrok/smart-search

Returns

Promise<number>

Inherited from

HttpDataSource.count

Defined in

src/dapi.ts:275


delete

delete(e): Promise<void>

Deletes an entity.

Parameters

NameType
eEntity

Returns

Promise<void>

Inherited from

HttpDataSource.delete

Defined in

src/dapi.ts:300


fetchProxy

fetchProxy(containerId, path, params?): Promise<Response>

Proxies URL requests to docker containers via Datagrok server with the same interface as fetch. Returns response from the containers as it is. If an error occurs on the server side returns a response with "application/json" Content-Type and JSON body with field "datagrok-error" that describes the cause. If container status is incorrect for performing requests returns a response with a 400 status code. If something goes wrong in the server workflow, it returns a response with a 500 status code. Any other cases are the result of direct requests to the container itself.

Parameters

NameTypeDescription
containerIdstringID of the DockerContainer to which the http request should be sent.
pathstringURI without scheme and authority component.
params?RequestInitparameters of the request.

Returns

Promise<Response>

Defined in

src/dapi.ts:927


filter

filter(w): HttpDataSource<DockerContainer>

Applies filter to current request. Also can be set with list method "options" parameter See example: https://public.datagrok.ai/js/samples/dapi/projects-list Smart filter: https://datagrok.ai/help/datagrok/smart-search

Parameters

NameType
wstring

Returns

HttpDataSource<DockerContainer>

Inherited from

HttpDataSource.filter

Defined in

src/dapi.ts:336


find

find(id): Promise<DockerContainer>

Returns an entity with the specified id. Throws an exception if an entity does not exist, or is not accessible in the current context. Sample: https://public.datagrok.ai/js/samples/data-access/save-and-load-df

Parameters

NameTypeDescription
idstringGUID of the corresponding object

Returns

Promise<DockerContainer>

{Promise<object>} - entity.

Inherited from

HttpDataSource.find

Defined in

src/dapi.ts:290


first

first(): Promise<DockerContainer>

Returns fist entity that satisfies the filtering criteria (see filter).

Returns

Promise<DockerContainer>

Promise<object>

Inherited from

HttpDataSource.first

Defined in

src/dapi.ts:281


getContainerLogs

getContainerLogs(containerId, limit?): Promise<null | string>

Returns container's logs or throws Exception with the cause.

Parameters

NameTypeDefault valueDescription
containerIdstringundefinedID of the DockerContainer whose logs is to be obtained.
limitnumber10000maximum line count of logs.

Returns

Promise<null | string>

string - container logs or null if there are no logs.

Defined in

src/dapi.ts:948


include

include(include): HttpDataSource<DockerContainer>

Includes entity in the result

Parameters

NameType
includestring

Returns

HttpDataSource<DockerContainer>

Inherited from

HttpDataSource.include

Defined in

src/dapi.ts:353


list

list(options?): Promise<DockerContainer[]>

Returns all entities that satisfy the filtering criteria (see filter). See examples: https://public.datagrok.ai/js/samples/dapi/projects-list Smart filter: https://datagrok.ai/help/datagrok/smart-search

Parameters

NameType
optionsObject
options.filter?string
options.order?string
options.pageNumber?number
options.pageSize?number

Returns

Promise<DockerContainer[]>

Inherited from

HttpDataSource.list

Defined in

src/dapi.ts:260


nextPage

nextPage(): HttpDataSource<DockerContainer>

Returns next page of all entities that satisfy the filtering criteria (see filter). Works only if pageSize was set during previous list() call See examples: https://public.datagrok.ai/js/samples/dapi/projects-list

Returns

HttpDataSource<DockerContainer>

Inherited from

HttpDataSource.nextPage

Defined in

src/dapi.ts:325


order

order(fieldName, desc?): HttpDataSource<DockerContainer>

Instructs data source to return results in the specified order.

Parameters

NameTypeDefault value
fieldNamestringundefined
descbooleanfalse

Returns

HttpDataSource<DockerContainer>

Inherited from

HttpDataSource.order

Defined in

src/dapi.ts:345


page

page(i): HttpDataSource<DockerContainer>

Restricts results to the specified page number. See also nextPage.

Parameters

NameType
inumber

Returns

HttpDataSource<DockerContainer>

Inherited from

HttpDataSource.page

Defined in

src/dapi.ts:316


request

request(id, path, params): Promise<null | string>

Deprecated

The method will be removed soon. Use fetchProxy.

Parameters

NameType
idstring
pathstring
paramsResponseInit

Returns

Promise<null | string>

Defined in

src/dapi.ts:938


run

run(containerId, awaitStart?): Promise<void>

Runs container.

Parameters

NameTypeDefault valueDescription
containerIdstringundefinedID of the DockerContainer to be run.
awaitStartbooleanfalseif [true] promise will not be resolved until the container is started, otherwise, it doesn't wait for start and resolves immediately after the container is queued for start.

Returns

Promise<void>

  • promise that resolves with void or throws Exception if something went wrong.

Defined in

src/dapi.ts:901


save

save(e): Promise<DockerContainer>

Saves an entity.

Parameters

NameType
eEntity

Returns

Promise<DockerContainer>

Inherited from

HttpDataSource.save

Defined in

src/dapi.ts:295


stop

stop(containerId, awaitStop?): Promise<void>

Stops container.

Parameters

NameTypeDefault valueDescription
containerIdstringundefinedID of the DockerContainer to be stopped.
awaitStopbooleanfalseif [true] promise will not be resolved until the container is stopped, otherwise, it doesn't wait for a stop and resolves immediately after the container is queued for a stop.

Returns

Promise<void>

or throws Exception if something went wrong.

Defined in

src/dapi.ts:912