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