Kargo CLI Skill

This skill enables progressive delivery management using Kargo CLI.

Environment

Connection

• Server: http://192.168.10.117:31080

• Web UI: http://192.168.10.117:31080

• Credentials: admin / admin

Login Command

If token expires, re-authenticate:

kargo login http://192.168.10.117:31080 --admin --password admin --insecure-skip-tls-verify

Project Overview

Project Description

kargo-simplex

SimplexAI main deployment pipeline

Stages

Stage Environment ArgoCD App Auto-Promote

local

K3s Local simplex-local Yes

local2

K3s Local2 simplex-local2 Yes

staging

AWS EKS Staging simplex-k2-staging Yes

prod

AWS EKS Production simplex-k1-prod No (Manual)

Core Concepts

Freight

A Freight represents a collection of artifacts (container images, git commits, Helm charts) that can be promoted through stages.

Stage

A Stage represents an environment in the deployment pipeline. Freights are promoted from one stage to another.

Warehouse

A Warehouse monitors artifact sources (ECR, git) for new versions and creates freights automatically.

Common Operations

Project Management

List all projects

kargo get projects

Get project details

kargo get project kargo-simplex

Stage Operations

List stages in project

kargo get stages -p kargo-simplex

Get specific stage details

kargo get stage staging -p kargo-simplex

Get stage in YAML format

kargo get stage staging -p kargo-simplex -o yaml

Freight Management

List all freights in project

kargo get freights -p kargo-simplex

Get freight details

kargo get freight <freight-id> -p kargo-simplex

List freights verified for a stage

kargo get freights -p kargo-simplex --verified-in staging

List freights approved for a stage

kargo get freights -p kargo-simplex --approved-for prod

Promotion Operations

Promote freight to stage

kargo promote --stage staging -p kargo-simplex --freight <freight-id>

Promote latest available freight

kargo promote --stage staging -p kargo-simplex

Promote to production (manual approval required)

kargo promote --stage prod -p kargo-simplex --freight <freight-id>

Warehouse Operations

List warehouses

kargo get warehouses -p kargo-simplex

Get warehouse details

kargo get warehouse <name> -p kargo-simplex

Refresh warehouse (check for new artifacts)

kargo refresh warehouse <name> -p kargo-simplex

Approval Operations

Approve freight for stage

kargo approve --stage prod -p kargo-simplex --freight <freight-id>

Deployment Pipeline Flow

┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ Warehouse │────▶│ local │────▶│ staging │────▶│ prod │ │ (ECR Watch) │ │ (Auto) │ │ (Auto) │ │ (Manual) │ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │ │ │ │ ▼ ▼ ▼ ▼ New Image K3s Local AWS Staging AWS Prod Detected Deployed Deployed Deployed

Typical Workflow

• New image pushed to ECR → Warehouse detects

• Freight created automatically

• Local stage auto-promotes and deploys

• Staging stage auto-promotes after local success

• Production stage requires manual promotion

Status Interpretation

Stage Status

Status Meaning

Healthy

Stage has current freight and is healthy

Progressing

Freight is being promoted/verified

Unhealthy

Promotion failed or ArgoCD sync failed

Freight Status

Field Meaning

verified

Freight has been tested in a stage

approved

Freight is approved for promotion to next stage

Output Formatting

Pipeline Status Summary

🚀 Kargo Pipeline Status (kargo-simplex)

┌──────────┬─────────────────────────┬───────────┬─────────────────┐ │ Stage │ Current Freight │ Health │ Status │ ├──────────┼─────────────────────────┼───────────┼─────────────────┤ │ local │ 719578f13844... │ Healthy │ Verified │ │ staging │ 719578f13844... │ Healthy │ Verified │ │ prod │ (pending) │ - │ Awaiting Promo │ └──────────┴─────────────────────────┴───────────┴─────────────────┘

Troubleshooting

Freight Not Created

• Check warehouse status: kargo get warehouses -p kargo-simplex

• Refresh warehouse: kargo refresh warehouse <name> -p kargo-simplex

• Verify ECR credentials are valid

• Check warehouse subscriptions match ECR repositories

Stage Not Promoting

• Check stage status: kargo get stage <name> -p kargo-simplex

• Check if freight is verified in previous stage

• Check ArgoCD application sync status

• For prod: verify freight is approved

Authentication Expired

kargo login http://192.168.10.117:31080 --admin --password admin --insecure-skip-tls-verify

Integration with ArgoCD

Kargo updates ArgoCD applications by:

• Modifying kustomization.yaml image tags in git

• Committing changes to the GitOps repository

• ArgoCD detects changes and syncs

Key integration points:

• Warehouse watches same ECR as ArgoCD apps

• Stage promotion tasks update git overlays

• ArgoCD apps have kargo.akuity.io/authorized-stage annotation

For application sync and status, use the ArgoCD CLI skill.