#Настройка ACP CLI

#Автодополнение в оболочке

Вы можете включить автодополнение по нажатию клавиши Tab для оболочек Bash или Zsh.

#Включение автодополнения для Bash

После установки ACP CLI (ac) вы можете включить автодополнение, чтобы автоматически дополнять команды ac или предлагать варианты при нажатии Tab. Следующая процедура включает автодополнение для оболочки Bash.

#Требования

• У вас должен быть установлен 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.

Автодополнение будет включено при открытии нового терминала.

#Включение автодополнения для Zsh

После установки ACP CLI (ac) вы можете включить автодополнение, чтобы автоматически дополнять команды ac или предлагать варианты при нажатии Tab. Следующая процедура включает автодополнение для оболочки Zsh.

#Требования

У вас должен быть установлен ACP CLI (ac).

#Процедура

Чтобы добавить автодополнение для ac в ваш файл .zshrc, выполните следующую команду:

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

Автодополнение будет включено при открытии нового терминала.

#Доступ к kubeconfig с помощью ACP CLI

Вы можете использовать ACP CLI (ac) для входа в вашу платформу ACP и получения файла kubeconfig для доступа к кластерам из командной строки. В отличие от традиционного экспорта kubeconfig для одного кластера, команда ac login создает комплексную конфигурацию для нескольких кластеров через обнаружение платформы.

#Требования

У вас должен быть доступ к конечной точке платформы ACP и действительные учетные данные для аутентификации.

#Процедура

1. Войдите в вашу платформу ACP, выполнив следующую команду:

   $ ac login <platform-url> --name <session-name>
   • <platform-url>: базовый URL платформы ACP (например, https://acp.prod.example.com)
   • <session-name>: удобочитаемое имя для этого подключения к платформе (например, "prod", "staging")

2. Процесс входа автоматически:

   • Аутентифицируется на платформе ACP
   • Обнаруживает все доступные кластеры на платформе
   • Создает записи kubeconfig для всех кластеров с метаданными, специфичными для ACP
   • Устанавливает контекст по умолчанию, указывающий на глобальный кластер

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 для поддержания актуального списка кластеров.