#Распространённые операции с командами CLI

Платформа Alauda Container Platform предоставляет инструменты командной строки для взаимодействия пользователей с реестром Alauda Container Platform. Ниже приведены примеры распространённых операций и команд:

Предположим, что у реестра Alauda Container Platform для кластера есть адрес сервиса registry.cluster.local, а пространство имён, с которым вы сейчас работаете, — my-ns.

Свяжитесь с технической службой, чтобы получить плагин kubectl-acp и убедиться, что он корректно установлен в вашей среде.

#Вход в реестр

Войдите в реестр кластера, выполнив вход в ACP.

kubectl acp login <ACP-endpoint>

#Добавление прав на пространство имён для пользователей

Добавить пользователю право на pull в пространстве имён.

kubectl create rolebinding <binding-name> --clusterrole=system:image-puller --user=<username> -n <namespace>

Добавить пользователю право на push в пространстве имён.

kubectl create rolebinding <binding-name> --clusterrole=system:image-pusher --user=<username> -n <namespace>

#Добавление прав на пространство имён для сервисного аккаунта

Добавить сервисному аккаунту право на pull в пространстве имён.

kubectl create rolebinding <binding-name> --clusterrole=system:image-puller --serviceaccount=<namespace>:<serviceaccount-name> -n <namespace>

Добавить сервисному аккаунту право на push в пространстве имён.

kubectl create rolebinding <binding-name> --clusterrole=system:image-pusher --serviceaccount=<namespace>:<serviceaccount-name> -n <namespace>

#Загрузка образов

Загружает образ из реестра внутрь кластера (например, для развертывания Pod).

# Загрузить образ с именем my-app и тегом latest из реестра текущего пространства имён (my-ns)
kubectl acp pull registry.cluster.local/my-ns/my-app:latest

# Загрузить образы из других пространств имён (например, shared-ns) (требуются права на pull из пространства shared-ns)
kubectl acp pull registry.cluster.local/shared-ns/base-image:latest

Эта команда проверяет вашу личность и права на pull в целевом пространстве имён, а затем загружает образ из реестра.

#Отправка образов

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

Сначала необходимо пометить (tag) локальный образ адресом и форматом пространства имён целевого реестра с помощью стандартного инструмента командной строки для контейнеров, например podman.

# Пометить образ целевым адресом:
podman tag my-app:latest registry.cluster.local/my-ns/my-app:v1

# Использовать команду kubectl для отправки образа в реестр текущего пространства имён (my-ns)
kubectl acp push registry.cluster.local/my-ns/my-app:v1

Отправляет образ из удалённого репозитория образов в конкретное пространство имён реестра Alauda Container Platform.

# Если в вашем удалённом репозитории образов есть образ remote.registry.io/demo/my-app:latest
# Используйте команду kubectl для отправки его в пространство имён (my-ns) реестра
kubectl acp push remote.registry.io/demo/my-app:latest registry.cluster.local/my-ns/my-app:latest

Эта команда проверяет вашу личность и права на push в пространстве имён my-ns, а затем загружает локально помеченный образ в реестр.