#配置 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 同步以保持集群列表的最新状态。