Настроить права доступа к кластеру GPU
Чтобы предоставить пользователю, группе или сервисному аккаунту доступ к кластеру GPU, назначьте на него роль.
Назначить роль
- В консоли управления
выберите каталог, в котором расположен кластер GPU. - Перейдите в сервис Compute Cloud.
- На панели слева выберите
→ Кластеры GPU. - Выберите нужный кластер GPU.
- Перейдите на вкладку
Права доступа. - Нажмите кнопку Назначить роли.
- В открывшемся окне выберите группу, пользователя или сервисный аккаунт, которым нужно предоставить доступ к кластеру GPU.
- Нажмите кнопку
Добавить роль и выберите необходимую роль. - Нажмите кнопку Сохранить.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.
-
Посмотрите описание команды CLI для назначения роли на кластер GPU:
yc compute gpu-cluster add-access-binding --help -
Получите список кластеров GPU в каталоге по умолчанию:
yc compute gpu-cluster list -
Посмотрите список ролей, которые уже назначены на ресурс:
yc compute gpu-cluster list-access-bindings <идентификатор_кластера_GPU> -
Назначьте роль с помощью команды:
-
Пользователю:
yc compute gpu-cluster add-access-binding <идентификатор_кластера_GPU> \ --user-account-id <идентификатор_пользователя> \ --role <роль>Где:
--user-account-id— идентификатор пользователя. Чтобы назначить роль для всех аутентифицированных пользователей, воспользуйтесь флагом--all-authenticated-users.--role— назначаемая роль.
-
Сервисному аккаунту:
yc compute gpu-cluster add-access-binding <идентификатор_кластера_GPU> \ --service-account-id <идентификатор_сервисного_аккаунта> \ --role <роль>Где:
--service-account-id— идентификатор сервисного аккаунта.--role— назначаемая роль.
-
Terraform
Terraform распространяется под лицензией Business Source License
Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
Чтобы назначить роль на доступ к кластеру GPU с помощью Terraform:
-
Опишите в конфигурационном файле Terraform параметры ресурсов, которые необходимо создать:
resource "yandex_compute_gpu_cluster_iam_binding" "sa-access" { gpu_cluster_id = "<идентификатор_GPU_кластера>" role = "<роль>" members = ["<тип_субъекта>:<идентификатор_субъекта>"] }Где:
gpu_cluster_id— идентификатор кластера GPU.role— назначаемая роль.members— список типов и идентификаторов субъектов, которым назначается роль. Указывается в видеuserAccount:<идентификатор_пользователя>илиserviceAccount:<идентификатор_сервисного_аккаунта>.
Более подробную информацию о параметрах ресурса
yandex_compute_gpu_cluster_iam_bindingсм. в документации провайдера. -
Примените изменения:
-
В терминале перейдите в папку, где вы отредактировали конфигурационный файл.
-
Проверьте корректность конфигурационного файла с помощью команды:
terraform validateЕсли конфигурация является корректной, появится сообщение:
Success! The configuration is valid. -
Выполните команду:
terraform planВ терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply -
Подтвердите изменения: введите в терминале слово
yesи нажмите Enter.
Terraform создаст все требуемые ресурсы. Проверить изменения можно в консоли управления
или с помощью команды CLI:yc compute gpu-cluster list-access-bindings <идентификатор_кластера_GPU> -
Чтобы назначить роль, воспользуйтесь методом REST API updateAccessBindings для ресурса GpuCluster или вызовом gRPC API GpuClusterService/UpdateAccessBindings. В теле запроса в свойстве action укажите ADD, а в свойстве subject — тип и идентификатор пользователя.
Назначить несколько ролей
- В консоли управления
выберите каталог, в котором расположен кластер GPU. - Перейдите в сервис Compute Cloud.
- На панели слева выберите
→ Кластеры GPU. - Выберите нужный кластер GPU.
- Перейдите на вкладку
Права доступа. - Нажмите кнопку Назначить роли.
- В открывшемся окне выберите группу, пользователя или сервисный аккаунт, которым нужно предоставить доступ к кластеру GPU.
- Нажмите кнопку
Добавить роль и выберите необходимую роль. - Добавьте еще роль через кнопку
Добавить роль. - Нажмите кнопку Сохранить.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.
Вы можете назначить несколько ролей с помощью команды set-access-bindings.
Внимание
Команда set-access-bindings полностью перезаписывает права доступа к ресурсу. Все текущие роли на ресурс будут удалены.
-
Убедитесь, что на ресурс не назначены роли, которые вы не хотите потерять:
yc compute gpu-cluster list-access-bindings <идентификатор_кластера_GPU> -
Посмотрите описание команды CLI для назначения ролей на кластер GPU:
yc compute gpu-cluster set-access-bindings --help -
Назначьте роли:
yc compute gpu-cluster set-access-bindings <идентификатор_кластера_GPU> \ --access-binding role=<роль>,subject=<тип_субъекта>:<идентификатор_субъекта> \ --access-binding role=<роль>,subject=<тип_субъекта>:<идентификатор_субъекта>Где:
-
--access-binding— параметры для установки прав доступа:
Например, назначьте роли нескольким пользователям и сервисному аккаунту:
yc compute gpu-cluster set-access-bindings my-gpu-cluster \ --access-binding role=editor,subject=userAccount:gfei8n54hmfh******** --access-binding role=viewer,subject=userAccount:helj89sfj80a******** --access-binding role=editor,subject=serviceAccount:ajel6l0jcb9s******** -
Terraform
Terraform распространяется под лицензией Business Source License
Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
Чтобы назначить несколько ролей на файловое хранилище с помощью Terraform:
-
Опишите в конфигурационном файле Terraform параметры ресурсов, которые необходимо создать:
resource "yandex_compute_gpu_cluster_iam_binding" "role1" { gpu_cluster_id = "<идентификатор_GPU_кластера>" role = "<роль_1>" members = ["<тип_субъекта>:<идентификатор_субъекта>"] } resource "yandex_compute_gpu_cluster_iam_binding" "role2" { gpu_cluster_id = "<идентификатор_GPU_кластера>" role = "<роль_2>" members = ["<тип_субъекта>:<идентификатор_субъекта>"] }Где:
gpu_cluster_id— идентификатор кластера GPU.role— назначаемая роль.members— список типов и идентификаторов субъектов, которым назначается роль. Указывается в видеuserAccount:<идентификатор_пользователя>илиserviceAccount:<идентификатор_сервисного_аккаунта>.
Более подробную информацию о параметрах ресурса
yandex_compute_gpu_cluster_iam_bindingсм. в документации провайдера. -
Примените изменения:
-
В терминале перейдите в папку, где вы отредактировали конфигурационный файл.
-
Проверьте корректность конфигурационного файла с помощью команды:
terraform validateЕсли конфигурация является корректной, появится сообщение:
Success! The configuration is valid. -
Выполните команду:
terraform planВ терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply -
Подтвердите изменения: введите в терминале слово
yesи нажмите Enter.
Terraform создаст все требуемые ресурсы. Проверить изменения можно в консоли управления
или с помощью команды CLI:yc compute gpu-cluster list-access-bindings <идентификатор_кластера_GPU> -
Чтобы назначить роли на ресурс, воспользуйтесь методом REST API setAccessBindings для ресурса GpuCluster или вызовом gRPC API GpuClusterService/SetAccessBindings.
Внимание
Метод setAccessBindings и вызов GpuClusterService/SetAccessBindings полностью перезаписывают права доступа к ресурсу. Все текущие роли на ресурс будут удалены.
Отозвать роль
- В консоли управления
выберите каталог, в котором расположен кластер GPU. - Перейдите в сервис Compute Cloud.
- На панели слева выберите
→ Кластеры GPU. - Выберите нужный кластер GPU.
- Перейдите на вкладку
Права доступа. - В строке нужного пользователя нажмите значок
и выберите Изменить роли. - Рядом с ролью нажмите значок
. - Нажмите кнопку Сохранить.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.
-
Посмотрите описание команды CLI для отзыва роли на кластер GPU:
yc compute gpu-cluster remove-access-binding --help -
Посмотрите, кому и какие роли назначены на ресурс:
yc compute gpu-cluster list-access-bindings <идентификатор_кластера_GPU> -
Чтобы отозвать права доступа, выполните команду:
yc compute gpu-cluster remove-access-binding <идентификатор_кластера_GPU> \ --role=<роль> \ --subject=<тип_субъекта>:<идентификатор_субъекта> \Где:
--role— идентификатор роли, которую надо отозвать.--subject— тип и идентификатор субъекта, у которого вы хотите отозвать роль.
Например, чтобы отозвать роль
viewerу пользователя с идентификаторомajel6l0jcb9s********на кластер GPU:yc compute gpu-cluster remove-access-binding my-gpu-cluster \ --role viewer \ --subject userAccount:ajel6l0jcb9s********
Terraform
Terraform распространяется под лицензией Business Source License
Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
Чтобы отозвать роль, назначенную на GPU кластер с помощью Terraform:
-
Откройте файл конфигурации Terraform и удалите фрагмент с описанием роли:
resource "yandex_compute_gpu_cluster_iam_binding" "sa-access" { gpu_cluster_id = "<идентификатор_GPU_кластера>" role = "<роль>" members = ["<тип_субъекта>:<идентификатор_субъекта>"] } -
Примените изменения:
-
В терминале перейдите в папку, где вы отредактировали конфигурационный файл.
-
Проверьте корректность конфигурационного файла с помощью команды:
terraform validateЕсли конфигурация является корректной, появится сообщение:
Success! The configuration is valid. -
Выполните команду:
terraform planВ терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply -
Подтвердите изменения: введите в терминале слово
yesи нажмите Enter.
Проверить изменения можно в консоли управления
или с помощью команды CLI:yc compute gpu-cluster list-access-bindings <идентификатор_кластера_GPU> -
Чтобы отозвать роль, воспользуйтесь методом REST API updateAccessBindings для ресурса GpuCluster или вызовом gRPC API GpuClusterService/UpdateAccessBindings. В теле запроса в свойстве action укажите REMOVE, а в свойстве subject — тип и идентификатор пользователя.