Configuración de la CLI

Instale, actualice y suprima las CLI necesarias y configure el entorno para que utilice IBM Cloud® Code Engine.

Entornos soportados para la CLI de Code Engine

La CLI de Code Engine da soporte a los siguientes entornos:

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

Instalación de la CLI de IBM Cloud

Instale la última versión de la CLI de IBM Cloud.

Antes de empezar

Debe crear una cuenta deIBM Cloud.

Descargue e instale la CLI de IBM Cloud.

Esta instalación incluye los siguientes archivos:
- Plugin de IBM Cloud Functions
- Plugin de IBM Cloud Object Storage
- Plugin de IBM Cloud Container Registry
- Plugin del servicio Kubernetes de IBM Cloud
Para obtener más información, consulte el tema sobre CLI de IBM Cloud.
Inicie una sesión en la CLI de IBM Cloud.
```
ibmcloud login
```
Si tiene más de una cuenta, se le solicitará que seleccione la cuenta a utilizar. Siga las indicaciones o utilice el mandato target para seleccionar su cuenta de IBM Cloud.
```
ibmcloud target -c <account_id>
```
También debe especificar una región. Puede utilizar el mandato target para especificar o cambiar las regiones.
```
ibmcloud target -r <region>
```

Debe especificar un grupo de recursos. Para obtener una lista de los grupos de recursos, ejecute el mandato siguiente.

ibmcloud resource groups

Salida de ejemplo

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

Puede establecer como destino un grupo de recursos ejecutando el mandato siguiente.
```
ibmcloud target -g <resource_group>
```
Salida de ejemplo
```
Targeted resource group default
```

Instalación del plugin de CLI de Code Engine

Instale la última versión de la CLI de Code Engine.

Asegúrese de que ha instalado la última versión de la CLI de IBM Cloud. De lo contrario, es posible que la instalación de la CLI de Code Engine falle con un mensaje que indica que Could not find compatible binary to install for plug-in code-engine.

Instale el plugin de Code Engine.
```
ibmcloud plugin install code-engine
```

Utilice el mandato ibmcloud plugin show code-engine para verificar que el plugin está instalado.

ibmcloud plugin show code-engine

Salida de ejemplo

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 ejecutar mandatos de Code Engine, utilice ibmcloud code-engine o ibmcloud ce. Para ver todo lo que puede hacer con el plugin de Code Engine, ejecute ibmcloud ce sin argumentos.
```
ibmcloud ce
```

Opcionalmente, puede instalar el paquete de jq. Muchos mandatos de Code Engine incluyen una opción (--output JSON) para crear una salida JSON. Con este paquete, puede ver y analizar respuestas JSON desde la línea de mandatos.

Para obtener más información sobre los mandatos de Code Engine, consulte los mandatos ibmcloud ce.

Actualización de la CLI de Code Engine

Actualice la CLI periódicamente para aprovechar las nuevas características.

Visualice la lista actual de plugins con el mandato ibmcloud plugin list.

ibmcloud plugin list

Salida de ejemplo

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

Si hay una actualización disponible, ejecute el mandato ibmcloud plugin update.
```
ibmcloud plugin update code-engine
```

Desinstalación de la CLI

Si ya no necesita una CLI, puede desinstalarla.

Obtenga una lista de los plugins que están instalados.
```
ibmcloud plugin list
```
Desinstale los plugins. Por ejemplo, para desinstalar el plugin de CLI de Code Engine:
```
ibmcloud plugin uninstall code-engine
```
Para verificar la desinstalación de los plugins, ejecute el mandato siguiente y compruebe la lista de plugins de instalados.
```
ibmcloud plugin list
```

Los plugins que ha suprimido no se muestran en los resultados.

Acceso a IBM Cloud Shell en el navegador web

Con IBM® Cloud Shell, puede utilizar la CLI de IBM Cloud y otros plugins de CLI directamente desde el navegador web.

IBM Cloud Shell está habilitado con varios plugins y herramientas, incluida la CLI base de IBM Cloud (ibmcloud) y la CLI de Code Engine .

Mientras utiliza Cloud Shell, tenga en cuenta las limitaciones siguientes.

Puede abrir hasta cinco sesiones simultáneas, que funcionan de forma independiente, para poder trabajar con distintos recursos, regiones y cuentas al mismo tiempo.
Los archivos que descargue y edite localmente, por ejemplo, los archivos YAML, se almacenan temporalmente en Cloud Shell y no persisten de una sesión a otra.
Cloud Shell tiene una cuota de uso que le limita a 50 horas por semana.

Para iniciar y utilizar la barra de menús IBM Cloud Shell, en la barra de menús IBM Cloud , pulse el icono Cloud Shell . Se inicia una sesión y le registra automáticamente en la CLI de IBM Cloud con las credenciales de la cuenta actual.