Установка CLI
Вы можете установить CLI следующими способами:
- Интерактивная установка CLI с помощью скрипта
- Неинтерактивная установка CLI с помощью скрипта
- Установка без использования скрипта
Интерактивная установка CLI с помощью скрипта
В разделе представлена инструкция по интерактивной установке CLI с помощью скрипта, который:
- Определяет вашу операционную систему и архитектуру.
- Скачивает исполняемый файл с последней стабильной версией CLI для вашего окружения.
- Проверяет работоспособность.
- Добавляет CLI в переменную окружения
PATH. - Генерирует настройки автодополнения.
-
Выполните команду:
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
Для дальнейшей работы с CLI создайте профиль.
Установка без использования скрипта
Если возможность запускать скрипты на целевой системе отсутствует, вы можете напрямую загрузить и установить исполняемый файл с последней стабильной версией CLI.
Выберите инструкцию, исходя из вашей операционной системы и архитектуры процессора:
-
Перейдите в директорию, в которую хотите скачать CLI:
cd <путь_к_директории> -
Скачайте и распакуйте файл yc_linux_amd64.tar.gz
:curl -O https://storage.yandexcloud.net/yandexcloud-yc/release/yc_linux_amd64.tar.gz tar -xzf yc_linux_amd64.tar.gz -
Выдайте разрешения на запуск файла:
chmod +x yc -
Добавьте путь к директории с исполняемым файлом в
PATH:export PATH=$PATH:$PWD
-
Перейдите в директорию, в которую хотите скачать CLI:
cd <путь_к_директории> -
Скачайте и распакуйте файл yc_linux_386.tar.gz
:curl -O https://storage.yandexcloud.net/yandexcloud-yc/release/yc_linux_386.tar.gz tar -xzf yc_linux_386.tar.gz -
Выдайте разрешения на запуск файла:
chmod +x yc -
Добавьте путь к директории с исполняемым файлом в
PATH:export PATH=$PATH:$PWD
-
Перейдите в директорию, в которую хотите скачать CLI:
cd <путь_к_директории> -
Скачайте и распакуйте файл yc_linux_arm64.tar.gz
:curl -O https://storage.yandexcloud.net/yandexcloud-yc/release/yc_linux_arm64.tar.gz tar -xzf yc_linux_arm64.tar.gz -
Выдайте разрешения на запуск файла:
chmod +x yc -
Добавьте путь к директории с исполняемым файлом в
PATH:export PATH=$PATH:$PWD
-
Перейдите в директорию, в которую хотите скачать CLI:
cd <путь_к_директории> -
Скачайте и распакуйте файл yc_darwin_amd64.tar.gz
:curl -O https://storage.yandexcloud.net/yandexcloud-yc/release/yc_darwin_amd64.tar.gz tar -xzf yc_darwin_amd64.tar.gz -
Выдайте разрешения на запуск файла:
chmod +x yc -
Добавьте путь к директории с исполняемым файлом в
PATH:export PATH=$PATH:$PWD
-
Перейдите в директорию, в которую хотите скачать CLI:
cd <путь_к_директории> -
Скачайте и распакуйте файл yc_darwin_arm64.tar.gz
:curl -O https://storage.yandexcloud.net/yandexcloud-yc/release/yc_darwin_arm64.tar.gz tar -xzf yc_darwin_arm64.tar.gz -
Выдайте разрешения на запуск файла:
chmod +x yc -
Добавьте путь к директории с исполняемым файлом в
PATH:export PATH=$PATH:$PWD
-
Перейдите в директорию, в которую хотите скачать CLI:
cd <путь_к_директории> -
Скачайте и распакуйте файл yc_windows_amd64.zip
:curl.exe -O https://storage.yandexcloud.net/yandexcloud-yc/release/yc_windows_amd64.zip Expand-Archive yc_windows_amd64.zip -DestinationPath . -
Добавьте путь к директории с исполняемым файлом в
PATH:[System.Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$PWD", "User") -
Перезапустите PowerShell.
-
Перейдите в директорию, в которую хотите скачать CLI:
cd <путь_к_директории> -
Скачайте и распакуйте файл yc_windows_386.zip
:curl.exe -O https://storage.yandexcloud.net/yandexcloud-yc/release/yc_windows_386.zip Expand-Archive yc_windows_386.zip -DestinationPath . -
Добавьте путь к директории с исполняемым файлом в
PATH:[System.Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$PWD", "User") -
Перезапустите PowerShell.
Для дальнейшей работы с CLI создайте профиль.