Zum Inhalt

FAQ

Driver failed programming external connectivity

Problem

Beim Starten der von OCI-Containern beispielsweise durch PTR oder Docker Compose kommt es zu Fehlern.

$ bin/ptr dev
(...)
ERROR: for example  Cannot start service example: driver failed programming external connectivity on endpoint example-example_1 (0123456789abcedf0123456789abcdef0123456789abcdef0123456789abcdef): Bind for 0.0.0.0:80 failed: port is already allocated

oder

$ bin/ptr dev
(...)
ERROR: for example  Cannot start service example: driver failed programming external connectivity on endpoint example-example_1 (0123456789abcedf0123456789abcdef0123456789abcdef0123456789abcdef): Error starting userland proxy: listen tcp 0.0.0.0:80: bind: address already in use

Lösung

Es läuft bereits an anderes Programm, was auf dem gleichen Port horcht. Entweder muss dieses Programm beendet werden, oder man muss jenes Programm und/oder dieses Projekt so konfigurieren, dass sie auf verschiedenen Ports horchen.

Das andere Programm kann entweder ein System-Dienst, welche man mit dem Befehl systemctl list-units auflisten kann, oder ein anderer OCI-Container, welche man mit dem Befehl docker container ls auflisten kann. Häufige Dienste und deren Ports sind:

  • Apache HTTPd: 80
  • Docker: 2375, 2376
  • MariaDB: 3306
  • Microsoft SQL Server: 1433
  • MySQL: 3306, 33060
  • NGINX: 80
  • PostgreSQL: 5432

System-Dienste lassen sich mit dem Befehl systemctl stop beenden und falls gewünscht mit systemctl disable permanent deaktivieren. Projekte basierend auf Docker Compose lassen sich für parallele Nutzung konfigurieren.

Migration can only be executed safely on ‘…’

Problem

Beim Starten der Entwicklungsumgebung eines Symfony-Projekts kommt es zu Fehlern.

$ bin/ptr dev
(...)
example_1 |   Migration can only be executed safely on 'example'.
(...)

Lösung

Es ist (wahrscheinlich unabsichtlich) eine andere Datenbank konfiguriert als die, für welche ursprünglich Migrations erstellt wurden. Überprüfe und ändere oder entferne die Datenbankkonfiguration in folgenden Dateien:

  • .env
  • .env.local

Service needs to be built

Problem

Beim Starten der Entwicklungsumgebung mit PTR kommt es zu Fehlern.

$ bin/ptr dev
(...)
ERROR: Service 'example' needs to be built, but --no-build was passed.

Lösung

Bevor die Container gestartet werden können müssen zuerst deren Images gebaut werden. Führe dafür erst bin/ptr build aus.

URL required authentication

Problem

Beim bauen eines Projekts mit PTR kommt es zu Authentifizierungsfehlern von Composer.

$ bin/ptr build
(...)
  [Composer\Downloader\TransportException]
  The 'https://example.net/example' URL required authentication.
  You must be using the interactive console to authenticate
(...)

Lösung

Konfiguriere die Zugangsdaten, welche in Bitwarden zu finden sind, der Repositorien, die in der Datei composer.json aufgelisteten sind.

$ bin/ptr exec composer config --global http-basic.HOSTNAME USERNAME PASSWORD