IBM Cloud Docs
Introdução à CLI do IBM Cloud

Introdução à CLI do IBM Cloud

Neste tutorial, você instala a versão mais recente da interface de linha de comando autônoma IBM Cloud®.

Quer começar a trabalhar com a CLI do IBM Cloud? Experimente o IBM Cloud Shell, que oferece a você um espaço de trabalho de shell pessoal baseado na nuvem com a CLI IBM Cloud completa e várias ferramentas de linha de comando, sem necessidade de instalação. Para iniciar, clique no ícone Cloud Shell IBM Cloud Shell ícone na barra de menus do console IBM Cloud. Para obter mais informações, consulte Introdução ao IBM Cloud Shell.

Antes de Iniciar

  • Dependendo do seu IBM Cloud® tipo de conta, o acesso a determinados recursos pode ser limitado ou restrito. Dependendo de seus limites de plano, determinadas capacidades que são requeridas por algumas cadeias de ferramentas podem não estar disponíveis. Para obter mais informações, consulte Configurando a sua conta da IBM Cloud.
  • Para Linux™, instale o comando curl para fazer download de pacotes por meio da linha de comando. Se curl já estiver instalado, o instalador o atualizará para a versão mais recente.

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

Execute o comando de instalação

A versão mais recente da CLI do IBM Cloud será instalada quando você executar o comando. Conforme a CLI é instalada, fique de olho na linha de comandos para autenticar conforme necessário.

  • No MacOS, execute o comando a seguir:

    curl -fsSL https://clis.cloud.ibm.com/install/osx | sh
    
  • Para Linux™, execute o comando a seguir:

    curl -fsSL https://clis.cloud.ibm.com/install/linux | sh
    
  • No Windows™, execute o seguinte comando no PowerShell como administrador:

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

    Para abrir o PowerShell, clique com o botão direito no ícone do Windows™ PowerShell e selecione Executar como administrador.

  • Para WSL2 no Windows™, execute o comando a seguir:

    curl -fsSL https://clis.cloud.ibm.com/install/linux | sh
    

Verifique a instalação

Para verificar se a CLI foi instalada com sucesso, execute o comando help:

ibmcloud help

A saída lista as instruções de uso, a versão atual e os comandos suportados.

Instalar plug-ins e ferramentas da CLI

Para instalar manualmente os plug-ins e ferramentas da CLI, consulte Estendendo a IBM Cloud CLI com plug-ins.

Configure seu ambiente

Efetue login na IBM Cloud com seu IBMid. Se você tiver múltiplas contas, deverá selecionar qual conta usar. Se você não especificar uma região com o sinalizador -r, deverá também selecionar uma região.

ibmcloud login

Se as suas credenciais forem rejeitadas, talvez você esteja usando um ID federado. Para efetuar login com um ID federado, use a sinalização --sso. Consulte Efetuando login com um ID federado para obter mais detalhes.

Próximas etapas

Se você instalou os plug-ins e as ferramentas da CLI, poderá começar a usar IBM Cloud recursos e serviços na CLI. Para obter mais informações, consulte Geral IBM Cloud comandos da CLI(ibmcloud). Além disso, tenha em mente a página Obtendo ajuda e suporte se você tiver perguntas ou problemas

Mantenha-se atualizado com a IBM Cloud CLI assinando o IBM Cloud repositório de versões da CLI. Você receberá notificações sobre novas liberações da CLI do IBM Cloud.

A CLI do IBM Cloud suporta uma estrutura de plug-in para ampliar sua capacidade. Descubra e instale novos plug-ins da CLI!

Precisa de ajuda para lembrar os comandos da CLI do IBM Cloud? Imprima a IBM Cloud referência rápida da CLI para manter os comandos de tarefas comuns na ponta de seus dedos.