Configurazione della CLI

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

Ambienti supportati per la CLI di Code Engine

La CLI di Code Engine supporta i seguenti ambienti:

  • Linux 64 bit
  • Linux ARM a 64 bit
  • Linux 32 bit
  • Mac OS X 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 di IBM Cloud.

Prima di iniziare

È necessario creare un account su IBM Cloud.

  1. Scarica e installa la CLI di IBM Cloud.

    Questa installazione include i seguenti file:

    • IBM Cloud Object Storage plug-in
    • IBM Cloud Container Registry plug-in
    • IBM Cloud Kubernetes Service plug-in

    Per ulteriori informazioni, vedi CLI IBM 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 istruzioni o utilizza il target per selezionare il tuo account IBM Cloud.

    ibmcloud target -c <account_id>
    
  4. Devi specificare anche una regione. È possibile utilizzare il target per selezionare 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_id> 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 di Code Engine.

Assicurati di aver installato l'ultima versione della CLI di IBM Cloud. In caso contrario, l'installazione della CLI di Code Engine potrebbe non andare a buon fine, 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. Utilizza il 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 di “ Code Engine ”, utilizzare ibmcloud code-engine oppure ibmcloud ce. Per scoprire tutte le funzionalità del plug-in " Code Engine ", esegui ibmcloud ce senza argomenti.

    ibmcloud ce
    

Se lo desideri, puoi installare il pacchetto jq. Molti comandi di Code Engine includono un'opzione (--output JSON) per generare un output in formato JSON. Con questo pacchetto è possibile visualizzare e analizzare le risposte JSON dalla riga di comando.

Per ulteriori informazioni sui comandi di “ Code Engine ”, consultare la sezione “ ibmcloud ce ”.

Aggiornamento della CLI Code Engine

Aggiornare periodicamente la CLI per poter usufruire delle nuove funzionalità.

  1. Per visualizzare l'elenco dei plug-in attualmente installati, esegui il ibmcloud plugin list comando.

    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, esegui il ibmcloud plugin update comando.

    ibmcloud plugin update code-engine
    

Disinstallazione della CLI

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

  1. Elenca i plug-in installati.

    ibmcloud plugin list
    
  2. Disinstallare i plug-in. Ad esempio, per disinstallare il plug-in CLI di 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 plug-in che hai eliminato non vengono visualizzati nei risultati.

Come accedere a IBM Cloud Shell dal proprio browser web

Con il IBM® Cloud Shell, è possibile utilizzare la CLI di IBM Cloud e altri plug-in CLI direttamente dal proprio browser web.

IBM Cloud Shell è supportato da diversi plug-in e strumenti, tra cui la CLI di base di IBM Cloud (ibmcloud) e la CLI di Code Engine.

Quando utilizzi l' Cloud Shell, tieni presente 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 scaricati e modificati localmente, come i file YAML, vengono memorizzati temporaneamente nella cartella " Cloud Shell " e non vengono conservati tra una sessione e l'altra.
  • Cloud Shell prevede una quota di utilizzo che limita l'accesso a 50 ore alla settimana.

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