La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

Distribuisci AI Data Engine come implementazione a nodo singolo con un proxy

10/26/2026 Collaboratori

PDF

Distribuisci AI Data Engine (AIDE) come distribuzione a nodo singolo da NetApp Console quando l'host di destinazione raggiunge Internet solo tramite un outbound proxy. Questa procedura include ogni passaggio della distribuzione a nodo singolo, insieme ai passaggi relativi al proxy. Se l'host di destinazione ha accesso diretto a Internet, utilizza "Distribuisci AI Data Engine come implementazione a nodo singolo" invece.

Per i tipi di proxy supportati e il riferimento completo dei parametri, vedi "Scopri di più sui proxy per AI Data Engine". Per gli endpoint da consentire sul proxy, vedi "Accesso Internet outbound".

Prima di iniziare

Permessi e accesso

In NetApp Console disponi di autorizzazioni di Organization admin o superiori.
Hai i permessi sudo o root sull'host di destinazione per eseguire il comando di installazione.

Ambiente

Il tuo ambiente soddisfa tutti i prerequisiti come descritto in "Prerequisiti per la distribuzione di AIDE su un singolo nodo" e "Requisiti AIDE".
I repository del sistema operativo sull'host di destinazione forniscono i pacchetti elencati in "Pacchetti del sistema operativo". Verifica che i gestori di pacchetti abbiano la configurazione proxy appropriata, se richiesta nel tuo ambiente.

NetApp Console

Un agente NetApp Console "viene distribuito" raggiungibile dall'host di AI Data Engine. L'indirizzo IP dell'agente Console è necessario per eseguire il comando di installazione.

Proxy

Hai configurato il tuo proxy per consentire gli endpoint in "Accesso Internet outbound".
Conosci l'host del proxy, la porta e lo schema (http o https). Se il proxy richiede autenticazione, conosci anche il nome utente e la password.
Se utilizzi un proxy HTTPS con un certificato firmato privatamente, hai il certificato CA come file PEM oppure una directory semplice di .crt e .pem file sull'host di destinazione.

Usa il programma di installazione solo per la prima installazione di AIDE. Non usarlo per aggiornare AIDE. Dopo l'installazione, l'operatore di AIDE gestisce gli aggiornamenti. Per informazioni sugli aggiornamenti, contatta NetApp Support.

Cosa configura il programma di installazione

In una distribuzione a nodo singolo, AI Data Engine è proprietario della VM su cui viene installato. Il programma di installazione configura il runtime k3s e AI Data Engine per il proxy. Non modifica la configurazione del proxy dell'host, come i gestori di pacchetti del sistema operativo. Il programma di installazione esegue le seguenti operazioni:

Scarica lo script di installazione e il binario di k3s tramite il proxy. Non fornisce a k3s o al kubelet un proxy a livello di sistema.
Configura il container runtime di k3s per scaricare le immagini tramite il proxy.
Aggiunge il certificato CA che fornisci con `--proxy-ca-cert`all'archivio attendibile di AI Data Engine.

Non configuri il container runtime di k3s né il trust store.

Copia il comando di installazione

In NetApp Console, vai a AI data hub > AI Data Engine.

Viene visualizzata la landing page di AI Data Engine.
Seleziona Deploy AI Data Engine.
Seleziona l'opzione di distribuzione Single-node e seleziona Next.
Seleziona la dimensione della tua configurazione:
- Piccolo: consigliato per ambienti con fino a circa 200 milioni di file.
- Media (Predefinita): consigliata per ambienti con fino a circa 1 miliardo di file.
- Grande: consigliato per ambienti con fino a circa 3 miliardi di file.
  
  Queste dimensioni rappresentano valori di riferimento consigliati, non limiti rigidi. Consulta "linee guida flessibili per il dimensionamento" se il tuo ambiente non rientra in questi intervalli.
La procedura guidata genera il comando di installazione con la dimensione di configurazione selezionata. Non è necessario modificare il comando per impostare la dimensione.
Copia il comando di installazione visualizzato nella procedura guidata in un editor.

Il comando di installazione scarica il programma di installazione da d13jb5dapseb36.cloudfront.net e lo avvia in un unico passaggio. Questo download non utilizza il proxy.
- Se l'host di destinazione può raggiungere d13jb5dapseb36.cloudfront.net direttamente, salta la sezione successiva e continua con Crea un file della password del proxy. Esegui il comando di installazione come copiato. Il programma di installazione ti chiede le impostazioni del proxy. Per fornirle invece sulla riga di comando, vedi Installazione non interattiva tramite flag da riga di comando.
- Se l'host di destinazione raggiunge Internet solo tramite un proxy, il comando si interrompe durante il download. Completa prima la sezione successiva.

Scarica il programma di installazione tramite il proxy

Scarica il programma di installazione e poi esegui il comando di installazione da sudo ./install-lite.sh in poi.

Trasferisci il programma di installazione sull'host di destinazione. Utilizza qualsiasi metodo consentito dal tuo ambiente, quindi posiziona il file sull'host di destinazione.

Per scaricare il programma di installazione dall'host di destinazione tramite il tuo proxy:
```
mkdir -p ~/aide && cd ~/aide
curl -fsSL -x http://PROXY_HOST:PROXY_PORT \
  https://d13jb5dapseb36.cloudfront.net/aide/latest/aide-installer.tar.gz -o aide-installer.tar.gz
```
Se il proxy richiede un nome utente, aggiungi --proxy-user USER al curl comando. Se ometti la password, curl te la chiederà, quindi non verrà salvata nella cronologia della shell.
- Usa https:// nell' `-x`indirizzo se il tuo proxy è in ascolto su HTTPS.
- Se il proxy utilizza un certificato firmato privatamente, aggiungi --proxy-cacert CA_FILE, oppure aggiungi prima il certificato CA al trust store dell'host di destinazione.
- Se usi un proxy HTTPS e una curl versione precedente alla 8.3, il download può bloccarsi per circa un minuto. Ubuntu 22.04 include una versione di questo tipo. Aspetta che finisca.
  
  In alternativa, scarica https://d13jb5dapseb36.cloudfront.net/aide/latest/aide-installer.tar.gz da un altro dispositivo e poi copialo nell'host di destinazione con scp o con il tuo solito metodo di trasferimento file.
Estrai il programma di installazione e spostati nella cartella di installazione:
```
tar -xzf aide-installer.tar.gz
cd installer
```
Esegui tutti i comandi seguenti dall'interno di questa cartella di installazione. Il file version.txt nella cartella mostra la versione di build del programma di installazione.
Prepara il comando di installazione che hai copiato da NetApp Console. Inizia con sudo bash -c ', scarica il programma di installazione e poi esegue ./install-lite.sh con i tuoi parametri. Dato che hai già scaricato il programma di installazione:
- Elimina tutto ciò che precede ./install-lite.sh, in modo che il comando inizi con ./install-lite.sh.
- Elimina l'apice singolo (') proprio alla fine.
- Aggiungi sudo davanti, in modo che il comando inizi con sudo ./install-lite.sh. Il programma di installazione deve essere eseguito come root e, rimuovendo il wrapper bash -c, rimuovi anche sudo che lo forniva.
- Se il comando contiene --no-proxy, eliminalo.
  
  Il comando rimanente si presenta così:
```
sudo ./install-lite.sh --account-id <account-id> --organization-id <organization-id> --agent-id <agent-id> --env <environment> --user-token <user-token> --cm-host <console-agent-ip> --catalog-endpoint <catalog-endpoint> --flavor <small|medium|large>
```
+ Mantieni ogni parametro che segue ./install-lite.sh esattamente come appare nel comando che hai copiato. Il programma di installazione ti chiederà le impostazioni del proxy. Vedi Configurazione guidata interattiva.

Crea un file della password del proxy

Se il proxy richiede l'autenticazione e vuoi fornire la password senza che ti venga richiesta, ad esempio in una distribuzione automatizzata, crea un file della password prima di eseguire il programma di installazione. In caso contrario, salta questa sezione. Il programma di installazione richiede la password con input nascosto.

Il file contiene solo la password. Inserisci la password esattamente così com'è, senza applicare la codifica percentuale ai caratteri speciali.

Esegui i seguenti comandi come root. Il comando di installazione a nodo singolo viene eseguito con sudo, quindi può leggere un file in /root.

umask 077
read -rs -p 'Proxy password: ' P && printf '%s' "$P" > /root/.aide-proxy-password; unset P; echo
chmod 600 /root/.aide-proxy-password

Elimina il file al termine dell'installazione.

Fornisci le impostazioni del proxy

Il programma di installazione ti chiede le impostazioni del proxy. Esegui il comando di installazione come copiato da NetApp Console e rispondi ai prompt. Per le distribuzioni automatizzate che devono essere eseguite senza prompt, vedi Installazione non interattiva tramite flag da riga di comando.

Usa la configurazione guidata interattiva

Quando esegui il comando di installazione in un terminale senza --proxy-host o --no-proxy, il programma di installazione ti pone le seguenti domande. Se passi un valore come parametro, il programma di installazione non te lo chiede di nuovo.

Prompt Cosa inserire

Prompt	Cosa inserire
`Configure outbound proxy? (y/N)`	Inserisci `y`.
Host o IP del proxy	Inserisci il proxy host name o l'indirizzo IPv4, facoltativamente con una porta (`host:port`).
Schema proxy (`https` o `http`)	Inserisci il protocollo su cui è in ascolto il tuo proxy. Il valore predefinito è `https`.
Porta del proxy	Inserisci la porta proxy. Il valore predefinito è `443` per HTTPS e `80` per HTTP.
Tipo di proxy	Premi Invio per accettare l'impostazione predefinita.
Certificato CA per il certificato del proxy stesso (solo HTTPS, facoltativo)	Inserisci il percorso del file o della directory della CA. Premi Invio se il certificato proxy è stato firmato da una CA pubblica.
Il proxy richiede un nome utente e una password? (s/N)	In caso affermativo, inserisci il nome utente e poi la password due volte. L'installer non visualizza la password.

Configure outbound proxy? (y/N)

Inserisci y.

Host o IP del proxy

Inserisci il proxy host name o l'indirizzo IPv4, facoltativamente con una porta (host:port).

Schema proxy (https o http)

Inserisci il protocollo su cui è in ascolto il tuo proxy. Il valore predefinito è https.

Porta del proxy

Inserisci la porta proxy. Il valore predefinito è 443 per HTTPS e 80 per HTTP.

Tipo di proxy

Premi Invio per accettare l'impostazione predefinita.

Certificato CA per il certificato del proxy stesso (solo HTTPS, facoltativo)

Inserisci il percorso del file o della directory della CA. Premi Invio se il certificato proxy è stato firmato da una CA pubblica.

Il proxy richiede un nome utente e una password? (s/N)

In caso affermativo, inserisci il nome utente e poi la password due volte. L'installer non visualizza la password.

Senza un terminale, il programma di installazione non mostra mai richieste. Passa --proxy-host per usare un proxy e --proxy-password-file se il proxy richiede una password.

Usa i flag della riga di comando per la configurazione

Utilizza i flag da riga di comando per distribuzioni automatizzate o altre distribuzioni non interattive che devono essere eseguite senza richieste. I flag sono facoltativi. Il programma di installazione ti chiede le informazioni sul proxy che non fornisci.

Aggiungi i parametri proxy alla fine del comando di installazione, dopo l'ultimo parametro esistente.

Se esegui il comando di installazione copiandolo da NetApp Console, aggiungi i parametri tra le virgolette, prima della virgoletta di chiusura.
Se hai scaricato il programma di installazione e hai abbreviato il comando, aggiungi i parametri alla fine del comando abbreviato.

Se il comando contiene --no-proxy, rimuovilo. Mantieni tutti gli altri parametri del comando di installazione. Per la descrizione e il valore predefinito di ciascun parametro, vedi "Parametri di configurazione del proxy". Gli esempi seguenti mostrano solo i parametri proxy.

proxy HTTP con nome utente e password

--proxy-host proxy.example.com \
--proxy-port 3128 \
--proxy-scheme http \
--proxy-user svc-aide \
--proxy-password-file /root/.aide-proxy-password

proxy HTTPS con certificato firmato privatamente e senza autenticazione

--proxy-host proxy.example.com \
--proxy-port 8443 \
--proxy-scheme https \
--proxy-ca-cert /root/proxy-ca.pem

Se il tuo proxy non richiede autenticazione, ometti --proxy-user e --proxy-password-file.
Se specifichi --proxy-user senza --proxy-password-file, il programma di installazione ti chiede la password quando lo esegui da un terminale.

Con un proxy HTTP, il nome utente e la password del proxy vengono inviati in clear text. Usa un proxy HTTPS quando il proxy richiede l'autenticazione.

Esegui l'installazione

Esegui il comando di installazione sull'host di destinazione. Se hai scaricato il programma di installazione, esegui il comando dalla cartella del programma di installazione.

Prima di scaricare qualsiasi file, il programma di installazione verifica dall'host di destinazione che il proxy risponda, che il proxy accetti le tue credenziali e che il certificato del proxy sia valido per lo schema che hai scelto. Se la verifica non riesce, il programma di installazione si interrompe e indica la causa.

L'installazione richiede circa 45 minuti per essere completata. Potrebbero verificarsi timeout e nuovi tentativi, ed è normale.
Se non hai passato tutti i parametri del proxy, rispondi ai prompt del proxy. Vedi Configurazione guidata interattiva.
Rispondi alla richiesta di conferma del programma di installazione per continuare l'installazione.

Il programma di installazione rileva l'indirizzo IP del nodo che esegue l'ingress NGINX di AI Data Engine e ti chiede di confermarlo. Premi Invio per mantenere l'indirizzo visualizzato oppure digita un indirizzo diverso. Usa un indirizzo raggiungibile dall'esterno della VM. Non inserire l'indirizzo dell'agente di Console.
Monitora la schermata di avanzamento finché non viene visualizzata la schermata di successo, che conferma che l'installazione di AIDE è completa.

Risultato

AI Data Engine è distribuito e connesso a NetApp Console. Ora puoi "collega una fonte di dati" per iniziare la scansione.

Verifica il proxy dopo l'installazione

L'operatore AI Data Engine registra il proxy che utilizza. Il log non include mai la password. Il programma di installazione scarica una propria copia di kubectl in /opt/netapp/aide/.aide-installer-tools e non la aggiunge al tuo PATH. Il file k3s kubeconfig è leggibile solo da root. Per controllare il proxy, esegui il seguente comando sull'host di destinazione:

sudo /opt/netapp/aide/.aide-installer-tools/kubectl --kubeconfig /etc/rancher/k3s/k3s.yaml -n aide logs deploy/aide-operator -c chart-fetcher | grep -m1 'proxy enabled'

La riga mostra l'endpoint del proxy, se l'autenticazione è attiva e se è montato un certificato CA.