Hur felsöks och åtgärdas vanliga problem med behållare i Container Station?
Container Station kan du använda till att distribuera program och behållare från tredje part på din QNAP-enhet. Skivavbilder med öppen källkod som används för att skapa dessa behållare kan medföra driftsättningsproblem.
QNAP tillhandahåller inte teknisk support för skivavbilder från tredje part. Följ dessa steg för att diagnostisera och lösa vanliga problem med behållare.
Kontroll av behållarkonfiguration
Behållare ärver alla attribut från källskivavbilden. Sök igenom skivavbildsfilen för att identifiera säkerhetsproblem, felkonfigurationer och bakdörrshot före distribueringen.
Om behållaren stöter på problem efter distribueringen analyserar du behållarnas loggar för att diagnostisera och lösa problem.
Undersöka skivavbildsinformation
Granska förkraven för skivavbilden och slutför alla nödvändiga steg innan behållaren installeras.
Om exempelvis en PostgreSQL-behållare distribueras med skivavbilden postgres krävs att miljövariabeln POSTGRES_PASSWORD ställts in. Behållaren kan inte driftsättas utan den variabeln.
POSTGRES_PASSWORD konfigureras i avsnittet Miljö.Analysera händelseloggar från Container Station
Container Station loggar alla program- och behållaraktiviteter. Felloggarna innehåller explicita felmeddelanden, inklusive applikations- eller behållarnamn, felkod och felinformation.
- Öppna Container Station.
- Klicka på Händelseloggar.
- Lokalisera felloggar.
Exempel 1
I det här exemplet registrerade händelseloggen ett uppstartsfel eftersom de angivna portarna redan användes av andra tjänster och det förhindrar att behållaren binds till de erforderliga nätverksgränssnitten.
Exempel 2
I det här exemplet registrerade händelseloggen ett uppstartsfel till följd av att ett felaktigt konfigurerat startpunktskommando hindrade behållaren från att utföra den avsedda processen.
Kontrollera enskilda behållarloggar
Analysera enskilda behållarloggar med avseende på fel- och varningsmeddelanden. Container Station loggar detaljerade feltillstånd, exempelvis saknade miljövariabler, ogiltiga namngivningsformat, misslyckade skivavbildsåterhämtningar och initieringsfel.
- Öppna Container Station.
- Klicka på Behållare.
- Välj en behållare för att öppna sidan med information.
- Klicka på Loggar.
- Granska fel- och varningsmeddelanden.
Exempel 1
Händelseloggen registrerade ett uppstartsfel eftersom miljövariabeln MYSQL_ROOT_PASSWORD inte var inställd innan MySQL-behållaren, som därför avslutades direkt efter initieringen, driftsattes.
Exempel 2
Händelseloggen registrerade ett uppstartsfel eftersom Rancher-behållaren driftsattes med hjälp av skivavbilden rancher/rancher utan att aktivera privilegierat läge. Utan flaggan --privileged kunde behållaren inte initieras på rätt sätt.
Verifiera skivavbildskompatibilitet
Kontrollera att bilden är kompatibel med processorarkitekturen och operativsystemet på din QNAP-enhet. Felaktiga skivavbildsversioner eller arkitekturer förhindrar att behållare körs.
Kontrollera plattformens kompatibilitet
Kontrollera att bildplattformen stämmer överens med din QNAP-enhets CPU-arkitektur. Om en skivavbild överförs från en annan QNAP-enhet måste det vara bekräftat att båda enheterna använder samma arkitektur.
Docker
Sidan för Docker-skivavbild har en lista över arkitektur och operativsystem som stöds, för varje skivavbildsversion. Följande är de allmänna riktlinjerna avseende kompatibilitet för Docker-skivavbilder:
linux/arm/v7skivavbilder har stöd för 32-bitars ARM-arkitekturer.linux/arm64/v8skivavbilder har stöd för 64-bitars ARM-arkitekturer.linux/amd64skivavbilder har stöd för 64-bitars x86-arkitekturer.
LXD
Mer information om kompatibilitet finns på LXD-skivavbildsservern. Följande är de allmänna riktlinjerna för arkitekturkompatibilitet för LXD-behållare:
armhfbehållare har stöd för 32-bitars ARM-arkitekturer.arm64behållare har stöd för 64-bitars ARM-arkitekturer.amd64behållare har stöd för 64-bitars x86-arkitekturer.
Identifiera icke kompatibla behållare
Inkompatibla Docker-behållare kan logga ett exec format error som då tyder på att arkitekturen inte stämmer överens.
När inkompatibla LXD-behållare driftsätts registrerar Container Station felloggar på sidan för händelseloggar.
Kontrollera sidstorlekskompatibilitet
QNAP uppdaterade systemets sidstorlek från 4K till 32K för en förbättrad prestanda på specifika 32-bitars ARM-enheter. Den ändringen kan begränsa behållaråtkomst till minnesresurser och orsaka segmenteringsfel. Verifiera kompatibilitet med tredjepartsbehållare innan driftsättningen.
| Serier | Modeller |
|---|---|
| TS-x31P | TS-531P |
| TS-x31P3 | TS-231P3, TS-431P3 |
| TS-x31X | TS-231X, TS-431X, TS-531X, TS-831X, TS-431X2, TS-431X3 |
| TS-x31KX | TS-431KX |
| TS-x31XU | TS-431XU, TS-431XU-RP, TS-831XU, TS-831XU-RP, TS-1231XU, TS-1231XU-RP |
| TS-x31XeU | TS-431XeU |
| TS-x35 | TS-1635 |
Kontrollera QNAP-systemkonfigurationen
Säkerställ att QNAP-enheten är konfigurerad på lämpligt sätt för driftsättning och orkestrering av behållare.
Verifiera nätverksinställningar
- Logga in på din QNAP-enhet och öppna Nätverk och virtuell växel.
- Välj Avancerat läge.
- Gå till Nätverk > Virtuell växel.
- Identifiera det nätverkssegment som används av behållarnätverket.
- Gå till Kontrollpanelen > System > Säkerhet> Tillåt-/nekalista.Obs!Om QuFirewall är installerat på din enhet behöver du kontrollera att den är aktiverad för att sedan öppna QuFirewall och lägga till de nätverkssegment som krävs i tillåt-listan.
- Säkerställ att behållarnätverkssegment är tillagda i tillåt-listan.
Viktigt!QNAP rekommenderar att följande IP-adressintervall läggs till i tillåt-listan: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. Om Kubernetes-tjänster är aktiverade ska även10.42.0.0/24läggas till (Kubernetes podd-nätverks-CIDR).
Kontrollera avancerade behörighetsinställningar
- Gå till Kontrollpanelen > Privilegium > Delade mappar > Avancerade behörigheter.
- Inaktivera Aktivera avancerade mappbehörigheter.
- Klicka på Tillämpa.
- Gå till Kontrollpanelen > Privilegium > Kvot för att kontrollera användarens kvotinställningar.Obs!Kvotinställningar tillämpas bara om kvothantering är aktiverad.VarningKontrollera inställningarna för användarkvot, för att säkerställa att det inte finns några oavsiktliga kvotbegränsningar. Oavsiktliga kvotinställningar kan ge upphov till att behållaren rapporterar fel på grund av lagringsbegränsningar.
Verifiera lagrings- och nätverkskonfiguration
- Gå till Lagring och snapshots > Lagring > Lagring/snapshots.
- Kontrollera tillgänglig lagringskapacitet.
Obs!Om statusen är något annat än Klar behöver diskstatusen kontrolleras för att se om det finns lagringsfel. Mer information finns i Diskstatusar i bruksanvisningen till QTS eller QuTS hero.
Kontrollera nätverkskonfigurationen
Säkerställ att nätverksinställningarna är rätt konfigurerade genom att följa dessa steg:
- Gå till Nätverk och virtuell växel > Nätverk > Gränssnitt och granska DNS- och gatewayinställningarna.
- Säkerställ att DHCP-servern kan tilldela IP-adresser till behållare med hjälp av en virtuell växel. Mer information finns i Konfiguration av virtuell växel i bruksanvisningen till QTS eller QuTS hero.Obs!Inställningen Tilldela inte IP-adresser (för särskilda ändamål, exempelvis för att bygga ett externt nätverk eller isolerat nätverk) i den virtuella växelns konfiguration är avsedd för specifika nätverkskonfigurationer. Om du inte har behov av en anpassad nätverksinstallation rekommenderar vi att den inställningen inaktiveras.
Om du emellertid installerar ett externt eller isolerat nätverk ska den vara aktiverad. Observera att den här inställningen kan påverka behållarens nätverkskonfiguration. Mer information finns i Skapa en virtuell växel i avancerat läge i bruksanvisningen till QTS eller QuTS hero. - Gå till Container Station > Preferenser > Nätverksinställningar och säkerställ att behållarens nätverkssegment inte står i konflikt med den lokala miljön.Viktigt!Container Station använder
10.0.3.0/24,10.0.5.0/24och10.0.7.0/24som standard-IP-nätverk.
Se onlinehjälp och dokumentation
Vissa skivavbilder är i öppen källkod och användare kan ändra källkoden. Om ingen av felsökningsmetoderna löser problemet kan källskivavbilden vara inkompatibel eller skadad. I sådana fall rekommenderar QNAP besök på skivavbildens webbplats för att inhämta mer information om skivavbilden eller att andra skivavbilder i samma kategori används.
Om skivavbilden kommer från Docker-registret kan du hitta mer information om skivavbilden på deras sida med översikt. Till exempel så tillhandahåller skivavbilden med Ubuntu i Docker snabbreferenslänkar för att finna information.