SSP Setup and Prerequisites
Before you can create a self-service Tetra Data Pipeline (SSP), you must do the following:
- Initialize the TetraScience Software Development Kit (SDK) 2.0 environment.
- Configure Tetra Data Platform (TDP) dependencies and authentication.
Initialize the TetraScience SDK 2.0 Environment
IMPORTANT
Keep in mind the following:
- Python is the only supported programming language that you can use to write SSPs. We recommend using
pyenv
if you have to work with multiple versions on the same machine.- You can choose which Python version a task script uses by adding a
"runtime"
parameter to the script'sconfig.json
file. Python versions 3.7, 3.8, 3.9, 3.10, and 3.11 are supported currently. For more information, see config.json Files.- The following procedure shows how to initialize the TetraScience SDK in a single, basic Python development environment. It's recommended that you use a Python package manager, such as pipx or uv, to initialize the SDK in more complex development environments.
To initialize the TetraScience SDK 2.0, do the following:
-
Install Python (versions 3.7 through 3.11 are supported currently)
-
Install the
poetry
package by running the following command:pip3 install poetry
-
Install the
poetry-plugin-export
package by running the following command:poetry self add poetry-plugin-export
-
Install the
tetrascience-cli
package by running the following command:pip3 install tetrascience-cli
-
Verify the installation was successful by running the following command:
ts-cli --help
Configure TDP Dependencies and Authentication
To configure the required TDP dependencies and authentication credentials, do the following:
- Sign in to the TDP as an admin user.
- Create a Service User account with admin access on the Organization Settings page in your profile (or use an existing one).
- Create a JSON Web Token (JWT) for the Service User that you've selected.
- Create an
auth.json
file (you can select a different name) at any location you want. You can also download this file from the previous step by selecting the Download ts-sdk config button on the token creation dialog. You will use this file later in thets-cli publish
command by adding-c path/to/auth.json
to the command line.
Example auth.json
File
{
"api_url":"<TDP API endpoint base URL>",
"auth_token":"<service token you generated>",
"org":"<your organization slug name>",
"ignore_ssl": <true to allow invalid SSL certificates>
}
Documentation Feedback
Do you have questions about our documentation or suggestions for how we can improve it? Start a discussion in TetraConnect Hub. For access, see Access the TetraConnect Hub.
NOTE
Feedback isn't part of the official TetraScience product documentation. TetraScience doesn't warrant or make any guarantees about the feedback provided, including its accuracy, relevance, or reliability. All feedback is subject to the terms set forth in the TetraConnect Hub Community Guidelines.
Updated 2 days ago