Aggiornamento dello script delle variabili di ambiente (aggiornamento dalla versione 5.3.x a una versione successiva 5.3 refresh)

I comandi per l'aggiornamento IBM® Software Hub utilizzano variabili con il formato ${VARIABLE_NAME}. Assicurati che lo script delle variabili di ambiente includa le informazioni corrette per l'istanza di IBM Software Hub che desideri aggiornare.

Fase di aggiornamento

Aggiornamento della workstation client
Raccolta delle informazioni richieste
Preparazione all'esecuzione di un aggiornamento in una rete con restrizioni
Preparazione all'esecuzione di un aggiornamento da un registro container privato
Aggiornamento del software prerequisito
Aggiornamento dei componenti condivisi del cluster
Preparazione all'aggiornamento di un'istanza
Aggiornamento di un'istanza

Chi deve completare questo compito?

Team operativo Il team IBM Software Hub operativo dovrebbe collaborare con l'amministratore del cluster per raccogliere informazioni sul cluster in cui IBM Software Hub è installato.

Quando devi completare questo compito?

Ripeti secondo necessità Se nel cluster sono presenti IBM Software Hub più istanze di e si utilizzano script separati per ciascuna istanza, aggiornare lo script per ogni istanza che si intende aggiornare.

Modifica del file delle variabili d'ambiente

Apri lo script shell delle variabili di ambiente esistenti in un editor di testo.
Individua la VERSION voce e specifica la versione a IBM Software Hub cui desideri eseguire l'aggiornamento. Ad esempio:
```
export VERSION=5.3.1
```
Imposta la variabile OLM_UTILS_IMAGE di ambiente:
```
export OLM_UTILS_IMAGE=icr.io/cpopen/cpd/olm-utils-v4:${VERSION}
```
Suggerimento: se il cluster recupera le immagini da un registro container privato, è necessario aggiornare questa variabile di ambiente dopo che l'immagine è stata inviata al registro container privato.
Se necessario, aggiornare la COMPONENTS variabile.
Verificare che l'elenco dei componenti del servizio sia corretto.
Se si eseguono il mirroring delle immagini in un registro container privato e si deve eseguire il mirroring di modelli o immagini opzionali non inclusi nelle immagini di servizio, aggiungere o aggiornare la variabile IMAGE_GROUPS di ambiente allo script:
```
export IMAGE_GROUPS=<comma-separated-list-of-group-names>
```
Un elenco separato da virgole di modelli o immagini opzionali da replicare nel tuo registro container privato.
Se un componente ha modelli o immagini opzionali che non vengono replicati di default, devi replicare esplicitamente quelle immagini nel tuo registro container privato.

Ad esempio, se prevedi di installare watsonx.ai™, devi scegliere quali modelli replicare nel tuo registro container privato.

Per ulteriori informazioni, consulta Determinare quali modelli e immagini replicare nel tuo registro container privato (Aggiornamento dalla versione 5.3.x a una versione successiva 5.3 refresh).
Aggiungi una nuova sezione denominata Configurazione di pull delle immagini allo script e aggiungi le seguenti variabili di ambiente:
1. Aggiungi la variabile IMAGE_PULL_SECRET di ambiente e impostala sul nome che desideri utilizzare per il segreto con ambito namespace che conterrà le base64 credenziali codificate per il recupero delle immagini.
  Specificare un nome Kubernetes conforme che contenga solo caratteri alfanumerici minuscoli, trattini (-) o punti (.). Il nome deve iniziare e terminare con un carattere alfanumerico.
```
export IMAGE_PULL_SECRET=<pull-secret-name>
```
2. Aggiungi le variabili di IMAGE_PULL_CREDENTIALS ambiente IMAGE_PULL_PREFIX e in base alla posizione da cui il tuo cluster estrae le immagini:
  IBM Entitled Registry
  Se il tuo cluster recupera immagini dal IBM Entitled Registry, aggiungi le seguenti variabili di ambiente al tuo script. Non modificare i export comandi:
```
export IMAGE_PULL_CREDENTIALS=$(echo -n "cp:$IBM_ENTITLEMENT_KEY" | base64 -w 0)
export IMAGE_PULL_PREFIX=icr.io
```
  Registro privato dei container
  Se il tuo cluster recupera immagini da un registro container privato, aggiungi le seguenti variabili di ambiente allo script. Non modificare i export comandi:
```
export IMAGE_PULL_CREDENTIALS=$(echo -n "$PRIVATE_REGISTRY_PULL_USER:$PRIVATE_REGISTRY_PULL_PASSWORD" | base64 -w 0)
export IMAGE_PULL_PREFIX=${PRIVATE_REGISTRY_LOCATION}
```
Salva le tue modifiche.
Verificare che lo script non contenga errori. Ad esempio, se hai chiamato lo script cpd_vars.sh, esegui:
```
bash ./cpd_vars.sh
```

Ricerca delle variabili d'ambiente

È necessario eseguire lo script da un prompt bash prima di eseguire i comandi di installazione e aggiornamento. Lo script esporta le variabili di ambiente nella sessione della riga di comando.

Importante: è necessario rieseguire lo script ogni volta che si apre un nuovo prompt bash.

Passa alla directory in cui hai salvato lo script.
Recupera le variabili d'ambiente. Ad esempio, se hai chiamato lo script cpd_vars.sh, esegui:
```
source ./cpd_vars.sh
```

Cosa fare successivamente

Ora che hai aggiornato le variabili di ambiente nel tuo script, sei pronto per completare la preparazione all'esecuzione dei comandi di aggiornamento IBM Software Hub in una rete con restrizioni (aggiornamento dalla versione 5.3.x a una versione successiva 5.3 refresh).