Kan du ändra en publicerad port för en container utan att bygga om dess databas?

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

Ja, du kan ändra en containers publicerade port utan att bygga om databasen, så länge databasen ligger kvar på samma verifierade beständiga lagring.

På en hem-NAS eller Docker-värd tillhör den synliga porten vanligtvis den utbytbara programcontainern, medan poster, konton och inställningar finns i en namngiven volym, en bind-montering eller en separat databastjänst. Den säkra ändringen är därför att bevara driftsättningsdefinitionen och de beständiga sökvägarna, ändra enbart publiceringsregeln på värdsidan, återskapa den berörda programtjänsten och sedan kontrollera alla proxyinställningar, bokmärken, återanropsadresser, brandväggsregler och hälsokontroller som fortfarande hänvisar till den gamla porten.

Skilj den publicerade värdporten från containerns lyssningsport

Skriv upp den aktuella mappningen som två olika slutpunkter innan du ändrar den. I 8080:80 ansluter klienterna till port 8080 på Docker-värden, medan programmet fortfarande lyssnar på port 80 inuti containern. Om du ändrar den vänstra sidan ändras inte automatiskt programprocessen eller dess databasanslutning.

Ett felsökningsfall från Docker-communityt betonar att värdmappningen och den interna lyssningsporten är separata, och att en ny publicerad port inte kan fungera om ingenting lyssnar internt på destinationsporten.

Kontrollera den körande containerns publicerade portar och lyssnande uttag, och testa sedan den interna slutpunkten inifrån containern eller dess nätverk. Behåll den interna porten oförändrad om inte själva programmet måste flyttas. Det här första testet förhindrar att en enkel ändring av värdporten leder till onödig omkonfigurering av programmet.

Skydda den aktuella databasens sökväg innan tjänsten återskapas

Dokumentera Compose-filen, avbildningstaggen eller digesten, miljöfilerna, namngivna volymer, bind-monteringar, nätverksnamn, hemligheter och databasens värdnamn. Målet är att fastställa vilket objekt som äger den beständiga datan innan Docker ersätter programcontainern.

Att byta portpublicering kräver en ny containerkonfiguration, men inte en ny avbildningsversion eller en ny databas. Ett praktiskt Docker-svar skiljer mellan återskapande av containern och att bygga om programmets avbildning när portinställningarna ändras.

Ta en aktuell databassäkerhetskopia eller ögonblicksbild som är konsekvent med appen om tjänsten är viktig, och kontrollera sedan att databassökvägen inte finns i containerns skrivbara lager. Avbryt om listan över monteringspunkter är tvetydig, volymnamnet har ändrats eller den aktuella appen verkar använda en oväntad tom databas.

Ändra endast mappningen på värdsidan och återskapa appens tjänst

Ändra appens tjänst från en mappning som 8080:80 till 8081:80. Låt avbildningen, den interna porten, volymerna, databasens URL, tjänstens namn, nätverken och användarmappningen vara oförändrade om det inte finns något annat verifierat krav.

Ports syntax i Compose tolkas från värd till container, så om du ändrar värdsidan fortsätter processen att lyssna på sin befintliga interna port. Ett exempel från ett Docker-forum förklarar varför vänster sida är värdporten och den högra sidan fortfarande måste motsvara appens lyssningsport.

Återskapa endast appens tjänst med den uppdaterade definitionen. Använd inte ett stackkommando som tar bort volymer, initiera inte databasen igen och lägg inte till --build om inte själva avbildningen har ändrats. Granska de faktiska monteringspunkterna och portmappningen efter återskapandet, innan du låter migreringar eller bakgrundsjobb köras.

Uppdatera alla klientvägar som är beroende av den gamla porten

Ett bokmärke i webbläsaren är bara en av flera användare av den publicerade porten. Omvända proxyservrar, routervidarebefordringar, lokala brandväggar, övervakningskontroller, mobilappar, webhook-mål, OAuth-callbackar, CORS-tillåtelselistor och genererade publika URL:er kan fortfarande peka på den tidigare slutpunkten.

Vissa appar för egenhosting gör loopback-anrop eller skapar callback-URL:er utifrån den konfigurerade publika adressen. En diskussion om en WordPress-container visar hur en ändrad extern mappning kan blottlägga loopback-beteende som är beroende av porten, även när databasen fortfarande fungerar.

Sök i Compose-projektet, proxykonfigurationen, miljöfilerna och programinställningarna efter den gamla porten. Uppdatera endast de lager som faktiskt använder värdslutpunkten. Interna containrar bör normalt fortsätta använda tjänstenamnet och den interna porten i stället för den nyligen publicerade värdporten.

Låt databasen vara kvar i sitt privata containerflöde

Ändra eller publicera inte databasporten bara för att webbappens värdport har ändrats. En databas som endast används av containrar i samma stack kan fortfarande nås via tjänstenamnet och den interna porten utan att någon port publiceras på värden.

Om du blandar ihop appens offentliga slutpunkt med databasanslutningen kan det leda till ett andra avbrott: programmet kan riktas mot NAS-adressen och en värdport trots att databasen är tänkt att ligga kvar på ett privat Docker-nätverk. Den ändringen innebär fler variabler för brandvägg, NAT och autentisering utan att hjälpa webbläsaren att nå webbtjänsten.

Från den återskapade programcontainern slår du upp databasens tjänstenamn, ansluter till dess interna TCP-port, autentiserar och gör en ofarlig läsning. Om den sökvägen är oförändrad låter du den vara. Om databasens test misslyckas återställer du den ursprungliga programdefinitionen innan du felsöker det separata nätverks- eller autentiseringsproblemet.

Verifiera den nya porten utan att röra beständiga data

Testa den nya värdporten direkt och testa sedan det vanliga värdnamnet eller omvända proxyvägen. Bekräfta inloggning, läsning av poster, en återställningsbar skrivning, uppladdningar, schemalagda jobb, integrationer och en kontrollerad omstart av containern.

ZimaSpace-guiden om att anpassa hälsokontroller till appens faktiska sökvägar är nästa steg när den nya slutpunkten fungerar i webbläsaren men Docker fortfarande rapporterar att tjänsten inte är frisk.

Ändringen är slutförd först när den nya publicerade porten finns kvar efter att containern återskapats och en omstart, proxyn och klienterna inte längre använder den gamla slutpunkten, programmet återansluter till samma beständiga databas och databassäkerhetskopian fortfarande finns tillgänglig. Återställ portmappningen om appen startar med ett nytt, tomt tillstånd eller försöker genomföra en oväntad migrering.

Support och tips

Mer att läsa

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.