anatools.anaclient.channels module

Channels Functions

build_managed_channel(self, channelfile, enforce_size_limit=True)

Build the Docker image of a channel.

Parameters:

  • channelfile (str) – The channel file for the channel to build.

  • enforce_size_limit (bool) – Flag that controls the size of the Docker Image and will block the build if larger than 7.5GB. Set this to False if the channel will be larger than 7.5GB.

Returns:

A boolean that indicates if the channel Docker image was successfully built.

Return type:

bool

create_managed_channel(self, name, description=None, organizationId=None, volumes=[], instance='p2.xlarge', timeout=120, interfaceVersion=1)

Create a managed channel for your organization.

Parameters:

  • name (str) – Channel name.

  • description (str) – Description of the channel

  • organizationId (str) – Organization ID. Defaults to current if not specified.

  • volumes (list[str]) – List of the data volume names to associate with this channel.

  • instance (str) – AWS Instance type.

  • timeout (int) – Maximum runtime of a channel run.

  • interface (int) – The ana interface version number.

Returns:

channel data

Return type:

list[dict]

delete_managed_channel(self, channelId)

Delete a managed channel of your organization.

Parameters:

channelId (str) – Id of channel to delete.

Returns:

Status

Return type:

str

deploy_managed_channel(self, channelId=None, channelfile=None, image=None, enforce_size_limit=True)

Deploy the Docker image of a channel.

Parameters:

  • channelId (str) – Channel ID that you are pushing the image to. If the channelId isn’t specified, it will use the image name to lookup the channelId.

  • channelfile (str) – Name of the channel file to look for.

  • image (str) – The Docker image name. This should match the channel name when running ana. If image is not specified, it will use the channel name for the channelId.

  • enforce_size_limit (bool) – Flag that controls the size of the Docker Image and will block the build if larger than 7.5GB. Set this to False if the channel will be larger than 7.5GB.

Returns:

deploymentId for current round of deployment or an error message if something went wrong

Return type:

str

edit_managed_channel(self, channelId, name=None, description=None, volumes=None, instance=None, timeout=None, status=None, interfaceVersion=None)

Edit a managed channel for your organization.

Parameters:

  • channelId (str) – ChannelId ID of the channel to edit.

  • name (name) – The new name to give the channel.

  • description (str) – Description of the channel

  • volumes (list[str]) – Data volumes for the channel.

  • instance (str) – Instance type to run the channel on.

  • timeout (int) – Maximum runtime for the channel run.

  • status (str) – The status of the channel.

  • interface (int) – The ana interface version number.

Returns:

If true, the channel was successfully edited.

Return type:

bool

get_channel_documentation(self, channelId, localDir=None)

Downloads a markdown file for channel documentation.

Parameters:

  • channelID (str) – The channelId of the channel

  • localDir (str) – The location to download the file to.

Returns:

The list of filenames downloaded.

Return type:

list[str]

get_channels(self, organizationId=None, workspaceId=None, channelId=None)

Shows all channels available to the user. Can filter by organizationId, workspaceId, or channelId.

Parameters:

  • organizationId (str) – Filter channel list on what’s available to the organization.

  • workspaceId (str) – Filter channel list on what’s available to the workspace.

  • channelId (str) – Filter channel list on the specific channelId.

Returns:

List of channels associated with user, workspace, organization or channelId.

Return type:

list[dict]

get_deployment_status(self, deploymentId, stream=False)

Retrieves status for a channel’s deployment.

Parameters:

  • deploymentId (str) – The deploymentId to retrieve status for

  • stream (bool) – Flag to print information to the terminal so the user can avoid constant polling to retrieve status.

Returns:

Deployment status.

Return type:

list[dict]

get_managed_channels(self, channelId=None, organizationId=None)

Get information for all managed channels that you own within your organization.

Parameters:

  • channelId (str) – Channel Id to filter.

  • organizationId (str) – Organization ID. Defaults to current if not specified.

Returns:

channel data

Return type:

list[dict]

upload_channel_documentation(self, channelId, mdfile)

Uploads a markdown file for channel documentation.

Parameters:

  • channelID (str) – The channelId of the channel

  • mdfile (str) – The filepath of the markdown file used for channel documentation.

Returns:

Success/Failure of channel documenation upload.

Return type:

bool