environment search
Usage
tecton environment search [OPTIONS]
Description
Search environments by their resolved requirements. This command helps you find environments containing specific packages and versions, which is useful for:
- Finding libraries with security issues
- Determining which environments support certain pipelines/transformations
- Environment management and auditing
Options
| Flag | Description |
|---|---|
-p, --package | Required. Package name to search for (exact match) |
-v, --version | Version constraint (e.g., '1.2.3', '<2.0.0', '>=1.5,<2.0'). If not specified, any version matches |
Examples
Search for environments containing pandas with any version:
tecton environment search --package pandas
Search for environments containing pandas with version >= 1.0 and < 2.0:
tecton environment search --package pandas --version ">=1.0,<2.0"
Search for environments containing protobuf with version > 6:
tecton environment search --package protobuf --version '>6'
Search for environments containing a specific version:
tecton environment search --package requests --version "2.32.4"
Output
The command displays results in a formatted table showing:
- Id: Environment ID
- Name: Environment name
- Type: Environment type (CORE or CUSTOM)
- Status: Environment status (READY, etc.)
- Created At: When the environment was created
- Matched Packages: The specific package versions that matched your search criteria
Example output:
🔍 Found 6 environment(s) matching the search criteria:
+----------------------------------+-----------------------------+--------+--------+-------------------------+------------------+
│ Id │ Name │ Type │ Status │ Created At │ Matched Packages │
+----------------------------------+-----------------------------+--------+--------+-------------------------+------------------+
│ e755fb18290995b5adef0b58174b1dd3 │ latest-tecton-runtime │ CUSTOM │ READY │ 2025-06-12 17:59:22 UTC │ protobuf==6.31.1 │
│ 225bf185a8767e7515ad05095c259f65 │ loadshedding-tecton-runtime │ CUSTOM │ READY │ 2025-06-12 18:01:01 UTC │ protobuf==6.31.1 │
│ fcc11c79a44c4db4b9c6d6e94c5a491d │ tecton-core-1.0.36 │ CORE │ READY │ 2025-07-24 19:18:14 UTC │ protobuf==6.31.1 │
+----------------------------------+-----------------------------+--------+--------+-------------------------+------------------+