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:
-
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). -
Execute o instalador:
- Para Mac e Windows™, execute o instalador.
- Para Linux™, extraia o pacote e execute o script
install
.
-
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.
-
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. -
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
-
Inclua na variável de ambiente
PATH
e ative a conclusão automática do shell.- Inclua o
{YOUR_DIRECTORY}/IBM_CLOUD_CLI
na variável de ambientePATH
. - Para suporte à conclusão automática de shell (somente Mac e Linux™), consulte Ativando a conclusão automática de shell para a IBM Cloud CLI.
- Inclua o
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.