#配置 ACP CLI

#Shell 补全

您可以为 Bash 或 Zsh shell 启用 Tab 补全功能。

#为 Bash 启用 Tab 补全

安装 ACP CLI (ac) 后，您可以启用 Tab 补全，在按下 Tab 键时自动完成 ac 命令或建议选项。以下操作步骤演示如何为 Bash shell 启用 Tab 补全。

#前提条件

• 您必须已安装 ACP CLI (ac)。
• 您必须已安装 bash-completion 包。

#操作步骤

1. 将 Bash 补全代码保存到文件：

   $ ac completion bash > ac_bash_completion

2. 将该文件复制到 /etc/bash_completion.d/ 目录：

   $ sudo cp ac_bash_completion /etc/bash_completion.d/

   您也可以将文件保存到本地目录，并从您的 .bashrc 文件中 source 它。

打开新终端后，Tab 补全即被启用。

#为 Zsh 启用 Tab 补全

安装 ACP CLI (ac) 后，您可以启用 Tab 补全，在按下 Tab 键时自动完成 ac 命令或建议选项。以下操作步骤演示如何为 Zsh shell 启用 Tab 补全。

#前提条件

您必须已安装 ACP CLI (ac)。

#操作步骤

要将 ac 的 Tab 补全添加到您的 .zshrc 文件，请运行以下命令：

cat >>~/.zshrc<<EOF
autoload -Uz compinit
compinit
if [[ $commands[ac] ]]; then
  source <(ac completion zsh)
  compdef _ac ac
fi
EOF

打开新终端后，Tab 补全即被启用。

#使用 ACP CLI 访问 kubeconfig

您可以使用 ACP CLI (ac) 登录 ACP 平台，并获取用于从命令行访问集群的 kubeconfig 文件。与传统的单集群 kubeconfig 导出不同，ac login 通过平台发现创建了一个全面的多集群配置。

#前提条件

您拥有 ACP 平台端点的访问权限和有效的身份验证凭证。

#操作步骤

1. 运行以下命令登录您的 ACP 平台：

   $ ac login <platform-url> --name <session-name>
   • <platform-url>：ACP 平台的基础 URL（例如 https://acp.prod.example.com）
   • <session-name>：用户自定义的该平台连接的友好名称（例如 "prod"、"staging"）

2. 登录过程会自动：

   • 与 ACP 平台进行身份验证
   • 发现平台中所有可访问的集群
   • 为所有集群创建带有 ACP 特定元数据的 kubeconfig 条目
   • 设置指向 global 集群的默认上下文

3. 若要导出配置到单独文件，运行：

   $ ac config view --raw > kubeconfig

4. 设置 KUBECONFIG 环境变量指向导出的文件：

   $ export KUBECONFIG=./kubeconfig

5. 使用 ac 与您的 ACP 集群交互：

   $ ac get nodes

#多集群配置处理

ACP CLI 登录过程创建了一个包含以下内容的综合 kubeconfig 结构：

• 多个集群条目：平台中每个可访问集群对应一个条目
• 会话元数据：平台 URL、会话名称和集群描述存储在扩展字段中
• 统一身份验证：单个用户凭证条目适用于平台中所有集群
• 智能命名：使用 acp:<session>:<cluster> 格式的无冲突命名规范

#安全注意事项

重要：导出的 kubeconfig 文件包含可访问您的 ACP 平台集群的身份验证令牌。

• 请安全存储该文件，并设置适当的文件权限
• 切勿将 kubeconfig 文件提交到版本控制系统
• 注意令牌的过期和刷新要求
• 对不同环境（prod、staging、dev）使用不同的会话名称以保持清晰分隔

如果您计划跨会话或机器重复使用导出的 kubeconfig 文件，请确保其安全存储，并定期使用 ac config sync 同步以保持集群列表的最新状态。