Install Commands

Commands for deploying agents into workspaces.

Commands

sekuire install token — Create an install token
sekuire install bundle — Generate Helm chart for BYOC
sekuire install agent — Install agent into workspace

token

Create a workspace-scoped install token for an agent.

bash

sekuire install token [OPTIONS]

Options

Option	Description
`--workspace <ID>`	Workspace ID (defaults to config)
`--agent <ID>`	Agent ID (defaults to manifest hash)
`--backend <URL>`	Backend URL (default: http://localhost:5556)
`--ttl-minutes <MIN>`	Token TTL in minutes

Example

Terminalbash

$ sekuire install token --workspace ws_abc123
✅ Install token created
   Workspace: ws_abc123
   Agent ID:  7f8a9b3c...
   Token:     it_abc123xyz...
   Expires:   2024-01-15T12:00:00Z

Use Cases

CI/CD pipelines — Create tokens for automated deployments
Kubernetes — Pass to bootstrap sidecar
On-premises — Install into private workspaces

bundle

Generate a Helm chart for Bring Your Own Cluster (BYOC) deployments.

bash

sekuire install bundle [OPTIONS]

Options

Option	Description
`--workspace <ID>`	Workspace ID (required)
`--agent <ID>`	Agent ID (defaults to manifest hash)
`--backend <URL>`	Backend URL (default: http://localhost:5556)
`--output <DIR>`	Output directory (default: deploy/helm)
`--image <REF>`	Container image (defaults to deployment.docker_image)
`--install-token <TOKEN>`	Pre-generated install token
`--namespace <NS>`	Kubernetes namespace (default: default)
`--service-port <PORT>`	Service port (default: 80)
`--container-port <PORT>`	Container port (default: 8000)

Example

Terminalbash

$ sekuire install bundle --workspace ws_abc123 --image myrepo/agent:v1.0.0
✅ Helm install bundle generated
   Chart directory: deploy/helm/my-agent-helm
   Agent ID:        7f8a9b3c...
   Workspace ID:    ws_abc123
   Install token:   it_abc123xyz...

Generated Files

deploy/helm/my-agent-helm/text

deploy/helm/my-agent-helm/
├── Chart.yaml
├── values.yaml          # Edit secrets before deploying
├── README.md
└── templates/
    ├── _helpers.tpl
    ├── deployment.yaml
    ├── service.yaml
    ├── configmap.yaml
    └── secret.yaml

Deploying

Terminalbash

cd deploy/helm/my-agent-helm

# Review and edit values.yaml
vi values.yaml

# Deploy to Kubernetes
helm install my-agent . -n my-namespace

agent

Install an agent into a workspace (remote/managed deployment).

bash

sekuire install agent [OPTIONS]

Options

Option	Description
`--workspace <ID>`	Workspace ID (required)
`--agent <ID>`	Agent ID (required)
`--deployment-type <TYPE>`	Deployment type: managed, byoc (default: managed)
`-r, --registry <URL>`	Registry URL

Example

Terminalbash

$ sekuire install agent --workspace ws_abc123 --agent 7f8a9b3c...
✅ Agent installed successfully!
   Installation ID: inst_xyz789
   Status: running
   Upstream URL: http://agent.example.com/a2a/tasks

Deployment Types

Type	Description
managed	Sekuire hosts and manages the agent
byoc	Bring Your Own Cluster (you host, Sekuire orchestrates)