Установка CLI
Вы можете устанавливать CLI в разных режимах:
Интерактивная установка CLI
-
Выполните команду:
curl -sSL https://storage.yandexcloud.net/yandexcloud-yc/install.sh | bashСкрипт установит CLI и добавит путь до исполняемого файла в переменную окружения
PATH.Примечание
Скрипт дополнит переменную
PATHтолько если его запустить в командных оболочкахbashилиzsh.Если вы запустили скрипт в другой оболочке, добавьте путь до CLI в переменную
PATHсамостоятельно.Важно
Для корректной работы автодополнения при использовании
zshтребуется версия оболочки не ниже 5.1, а при использованииbashна CentOS и производных дистрибутивах необходимо установить пакетbash-completion. -
После завершения установки перезапустите командную оболочку.
-
Выполните команду:
curl -sSL https://storage.yandexcloud.net/yandexcloud-yc/install.sh | bashСкрипт установит CLI и добавит путь до исполняемого файла в переменную окружения
PATH. -
Перезапустите командную оболочку, чтобы перезагрузить переменные окружения.
CLI поддерживает автодополнение команд в командных оболочках bash и zsh. Чтобы включить автодополнение:
-
Установите менеджер пакетов Homebrew
. -
Установите пакет
zsh-completion:Важно
Если вы установили bash вместо zsh либо используете macOS 10.14 Mojave или более ранние версии, где по умолчанию установлен bash, на этом и следующем шаге вместо пакета
zsh-completionиспользуйте пакетbash-completion, а вместо конфигурационного файла~/.zshrc—~/.bash_profile.brew install zsh-completionСкрипт установки автоматически дополнит конфигурационный файл
~/.zshrc:# The next line updates PATH for Yandex Cloud CLI. if [ -f '/Users/<username>/yandex-cloud/path.bash.inc' ]; then source '/Users/<username>/yandex-cloud/path.bash.inc'; fi # The next line enables shell command completion for yc. if [ -f '/Users/<username>/yandex-cloud/completion.zsh.inc' ]; then source '/Users/<username>/yandex-cloud/completion.zsh.inc'; fi -
После завершения установки добавьте в конфигурационный файл
~/.zshrcследующие строки. Расположите их выше строк, автоматически добавленных скриптом установки.if [ -f $(brew --prefix)/etc/zsh_completion ]; then . $(brew --prefix)/etc/zsh_completion fi -
Перезапустите командную оболочку.
Для Windows CLI можно установить с помощью PowerShell или командной строки:
-
Для установки с помощью PowerShell:
-
Выполните команду:
iex (New-Object System.Net.WebClient).DownloadString('https://storage.yandexcloud.net/yandexcloud-yc/install.ps1') -
Скрипт установки спросит, нужно ли добавить путь до
ycв переменную PATH:Add yc installation dir to your PATH? [Y/n] -
Введите
Y. После этого Yandex Cloud CLI можно пользоваться, командную оболочку перезапускать не нужно.
-
-
Для установки с помощью командной строки:
-
Выполните команду:
@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://storage.yandexcloud.net/yandexcloud-yc/install.ps1'))" && SET "PATH=%PATH%;%USERPROFILE%\yandex-cloud\bin" -
Скрипт установки спросит, нужно ли добавить путь до
ycв переменную PATH:Add yc installation dir to your PATH? [Y/n] -
Введите
Y. -
Перезапустите командную оболочку, чтобы перезагрузить переменные окружения.
-
Если в процессе установки CLI возникла ошибка, см. раздел Решение проблем CLI.
Для дальнейшей работы с CLI создайте профиль.
Неинтерактивная установка CLI
Для использования CLI в скриптах можно использовать флаги для неинтерактивной установки:
Выполните команду:
curl https://storage.yandexcloud.net/yandexcloud-yc/install.sh | bash -s -- -h
Usage: install [options...]
Options:
-i [INSTALL_DIR] Installs to specified dir.
-r [RC_FILE] Automatically modify RC_FILE with PATH modification and shell completion.
-n Don't modify rc file and don't ask about it.
-a Automatically modify default rc file with PATH modification and shell completion.
-h Prints help.
Примеры использования:
-
Установка CLI в
/opt/yc, без изменений в файле.bashrc:curl https://storage.yandexcloud.net/yandexcloud-yc/install.sh | \ bash -s -- -i /opt/yc -n -
Установка CLI в директорию по умолчанию, в файл
.bashrcдобавляютсяcompletionиPATH:curl https://storage.yandexcloud.net/yandexcloud-yc/install.sh | \ bash -s -- -a