Aggiunta e rimozione di plug-in della CLI IBM Cloud (ibmcloud plugin)

IBM Cloud® supporta un framework di plug-in per estendere la sua funzionalità. Utilizza i seguenti comandi per gestire i plugin della CLI (Command Line Interface) IBM Cloud.

ibmcloud plugin repos

Per trovare i repository di plug-in che si desidera aggiungere, è possibile elencare tutti i repository di plug-in registrati in IBM Cloud CLI.

ibmcloud plugin repos

ibmcloud plugin repo-add

Aggiungi un nuovo repository di plug-in alla CLI IBM Cloud.

ibmcloud plugin repo-add REPO_NAME REPO_URL

Opzioni comando:

NOME_REPOSITORY (obbligatorio): Il nome del repository da aggiungere. Puoi definire un tuo nome per ciascun repository.
URL_REPOSITORY (obbligatorio): L'URL del repository da aggiungere. Il repository URL deve contenere il protocollo (ad esempio, https://plugins.cloud.ibm.com invece di plugins.cloud.ibm.com). https://plugins.cloud.ibm.com è il repository ufficiale dei plug-in di IBM Cloud CLI.

Esempi:

Aggiungi il repository di plug-in ufficiale della CLI IBM Cloud come ibmcloud-repo:

ibmcloud plugin repo-add ibmcloud-repo https://plugins.cloud.ibm.com

ibmcloud plugin repo-remove

Rimuovi un repository di plug-in dalla CLI IBM Cloud.

ibmcloud plugin repo-remove REPO_NAME

Opzioni comando:

NOME_REPOSITORY (obbligatorio): Il nome del repository da rimuovere.

Esempi:

Rimuove il repository ibmcloud-repo dalla CLI IBM Cloud:

ibmcloud plugin repo-remove ibmcloud-repo

ibmcloud plugin repo-plugins

Elenca tutti i plug-in disponibili in tutti i repository aggiunti o in uno specifico repository.

ibmcloud plugin repo-plugins [-r REPO_NAME]

Opzioni comando:

-r NOME REPO (facoltativo): Elenca solo i plug-in nel repository specificato.

Esempi:

Elenca tutti i plug-in in tutti i repository aggiunti:

ibmcloud plugin repo-plugins

Elenca tutti i plug-in nel repository ibmcloud-repo:

ibmcloud plugin repo-plugins -r ibmcloud-repo

ibmcloud plugin repo-plugin

Mostra i dettagli di un plug-in nel repository.

ibmcloud plugin repo-plugin PLUGIN_NAME [-r REPO_NAME]

Opzioni comando:

-r NOME REPO (facoltativo): Il nome del repository. Se non viene specificato alcun repository, il comando utilizza il repository di plug-in predefinito.

Esempi:

Elenca i dettagli del plugin "IBM-Containers" nel repository "sample-repo":

ibmcloud plugin repo-plugin IBM-Containers -r sample-repo

Elencare i dettagli del plug-in " IBM-Containers" nel repository predefinito

ibmcloud plugin repo-plugin IBM-Containers -r sample-repo

ibmcloud plugin list

Elenca tutti i plug-in installati nella CLI IBM Cloud. Ogni plug-in restituisce la versione correntemente installata, se è disponibile una versione più recente da aggiornare e se la versione del plug-in installata supporta l'uso di endpoint privati.

ibmcloud plugin list

ibmcloud plugin show

Visualizza i dettagli di un plugin installato.

ibmcloud plugin show PLUGIN-NAME

ibmcloud plugin install

Installa una specifica versione di un plug-in nella CLI IBM Cloud dal repository o dal percorso specificato o da tutti i plug-in disponibili più recenti nel repository.

ibmcloud plugin install PLUGIN_PATH|PLUGIN_NAME [-r REPO_NAME] [-v VERSION] [-f]

ibmcloud plugin install [-a, --all] [-r REPO_NAME] [-f]

ibmcloud plugin install LOCAL-PATH/TO/PLUGIN | URL [-f]

Se non viene specificato alcun repository, il comando utilizza il repository di plug-in predefinito IBM Cloud. Se si sta installando un singolo plug - in e non viene specificata alcuna versione, il comando seleziona l'ultima versione disponibile da installare. Se viene specificato il flag '-a, --all', il comando installa tutti gli ultimi plug-in disponibili nel repository.

Opzioni comando:

PERCORSO_PLUGIN | NOME_PLUGIN: Se -r REPO_NAME non è specificato, il plug-in viene installato dal percorso locale o remoto specificato URL.
-a, --all (opzionale): Installare tutti gli ultimi plug-in disponibili nel repository.
-r NOME REPO (facoltativo): Il nome del repository in cui si trova il file binario del plug-in. Se non viene specificato alcun repository, il comando utilizza il repository di plug-in predefinito IBM Cloud.
-v VERSIONE (opzionale): La versione del plug-in da installare. Accetta versione o vincolo semantici specifici.
-f (facoltativo): Forza l'installazione del plug-in senza conferma.

La CLI IBM Cloud ha il nome repository ufficiale di IBM Cloud.

Esempi:

Installa un plug-in dal file locale:

ibmcloud plugin install /downloads/new_plugin

Installa un plug-in dall'URL remoto:

ibmcloud plugin install http://example.com/downloads/my-plugin

Installa il plug-in container-service dell'ultima versione dal repository IBM Cloud:

ibmcloud plugin install container-service -r "IBM Cloud"

oppure puoi eseguire:

ibmcloud plugin install container-service

Installa il plug-in container-service con la versione 0.1.425 dal repository di plug-in ufficiale:

ibmcloud plugin install container-service -v 0.1.425

Installare tutti i plug-in disponibili più recenti dal repository di plug-in ufficiale:

ibmcloud plugin install --all

Installare tutti i plug-in disponibili più recenti dal repository di plug-in ufficiale senza conferma:

ibmcloud plugin install --all -f

Installare più plug-in contemporaneamente:

ibmcloud plugin install container-service@1.0.506 secrets-manager@0.1.25

download plugin ibmcloud

Scarica una versione specifica di un plug-in nella CLI IBM Cloud dal repository specificato o tutti i plug-in disponibili più recenti nel repository.

ibmcloud plugin download PLUGIN_NAME [-r REPO_NAME] [-v VERSION] [-d, --dest DOWNLOAD_DIRECTORY] [-f]

ibmcloud plugin download [-a, --all] [-r REPO_NAME] [-f]

ibmcloud plugin download URL [-f] [-d DOWNLOAD_DIRECTORY]

Se non viene specificato alcun repository, il comando utilizza il repository di plug-in predefinito IBM Cloud. Se si sta scaricando un singolo plug - in e non è specificata alcuna versione, il comando seleziona l'ultima versione disponibile da scaricare. Se viene specificato il flag '-a, --all', il comando scarica tutti gli ultimi plug-in disponibili nel repository.

Opzioni comando:

-a, --all (opzionale): Scarica tutti gli ultimi plug-in disponibili nel repository.
-r NOME REPO (facoltativo): Il nome del repository in cui si trova il file binario del plug-in. Se non viene specificato alcun repository, il comando utilizza il repository di plug-in predefinito IBM Cloud.
-v VERSIONE (opzionale): Versione del plugin di cui eseguire il download. Accetta versione o vincolo semantici specifici.
-d, --dest DOWNLOAD_DIRECTORY (opzionale): La directory di destinazione per il plug-in scaricato. Se non specificato, questa è la directory di lavoro.
-f: Forza il download del plug-in senza conferma.

La CLI IBM Cloud ha il nome repository ufficiale di IBM Cloud.

Esempi:

Scaricare un plug-in dal sito remoto URL:

ibmcloud plugin download http://example.com/downloads/my-plugin

Scaricare il plug-in container-service dell'ultima versione dal repository IBM Cloud:

ibmcloud plugin download container-service -r "IBM Cloud"

oppure puoi eseguire:

ibmcloud plugin download container-service

Scaricare il plug-in container-service con la versione 0.1.425 dal repository ufficiale del plug-in:

ibmcloud plugin download container-service -v 0.1.425

Scaricare il plug-in container-service con versione 0.1.425 dal repository di plug-in ufficiale, nella directory ~/my_downloads:

ibmcloud plugin download container-service -v 0.1.425 -d ~/my_downloads

Scaricare tutti gli ultimi plug-in disponibili dal repository di plug-in ufficiale:

ibmcloud plugin download --all

Scarica tutti i plug-in disponibili più recenti dal repository di plug-in ufficiale senza conferma:

ibmcloud plugin download --all -f

ibmcloud plugin update

Aggiorna il plug-in da un repository.

ibmcloud plugin update [PLUGIN NAME] [-r REPO_NAME] [-v VERSION] [--all]

Se non viene specificato alcun repository, il comando utilizza il repository di plug-in predefinito IBM Cloud. Se non viene specificata alcuna versione, il comando seleziona l'ultima versione disponibile da installare.

Opzioni comando:

NOME PLUGIN: Nome del plug-in da aggiornare. Se non specificato, il comando ricerca gli aggiornamenti per tutti i plug-in installati.
-r NOME_REPOSITORY: Il nome del repository in cui si trova il file binario del plug-in. Se non specificato, il comando utilizza il repository di plug-in predefinito IBM Cloud.
-v VERSIONE (opzionale): La versione a cui aggiornare il plug-in. Se non viene fornita, aggiorna il plug-in alla versione più recente.
--all: Aggiorna tutti i plugin disponibili.

Esempi:

Controlla tutti gli aggiornamenti disponibili nel repository di plug-in ufficiale IBM Cloud:

ibmcloud plugin update -r "IBM Cloud"

oppure puoi eseguire:

ibmcloud plugin update

Aggiornare il plug-in container-service nel repository ufficiale dei plug-in alla versione più recente:

ibmcloud plugin update container-service

Aggiornare il plug-in container-service nel repository ufficiale dei plug-in alla versione ' 0.1.440 ':

ibmcloud plugin update container-service -v 0.1.440

ibmcloud plugin uninstall

Disinstalla il plug-in specificato dalla CLI IBM Cloud.

ibmcloud plugin uninstall PLUGIN_NAME

Opzioni comando:

NOME_PLUGIN (obbligatorio): Il nome del plug-in da disinstallare.

Esempi:

Disinstalla il plug-in 'container-service' precedentemente installato:

ibmcloud plugin uninstall container-service