Come eseguire il debug e la correzione di problemi comuni relativi ai container in Container Station?

I container ereditano tutti gli attributi dell'immagine di origine. Eseguire la scansione del file di immagine per identificare le vulnerabilità di sicurezza, le configurazioni errate e le minacce backdoor prima della distribuzione.

Se il contenitore incontra problemi dopo la distribuzione, analizzare i log del container per diagnosticare e risolvere i problemi.

Esaminare i prerequisiti dell'immagine e completare le operazioni necessarie prima di distribuire il container.

Ad esempio, la distribuzione di un container PostgreSQL mediante l’immagine postgres richiede l’impostazione della variabile di ambiente POSTGRES_PASSWORD. Il contenitore non può essere distribuito senza questa variabile.

Container Station registra tutte le attività dell'applicazione e del container. I log degli errori forniscono messaggi di errore espliciti, tra cui il nome dell'applicazione o del container, il codice di errore e i dettagli dell'errore.

1. Aprire Container Station.
2. Fare clic su Log eventi.
3. Individuare i log degli errori.

Esempio 1

In questo esempio, il registro eventi ha registrato un errore di avvio poiché le porte specificate erano già utilizzate da altri servizi, impedendo al container di collegarsi alle interfacce di rete richieste.

Esempio 2

Il registro eventi ha registrato un errore di avvio in questo esempio a causa di un comando punto di ingresso non configurato correttamente, che ha impedito al container di eseguire il processo previsto.

Analizzare i log container singoli per rilevare eventuali messaggi di errore e di avviso. Container Station registra gli stati di errore dettagliati, ad esempio variabili di ambiente mancanti, formati di denominazione non validi, recupero delle immagini non riuscito e errori di inizializzazione.

1. Aprire Container Station.
2. Fare clic su Container.
3. Selezionare un container per aprire la pagina dei dettagli.
4. Fare clic su Log.
5. Rivedere i messaggi di errore e di avvertenza.

Esempio 1

Il registro eventi ha registrato un errore di avvio perché la variabile di ambiente MYSQL_ROOT_PASSWORD non era impostata prima della distribuzione del container MySQL, causando l'uscita immediatamente dopo l’inizializzazione.

Esempio 2

Il registro eventi ha registrato un errore di avvio poiché il container Rancher è stato distribuito utilizzando l'immagine rancher/rancher senza attivare la modalità privilegiata. Senza il flag --privileged, il container potrebbe non essere inizializzato correttamente.

Verificare che l'immagine sia compatibile con l'architettura del processore e il sistema operativo del dispositivo QNAP. Versioni di immagini o architetture errate impediscono l'esecuzione dei container.

Verificare che la piattaforma dell'immagine corrisponda all'architettura CPU del dispositivo QNAP. Se si trasferisce un'immagine da un altro dispositivo QNAP, verificare che entrambi i dispositivi utilizzino la stessa architettura.

Docker

La pagina dell'immagine Docker fornisce un elenco delle architetture e dei sistemi operativi supportati per ciascuna versione dell'immagine. Di seguito sono riportate le linee guida generali di compatibilità per le immagini Docker:

• linux/arm/v7 Le immagini supportano architetture ARM a 32 bit.
• linux/arm64/v8 Le immagini supportano architetture ARM a 64 bit.
• linux/amd64 Le immagini supportano architetture x86 a 64 bit.

LXD

Per informazioni sulla compatibilità, visitare il sito Web Server immagine LXD. Di seguito sono riportate le linee guida generali sulla compatibilità dell’architettura per i container LXD:

• armhf I container supportano architetture ARM a 32 bit.
• arm64 I container supportano architetture ARM a 64 bit.
• amd64 I container supportano architetture x86 a 64 bit.

I container Docker incompatibili possono registrare un exec format error, indicando una mancata corrispondenza dell'architettura.

Quando si distribuiscono container LXD incompatibili, Container Station registra i log errore nella pagina Log eventi.

QNAP ha aggiornato le dimensioni della pagina di sistema da 4K a 32K per migliorare le prestazioni su specifici dispositivi ARM a 32 bit. Questa modifica può limitare l'accesso del container alle risorse di memoria, causando errori di segmentazione. Verificare la compatibilità dei container di terze parti prima della distribuzione.

Verificare che il dispositivo QNAP sia configurato correttamente per l'implementazione e l'organizzazione dei container.

Verifica impostazioni di rete

1. Accedere al dispositivo QNAP e aprire Rete e switch virtuale.
2. Selezionare la modalità Avanzate.
3. Andare su Rete > Switch virtuale.
4. Identificare i segmenti di rete utilizzati dalla rete container.
5. Accedere a Pannello di controllo > Sistema > Sicurezza > Elenco consentiti/non consentiti.
   Nota

   Se QuFirewall è installato sul dispositivo, assicurarsi che sia attivato, quindi aprire QuFirewall e aggiungere i segmenti di rete richiesti all'Elenco consentiti.
6. Verificare che i segmenti di rete del container siano aggiunti all'Elenco consentiti.
   Importante

   QNAP consiglia vivamente di aggiungere i seguenti intervalli IP all'Elenco consentiti: 10.0.3.0/24, 10.0.5.0/24, 10.0.7.0/24, 172.29.0.0/22, 172.30.0.0/22. Se i servizi Kubernetes sono abilitati, aggiungere anche 10.42.0.0/24 (Kubernetes Pod Network CIDR).

Verifica impostazioni di autorizzazione avanzate

1. Accedere a Pannello di controllo > Privilegio > Cartelle condivise > Autorizzazioni avanzate.
2. Disattivare Abilita autorizzazioni cartella avanzate.
3. Fare clic su Applica.
4. Accedere a Pannello di controllo > Privilegio > Quota e controllare le impostazioni delle quote utente.
   Nota

   Le impostazioni delle quote si applicano solo se la gestione delle quote è attivata.
   Avviso

   Controllare le impostazioni delle quote utente per assicurarsi che non siano state applicate restrizioni non intenzionali. Le impostazioni di quota accidentali possono causare la segnalazione di errori da parte del container a causa delle limitazioni di archiviazione.

Verifica dello storage e della configurazione di rete

1. Andare su Archiviazione e Snapshot > Archiviazione > Archiviazione/Snapshot.
2. Verificare la capacità di archiviazione disponibile.
   
   
   Nota

   Se lo stato è diverso da Pronto, controllare lo stato del disco per verificare la presenza di errori di archiviazione. Per ulteriori informazioni, vedere Stati disco nella Guida dell'utente QTS o QuTS hero.

Verifica configurazione di rete

Verificare che le impostazioni di rete siano configurate correttamente attenendosi alla seguente procedura:

1. Andare su Rete e switch virtuale > Rete > Interfacce e rivedere le impostazioni DNS e del gateway.
2. Verificare che il server DHCP possa assegnare gli indirizzi IP ai container utilizzando uno switch virtuale. Per ulteriori informazioni, vedere Configurazione switch virtuale nella Guida dell'utente QTS o QuTS hero.
   Nota

   L'impostazione Non assegnare indirizzi IP (per scopi speciali, come la creazione di una rete esterna o di una rete isolata) nella configurazione dello switch virtuale è destinata a configurazioni di rete specifiche. Se non è necessaria una configurazione di rete personalizzata, si consiglia di disattivare questa impostazione.
   Tuttavia, se si sta configurando una rete esterna o isolata, attivarla. Tenere presente che questa impostazione può influire sulla configurazione di rete del container. Per ulteriori informazioni vedere Creazione di uno switch virtuale in modalità avanzata nella Guida dell'utente QTS o QuTS hero.
3. Accedere a Container Station > Preferenze > Impostazioni di rete e verificare che i segmenti di rete del container non siano in conflitto con l'ambiente locale.
   Importante

   Container Station utilizza 10.0.3.0/24, 10.0.5.0/24 e 10.0.7.0/24 come le reti IP predefinite.

Alcune immagini sono open source e consentono agli utenti di modificare il codice sorgente. Se nessuno dei metodi di risoluzione dei problemi risolve il problema, l'immagine di origine potrebbe essere incompatibile o danneggiata. In questi casi, QNAP consiglia di visitare il sito Web delle immagini per ulteriori informazioni o di utilizzare immagini alternative della stessa categoria.

Se l'immagine proviene dal registro Docker, è possibile trovare ulteriori dettagli nella pagina Panoramica dell'immagine. Ad esempio, l'immagine Ubuntu in Docker fornisce collegamenti di riferimento rapido per ulteriori informazioni.