#Начало работы с ACP CLI

#О ACP CLI

С помощью ACP CLI (ac) вы можете управлять платформами и кластерами ACP из терминала. ACP CLI предоставляет опыт, похожий на kubectl, оптимизированный для централизованной, прокси-ориентированной мультикластерной архитектуры ACP.

ACP CLI идеально подходит в следующих случаях:

• Работа с платформами ACP и несколькими кластерами через единый интерфейс
• Прямая работа с исходным кодом проектов, скриптование операций платформы ACP и автоматизация рабочих процессов
• Управление проектами при ограниченных ресурсах пропускной способности и отсутствии доступа к веб-консоли
• Управление приложениями в разных средах ACP (production, staging, development)

#Установка

#Установка из бинарного файла

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

Выполните следующие шаги, чтобы скачать нужный пакет:

1. Откройте в браузере страницу загрузки Alauda Cloud.
2. Выберите CLI Tools, чтобы перейти на страницу загрузки CLI.
3. Найдите раздел ACP CLI (ac).
4. Скачайте бинарный файл, соответствующий вашей операционной системе и архитектуре процессора (например, ac-linux-amd64).

#Установка ACP CLI на Linux

1. Выполните шаги загрузки выше, чтобы получить бинарный файл для Linux (например, ac-linux-amd64 или ac-linux-arm64).
2. Сделайте бинарный файл исполняемым:

   chmod +x ac-linux-amd64
   Замените ac-linux-amd64 на имя скачанного файла.
3. Переместите бинарный файл в каталог из PATH и переименуйте его в ac:

   sudo mv ac-linux-amd64 /usr/local/bin/ac
   При необходимости измените имя файла, если скачали другую версию.
4. Проверьте установку:

   ac version

#Установка ACP CLI на macOS

1. Выполните шаги загрузки выше, чтобы получить бинарный файл для macOS (например, ac-darwin-amd64 или ac-darwin-arm64).
2. Сделайте бинарный файл исполняемым:

   chmod +x ac-darwin-amd64
   Замените ac-darwin-amd64 на имя скачанного файла.
3. Переместите бинарный файл в каталог из PATH и переименуйте его в ac:

   sudo mv ac-darwin-amd64 /usr/local/bin/ac
   При необходимости измените имя файла, если скачали другую версию.
4. Проверьте установку:

   ac version

#Установка ACP CLI на Windows

1. Выполните шаги загрузки выше, чтобы получить бинарный файл для Windows (например, ac-windows-amd64.exe).
2. Переместите бинарный файл ac-windows-amd64.exe в каталог из PATH и при желании переименуйте в ac.exe. Можно оставить исходное имя, главное — чтобы каталог файла был в PATH.
3. Проверьте установку:

   ac version

#Первые шаги

#Вход в ACP Platform

Команда ac login — это ваша точка входа для подключения к платформам ACP. Она выполняет аутентификацию и автоматически настраивает доступ ко всем доступным кластерам.

#Интерактивный вход

Для простейшего варианта запустите ac login без параметров и следуйте интерактивным подсказкам:

$ ac login
Platform URL: https://prod.acp.com
Session name: prod
Username: user@example.com
Password: [hidden]
✔ Login successful. Welcome, user@example.com!

Your kubeconfig has been configured for the 'prod' platform.
+ Default context 'prod/global' has been created and activated.

To switch clusters within this session, use:
  ac config use-cluster <cluster_name>

To switch between platforms, use:
  ac config get-sessions          # Discover all configured sessions
  ac config use-session <name>    # Switch to different platform

#Вход с параметрами

Вы также можете передать параметры напрямую:

ac login https://prod.acp.com --name prod --username user@example.com

#Вход с использованием переменных окружения

Для автоматизации и скриптинга используйте переменные окружения:

export AC_LOGIN_PLATFORM_URL=https://prod.acp.com
export AC_LOGIN_SESSION=prod
export AC_LOGIN_USERNAME=user@example.com
export AC_LOGIN_PASSWORD=your-password
ac login

#Быстрое управление конфигурацией

После входа ACP CLI предоставляет удобные команды для повседневных операций:

#Просмотр текущего статуса

Используйте ac namespace, чтобы увидеть текущий рабочий контекст:

$ ac namespace
You are currently in namespace "default" (no namespace set in context).

Context:   prod/global
Cluster:   acp:prod:global
Server:    https://acp.prod.example.com/kubernetes/global/

#Переключение кластеров

Переключайтесь между кластерами в рамках текущей сессии:

$ ac config use-cluster workload-a
Switched to context "prod/workload-a".

$ ac config use-cluster global
Switched to context "prod/global".

#Переключение пространств имён

Измените активное пространство имён:

$ ac namespace my-app-dev
Now using namespace "my-app-dev" in context "prod/global".

#Основные операции с ресурсами

Используйте стандартные команды kubectl для управления ресурсами:

# Список pod-ов в текущем пространстве имён
$ ac get pods

# Описание конкретного pod-а
$ ac describe pod my-pod

# Получить сервисы во всех пространствах имён
$ ac get services --all-namespaces

# Применить конфигурационный файл
$ ac apply -f deployment.yaml

#Управление несколькими средами

Для пользователей, работающих с несколькими платформами ACP:

Список всех настроенных сессий:

$ ac config get-sessions
CURRENT   SESSION    PLATFORM                              USER                  CLUSTERS
*         prod       https://acp.prod.example.com          user@example.com      3
          staging    https://staging.acp.example.com       user@example.com      2

Переключение между платформами:

$ ac config use-session staging
Switched to session "staging".
Context "staging/global" activated.

#Ваше первое приложение

Создадим и посмотрим простое приложение, чтобы убедиться, что всё работает:

#Создание простого pod-а

1. Создайте базовую конфигурацию pod-а:

   cat > test-pod.yaml << EOF
   apiVersion: v1
   kind: Pod
   metadata:
     name: test-pod
     labels:
       app: test
   spec:
     containers:
     - name: nginx
       image: nginx:1.20
       ports:
       - containerPort: 80
   EOF

2. Примените конфигурацию:

   $ ac apply -f test-pod.yaml
   pod/test-pod created

#Просмотр статуса приложения

1. Список pod-ов для просмотра приложения:

   $ ac get pods
   NAME       READY   STATUS    RESTARTS   AGE
   test-pod   1/1     Running   0          30s

2. Подробная информация о pod-е:

   $ ac describe pod test-pod

3. Просмотр логов pod-а:

   $ ac logs test-pod

#Очистка

Удалите тестовый pod после завершения:

ac delete -f test-pod.yaml

#Получение помощи

#Встроенная система помощи

ACP CLI предоставляет подробную помощь на разных уровнях:

#Общая помощь

Обзор всех доступных команд:

ac help

#Помощь по конкретной команде

Подробная помощь по любой команде:

ac login --help
ac config --help
ac get --help

#Документация по ресурсам

Информация о Kubernetes-ресурсах:

ac explain pod
ac explain deployment
ac explain service

#Выход из системы

Когда вы закончите работу или нужно сменить учётные данные, используйте команду выхода:

$ ac logout
✔ Successfully logged out from 'prod' platform.

All session configurations have been removed.
To reconnect, run: ac login https://prod.acp.com --name prod

Команда logout:

• Удаляет токены аутентификации из локальной конфигурации
• Очищает все записи о кластерах и контекстах для сессии
• Отзывает используемые токены в ACP
• Обеспечивает отсутствие «зависших» конфигураций