• Русский
  • AC CLI Справочник команд администратора

    В этом справочнике приведены описания и примеры команд администратора AC CLI. Для использования этих команд необходимо иметь права cluster-admin или эквивалентные.

    Для команд разработчика смотрите справочник команд разработчика AC CLI.

    Выполните ac adm -h, чтобы вывести список всех команд администратора, или ac <command> --help для получения дополнительной информации по конкретной команде.

    ac adm

    Административные инструменты ACP для управления кластером

    Пример использования

    # Освободить узел для обслуживания
    ac adm drain NODE_NAME
    
    # Заблокировать узел (отметить как нераспределяемый)
    ac adm cordon NODE_NAME
    
    # new-project для создания проекта с кластером
    ac adm new-project PROJECT_NAME --cluster CLUSTER_NAME
    
    # Разблокировать узел (отметить как распределяемый)
    ac adm uncordon NODE_NAME

    ac adm certificate

    Изменение ресурсов сертификатов

    ac adm certificate approve

    Одобрить запрос на подпись сертификата

    Пример использования

    # Одобрить CSR 'csr-sqgzp'
    ac adm certificate approve csr-sqgzp

    ac adm certificate deny

    Отклонить запрос на подпись сертификата

    Пример использования

    # Отклонить CSR 'csr-sqgzp'
    ac adm certificate deny csr-sqgzp

    ac adm cordon

    Отметить узел как нераспределяемый

    Пример использования

    # Отметить узел "foo" как нераспределяемый
    ac adm cordon foo

    ac adm drain

    Освободить узел в подготовке к обслуживанию

    Пример использования

    # Освободить узел "foo", даже если на нем есть поды, не управляемые replication controller, replica set, job, daemon set или stateful set
    ac adm drain foo --force
    
    # То же, но прервать, если есть поды, не управляемые replication controller, replica set, job, daemon set или stateful set, и использовать период ожидания 15 минут
    ac adm drain foo --grace-period=900

    ac adm new-project

    Создать новый проект

    Пример использования

    # Создать проект с конкретными кластерами
    ac adm new-project my-project --cluster cluster1
    
    # Создать проект с несколькими кластерами
    ac adm new-project my-project --cluster cluster1,cluster2

    ac adm new-project-namespace

    Создать новое пространство имён в проекте

    Пример использования

    # Создать пространство имён в проекте с конкретными кластерами
    ac adm new-project-namespace  my-namespace --project my-project --cluster cluster1

    ac adm policy

    Управление политиками RBAC в проекте или пространстве имён

    Пример использования

    # Назначить пользователя в роль администратора проекта
    ac adm policy add-project-role-to-user project-admin-system alice --project my-project
    
    # Назначить пользователя в роль пространства имён в пространстве кластера проекта
    ac adm policy add-namespace-role-to-user namespace-developer-system alice --namespace my-namespace --project my-project --cluster business-1
    
    # Добавить роль кластера kubernetes view пользователю alice
    ac adm policy add-cluster-role-to-user view alice
    
    # Добавить роль kubernetes view пользователю alice
    ac adm policy add-role-to-user view alice -n my-namespace
    

    ac adm policy add-cluster-role-to-user

    Назначить роль кластера kubernetes пользователю в текущем контексте кластера

    Пример использования

    # Добавить роль кластера kubernetes view пользователю alice
    ac adm policy add-cluster-role-to-user view alice

    ac adm policy add-namespace-role-to-user

    Назначить платформенную роль пользователю в специальном пространстве кластера проекта

    Пример использования

    # Назначить роль namespace-developer-system пользователю alice в проекте my-project
    ac adm policy add-namespace-role-to-user namespace-developer-system alice --namespace my-namespace --project my-project --cluster business-1

    ac adm policy add-project-role-to-user

    Назначить платформенную роль пользователю в проекте

    Пример использования

    # Назначить роль project-admin-system пользователю alice в проекте my-project
    ac adm policy add-project-role-to-user project-admin-system alice --project my-project

    ac adm policy add-role-to-user

    Назначить роль kubernetes пользователю в текущем контексте кластера

    Пример использования

    # Добавить роль kubernetes view пользователю alice
    ac adm policy add-role-to-user view alice -n my-namespace

    ac adm release

    Управление метаданными релиза и связанными административными процессами

    Пример использования

    # Импортировать ProductManifest для версии релиза
    ac adm release import-manifest --version 4.20.0

    ac adm release import-manifest

    Импортировать метаданные релиза как ProductManifest

    Пример использования

    # Импортировать метаданные релиза для версии 4.20.0
    ac adm release import-manifest --version 4.20.0
    
    # Импортировать метаданные и ждать, пока ProductManifest не станет Ready
    ac adm release import-manifest --version 4.20.0 --wait
    
    # Переопределить таймаут ожидания
    ac adm release import-manifest --version 4.20.0 --wait --timeout=10m

    ac adm taint

    Обновить taints на одном или нескольких узлах

    Пример использования

    # Обновить узел 'foo' с taint с ключом 'dedicated', значением 'special-user' и эффектом 'NoSchedule'
    # Если taint с таким ключом и эффектом уже существует, его значение заменяется указанным
    ac adm taint nodes foo dedicated=special-user:NoSchedule
    
    # Удалить с узла 'foo' taint с ключом 'dedicated' и эффектом 'NoSchedule', если он существует
    ac adm taint nodes foo dedicated:NoSchedule-
    
    # Удалить с узла 'foo' все taint с ключом 'dedicated'
    ac adm taint nodes foo dedicated-
    
    # Добавить taint с ключом 'dedicated' на узлах с меткой myLabel=X
    ac adm taint node -l myLabel=X  dedicated=foo:PreferNoSchedule
    
    # Добавить на узел 'foo' taint с ключом 'bar' без значения
    ac adm taint nodes foo bar:NoSchedule

    ac adm uncordon

    Отметить узел как распределяемый

    Пример использования

    # Отметить узел "foo" как распределяемый
    ac adm uncordon foo

    ac adm upgrade

    Просмотр или запрос обновления кластера

    Пример использования

    # Просмотреть статус обновления и доступные обновления кластера
    ac adm upgrade
    
    # Просмотреть сводку для конкретного кластера
    ac adm upgrade --cluster=workload-a
    
    # Обновиться до последней версии
    ac adm upgrade --to-latest
    
    # Обновиться до конкретной версии из доступных обновлений
    ac adm upgrade --cluster=workload-a --to=4.15.0
    
    # Разрешить явное обновление до версии вне доступных обновлений
    ac adm upgrade --to=4.15.0 --allow-explicit-upgrade

    ac adm upgrade status

    Просмотр деталей предварительной проверки и этапов обновления целевого кластера

    Пример использования

    # Просмотреть статус Cluster Version Operator для кластера по умолчанию
    ac adm upgrade status
    
    # Просмотреть статус конкретного кластера
    ac adm upgrade status --cluster=workload-a
    
    # Просмотреть полные детали, предоставленные контроллером
    ac adm upgrade status --verbose