Tool

Connect agents and people to databases, servers, APIs, and Kubernetes.

A Tool connects agents and CLI users to an external system. Industric supplies connection details when needed; credentials stay in the cluster.

Overview

Set the host, port, database, credentials, and TLS options.
Run queries or commands through agents or exo tool connect/exec.
Set optional database or tool permissions with spec.permissions.

Declare a Tool

The Tools page with the add-a-tool guide and per-integration YAML samples — Store credentials in a Secret, apply the Tool, then sync. Start with an integration's YAML sample.

tool-postgres.yaml· yaml

1apiVersion: v1
2kind: Secret
3metadata:
4  name: analytics-pg-creds
5type: Opaque
6stringData:
7  password: REPLACE_ME
8---
9apiVersion: autonomic.sh/v1alpha1
10kind: Tool
11metadata:
12  name: analytics-postgres
13spec:
14  type: postgres
15  description: "Analytics Postgres read-replica"
16  tags:
17    - databases
18    - postgres
19    - readonly
20  probe: true
21  config:
22    hostname: pg-analytics.prod.internal
23    port: 5432
24    username: autonomic_ro
25    databaseName: analytics
26    sslMode: require
27    credentialsRef:
28      name: analytics-pg-creds
29      key: password

Integration types

Common values for spec.type include:

spec.type· text

1ssh           postgres    mysql       mariadb     sqlserver   mongodb
2redis         clickhouse  kubernetes  http        git         github
3snowflake     bigquery    elasticsearch kafka     oracle      cockroachdb
4yugabytedb    redshift    rabbitmq    aws         gcp         azure
5custom

Managed variants include mongodb_atlas, documentdb, elasticache, and the *_aws_secrets_manager types. See examples in autonomic/samples/tool-*.yaml, including tool-custom.yaml for your own image.

Config & credentials

Set connection details in spec.config and link credentials with credentialsRef. Set spec.probe: true to test the connection before marking the tool Ready. Custom tools use their own container image.