Configurazione della CLI

Installa, aggiorna ed elimina le CLI richieste e configura il tuo ambiente per utilizzare IBM Cloud® Code Engine.

Ambienti supportati per la CLI Code Engine

La CLI Code Engine supporta i seguenti ambienti:

  • Linux a 64 bit
  • Linux ARM a 64 bit
  • Linux a 32 bit
  • Mac OS X a 64 bit
  • Mac OS X M1/ARM
  • Windows a 64 bit
  • Windows a 32 bit

Installazione della CLI IBM Cloud

Installa l'ultima versione della CLI IBM Cloud .

Prima di iniziare

Devi creare un accountIBM Cloud.

  1. Scarica e installa la CLIIBM Cloud.

    Questa installazione include i seguenti file:

    • Plugin IBM Cloud Functions
    • Plugin IBM Cloud Object Storage
    • Plugin di IBM Cloud Container Registry
    • Plug-in IBM Cloud Kubernetes Service

    Per ulteriori informazioni, vedi CLIIBM Cloud.

  2. Accedi alla CLI IBM Cloud.

    ibmcloud login
    
  3. Se hai più di un account, ti viene richiesto di selezionare quale utilizzare. Segui le richieste o utilizza il comando target per selezionare il tuo account IBM Cloud .

    ibmcloud target -c <account_id>
    
  4. Devi specificare anche una regione. È possibile utilizzare il comando target per specificare o modificare le regioni.

    ibmcloud target -r <region>
    
  5. Devi specificare un gruppo di risorse. Per ottenere un elenco dei tuoi gruppi di risorse, immetti il seguente comando.

    ibmcloud resource groups
    

    Output di esempio

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

    ibmcloud target -g <resource_group>
    

    Output di esempio

    Targeted resource group default
    

Installazione del plugin della CLI Code Engine

Installa l'ultima versione della CLI Code Engine .

Assicurati di aver installato la versione più recente della CLI IBM Cloud . Altrimenti, l'installazione della CLI Code Engine potrebbe non riuscire con un messaggio simile a Could not find compatible binary to install for plug-in code-engine.

  1. Installa il plug-in Code Engine.

    ibmcloud plugin install code-engine
    
  2. Utilizzare il comando ibmcloud plugin show code-engine per verificare che il plug-in sia installato.

    ibmcloud plugin show code-engine
    

    Output di esempio

    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.
    [...]
    
  3. Per eseguire i comandi Code Engine , utilizza ibmcloud code-engine o ibmcloud ce. Per visualizzare tutto ciò che puoi fare con il plug-in Code Engine , esegui ibmcloud ce senza argomenti.

    ibmcloud ce
    

Facoltativamente, è possibile installare il pacchetto jq. Molti comandi Code Engine includono un'opzione (--output JSON) per creare l'output JSON. Con questo pacchetto, puoi visualizzare e analizzare le risposte JSON dalla riga di comando.

Per ulteriori informazioni sui comandi Code Engine , vedi i comandi**ibmcloud ce**.

Aggiornamento della CLI Code Engine

Aggiorna periodicamente la CLI per sfruttare le nuove funzionalità.

  1. Visualizzare l'elenco di plugin corrente eseguendo il comando ibmcloud plugin list .

    ibmcloud plugin list
    

    Output di esempio

    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
    
  2. Se è disponibile un aggiornamento, eseguire il comando ibmcloud plugin update .

    ibmcloud plugin update code-engine
    

Disinstallazione della CLI

Se non hai più bisogno della CLI, puoi disinstallarla.

  1. Elencare i plug-in installati.

    ibmcloud plugin list
    
  2. Disinstallare i plug - in. Ad esempio, per disinstallare il plugin CLI Code Engine :

    ibmcloud plugin uninstall code-engine
    
  3. Verifica che i plugin siano stati disinstallati eseguendo questo comando e controllando l'elenco dei plugin installati.

    ibmcloud plugin list
    

I plugin eliminati non vengono visualizzati nei risultati.

Accesso a IBM Cloud Shell nel tuo browser web

Con IBM® Cloud Shell, puoi utilizzare la CLI IBM Cloud e altri plug-in della CLI direttamente dal tuo browser web.

IBM Cloud Shell è abilitato con diversi plugin e strumenti, incluso la CLI di base IBM Cloud (ibmcloud) e la CLI Code Engine .

Mentre utilizzi Cloud Shell, tieni a mente le seguenti limitazioni.

  • Puoi aprire fino a cinque sessioni simultanee, che operano indipendentemente in modo da consentirti di lavorare con risorse, regioni ed account differenti contemporaneamente.
  • Tutti i file che scarichi e modifichi localmente, come ad esempio i file YAML, vengono memorizzati temporaneamente in Cloud Shell e non persistono tra le sessioni.
  • Cloud Shell ha una quota di utilizzo che ti limita a 50 ore in una settimana.

Per avviare e utilizzare la IBM Cloud Shell, nella barra dei menu della consoleIBM Cloud , fai clic sull'icona Cloud Shell IBM Cloud Shell. Una sessione viene avviata e ti collega automaticamente alla CLI IBM Cloud con le tue credenziali dell'account correnti.