Instalando a CLI IBM Cloud Independente

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

Se você quiser instalar a CLI mais recente do IBM Cloud e outros plug-ins e ferramentas recomendados para o desenvolvimento de aplicativos para o IBM Cloud, consulte Introdução à CLI do IBM Cloud e Extensão da CLI do IBM Cloud com plug-ins.

Antes de Iniciar

Se precisar usar uma versão de 32 bits ou uma versão anterior que não seja a mais recente para ambientes dedicados IBM Cloud, consulte IBM Cloud CLI releases.

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 64-bit, Windows™ 64-bit, Linux™ x86 64-bit e Linux™ LE 64-bit ( ppc64le ).
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
```
No 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 o.Net Framework 4.5 ou posterior esteja 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 ambiente PATH.
- 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.

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 receber notificações sobre novas versões da CLI do IBM Cloud, assine o repositório de versões da CLI do IBM Cloud.