Skip to main content

Substrate

Substrate is a tool that allows you to automate the process of deploying visualization tools to different computing environments.

Supported Visualization tools

Supported Environments

Any computing environment capable of running Docker Swarm is a valid deployment target.

Requirements

This tool relies upon Docker Swarm. In order for it to work, the following assumptions are made of each compute node (for AWS deployments, these requirements are handled automatically):

  • Docker Engine must be installed.
  • The ports needed by Docker Swarm must be open for communication between nodes. Please review the Docker Swarm docs for more information.
  • You must be able to connect to each node over SSH with a private key available in ~/.ssh.

Getting Started (none of this works yet)

To install run

pip install seelabutk-substrate

then launch a visualization tool via a CLI using

substrate 'tool_name' start
substrate 'tool_name' stop

or via Python using

from substrate import Substrate

stack = Substrate('tool_name')
stack.start()
stack.stop()

Valid tool names:

  • tapestry
  • vci

Configuration

Substrate is configured using substrate.config.yaml. The tool will look for this file starting in your current working directory then look for it in parent folders. You can also provide a path with

substrate tapestry start -c /path/to/substrate.config.yaml

or

stack = Substrate('tool_name', path='path/to/substrate.config.yaml')

The options for the configuration file can be found here.

Each tool has static files that are needed to run it. Defaults are provided, but if needed or desired they can be modified. Here are links to get the default files for Tapestry and VCI.

For more information on configuring each tool, please refer to each tools documentation:

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

seelabutk-substrate-0.10.tar.gz (65.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

seelabutk_substrate-0.10-py3-none-any.whl (73.8 kB view details)

Uploaded Python 3

File details

Details for the file seelabutk-substrate-0.10.tar.gz.

File metadata

  • Download URL: seelabutk-substrate-0.10.tar.gz
  • Upload date:
  • Size: 65.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.63.0 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.8.10

File hashes

Hashes for seelabutk-substrate-0.10.tar.gz
Algorithm Hash digest
SHA256 e3c72f177956e77b885bc64dfe1dff38a4103e8c0aef24d375ff3b5348f29b21
MD5 d9a6c86331fddda99577d49791e38f60
BLAKE2b-256 25c08b5ae3c05a7a7e6a6d08aa3374ddddb5888d273438d4d05c205ccd904a26

See more details on using hashes here.

File details

Details for the file seelabutk_substrate-0.10-py3-none-any.whl.

File metadata

  • Download URL: seelabutk_substrate-0.10-py3-none-any.whl
  • Upload date:
  • Size: 73.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.63.0 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.8.10

File hashes

Hashes for seelabutk_substrate-0.10-py3-none-any.whl
Algorithm Hash digest
SHA256 33f4e7cf34532b17a9e3eff313759fde454007a780a1cd9259991048e175262d
MD5 21f54a4208750219fa2e2b36be9eada6
BLAKE2b-256 28b9ccbc8b39e0e90d83583e64ecfeb47f3698318f7530b688f3c1912df9ede5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page