IBM Cloud Docs
Instalando a CLI IBM Cloud Independente

Instalando a CLI IBM Cloud Independente

A interface da linha de comandos da IBM Cloud® fornece comandos para gerenciar recursos na IBM Cloud. Quando você instala a CLI autônoma IBM Cloud Você obtém apenas a própria CLI, sem nenhum plug-in ou ferramenta recomendada.

Se você quiser instalar a última versão da IBM Cloud CLI e outros plug-ins e ferramentas recomendados para o desenvolvimento de aplicativos para IBM Cloud, consulte Introdução à IBM Cloud CLI e Estendendo IBM Cloud CLI com plug-ins.

Antes de Iniciar

Se você precisar usar uma versão de 32 bits ou uma versão anterior que não seja a mais recente para IBM Cloud Ambientes dedicados, consulte IBM Cloud Versões da CLI.

Instalando com um instalador

Use as etapas a seguir para instalar a CLI do IBM Cloud independente mais recente:

  1. Use um navegador para acessar o repositório GitHub oficial ibm-cloud-cli-releases e selecione o instalador de seu S.O. para iniciar o download. Os seguintes sistemas operacionais são compatíveis: macOS X de 64 bits, Windows™ de 64 bits, Linux™ x86 de 64 bits e Linux™ LE de 64 bitsppc64le).

  2. Execute o instalador:

    • Para Mac e Windows™, execute o instalador.
    • Para Linux™, extraia o pacote e execute o script install.
  3. Efetue login no IBM Cloud:

    ibmcloud login
    

    Agora, você está pronto para gerenciar os recursos do IBM Cloud . Insira ibmcloud help para visualizar as descrições do comando.

    Se você estiver usando um ID federado, efetue login com uma senha descartável ou uma chave de API.

Instalando usando o shell

Para instalar a CLI mais recente para seu S.O. usando o shell manualmente, use o comando a seguir para seu S.O.:

Caso não queira fazer a instalação a partir do shell, devido à possibilidade de uso de permissões raiz, é possível fazer download e executar o instalador.

  • Para Mac, copie e cole o comando a seguir em um terminal e execute-o:

    curl -fsSL https://clis.cloud.ibm.com/install/osx | sh
    
  • Para Linux™, copie e cole o seguinte comando em um terminal e execute-o:

    curl -fsSL https://clis.cloud.ibm.com/install/linux | sh
    
  • Para Windows™, copie e cole o seguinte comando em um console de terminal do Windows™ PowerShell 5 e execute-o:

    iex (New-Object Net.WebClient).DownloadString('https://clis.cloud.ibm.com/install/powershell')
    

    Se você encontrar erros como ' The underlying connection was closed: An unexpected error occurred on a send, certifique-se de que tenha o .Net Framework 4.5 ou posterior instalado. Tente também ativar o protocolo TLS 1.2 executando o comando a seguir:

    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
    

Instalando em um diretório customizado

Ao usar os instaladores ou um shell script para instalar a CLI do IBM Cloud, ele é instalado em seus diretórios do sistema. Se você desejar especificar um diretório diferente, use as etapas a seguir.

Se você instalar a CLI do IBM Cloud em um diretório customizado, o comando ibmcloud update não poderá ser usado para atualizar a CLI.

  1. Use um navegador para acessar o repositório GitHub oficial ibm-cloud-cli-releases e selecione o binário correspondente de sua plataforma para iniciar o download. As plataformas a seguir são suportadas: macOS, linux32, linux64, ppc64le, win32 e win64.

  2. Extraia o pacote em um diretório que você especificar.

    É possível ver o conteúdo extraído a seguir:

    Para Linux™ e Mac:

    IBM_Cloud_CLI
    ├── LICENSE
    ├── NOTICE
    ├── autocomplete
    │   ├── bash_autocomplete
    │   └── zsh_autocomplete
    ├── ibmcloud
    └── ibmcloud-analytics
    

    Para Windows™:

    IBM_Cloud_CLI
    ├── LICENSE
    ├── NOTICE
    ├── ibmcloud-analytics.exe
    └── ibmcloud.exe
    
  3. Inclua na variável de ambiente PATH e ative a conclusão automática do shell.

Atualizando a CLI do IBM Cloud

Use a versão mais recente da CLI. Se você não estiver usando a versão mais recente, execute o comando a seguir para atualizar sua CLI:

ibmcloud update

Para determinar a versão da CLI do IBM Cloud, execute o comando a seguir:

ibmcloud -v

Se você estiver executando a liberação atual, a saída a seguir será exibida:

Checking for updates...
No update required. Your CLI is already up-to-date.

Para ser notificado sobre novas versões IBM Cloud CLI, assine o repositório de versões da IBM Cloud Repositório de versões da CLI.