Configurando a CLI

Instale, atualize e exclua as CLIs necessárias e configure seu ambiente para usar o IBM Cloud® Code Engine.

Ambientes suportados para a CLI do Code Engine

A CLI do Code Engine suporta os ambientes a seguir:

Linux de 64 bits
Linux ARM de 64 bits
Linux de 32 bits
Mac OS X 64 bit
Mac OS X M1/ARM
Windows 64 bit
Windows 32 bit

Instalando a CLI da IBM Cloud

Instale a versão mais recente da CLI da IBM Cloud.

Antes de iniciar

Você deve criar um IBM Cloud conta.

Faça download e instale o IBM Cloud CLI.

Esta instalação inclui os arquivos a seguir:
- Plug-in da IBM Cloud Functions
- Plug-in do IBM Cloud Object Storage
- Plug-in do IBM Cloud Container Registry
- Plug-in do IBM Cloud Kubernetes Service
Para obter mais informações, consulte CLI da IBM Cloud.
Efetue login na CLI do IBM Cloud .
```
ibmcloud login
```
Se você tiver mais de uma conta, será solicitado que selecione qual conta será usada. Siga os prompts ou use o comando target para selecionar sua conta do IBM Cloud.
```
ibmcloud target -c <account_id>
```
Também deve-se especificar uma região. É possível usar o comando target para direcionar ou mudar regiões.
```
ibmcloud target -r <region>
```

Deve-se especificar um grupo de recursos. Para obter uma lista de seus grupos de recursos, execute o comando a seguir.

ibmcloud resource groups

Saída de exemplo

Retrieving all resource groups under account <account_name> as email@ibm.com...
OK
Name      ID                                 Default Group   State   
default   a8a12accd63b437bbd6d58fb8b462ca7   true            ACTIVE
test      a8a12abbbd63b437cca6d58fb8b462ca7  false           ACTIVE

Direcione um grupo de recursos executando o comando a seguir.
```
ibmcloud target -g <resource_group>
```
Saída de exemplo
```
Targeted resource group default
```

Instalando o plug-in da CLI do Code Engine

Instale a versão mais recente da CLI do Code Engine.

Certifique-se de ter instalado a versão mais recente da CLI da IBM Cloud. Caso contrário, a instalação da CLI do Code Engine poderá falhar com uma mensagem semelhante a Could not find compatible binary to install for plug-in code-engine.

Instale o plug-in do Code Engine.
```
ibmcloud plugin install code-engine
```

Use o comando ibmcloud plugin show code-engine para verificar se o plug-in está instalado.

ibmcloud plugin show code-engine

Saída de exemplo

Plugin Name                              code-engine[ce]
Plugin Version                           1.31.0
Plugin SDK Version                       0.9.0
Minimal IBM Cloud CLI version required   1.0.0
Private endpoints supported              true

Commands:
code-engine,ce                    Manage Code Engine components.
[...]

Para executar comandos do Code Engine, use ibmcloud code-engine ou ibmcloud ce. Para ver tudo o que é possível fazer com o plug-in do Code Engine, execute ibmcloud ce sem argumentos.
```
ibmcloud ce
```

Opcionalmente, é possível instalar o pacote jq. Muitos comandos do Code Engine incluem uma opção (--output JSON) para criar a saída JSON. Com esse pacote, é possível visualizar e analisar respostas JSON na linha de comandos.

Para obter mais informações sobre os comandos do Code Engine, consulte os comandos ibmcloud ce.

Atualizando a CLI do Code Engine

Atualize a CLI periodicamente para aproveitar os novos recursos.

Visualize sua lista de plug-ins atual executando o comando ibmcloud plugin list.

ibmcloud plugin list

Saída de exemplo

Listing installed plug-ins...

Plugin Name                                  Version   Status             Private endpoints supported
code-engine[ce]                              1.31.0                       true
container-registry                           0.1.571                      true
container-service[kubernetes-service]        1.0.408                      false

Se uma atualização estiver disponível, execute o comando ibmcloud plugin update.
```
ibmcloud plugin update code-engine
```

Desinstalando a CLI

Se você não precisar mais da CLI, será possível desinstalá-la.

Liste os plug-ins instalados.
```
ibmcloud plugin list
```
Desinstale os plug-ins. Por exemplo, para desinstalar o plug-in da CLI do Code Engine:
```
ibmcloud plugin uninstall code-engine
```
Verifique se os plug-ins foram desinstalados executando o comando a seguir e verificando a lista dos plug-ins instalados.
```
ibmcloud plugin list
```

Os plug-ins excluídos não são exibidos nos resultados.

Acessando o IBM Cloud Shell em seu navegador web

Com o IBM® Cloud Shell, você pode usar a CLI IBM Cloud e outros plug-ins CLI diretamente do seu navegador web.

O IBM Cloud Shell é ativado com vários plug-ins e ferramentas, incluindo a base IBM Cloud CLI (ibmcloud) e a CLI Code Engine CLI.

Enquanto você usa o Cloud Shell, tenha em mente as seguintes limitações.

Você pode abrir até cinco sessões simultâneas, que operam de forma independente para que você possa trabalhar com diferentes recursos, regiões e contas de uma só vez.
Quaisquer arquivos transferidos por download e editados localmente, como arquivos YAML, são armazenados temporariamente no Cloud Shell e não persistem nas sessões.
O Cloud Shell tem uma cota de uso que limita você a 50 horas dentro de uma semana.

Para lançar e utilizar o IBM Cloud Shell, na barra de menus IBM Cloud console , clique no ícone Cloud Shell IBM Cloud Shell ícone . Uma sessão é iniciada e registra automaticamente você na CLI do IBM Cloud com suas credenciais de conta atuais.