Introduzione alla CLI Code Engine

È possibile utilizzare l'API IBM Cloud® Code Engine per creare e gestire le entità Code Engine.

Configurazione dell'ambiente CLI

Per lavorare con la CLI per creare e gestire entità Code Engine, configura il tuo ambiente della CLI. Assicurati di avere installata l'ultima versione della CLI di IBM Cloud.

Prima di iniziare

Devi creare un accountIBM Cloud.

  1. Scarica e installa la CLI IBM Cloud.

  2. Accedi alla CLI IBM Cloud.

    1. Accedi alla CLI IBM Cloud.
        ibmcloud login
    ```
2. Se hai più di un account, ti viene richiesto di selezionare quale utilizzare. Segui le istruzioni o utilizza il **`target`** per selezionare il tuo account IBM Cloud.

```txt {: pre}
    ibmcloud target -c <account_id>
    ```
3. Specifica una regione. Utilizza il **`target`** per selezionare o modificare le regioni.

```txt {: pre}
    ibmcloud target -r <region>
    ```
4. Specifica un gruppo di risorse. Per ottenere un elenco dei tuoi gruppi di risorse, immetti il seguente comando.

```txt {: pre}
    ibmcloud resource groups
    ```
    Output di esempio

    ```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. Specifica un gruppo di risorse immettendo il seguente comando:

```txt {: pre}
    ibmcloud target -g <resource_group>
    ```
    Output di esempio

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

  3. Installa il plugin CLI Code Engine.

    ibmcloud plugin install code-engine

  4. Verificare che il plug-in CLI di Code Engine sia installato. È possibile utilizzare il comando ibmcloud code-engine version o il comando ibmcloud plugin list per verificare che il plug-in sia installato.

    ibmcloud code-engine version

    Output di esempio

    OK
version:  v1.54.2
commit:   e4800be63b1077563bdbaee9e656ce1f81c3e08d

  5. Esegui il comando ibmcloud ce help per visualizzare i comandi per la CLI Code Engine. Ad esempio,

    ibmcloud ce help

Utilizzo della CLI Code Engine

Ora che il tuo ambiente CLI Code Engine è configurato, sei pronto a lavorare con Code Engine risorse, come applicazioni, funzioni o lavori con la CLI.

Prima di poter utilizzare le risorse Code Engine, devi lavorare nel contesto di un progetto.

Un progetto è un insieme di entità di Code Engine, quali applicazioni, funzioni, processi, flotte e build. Un progetto è basato su un namespace Kubernetes. Il nome del tuo progetto deve essere univoco all'interno del tuo gruppo di risorse, account utente e regione IBM Cloud®. I progetti servono a gestire le risorse e a fornire accesso alle relative entità.

Un progetto offre le seguenti funzionalità:

  • Uno spazio dei nomi univoco per i nomi delle entità.
  • Gestione degli accessi in entrata alle risorse del progetto.
  • Gestione degli accessi in uscita ai servizi di supporto, ai registri e agli archivi.
  • Un certificato generato automaticamente per il servizio a livello di trasporto ( TLS ).

Per ulteriori informazioni sui progetti Code Engine, vedi Gestione dei progetti.

  1. Creare un progetto con il comando project create. Utilizzare un nome progetto univoco per la propria regione.

    ibmcloud ce project create --name PROJECT_NAME

    Output di esempio

    Creating project 'myproject'...
OK

  2. Visualizzare i dettagli sul progetto con il comando project get.

    ibmcloud ce project get --name PROJECT_NAME

    Output di esempio

    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

In alternativa, è possibile utilizzare il comando project list per visualizzare un elenco dei progetti creati.

Per utilizzare un progetto con CLI, il progetto deve essere selezionato come contesto corrente. Un progetto viene automaticamente selezionato come contesto corrente quando viene creato, a meno che non si specifichi l'opzione --no-select. Per selezionare un progetto che non è attualmente destinato, utilizzare il comando project select.

Per ulteriori informazioni sull'utilizzo dei progetti, consultare Gestione dei progetti.

Passi successivi

Ora che hai configurato il tuo ambiente CLI e hai eseguito i primi passaggi per assicurarti di lavorare nel contesto di un progetto Code Engine, puoi utilizzare la CLI Code Engine per lavorare con applicazioni, funzioni e lavori.

Per iniziare a utilizzare i componenti Code Engine con la CLI, vedi i seguenti argomenti.

Per ulteriori informazioni sulla CLI Code Engine, consulta Configurazione dell'ambiente CLI.

Per ulteriori informazioni sull'utilizzo dell'ambiente CLI Code Engine, vedi Code Engine CLI Command Reference.

Per un riepilogo delle modifiche per ogni versione della CLI, vedi CLI version history. Assicurati di mantenere aggiornata la tua CLI, in modo da poter utilizzare tutti i comandi disponibili e le relative opzioni.