Generator polecenia docker run

Generator docker run — poprawna i bezpiecznie cytowana komenda

Generator docker run składa polecenie uruchamiające pojedynczy kontener z wybranego obrazu. Ustaw nazwę, mapowanie portu, jeden wolumen, plik zmiennych środowiskowych oraz sposób działania po zatrzymaniu, a otrzymasz wielowierszową komendę przygotowaną dla powłoki POSIX.

Narzędzie nie uruchamia Dockera i nie przesyła obrazu. Wynik jest zwykłym tekstem do sprawdzenia i skopiowania. Każda wartość pochodząca z formularza trafia do osobnego argumentu, a nazwa obrazu pozostaje na końcu, bo Docker interpretuje wszystko po niej jako komendę procesu w kontenerze. Walidacja odrzuca niepełne porty, niebezpieczne montowania i połączenie opcji, których Docker nie akceptuje.

Jak opcje przekładają się na polecenie?

Krok po kroku

1. Wpisz pełną nazwę obrazu z wersją, na przykład nginx:1.27-alpine. Unikaj latest, jeśli zależy Ci na powtarzalnym uruchomieniu.
2. Nadaj kontenerowi nazwę. Pozwoli używać prostego docker logs web-app zamiast losowego identyfikatora.
3. Podaj oba porty albo wyczyść oba pola. Generator publikuje port hosta na 127.0.0.1, więc usługa nie staje się przypadkiem publiczna.
4. Opcjonalnie dodaj montowanie w formacie źródło:/cel:ro oraz ścieżkę do pliku środowiskowego.
5. Wybierz politykę działania, wygeneruj polecenie, przeczytaj je i dopiero potem uruchom w terminalu.

docker run \
  -d \
  --restart unless-stopped \
  --name 'web-app' \
  --publish 127.0.0.1:8080:80 \
  --volume './public:/usr/share/nginx/html:ro' \
  'nginx:1.27-alpine'

Shell quoting i odporność na wstrzyknięcie

Spacja, apostrof, średnik albo znak dolara mają specjalne znaczenie dla powłoki. Proste sklejenie -v z danymi formularza może rozbić argument albo wykonać dodatkowe polecenie. Generator otacza dynamiczne wartości apostrofami i zapisuje apostrof wewnątrz wartości w przenośnej formie POSIX. Flagi są stałe i dodawane osobno. Dzięki temu ścieżka ze spacją pozostaje jednym argumentem dla klienta Docker.

Cytowanie zabezpiecza składnię powłoki, ale nie sprawia, że dowolna konfiguracja jest dobrym pomysłem. Narzędzie odrzuca montowanie katalogu głównego hosta i gniazda docker.sock, bo dają kontenerowi dostęp porównywalny z administratorem. Nie oferuje też --privileged. Jeśli aplikacja ma zapisywać tylko jeden katalog, udostępnij właśnie ten katalog zamiast całego systemu plików.

Porty, sieć i dostęp z zewnątrz

Zapis 127.0.0.1:8080:80 oznacza: klient łączy się z portem 8080 hosta, Docker przekazuje ruch do portu 80 kontenera, ale tylko interfejs pętli zwrotnej przyjmuje połączenia. To dobre ustawienie za lokalnym Nginxem lub tunelem SSH. Aby wystawić usługę publicznie, świadomie zmień adres po wygenerowaniu i skonfiguruj firewall oraz TLS.

Sam EXPOSE w Dockerfile nie publikuje portu. Jest dokumentacją obrazu; dostęp tworzy dopiero --publish. Konfigurację warstwy HTTP przygotujesz z generatorem .htaccess, a szersze wdrożenie klastra opisze generator Deployment Kubernetes. Dla kilku współpracujących usług lepszy będzie deklaratywny plik Compose.

Wolumeny i plik środowiskowy

Montowanie bind łączy konkretną ścieżkę hosta z bezwzględną ścieżką w kontenerze. Sufiks :ro blokuje zapis z kontenera i powinien być domyślnym wyborem dla konfiguracji oraz statycznych plików. Uważaj na względne ścieżki: są liczone od katalogu, z którego uruchamiasz klienta Docker. Generator cytuje cały zapis jako jeden argument.

Wzorce plików, których nie należy wysyłać do obrazu, przygotuje generator .gitignore, a strukturę deklaratywnej konfiguracji możesz sprawdzić walidatorem YAML. Te narzędzia nie zastępują przeglądu praw dostępu i konfiguracji konkretnego hosta.

Restart i kontenery jednorazowe

--restart unless-stopped pasuje do usługi działającej stale. --rm pasuje do migracji, kompilacji lub jednorazowego skryptu, który ma zniknąć po zakończeniu. Docker nie pozwala połączyć polityki restartu z automatycznym usunięciem, dlatego generator zgłasza błąd zamiast tworzyć komendę, która zostanie odrzucona.

Najczęściej zadawane pytania