Dockerfile-generator

Dockerfile-generator

App instellen

Kies een van de vijf stacks en vul het bestand of pakket in waarmee je app daadwerkelijk start.

PHP-FPM biedt FastCGI aan op interne TCP-poort 9000, geen HTTP. Verbind het via een privénetwerk met een webserver die FastCGI ondersteunt. Publiceer deze poort niet op internet.

Gegenereerde bestanden controleren

Maak een Dockerfile en bijpassende .dockerignore voor een project met Node.js, Python, PHP-FPM, Go of Rust. Kies de stack en vul het pad of de binary in die je eigen app gebruikt, zodat het startcommando niet wordt geraden. De uitvoer is een bouwbaar uitgangspunt voor een gangbaar project met de genoemde manifestbestanden. Lees beide gegenereerde bestanden voordat je ze aan je repository toevoegt.

Bestanden maken en controleren

  1. 1

    Kies de stack en het startpunt

    Vul voor Node.js of Python het relatieve scriptpad in, voor Go het pakketpad en voor Rust de naam van de Cargo-binary. PHP-FPM heeft een vast startcommando.

  2. 2

    Stel de werkmap en interne poort in

    Kies een ondersteund app-pad zoals /app of /srv/app. EXPOSE documenteert de poort; je app moet er zelf op luisteren. PHP-FPM gebruikt interne FastCGI-poort 9000.

  3. 3

    Controleer beide bestanden

    Lees de Dockerfile en .dockerignore samen. Controleer de manifestnamen, het startpunt, runtime-rechten en eventuele systeembibliotheken die je project nodig heeft.

  4. 4

    Kopieer of download

    Download de ZIP en pak beide bestanden uit in de hoofdmap van je Docker-buildcontext. Je kunt ze ook afzonderlijk kopiëren en opslaan als Dockerfile en .dockerignore. Bouw daarna de container en test die met je eigen app.

Kies een startpunt dat in je project bestaat

De generator kan je repository niet inspecteren. Hij gebruikt de stack, het startpunt, de werkmap en de poort die je opgeeft. Een Node.js-app heeft een JavaScript-startbestand en een npm-lockbestand nodig; een Python-app een script en requirements.txt; Go een go.mod-module en pakketpad; Rust een Cargo-project en een binary met de opgegeven naam. PHP-FPM werkt anders: het start een FastCGI-proces, geen HTTP-server. Plaats er via een particulier containernetwerk een webserver met FastCGI-ondersteuning, zoals Nginx, voor. De PHP-image luistert intern op poort 9000. Publiceer deze FastCGI-poort niet op internet.

Stack Op te geven startpunt Te controleren projectbestanden
Node.js Relatief JavaScript-pad, bijvoorbeeld server.js package.json, package-lock.json, startbestand
Python Relatief Python-pad, bijvoorbeeld app.py requirements.txt, startbestand
PHP-FPM Vast php-fpm-proces PHP-broncode en een afzonderlijke FastCGI-webserver
Go Pakketpad, bijvoorbeeld . of ./cmd/server go.mod en broncode voor dat pakket
Rust Naam van de Cargo-binary Cargo.toml, Cargo.lock en het genoemde binary-target

Wat de gegenereerde bestanden doen

WORKDIR stelt de werkmap van het proces in de image in. Het formulier accepteert app-paden onder /app, /srv/app, /opt/app, /workspace, /usr/src/app of /var/www; systeempaden zoals /root en tekens die invoer in een andere Dockerfile-instructie kunnen veranderen, worden geweigerd. EXPOSE documenteert een containerpoort; het opent geen firewall op de host en laat je app niet luisteren. De gegenereerde .dockerignore houdt gebruikelijke lokale mappen met afhankelijkheden, versiebeheerdata en .env-bestanden in de hoofdmap en submappen buiten de buildcontext. Lees het bestand voor het bouwen: pas een regel aan als die een bestand uitsluit dat je project nodig heeft. Verwerk nooit geheimen in broncode, ARG of ENV.

Gecompileerde Go- en Rust-projecten gebruiken afzonderlijke bouw- en uitvoeringsfasen, zodat de compiler niet in de uiteindelijke image terechtkomt. De Node.js- en Python-varianten installeren de opgegeven afhankelijkheden en de PHP-FPM-variant start de FastCGI-service. Een containerrecept kan niet garanderen dat een echt project bouwt, start, een gezondheidscontrole doorstaat, de verwachte route aanbiedt of veilig kan worden uitgerold. Frameworks, native extensies, het bouwen van assets en bestandsrechten kunnen extra stappen vereisen. Docker beschrijft de laagvolgorde en de werking van uitsluitbestanden in de aanbevelingen voor builds en de uitleg over de buildcontext.

Test met je eigen app

Pak de ZIP uit in de hoofdmap van de buildcontext, zodat de bestanden precies Dockerfile en .dockerignore blijven heten. Je kunt beide bestanden ook kopiëren en onder die namen opslaan. Voer docker build --check . uit als je Docker-versie dit ondersteunt en daarna docker build -t my-app .. Start de image in een testomgeving en controleer het werkelijke startcommando en de route. Koppel bij HTTP-stacks alleen de bedoelde containerpoort en controleer de respons. Gebruik voor PHP-FPM een FastCGI-verbinding via een privénetwerk in plaats van poort 9000 te publiceren. Controleer actuele patches voor de basisimage en je dependency-lockbestanden vóór een productie-uitrol.

Veelgestelde vragen

Nee. Het is een gangbaar uitgangspunt voor de gekozen stack en het startpunt. Controleer je werkelijke dependencybestanden, systeempakketten, assetbuild, rechten, opstartgedrag en beveiligingseisen. Bouw en start de image met je project voordat je die uitrolt.

Nee. EXPOSE documenteert de containerpoort. Je app moet op die poort luisteren en een aparte runtime-instelling bepaalt of de poort naar de host wordt gekoppeld. PHP-FPM gebruikt FastCGI in plaats van HTTP; houd poort 9000 op een particulier containernetwerk achter een geschikte webserver.

Dit bestand houdt gebruikelijke lokale afhankelijkheden, Git-data en omgevingsbestanden buiten de Docker-buildcontext. De punt aan het begin van de bestandsnaam blijft in de ZIP behouden. Pak beide bestanden uit in de hoofdmap van je buildcontext en controleer elke regel tegen je project, zodat benodigde bouwbestanden niet worden uitgesloten.

Nee. De gekozen stack, het startpunt, de werkmap en de poort staan in de URL van de resultaatpagina en bereiken deze site om de bestanden weer te geven. Vul geen geheimen of paden naar privérepositories in. De tool uploadt geen broncode en inspecteert je repository niet.

Gerelateerde tools

Tool beschikbaar in andere talen