Создание профиля
Создать профиль можно двумя способами:
-
Создание пустого профиля и добавление параметров вручную.
Будет создан и активирован пустой профиль — все необходимые параметры надо будет задать отдельно.
-
Интерактивное создание профиля с базовыми параметрами.
CLI будет поэтапно предлагать задать базовые параметры профиля. С помощью этого способа можно переопределить параметры уже существующего профиля. Способ не подходит для сервисных аккаунтов.
Создание пустого профиля и добавление параметров вручную
Создайте профиль с именем test
:
-
Выполните команду:
yc config profile create test
Результат:
Profile 'test' created and activated
-
Добавьте необходимые параметры профиля, например каталог:
yc config set folder-id <ID каталога>
Ознакомьтесь с полным списком параметров профиля, а также как ими управлять.
Пример создания такого профиля можно посмотреть в начале работы.
Интерактивное создание профиля с базовыми параметрами
В процессе интерактивного создания профиля CLI будет поэтапно предлагать задать базовые параметры профиля:
- Имя профиля.
- OAuth-токен (для аккаунта на Яндексе).
- Облако, в котором у вас есть права доступа.
- Каталог по умолчанию.
- Зона доступности по умолчанию, в которой будут создаваться ресурсы сервиса Yandex Compute Cloud.
Вы можете прервать процесс создания профиля в любой момент. В профиле будут сохранены настройки, которые вы успели задать до прерывания.
Если вы еще не подключены к консоли управления, войдите в консоль
Чтобы аутентифицироваться с помощью аккаунта на Яндексе:
-
Получите OAuth-токен в сервисе Яндекс ID
:-
Перейдите по ссылке
. Если приложение запрашивает доступ к данным, разрешите. Это нужно для получения токена. -
Скопируйте в буфер обмена или сохраните полученный токен.
-
-
Если вы аутентифицируетесь впервые, перейдите в консоль облака
. Примите условия лицензионного соглашения и политики конфиденциальности. -
Чтобы начать настройку профиля CLI, выполните команду:
yc init
-
Выберите профиль, для которого вы хотите настроить аутентификацию, или создайте новый. Если вы выполняете команду
yc init
впервые, этот шаг будет отсутствовать.Pick desired action: [1] Re-initialize this profile 'default' with new settings [2] Create a new profile Please enter your numeric choice: 1
-
По запросу команды введите OAuth-токен, полученный ранее:
Please go to https://oauth.yandex.ru/authorize?response_type=token&client_id=1a6990aa636648e9b2ef855fa7bec2fb in order to obtain OAuth token. Please enter OAuth token: y0_AgA ... wvs7N4
-
Выберите одно из предложенных облаков, к которым у вас есть доступ:
Please select cloud to use: [1] cloud1 (id = aoe2bmdcvata********) [2] cloud2 (id = dcvatao4faoe********) Please enter your numeric choice: 2
Если вам доступно только одно облако, оно будет выбрано автоматически.
-
Выберите каталог по умолчанию:
Please choose a folder to use: [1] folder1 (id = cvatao4faoe2********) [2] folder2 (id = tao4faoe2cva********) [3] Create a new folder Please enter your numeric choice: 1
-
Чтобы выбрать зону доступности по умолчанию для сервиса Compute Cloud, введите
Y
. Чтобы пропустить настройку, введитеn
.Do you want to configure a default Yandex Compute Cloud availability zone? [Y/n] Y
Если вы ввели
Y
, выберите зону доступности:Which zone do you want to use as a profile default? [1] ru-central1-a [2] ru-central1-b [3] ru-central1-c [4] ru-central1-d [5] Do not set default zone Please enter your numeric choice: 2
-
Проверьте настройки вашего профиля CLI:
yc config list
Результат:
token: y0_AgA...wvs7N4 cloud-id: b1g159pa15cd******** folder-id: b1g8o9jbt58******** compute-default-zone: ru-central1-b
Чтобы аутентифицироваться с помощью SAML-совместимой федерации удостоверений:
-
Узнайте идентификатор федерации у вашего администратора.
-
Запустите интерактивное создание профиля:
yc init --federation-id=<идентификатор_федерации>
-
Выберите профиль, для которого вы хотите настроить аутентификацию, или создайте новый.
Welcome! This command will take you through the configuration process. Pick desired action: [1] Re-initialize this profile 'default' with new settings [2] Create a new profile
-
CLI выведет сообщение о продолжении аутентификации в браузере. Для продолжения нажмите клавишу Enter.
You are going to be authenticated via federation-id 'aje1f0hsgds3a********'. Your federation authentication web site will be opened. After your successful authentication, you will be redirected to 'https://console.yandex.cloud'. Press 'enter' to continue...
После успешной аутентификации в профиле сохранится IAM-токен. При каждой операции аутентификация будет происходить с помощью этого токена, пока не истечет время жизни токена. После этого CLI снова выведет сообщение о необходимости пройти аутентификацию в браузере.
-
Вернитесь в интерфейс командной строки, чтобы завершить создание профиля.
-
Выберите одно из предложенных облаков, в которых у вас есть права доступа:
Please select cloud to use: [1] cloud1 (id = aoe2bmdcvata********) [2] cloud2 (id = dcvatao4faoe********) Please enter your numeric choice: 2
Если вам доступно только одно облако, оно будет выбрано автоматически.
-
Выберите каталог по умолчанию:
Please choose a folder to use: [1] folder1 (id = cvatao4faoe2********) [2] folder2 (id = tao4faoe2cva********) [3] Create a new folder Please enter your numeric choice: 1
-
Чтобы выбрать зону доступности по умолчанию для сервиса Compute Cloud, введите
Y
. Чтобы пропустить настройку, введитеn
.Do you want to configure a default Yandex Compute Cloud availability zone? [Y/n] Y
Если вы ввели
Y
, выберите зону доступности:Which zone do you want to use as a profile default? [1] ru-central1-a [2] ru-central1-b [3] ru-central1-c [4] ru-central1-d [5] Do not set default zone Please enter your numeric choice: 2
-
Проверьте настройки вашего профиля CLI:
yc config list
Результат:
federation-id: aje1f0hs6oja******** cloud-id: b1g159pa15cd******** folder-id: b1g8o9jbt58******** compute-default-zone: ru-central1-b