create-role-associations

Описание

Создаёт ассоциации ролей заданной роли IAM с учётными записями сервиса EMR таким образом, чтобы она могла использоваться с Amazon EMR на EKS с заданным пространством имён из заданного кластера EKS.

Примечание: Команда связает учётные записи сервиса EMR с предоставленной ролью IAM с идентификацией под-подов EKS:

• “emr-containers-sa-%(FRAMEWORK)s-%(COMPONENT)s-%(AWS_ACCOUNT_ID)s-%(BASE36_ENCODED_ROLE_NAME)s”

Здесь:

<FRAMEWORK> = EMR on EKS framework such as spark, flink, livy
<COMPONENT> = Task component for the framework. Such as client, driver, executor for spark; flink-operator, jobmanager, taskmanager for flink.
<AWS_ACCOUNT_ID> = AWS Account ID of the EKS cluster
<BASE36_ENCODED_ROLE_NAME> = Base36 encoded form of the IAM Role name

Вы можете использовать опцию –type, чтобы выбрать, какую модель отправки нужно ассоциировать.

Вы можете использовать опцию –operator-namespace, если ваши задачи оператора/livy выполняются в другом пространстве имён оператора, отличном от пространства имён задач/приложений. –namespace должно быть пространством имён задачи/приложения, а эта опция предназначена для пространства имён оператора для ассоциации учётной записи сервиса оператора/livy.

Вы можете использовать опцию –service-account-name, чтобы ассоциировать роль с пользовательской учётной записью сервиса.

Синтаксис

  create-role-associations
--cluster-name <value>
--namespace <value>
--role-name <value>
[--type <value>]
[--operator-namespace <value>]
[--service-account-name <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--cluster-name (строка) Укажите имя кластера Amazon EKS, с которым будет связана роль IAM.

--namespace (строка) Укажите пространство имён задачи/приложения из кластера Amazon EKS, с которым будет связана роль IAM.

--role-name (строка) Укажите имя роли IAM, которую вы хотите связать с Amazon EMR на EKS.

--type (строка) Укажите модель отправки Amazon EMR на EKS и выберите учётные записи сервиса, которые вы хотите связать с Amazon EMR на EKS. По умолчанию используется start_job_run. Поддерживаемые типы: start_job_run, interactive_endpoint, spark_operator, flink_operator, livy.

--operator-namespace (строка) Укажите пространство имён, с которым вы хотите связать учётную запись сервиса оператора с ролью IAM. По умолчанию используется пространство имён задачи/приложения. Примечание: если задачи выполняются в другом пространстве имён, отличном от пространства имён установки оператора, этот параметр должен быть установлен как пространство имён, в котором работает оператор.

--service-account-name (строка) Укажите имя учётной записи сервиса, которую вы хотите связать с ролью IAM. По умолчанию используются учётные записи сервиса Amazon EMR на EKS.

Глобальные параметры

--debug (логическое значение)

Включить отладку логов.

--endpoint-url (строка)

Переопределить значение URL по умолчанию для команды данным URL.

--no-verify-ssl (логическое значение)

По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого соединения SSL AWS CLI будет проверять сертификаты SSL. Данный параметр переопределяет поведение по умолчанию проверки сертификатов SSL.

--no-paginate (логическое значение)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команды.

• json
• text
• table
• yaml
• yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использование определённого профиля из файла с данными учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Отображение версии этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

• on
• off
• auto

--no-sign-request (логическое значение)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Файл с набором сертификатов CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения к сокету в секундах. Если значение установлено в 0, подключение к сокету будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования для двоичных блоков. Формат по умолчанию - base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной строкой base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое отображается на двоичный блок fileb:// всегда будет обрабатываться как двоичный и будет использоваться содержимое файла напрямую, независимо от cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для конфигурированного cli-binary-format.

• base64
• raw-in-base64-out

--no-cli-pager (логическое значение)

Отключить вывод постраничной навигации CLI.

--cli-auto-prompt (логическое значение)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматическое запросы параметров ввода CLI.

Примеры

Для создания ассоциаций ролей роли IAM с учётными записями сервиса EMR для использования с Amazon EMR на EKS

Следующий create-role-associations пример команды создаёт ассоциации с идентификацией под-подов EKS роли с именем example_iam_role с учётными записями сервиса EMR таким образом, чтобы она могла использоваться с Amazon EMR на EKS с пространством имён example_namespace из кластера EKS с именем example_cluster:

aws emr-containers create-role-associations \
    --cluster-name example_cluster \
    --namespace example_namespace \
    --role-name example_iam_role

Вывод:

[
    {
        "clusterName": "example_cluster",
        "namespace": "example_namespace",
        "serviceAccount": "emr-spark-client-service-account-example",
        "roleArn": "arn:aws:iam::111111111111:role/example_iam_role",
        "associationArn": "arn:aws:eks:us-east-1:111111111111:podidentityassociation/example_cluster/a-bgyr1umgdmrk1kdtq",
        "associationId": "a-bgyr1umgdmrk1kdtq",
        "tags": {},
        "createdAt": "2022-11-15T10:49:00+00:00",
        "modifiedAt": "2022-11-15T10:49:00+00:00"
    },
    {
        "clusterName": "example_cluster",
        "namespace": "example_namespace",
        "serviceAccount": "emr-spark-driver-service-account-example",
        "roleArn": "arn:aws:iam::111111111111:role/example_iam_role",
        "associationArn": "arn:aws:eks:us-east-1:111111111111:podidentityassociation/example_cluster/b-bgyr1umgdmrk1kdtq",
        "associationId": "b-bgyr1umgdmrk1kdtq",
        "tags": {},
        "createdAt": "2022-11-15T10:49:00+00:00",
        "modifiedAt": "2022-11-15T10:49:00+00:00"
    },
    {
        "clusterName": "example_cluster",
        "namespace": "example_namespace",
        "serviceAccount": "emr-spark-executor-service-account-example",
        "roleArn": "arn:aws:iam::111111111111:role/example_iam_role",
        "associationArn": "arn:aws:eks:us-east-1:111111111111:podidentityassociation/example_cluster/c-bgyr1umgdmrk1kdtq",
        "associationId": "c-bgyr1umgdmrk1kdtq",
        "tags": {},
        "createdAt": "2022-11-15T10:49:00+00:00",
        "modifiedAt": "2022-11-15T10:49:00+00:00"
    }
]