Back to Details

kargo-cli

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Kargo CLI Skill

Kargo CLI Skill

This skill enables progressive delivery management using Kargo CLI.
该Skill支持使用Kargo CLI进行渐进式交付管理。

Environment

环境

Connection

连接信息

  • Server: 
    http://192.168.10.117:31080
  • Web UI: 
    http://192.168.10.117:31080
  • Credentials: admin / admin
  • 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:
bash
kargo login http://192.168.10.117:31080 --admin --password admin --insecure-skip-tls-verify
如果令牌过期，请重新认证：
bash
kargo login http://192.168.10.117:31080 --admin --password admin --insecure-skip-tls-verify

Project Overview

项目概览

ProjectDescription
kargo-simplex
SimplexAI main deployment pipeline
项目描述
kargo-simplex
SimplexAI主部署流水线

Stages

阶段

StageEnvironmentArgoCD AppAuto-Promote
local
K3s Localsimplex-localYes
local2
K3s Local2simplex-local2Yes
staging
AWS EKS Stagingsimplex-k2-stagingYes
prod
AWS EKS Productionsimplex-k1-prodNo (Manual)
阶段环境ArgoCD应用自动晋升
local
K3s本地环境simplex-local是
local2
K3s本地环境2simplex-local2是
staging
AWS EKS预发布环境simplex-k2-staging是
prod
AWS EKS生产环境simplex-k1-prod否（手动）

Core Concepts

核心概念

Freight

Freight

A Freight represents a collection of artifacts (container images, git commits, Helm charts) that can be promoted through stages.
Freight代表一组可在各个阶段之间晋升的工件（容器镜像、Git提交、Helm图表）。

Stage

Stage

A Stage represents an environment in the deployment pipeline. Freights are promoted from one stage to another.
Stage代表部署流水线中的一个环境。Freight可在不同Stage之间晋升。

Warehouse

Warehouse

A Warehouse monitors artifact sources (ECR, git) for new versions and creates freights automatically.
Warehouse会监控工件源（ECR、Git）的新版本，并自动创建Freight。

Common Operations

常见操作

Project Management

项目管理

bash
undefined
bash
undefined

List all projects

列出所有项目

kargo get projects
kargo get projects

Get project details

获取项目详情

kargo get project kargo-simplex
undefined
kargo get project kargo-simplex
undefined

Stage Operations

阶段操作

bash
undefined
bash
undefined

List stages in project

列出项目中的所有阶段

kargo get stages -p kargo-simplex
kargo get stages -p kargo-simplex

Get specific stage details

获取特定阶段详情

kargo get stage staging -p kargo-simplex
kargo get stage staging -p kargo-simplex

Get stage in YAML format

以YAML格式获取阶段信息

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

Freight Management

Freight管理

bash
undefined
bash
undefined

List all freights in project

列出项目中的所有Freight

kargo get freights -p kargo-simplex
kargo get freights -p kargo-simplex

Get freight details

获取Freight详情

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

List freights verified for a stage

列出在某阶段已验证的Freight

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

List freights approved for a stage

列出已批准进入某阶段的Freight

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

Promotion Operations

晋升操作

bash
undefined
bash
undefined

Promote freight to stage

将Freight晋升至指定阶段

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

Promote latest available freight

晋升最新可用的Freight

kargo promote --stage staging -p kargo-simplex
kargo promote --stage staging -p kargo-simplex

Promote to production (manual approval required)

晋升至生产环境（需要手动批准）

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

Warehouse Operations

Warehouse操作

bash
undefined
bash
undefined

List warehouses

列出所有Warehouse

kargo get warehouses -p kargo-simplex
kargo get warehouses -p kargo-simplex

Get warehouse details

获取Warehouse详情

kargo get warehouse <name> -p kargo-simplex
kargo get warehouse <name> -p kargo-simplex

Refresh warehouse (check for new artifacts)

刷新Warehouse（检查新工件）

kargo refresh warehouse <name> -p kargo-simplex
undefined
kargo refresh warehouse <name> -p kargo-simplex
undefined

Approval Operations

批准操作

bash
undefined
bash
undefined

Approve freight for stage

批准Freight进入指定阶段

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

Deployment Pipeline Flow

部署流水线流程

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

Typical Workflow

典型工作流

  1. New image pushed to ECR → Warehouse detects
  2. Freight created automatically
  3. Local stage auto-promotes and deploys
  4. Staging stage auto-promotes after local success
  5. Production stage requires manual promotion
  1. 新镜像推送至ECR → Warehouse检测到
  2. 自动创建Freight
  3. Local阶段自动晋升并部署
  4. Staging阶段在Local成功后自动晋升
  5. Production阶段需要手动晋升

Status Interpretation

状态说明

Stage Status

阶段状态

StatusMeaning
Healthy
Stage has current freight and is healthy
Progressing
Freight is being promoted/verified
Unhealthy
Promotion failed or ArgoCD sync failed
状态含义
Healthy
阶段拥有当前Freight且状态健康
Progressing
Freight正在晋升/验证中
Unhealthy
晋升失败或ArgoCD同步失败

Freight Status

Freight状态

FieldMeaning
verified
Freight has been tested in a stage
approved
Freight is approved for promotion to next stage
字段含义
verified
Freight已在某阶段完成测试
approved
Freight已批准晋升至下一阶段

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  │
└──────────┴─────────────────────────┴───────────┴─────────────────┘
🚀 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

未创建Freight

  1. Check warehouse status: 
    kargo get warehouses -p kargo-simplex
  2. Refresh warehouse: 
    kargo refresh warehouse <name> -p kargo-simplex
  3. Verify ECR credentials are valid
  4. Check warehouse subscriptions match ECR repositories
  1. 检查Warehouse状态：
    kargo get warehouses -p kargo-simplex
  2. 刷新Warehouse：
    kargo refresh warehouse <name> -p kargo-simplex
  3. 验证ECR凭证是否有效
  4. 检查Warehouse订阅是否匹配ECR仓库

Stage Not Promoting

阶段未自动晋升

  1. Check stage status: 
    kargo get stage <name> -p kargo-simplex
  2. Check if freight is verified in previous stage
  3. Check ArgoCD application sync status
  4. For prod: verify freight is approved
  1. 检查阶段状态：
    kargo get stage <name> -p kargo-simplex
  2. 检查Freight是否在前一阶段已验证
  3. 检查ArgoCD应用同步状态
  4. 针对生产环境：验证Freight是否已获得批准

Authentication Expired

认证过期

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

Integration with ArgoCD

与ArgoCD的集成

Kargo updates ArgoCD applications by:
  1. Modifying 
    kustomization.yaml
    image tags in git
  2. Committing changes to the GitOps repository
  3. 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.
Kargo通过以下方式更新ArgoCD应用：
  1. 修改Git中的
    kustomization.yaml
    镜像标签
  2. 将变更提交至GitOps仓库
  3. ArgoCD检测到变更并执行同步
关键集成点：
  • Warehouse监控的ECR与ArgoCD应用一致
  • 阶段晋升任务会更新Git覆盖配置
  • ArgoCD应用带有
    kargo.akuity.io/authorized-stage
    注解
如需应用同步和状态相关操作，请使用ArgoCD CLI Skill。