`agentkit build`命令用于将您的Agent代码打包成Docker镜像，为部署做准备。 ## 注意事项 ### **Local模式** * 确保Docker已安装并运行。 * Docker daemon可正常访问。 ### **Cloud模式** * 已设置AK/SK环境变量。 * 确保网络能访问火山引擎。 ### **Docker构建自定义** * 构建脚本的路径，请填写相对于项目根目录的相对路径。 * 脚本会自动获得执行权限。 * 构建脚本不存在会记录警告但不会中断构建。 * Dockerfile自动生成，配置变化时自动更新。 * 旧版本Dockerfile会备份到`.agentkit/dockerfile_backups/`。 * 删除Dockerfile元数据头后不再自动管理。 :::tip 构建信息会自动更新到配置文件，供deploy命令使用。 ::: ## 使用方法 ```Bash agentkit build [选项] ``` ## 参数说明 `--config-file`：配置文件路径。 * 指定配置文件位置。 * 默认：`agentkit.yaml`。 `--platform`：构建平台。 * 指定目标平台架构。 * 默认：`auto`（自动识别）。 * 一般不需要手动设置。 `--regenerate-dockerfile`：强制重新生成Dockerfile。 * 强制重新生成Dockerfile，即使已存在。 * 适用场景：配置更新后需要强制刷新Dockerfile。 * 默认：`False`。 ## Docker构建自定义配置 AgentKit支持通过`docker_build`配置段自定义Docker镜像构建过程。在`agentkit.yaml`中添加以下配置： ### 配置参数 **`base_image`** **：自定义基础镜像** Python项目（字符串格式）： ```YAML docker_build: base_image: "python:3.12-slim" # 或使用 Alpine 镜像 base_image: "python:3.12-alpine" ``` **`build_script`** **：自定义构建脚本** * 路径相对于项目根目录。 * 用于安装系统依赖、编译扩展等。 * 脚本会在构建过程中自动执行。 ```YAML docker_build: build_script: "scripts/setup.sh" ``` ### 完整配置示例 #### **Python项目示例：** ```YAML agent_name: my-agent entry_point: agent.py language: Python language_version: "3.12" dependencies_file: requirements.txt launch_type: local # Docker 构建自定义配置 docker_build: base_image: "python:3.12-alpine" build_script: "scripts/setup.sh" ``` #### **构建脚本示例(** **`scripts/setup.sh`** **)：** ```Bash #!/bin/bash # 安装系统依赖 apt-get update && apt-get install -y gcc g++ libpq-dev # 或 Alpine 系统使用：apk add --no-cache gcc musl-dev postgresql-dev echo "Custom build script completed" ``` ### 使用场景 |**场景** |**配置方式** |**示例** | |---|---|---| |使用轻量级镜像 |指Alpine基础镜像 |`base_image: "python:3.12-alpine"` | |安装系统依赖 |编写构建脚本 |`build_script: "scripts/install_deps.sh"` | |编译C扩展 |安装编译工具 |在脚本中安装gcc、g++等 | |配置证书 |更新CA证书 |在脚本中运行`update-ca-certificates` | |多阶段构建 |分别指定builder和runtime |仅Golang项目支持 | ### Dockerfile自动管理 * Dockerfile会根据配置**自动生成**，包含元数据头。 * 配置变化时自动更新（旧版本备份到`.agentkit/dockerfile_backups/`）。 * 删除元数据头后，AgentKit不再自动管理该文件。 * 使用`--regenerate-dockerfile`强制重新生成。元数据头示例： ```Dockerfile # ============================================================================ # AUTO-GENERATED by AgentKit v1.x.x # ============================================================================ # Source: agentkit.yaml # Checksum: sha256:... # Generated: 2025-01-17T10:30:00 # # This file is automatically generated and managed by AgentKit: # - It will be auto-updated when agentkit.yaml config changes # - To fully customize, remove this header comment # ============================================================================ ``` ## 构建过程根据配置的`launch_type`自动选择构建方式： ### Local模式（本地构建）在本地用Docker构建： ```Plain Text 🔨 开始构建本地镜像... [1/3] 生成 Dockerfile... [2/3] Docker 构建镜像... [3/3] 验证镜像可用性... ✅ 构建成功: my-agent:latest ``` > 预计耗时：1～3分钟。 ### Cloud模式（云端构建）在火山引擎上自动构建： ```Plain Text 🔨 开始云端构建... [1/6] 生成 Dockerfile... [2/6] 打包项目代码... [3/6] 上传到对象存储... [4/6] 准备镜像仓库... [5/6] 创建构建流水线... [6/6] 执行构建任务... ✅ 构建成功: xxx.cr.volces.com/agentkit/my-agent:latest ``` > 预计耗时：3～5分钟。 ## 构建结果 * **镜像名称**：`{agent_name}:{image_tag}` * **镜像信息**：自动保存到配置文件 * **构建记录**：包含时间戳、镜像 ID 等 ## 使用示例 ```Bash # 示例 1：使用默认配置 agentkit build # 示例 2：指定配置文件 agentkit build --config-file ./prod.yaml # 示例 3：强制重新生成 Dockerfile agentkit build --regenerate-dockerfile # 示例 4：配置更新后强制刷新 agentkit build --config-file ./prod.yaml --regenerate-dockerfile ``` ### 自定义构建示例 #### **示例1:使用Alpine基础镜像** 1. 修改`agentkit.yaml`。 ```YAML docker_build: base_image: "python:3.12-alpine" build_script: "scripts/alpine-setup.sh" ``` 2. 创建`scripts/alpine-setup.sh`。 ```Bash #!/bin/sh apk add --no-cache gcc musl-dev postgresql-dev ``` 3. 构建。 ```Bash agentkit build ``` #### **示例2：安装系统依赖（C扩展）** 1. 修改`agentkit.yaml`。 ```Bash docker_build: build_script: "scripts/install-deps.sh" ``` 2. 创建`scripts/install-deps.sh`。 ```Bash #!/bin/bash apt-get update && apt-get install -y \ gcc g++ \ libpq-dev \ libxml2-dev \ libxslt1-dev ``` 3. 构建。 ```Bash agentkit build ``` #### **示例3：Golang多阶段构建** 1. 修改`agentkit.yaml`。 ```Bash docker_build: base_image: builder: "golang:1.24-alpine" runtime: "alpine:3.19" build_script: "scripts/install-certs.sh" ``` 2. 构建。 ```Bash agentkit build ```