Установка CLI

1. Выполните команду:

   curl -sSL https://storage.yandexcloud.net/yandexcloud-yc/install.sh | bash
   

   Скрипт установит CLI и добавит путь до исполняемого файла в переменную окружения PATH.

2. Перезапустите командную оболочку, чтобы перезагрузить переменные окружения.

Для Windows CLI можно установить с помощью PowerShell или командной строки:

• Для установки с помощью PowerShell:

  1. Выполните команду:

     iex (New-Object System.Net.WebClient).DownloadString('https://storage.yandexcloud.net/yandexcloud-yc/install.ps1')
     

  2. Скрипт установки спросит, нужно ли добавить путь до yc в переменную PATH:

     Add yc installation dir to your PATH? [Y/n]
     

  3. Введите Y. После этого Yandex Cloud CLI можно пользоваться, командную оболочку перезапускать не нужно.

• Для установки с помощью командной строки:

  1. Выполните команду:

     @"%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"
     

  2. Скрипт установки спросит, нужно ли добавить путь до yc в переменную PATH:

     Add yc installation dir to your PATH? [Y/n]
     

  3. Введите Y.

  4. Перезапустите командную оболочку, чтобы перезагрузить переменные окружения.

Чтобы включить автодополнение:

1. Откройте ~/.zshrc и добавьте в начало файла следующие строки:

   autoload -Uz compinit
   compinit
   

   Скрипт установки yc добавляет строки инициализации CLI и автодополнения в конец ~/.zshrc. Разместите вызовы autoload и compinit выше этих строк, иначе при запуске терминала появится ошибка command not found: compdef.

   Итоговый ~/.zshrc должен выглядеть так:

   autoload -Uz compinit
   compinit
   
   # Строки ниже добавлены скриптом установки yc автоматически.
   if [ -f "$HOME/yandex-cloud/path.bash.inc" ]; then source "$HOME/yandex-cloud/path.bash.inc"; fi
   if [ -f "$HOME/yandex-cloud/completion.zsh.inc" ]; then source "$HOME/yandex-cloud/completion.zsh.inc"; fi
   
   Установка расширенных автодополнений

   Пакет zsh-completions расширяет базовые автодополнения системы. Для автодополнения yc он не обязателен.

   Чтобы установить пакет:

   1. Установите Homebrew.

   2. Установите пакет zsh-completions:

      brew install zsh-completions
      

      Совет

      Если вы используете bash, вместо zsh-completions установите пакет bash-completion.

   3. Добавьте блок с FPATH перед строками autoload и compinit. Итоговый ~/.zshrc должен выглядеть так:

      if type brew &>/dev/null; then
        FPATH=$(brew --prefix)/share/zsh-completions:$FPATH
      fi
      autoload -Uz compinit
      compinit
      
      # Строки ниже добавлены скриптом установки yc автоматически.
      if [ -f "$HOME/yandex-cloud/path.bash.inc" ]; then source "$HOME/yandex-cloud/path.bash.inc"; fi
      if [ -f "$HOME/yandex-cloud/completion.zsh.inc" ]; then source "$HOME/yandex-cloud/completion.zsh.inc"; fi
      

2. Перезапустите командную оболочку или выполните команду exec -l $SHELL.

3. Проверьте, что автодополнение работает: введите yc и нажмите Tab дважды. Должен появиться список доступных команд.

winget install Microsoft.PowerShell

Чтобы включить автодополнение в PowerShell:

1. Если у вас нет профиля PowerShell, создайте его и откройте в текстовом редакторе:

   New-Item -Path $PROFILE -Type File -Force
   notepad $PROFILE
   

   Вместо notepad можно использовать любой удобный редактор. Например, для VS Code используйте команду code $PROFILE.

2. Добавьте в файл следующий код и сохраните:

   Register-ArgumentCompleter -Native -CommandName yc -ScriptBlock {
       param($wordToComplete, $commandAst, $cursorPosition)
   
       $elements = $commandAst.CommandElements
       $allTokens = $elements | Select-Object -Skip 1 | ForEach-Object { $_.ToString() }
       $allTokens = $allTokens | Where-Object { $_ -match '^[\x20-\x7E]+$' }
   
       if ($wordToComplete -ne '') {
           $completedTokens = $allTokens | Select-Object -SkipLast 1
           $queryTokens = @($completedTokens) + @("")
       } else {
           $queryTokens = @($allTokens) + @("")
       }
   
       $result = yc __completeNoDesc @queryTokens 2>$null
   
       $completions = $result | Where-Object {
           $_ -notmatch '^\:' -and $_ -notmatch '^Completion'
       } | Where-Object {
           $_.StartsWith($wordToComplete)
       }
   
       if ($completions.Count -eq 0 -and $wordToComplete -ne '') {
           $queryTokensFallback = @($completedTokens) + @($wordToComplete)
           $resultFallback = yc __completeNoDesc @queryTokensFallback 2>$null
   
           $completions = $resultFallback | Where-Object {
               $_ -notmatch '^\:' -and $_ -notmatch '^Completion'
           } | Where-Object {
               $_.StartsWith($wordToComplete)
           }
       }
   
       $completions | ForEach-Object {
           $parts = $_ -split '\t'
           [System.Management.Automation.CompletionResult]::new(
               $parts[0], $parts[0], 'ParameterValue', $parts[0]
           )
       }
   }
   

   Примечание

   По умолчанию при нажатии Tab в PowerShell варианты подставляются по очереди. Чтобы вместо этого открывалось меню со всеми вариантами и всплывающими подсказками, добавьте в начало файла следующие строки:

   Set-PSReadLineOption -ShowToolTips
   Set-PSReadLineKeyHandler -Key Tab -Function MenuComplete
   

   Эти строки меняют поведение Tab во всех командах PowerShell, не только в yc.

3. Перезапустите PowerShell. Проверьте, что автодополнение работает: введите yc и нажмите Tab. Должны появиться варианты доступных команд.

1. Перейдите в директорию, в которую хотите скачать CLI:

   cd <путь_к_директории>
   

2. Скачайте и распакуйте файл 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
   

3. Выдайте разрешения на запуск файла:

   chmod +x yc
   

4. Добавьте путь к директории с исполняемым файлом в PATH:

   export PATH=$PATH:$PWD
   

1. Перейдите в директорию, в которую хотите скачать CLI:

   cd <путь_к_директории>
   

2. Скачайте и распакуйте файл 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
   

3. Выдайте разрешения на запуск файла:

   chmod +x yc
   

4. Добавьте путь к директории с исполняемым файлом в PATH:

   export PATH=$PATH:$PWD
   

1. Перейдите в директорию, в которую хотите скачать CLI:

   cd <путь_к_директории>
   

2. Скачайте и распакуйте файл 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
   

3. Выдайте разрешения на запуск файла:

   chmod +x yc
   

4. Добавьте путь к директории с исполняемым файлом в PATH:

   export PATH=$PATH:$PWD
   

1. Перейдите в директорию, в которую хотите скачать CLI:

   cd <путь_к_директории>
   

2. Скачайте и распакуйте файл 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
   

3. Выдайте разрешения на запуск файла:

   chmod +x yc
   

4. Добавьте путь к директории с исполняемым файлом в PATH:

   export PATH=$PATH:$PWD
   

1. Перейдите в директорию, в которую хотите скачать CLI:

   cd <путь_к_директории>
   

2. Скачайте и распакуйте файл 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 .
   

3. Добавьте путь к директории с исполняемым файлом в PATH:

   [System.Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$PWD", "User")
   

4. Перезапустите PowerShell.

1. Перейдите в директорию, в которую хотите скачать CLI:

   cd <путь_к_директории>
   

2. Скачайте и распакуйте файл 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 .
   

3. Добавьте путь к директории с исполняемым файлом в PATH:

   [System.Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$PWD", "User")
   

4. Перезапустите PowerShell.