Iniciación a la CLI de Code Engine

Puede utilizar la API de IBM Cloud® Code Engine para crear y gestionar las entidades de Code Engine.

Configuración de tu entorno de CLI

Para trabajar con la CLI para crear y gestionar entidades Code Engine, configure el entorno de CLI. Asegúrate de tener instalada 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.

Inicie una sesión en la CLI de IBM Cloud.

Inicie una sesión en la CLI de IBM Cloud.

    ibmcloud login
    ```
2. 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.

```txt {: pre}
    ibmcloud target -c <account_id>
    ```
3. Especifique una región. Utiliza el **`target`** comando para seleccionar o cambiar de región.

```txt {: pre}
    ibmcloud target -r <region>
    ```
4. Especifique un grupo de recursos. Para obtener una lista de los grupos de recursos, ejecute el mandato siguiente.

```txt {: pre}
    ibmcloud resource groups
    ```
    Salida de ejemplo

    ```txt {: screen}
    Retrieving all resource groups under account <account_id> as email@ibm.com...
    OK
    Name      ID                                 Default Group   State   
    default   a8a12accd63b437bbd6d58fb8b462ca7   true            ACTIVE
    test      a8a12abbbd63b437cca6d58fb8b462ca7  false           ACTIVE
    ```
5. Puede establecer como destino un grupo de recursos ejecutando el mandato siguiente.

```txt {: pre}
    ibmcloud target -g <resource_group>
    ```
    Salida de ejemplo

    ```txt {: screen}
    Targeted resource group default
    ```

Instale el plugin de la CLI de Code Engine.
```
ibmcloud plugin install code-engine
```
Comprueba que el complemento de la CLI de « Code Engine » esté instalado. Puede utilizar el mandato ibmcloud code-engine version o el mandato ibmcloud plugin list para confirmar que el plugin está instalado.
```
ibmcloud code-engine version
```
Salida de ejemplo
```
OK
version:  v1.54.2
commit:   e4800be63b1077563bdbaee9e656ce1f81c3e08d
```
Ejecute el mandato ibmcloud ce help para ver los mandatos para la CLI Code Engine. Por ejemplo:
```
ibmcloud ce help
```

Cómo trabajar con la CLI de Code Engine

Ahora que se ha configurado el entorno CLI de Code Engine, está preparado para trabajar con recursos de Code Engine, como aplicaciones, funciones o trabajos con la CLI.

Para poder trabajar con recursos Code Engine, debe trabajar en el contexto de un proyecto.

Un proyecto es un conjunto de entidades de Code Engine, como aplicaciones, funciones, trabajos, flotas y compilaciones. Un proyecto se basa en un espacio de nombres de Kubernetes. El nombre del proyecto debe ser exclusivo en el grupo de recursos, la cuenta de usuario y la región de IBM Cloud®. Los proyectos se utilizan para gestionar recursos y facilitar el acceso a sus entidades.

Un proyecto ofrece las siguientes funciones:

Un espacio de nombres único para los nombres de las entidades.
Gestión del acceso de los usuarios a los recursos del proyecto.
Gestión del acceso externo a los servicios de respaldo, los registros y los repositorios.
Un certificado generado automáticamente para el Servicio de la Capa de Transporte ( TLS ).

Para obtener más información sobre los proyectos Code Engine, consulte Gestión de proyectos.

Cree un proyecto con el mandato project create. Utilice un nombre de proyecto que sea exclusivo de la región.
```
ibmcloud ce project create --name PROJECT_NAME
```
Salida de ejemplo
```
Creating project 'myproject'...
OK
```

Ver detalles sobre el proyecto con el mandato project get.

ibmcloud ce project get --name PROJECT_NAME

Salida de ejemplo

Getting project 'myproject'...
OK
Name:                       myproject
ID:                         01234567-abcd-abcd-abcd-abcdabcd1111
Status:                     active
Selected:                   true
Region:                     us-south
Resource Group:             default
Service Binding Service ID: ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f
Age:                        52d
Created:                    Fri, 15 Jan 2021 13:32:30 -0500
Updated:                    Fri, 15 Jan 2021 13:32:45 -0500
Quotas:
Category                                  Used      Limit
App revisions                             1         100
Apps                                      1         100
Build runs                                0         100
Builds                                    0         100
Configmaps                                2         100
CPU                                       1.025     64
Ephemeral storage                         902625Ki  256G
Instances (active)                        1         250
Instances (total)                         2         2500
Job runs                                  1         100
Jobs                                      1         100
Memory                                    4400M     256G
Secrets                                   5         100
Subscriptions (cron)                      0         100
Subscriptions (IBM Cloud Object Storage)  0         100

De forma alternativa, puede utilizar el mandato project list para visualizar una lista de los proyectos creados.

Para trabajar con un proyecto con la CLI, el proyecto se debe seleccionar como contexto actual. Un proyecto se selecciona automáticamente como contexto actual cuando se crea, a menos que se especifique la opción --no-select. Para seleccionar un proyecto que no esté actualmente como destino, utilice el mandato project select.

Para obtener más información sobre cómo trabajar con proyectos, consulte Ejecución de trabajos.

Próximos pasos

Ahora que ha configurado el entorno de CLI y ha realizado los primeros pasos para asegurarse de que está trabajando en el contexto de una CLI de Code Engine, puede utilizar la CLI de Code Engine para trabajar con apps, funciones y trabajos.

Para empezar a trabajar con los componentes de Code Engine con la CLI, consulte los temas siguientes.

Para obtener más información sobre la CLI Code Engine, consulte Configuración del entorno de CLI.

Para obtener más información sobre cómo trabajar en el entorno de CLI Code Engine, consulte la documentación de referencia de mandatos de CLI deCode Engine.

Para obtener un resumen de los cambios para cada versión de la CLI, consulte Historial de versiones de CLI. Asegúrese de mantener la CLI actualizada para que pueda utilizar todos los mandatos disponibles y sus opciones.