Installazione e gestione dei pacchetti

In questo argomento viene descritto come installare e gestire pacchetti e repository di pacchetti utilizzando la CLI di Tanzu.

Nota

Il plug-in CLI tanzu package è destinato solo ai pacchetti gestiti dalla CLI. Non utilizzare i comandi forniti in questo argomento per installare e gestire pacchetti gestiti automaticamente. Il loro ciclo di vita viene gestito automaticamente da Tanzu Kubernetes Grid. Per ulteriori informazioni sui pacchetti gestiti automaticamente, vedere Pacchetti gestiti automaticamente.

Preparazione all'installazione di pacchetti gestiti dalla CLI

Prima di installare i pacchetti gestiti dalla CLI dal repository dei pacchetti standard:

1. Installare la CLI di Tanzu.
2. Aggiungere il repository dei pacchetti tanzu-standard.
3. Verificare Contenuti del repository standard di Tanzu.
4. Installare cert-manager per la gestione dei certificati nei cluster del carico di lavoro.

Panoramica dell'installazione

Per istruzioni su come installare e gestire i pacchetti utilizzando la CLI di Tanzu, vedere le sezioni seguenti.

• Repository dei pacchetti: Vedere questa sezione se si desidera:

  • Elencare tutti i repository dei pacchetti disponibili per o aggiunti al cluster di destinazione
  • Ottenere i dettagli di un repository di pacchetti disponibile o aggiunto
  • Aggiungere, aggiornare o eliminare un repository di pacchetti

• Pacchetti: Vedere questa sezione se si desidera:

  • Elencare tutti i pacchetti disponibili in o installati nel cluster di destinazione
  • Ottenere i dettagli di un pacchetto disponibile o installato
  • Installare, aggiornare o eliminare un pacchetto

Per ulteriori informazioni sui comandi tanzu package, vedere pacchetto tanzu.

Spazi dei nomi del pacchetto e spazi dei nomi del sistema

È possibile installare repository di pacchetti e pacchetti nello spazio dei nomi desiderato. Se non si imposta l'opzione --namespace, la CLI di Tanzu ha come destinazione lo spazio dei nomi default.

I componenti dei servizi nel pacchetto vengono eseguiti in uno spazio dei nomi del sistema separato da dove vengono distribuiti i pacchetti stessi. Ad esempio, i componenti Contour ed Envoy vengono eseguiti nello spazio dei nomi tanzu-system-ingress e i componenti Harbor vengono eseguiti in tanzu-system-registry.

Non installare pacchetti in spazi dei nomi tanzu-system-.

Repository dei pacchetti

Le sezioni seguenti descrivono come elencare, aggiungere, aggiornare ed eliminare i repository dei pacchetti.

Elenco dei repository dei pacchetti

Il comando tanzu package repository list elenca tutti i repository di pacchetti disponibili nel cluster di destinazione. Questo elenco include i repository di pacchetti che sono stati aggiunti al cluster di destinazione eseguendo il comando tanzu package repository add. Per aggiungere un repository del pacchetto al cluster, vedere Aggiunta di un repository del pacchetto di seguito.

• Per elencare i repository dei pacchetti in tutti gli spazi dei nomi nel cluster di destinazione, eseguire:

  tanzu package repository list -A
  

• Per elencare i repository dei pacchetti in uno spazio dei nomi specifico, eseguire:

  tanzu package repository list -n NAMESPACE
  

  Dove NAMESPACE è lo spazio dei nomi di destinazione. L'opzione --namespace o -n è obbligatoria se si desidera elencare i repository dei pacchetti in uno spazio dei nomi diverso da default.

  Per elencare i repository dei pacchetti nello spazio dei nomi default, è anche possibile eseguire:

  tanzu package repository list
  

Ottenere i dettagli di un repository del pacchetto

Il comando tanzu package repository get recupera i dettagli di un repository del pacchetto.

Per recuperare i dettagli di un repository del pacchetto, eseguire:

tanzu package repository get REPOSITORY-NAME -n REPOSITORY-NAMESPACE

In cui:

• REPOSITORY-NAME è il nome del repository del pacchetto nel cluster di destinazione.
• REPOSITORY-NAMESPACE è lo spazio dei nomi del repository del pacchetto nel cluster di destinazione.

Aggiunta di un repository di pacchetti

Il comando tanzu package repository add aggiunge un repository del pacchetto.

Per aggiungere un repository di pacchetti al cluster di destinazione, eseguire:

tanzu package repository add REPOSITORY-NAME --url REPOSITORY-URL -n REPOSITORY-NAMESPACE

In cui:

• REPOSITORY-NAME è il nome scelto per il repository del pacchetto.
• REPOSITORY-URL è l'URL del registro OCI del repository del pacchetto.
  • Vedere Elenco dei repository dei pacchetti per ottenere questo valore dalla CLI di Tanzu oppure in Tanzu Mission Control vedere l'elenco Elementi aggiuntivi (Addons) > Repository (Repositories) nel riquadro Cluster.
  • Se si omette un tag del repository del pacchetto alla fine dell'URL, il sistema utilizza il tag dalla versione più recente di Tanzu Kubernetes Grid.
  • Questo URL non può essere sotto projects.registry.vmware.com/tce.
• REPOSITORY-NAMESPACE è lo spazio dei nomi di destinazione per il repository del pacchetto. Se questa opzione non è specificata, la CLI di Tanzu aggiunge il repository del pacchetto allo spazio dei nomi default.

Ad esempio, per aggiungere il repository dei pacchetti standard, che contiene i pacchetti gestiti dalla CLI inclusi in Tanzu Kubernetes Grid, eseguire il comando seguente. Il --namespace di destinazione per il repository dei pacchetti standard è tkg-system.

tanzu package repository add tanzu-standard --url projects.registry.vmware.com/tkg/packages/standard/repo:v2023.10.16 --namespace tkg-system

Aggiornamento di un repository del pacchetto

Il comando tanzu package repository update aggiorna un repository del pacchetto con una nuova versione pubblicata in un URL.

Per aggiornare un repository di pacchetti nel cluster di destinazione, eseguire:

tanzu package repository update REPOSITORY-NAME --url REPOSITORY-URL -n REPOSITORY-NAMESPACE

In cui:

• REPOSITORY-NAME è il nome del repository del pacchetto nel cluster.
• REPOSITORY-URL è il nuovo URL del repository del pacchetto. Se non si specifica un tag del repository del pacchetto nell'URL, il sistema utilizza il tag del repository del pacchetto della versione più recente di Tanzu Kubernetes Grid.
• REPOSITORY-NAMESPACE è lo spazio dei nomi del repository del pacchetto nel cluster.

Eliminazione di un repository del pacchetto

Il comando tanzu package repository delete rimuove un repository del pacchetto. Per eliminare un repository del pacchetto dal cluster di destinazione, eseguire:

tanzu package repository delete REPOSITORY-NAME -n REPOSITORY-NAMESPACE

In cui:

• REPOSITORY-NAME è il nome del repository dei pacchetti.
• REPOSITORY-NAMESPACE è lo spazio dei nomi del repository del pacchetto.

Pacchetti

Le sezioni seguenti descrivono come elencare, installare, aggiornare ed eliminare i pacchetti.

Elenco dei pacchetti disponibili

Il comando tanzu package available list elenca tutte le versioni dei pacchetti e i pacchetti disponibili.

Elenco dei pacchetti disponibili:

• Per elencare i pacchetti disponibili in tutti gli spazi dei nomi nel cluster di destinazione, eseguire:

  tanzu package available list -A
  

• Per elencare i pacchetti disponibili in uno spazio dei nomi specifico, eseguire:

  tanzu package available list -n NAMESPACE
  

  Dove NAMESPACE è lo spazio dei nomi da cui recuperare l'elenco dei pacchetti disponibili. Per elencare i pacchetti disponibili nello spazio dei nomi default, è anche possibile eseguire:

  tanzu package available list
  

Elenco delle versioni di pacchetti disponibili:

• Per elencare le versioni dei pacchetti disponibili per un pacchetto in tutti gli spazi dei nomi nel cluster di destinazione, eseguire:

  tanzu package available list AVAILABLE-PACKAGE-NAME -A
  

  Dove AVAILABLE-PACKAGE-NAME è il nome del pacchetto recuperato eseguendo il comando tanzu package available list.

• Per elencare le versioni dei pacchetti disponibili per un pacchetto in uno spazio dei nomi specifico, eseguire:

  tanzu package available list AVAILABLE-PACKAGE-NAME -n AVAILABLE-PACKAGE-NAMESPACE
  

  In cui:

  • AVAILABLE-PACKAGE-NAME è il nome del pacchetto recuperato eseguendo il comando tanzu package available list.
  • AVAILABLE-PACKAGE-NAMESPACE è lo spazio dei nomi del pacchetto disponibile.

  Per elencare le versioni dei pacchetti disponibili per un pacchetto nello spazio dei nomi default, è inoltre possibile eseguire:

  tanzu package available list AVAILABLE-PACKAGE-NAME
  

Ottenere i dettagli di un pacchetto disponibile

Il comando tanzu package available get recupera i dettagli di un pacchetto disponibile.

Per recuperare i dettagli di un pacchetto disponibile, eseguire:

tanzu package available get AVAILABLE-PACKAGE-NAME -n AVAILABLE-PACKAGE-NAMESPACE

Oppure:

tanzu package available get AVAILABLE-PACKAGE-NAME/AVAILABLE-PACKAGE-VERSION -n AVAILABLE-PACKAGE-NAMESPACE

In cui:

• AVAILABLE-PACKAGE-NAME è il nome del pacchetto disponibile. È possibile recuperare questo nome eseguendo il comando tanzu package available list.
• AVAILABLE-PACKAGE-VERSION è la versione del pacchetto disponibile. È possibile recuperare l'elenco delle versioni dei pacchetti disponibili eseguendo il comando tanzu package available list AVAILABLE-PACKAGE-NAME.
• AVAILABLE-PACKAGE-NAMESPACE è lo spazio dei nomi del pacchetto disponibile.

Per recuperare la configurazione predefinita di un pacchetto disponibile, usare il flag --default-values-file-output del comando tanzu package available get:

tanzu package available get AVAILABLE-PACKAGE-NAME/AVAILABLE-PACKAGE-VERSION -n AVAILABLE-PACKAGE-NAMESPACE --default-values-file-output FILE-PATH

Per recuperare lo schema dei valori per un pacchetto disponibile, incluso il valore predefinito per ogni chiave, utilizzare il flag --values-schema del comando tanzu package available get. In questo modo viene recuperata la sezione valuesSchema dalla risorsa API Kubernetes Package per il pacchetto disponibile. È possibile impostare il formato di output, -o, per lo schema dei valori su yaml, json o table.

tanzu package available get AVAILABLE-PACKAGE-NAME/AVAILABLE-PACKAGE-VERSION -n AVAILABLE-PACKAGE-NAMESPACE --values-schema

Elenco dei pacchetti installati

Il comando tanzu package installed list elenca tutti i pacchetti attualmente installati nel cluster di destinazione.

Per elencare i pacchetti installati in tutti gli spazi dei nomi in un cluster, eseguire:

tanzu package installed list -A

Per elencare i pacchetti installati in uno spazio dei nomi specifico, eseguire:

tanzu package installed list -n NAMESPACE

Dove NAMESPACE è lo spazio dei nomi da cui recuperare l'elenco dei pacchetti installati.

Ottenere i dettagli di un pacchetto installato

Il comando tanzu package installed get recupera i dettagli di un pacchetto installato.

Per recuperare i dettagli di un pacchetto installato, eseguire:

tanzu package installed get INSTALLED-PACKAGE-NAME -n INSTALLED-PACKAGE-NAMESPACE

In cui:

• INSTALLED-PACKAGE-NAME è il nome del pacchetto installato.
• INSTALLED-PACKAGE-NAMESPACE è lo spazio dei nomi in cui è installato il pacchetto.

Se si desidera salvare la configurazione corrente di un pacchetto installato in un file, eseguire:

tanzu package installed get INSTALLED-PACKAGE-NAME -n INSTALLED-PACKAGE-NAMESPACE --values-file-output FILE-PATH

Dove FILE-PATH è il percorso del file. Ad esempio, values.yaml.

Installazione di un pacchetto

Il comando tanzu package install installa un pacchetto gestito dalla CLI.

Per installare un pacchetto gestito da CLI nel cluster di destinazione:

1. Se non è già stato fatto, aggiungere il repository del pacchetto che contiene il pacchetto. Vedere la sezione Aggiunta di un repository di pacchetti precedente.

2. Prendere nota del nome e della versione del pacchetto da installare. Per visualizzare il nome e la versione del pacchetto, eseguire il comando tanzu package available list. Vedere la sezione Elenco dei pacchetti disponibili precedente.

3. Installare il pacchetto:

   tanzu package install PACKAGE-NAME -p AVAILABLE-PACKAGE-NAME -v AVAILABLE-PACKAGE-VERSION --values-file PACKAGE-CONFIGURATION-FILE -n TARGET-NAMESPACE
   

   In cui:

   • PACKAGE-NAME è un nome scelto per il pacchetto.
   • AVAILABLE-PACKAGE-NAME è il nome del pacchetto annotato in precedenza.
   • AVAILABLE-PACKAGE-VERSION è la versione del pacchetto annotata in precedenza.
   • PACKAGE-CONFIGURATION-FILE è il file di configurazione preparato per il pacchetto. Se questa opzione non è specificata, il pacchetto viene installato con la configurazione predefinita.

   • TARGET-NAMESPACE è lo spazio dei nomi in cui installare il pacchetto (PackageInstall), l'app del pacchetto (App) e tutte le altre risorse Kubernetes che descrivono il pacchetto. Ad esempio, lo spazio dei nomi my-packages o tanzu-cli-managed-packages.

     • Se il flag -n non viene specificato, la CLI di Tanzu utilizza lo spazio dei nomi default. Non installare il contenuto del pacchetto, ad esempio pod e servizi, in questo spazio dei nomi. Lo spazio dei nomi per il contenuto del pacchetto viene impostato separatamente, nella configurazione del pacchetto.
     • Lo spazio dei nomi specificato deve essere già stato creato, ad esempio eseguendo kubectl create namespace my-packages.

   Per visualizzare l'elenco completo dei flag supportati per questo comando, utilizzare l'opzione --help.

4. Per verificare che il pacchetto sia stato installato, eseguire il comando tanzu package installed list. Vedere la sezione Elenco dei pacchetti installati precedente.

Aggiornamento di un pacchetto

Il comando tanzu package installed update aggiorna la versione e la configurazione di un pacchetto gestito dalla CLI.

Prima di aggiornare la versione di un pacchetto gestito dalla CLI, in genere si aggiorna il relativo repository come descritto in Aggiornamento di un repository del pacchetto.

Per aggiornare sia la versione sia la configurazione di un pacchetto gestito dalla CLI, eseguire:

tanzu package installed update INSTALLED-PACKAGE-NAME -v TARGET-PACKAGE-VERSION --values-file PACKAGE-CONFIGURATION-FILE -n INSTALLED-PACKAGE-NAMESPACE

In cui:

• INSTALLED-PACKAGE-NAME è il nome scelto per il pacchetto. Per visualizzare il nome del pacchetto, è possibile eseguire il comando tanzu package installed list. Per ulteriori informazioni, vedere Elenco dei pacchetti installati.
• (Facoltativo) TARGET-PACKAGE-VERSION è la versione a cui si desidera aggiornare il pacchetto. Non necessario se si aggiorna la configurazione del pacchetto, non la versione.
• (Facoltativo) PACKAGE-CONFIGURATION-FILE è il percorso del file .yaml che contiene la configurazione del pacchetto aggiornata. Non necessario se si aggiorna la versione del pacchetto, non la configurazione. Per recuperare la configurazione corrente, vedere Ottenere i dettagli di un pacchetto installato.
• INSTALLED-PACKAGE-NAMESPACE è lo spazio dei nomi in cui è installato il pacchetto.

Il comando tanzu package installed delete elimina un pacchetto gestito dalla CLI.

Per eliminare un pacchetto gestito dalla CLI dal cluster di destinazione, eseguire:

tanzu package installed delete INSTALLED-PACKAGE-NAME -n INSTALLED-PACKAGE-NAMESPACE

In cui:

• INSTALLED-PACKAGE-NAME è il nome del pacchetto da eliminare. Per visualizzare il nome del pacchetto, è possibile eseguire il comando tanzu package installed list. Per ulteriori informazioni, vedere Elenco dei pacchetti installati.
• INSTALLED-PACKAGE-NAMESPACE è lo spazio dei nomi in cui è installato il pacchetto. Se non si specifica uno spazio dei nomi, viene utilizzato lo spazio dei nomi default.

Applicazione di overlay ai pacchetti

Per personalizzare i pacchetti gestiti dalla CLI, è possibile applicare overlay ytt. Per informazioni su come scaricare e installare ytt, vedere Installazione degli strumenti Carvel.