Bereiten Sie Ihre Laravel -App für die Cloud vor

Die jüngsten Ankündigungen bei Laraconus haben ein erneutes Interesse an Cloud-basierten Bereitstellungen innerhalb der Laravel-Community geweckt. Wenn die Debatte über die Bereitstellung Ihrer Apps weitergeht, ist eine Sache klar: Die Cloud wird für Laravel -Benutzer zu einer praktikableren Option.

In diesem Artikel werden wir untersuchen, wie Sie Ihre Laravel -App für die Bereitstellung in einer Cloud -Umgebung mit Frankenphp, Caddy, Dockerfiles vorbereiten und schließlich in Sevalla bereitstellen.

Wo fangen wir an? Natürlich in der lokalen Umgebung! ?

#Lokalentwicklungsumgebung

Um der Einfachheit zu willen, werden wir davon ausgehen, dass Sie eine frische Laravel -App auf Ihrem lokalen Computer installiert haben, die eine Verbindung zu einer PostgreSQL -Datenbank herstellt, um einige Daten zu lesen/zu schreiben.

Bevor wir fortfahren, stellen Sie sicher .env

:

.env

Sobald dies verifiziert ist, können wir mit dem Bau beginnen. ? ☕️

<!-- Syntax highlighted by torchlight.dev -->...
DB_CONNECTION=pgsql
...

Es ist immer eine gute Idee, eine lokale Entwicklungsumgebung zu haben, die Ihrer Produktionsumgebung stark ähnelt. Auf diese Weise können Sie frühzeitig Probleme aufnehmen und Überraschungen vermeiden, wenn Sie Ihre App in der Produktion bereitstellen.

Um das Produktionsaufbau nachzuahmen, werden wir Docker und Docker Compose verwenden. Wenn Sie Docker nicht auf Ihrem Computer installiert haben, können Sie es von der offiziellen Website herunterladen.

#Running Laravel ohne die Datenbank

Erstellen Sie zunächst eine neue Datei namens

im Stammvermögen Ihres Laravel -Projekts und fügen Sie den folgenden Inhalt hinzu:

compose.yml

:

compose.yml

Diese Konfigurationsdatei definiert einen Dienst namens

<!-- Syntax highlighted by torchlight.dev -->services:
  php:
    image: dunglas/frankenphp:php8.3-bookworm
    environment:
      SERVER_NAME: ":8080"
    ports:
      - 8080:8080
    volumes:
      - .:/app

, der das Bild

verwendet, bei dem es sich um ein Frankenphp -Bild handelt, das die erforderlichen Erweiterungen zum Ausführen einer Laravel -App enthält. Die Umgebungsvariable php konfiguriert Caddy, um Port dunglas/frankenphp:php8.3-bookworm zu hören. Wir setzen auch Port SERVER_NAME aus, um auf die App aus dem Host -Computer zuzugreifen. 8080 8080 Um Ihre Konfiguration zu testen, leiten Sie den folgenden Befehl in Ihrem Terminal aus:

Sie sollten eine Laravel -Fehlerseite sehen, die erklärt, dass die Verbindung nicht in der Datenbank festgelegt wurde, da ein fehlender Treiber in Ihrem Browser zu

<!-- Syntax highlighted by torchlight.dev -->docker compose up [-d]

navigiert wird. Dies wird erwartet, da wir unsere Laravel -App noch nicht mit einer Datenbank verbunden haben.

http://localhost:8080 fantastisch, bisher haben wir unsere Laravel -App so konfiguriert, dass sie von einem Frankenphp -Server bedient werden.

Verbinden wir unsere lokale App als nächstes mit einer PostgreSQL -Datenbank!

#Running Laravel mit der Datenbank

Um Ihre Laravel -App mit einer PostgreSQL -Datenbank zu verbinden, müssen wir ein paar Dinge tun.

Erstens müssen wir die folgenden Umgebungsvariablen in Ihrer

-Fatei festlegen:

.env

:

<!-- Syntax highlighted by torchlight.dev -->...
DB_CONNECTION=pgsql
...

Im Folgenden müssen Sie Ihrer compose.yml -Datei neue Dienste hinzufügen und eine benutzerdefinierte Dockerfile für Ihre Entwicklerumgebung erstellen. Erstellen und aktualisieren Sie die Dateien mit dem folgenden Inhalt:

Dockerfile.dev:

<!-- Syntax highlighted by torchlight.dev -->services:
  php:
    image: dunglas/frankenphp:php8.3-bookworm
    environment:
      SERVER_NAME: ":8080"
    ports:
      - 8080:8080
    volumes:
      - .:/app

Dockerfile.dev soll nur von Ihrer lokalen/Entwicklungsumgebung verwendet werden und erweitert das Bild dunglas/frankenphp:php8.3-bookworm um die Erweiterung pdo_pgsql, die zur Verbindung zu einer PostgreSQL -Datenbank erforderlich ist.

compose.yml:

<!-- Syntax highlighted by torchlight.dev -->docker compose up [-d]

hier ist viel los. Schauen wir uns an, was sich geändert hat und warum:

1. Wir haben den php -Dienst aktualisiert, um eine benutzerdefinierte Dockerfile namens Dockerfile.dev zu verwenden, um ein neues Bild zu erstellen, das die erforderlichen Erweiterungen enthält, um eine Verbindung zu einer PostgreSQL -Datenbank herzustellen.
2. Wir haben einen neuen Dienst namens db hinzugefügt, der das Bild postgres:16.4-alpine verwendet, um eine PostgreSQL -Datenbank auszuführen. Wir haben auch einige Umgebungsvariablen definiert, um den Namen des Datenbankbenutzers, des Kennworts und des Datenbanknamens einzurichten.
3. Wir haben ein neues Volumen namens db_data erstellt, um die Daten in der Datenbank auf Ihrem Computer zu bestehen, und Docker könnte sie wiederverwenden, wenn Sie die Dienste neu starten.
4. wurde auch ein neuer Dienst namens init hinzugefügt, der Dockerfile.dev wiederverwendet. Dieses Bild wird verwendet, um den Befehl php artisan migrate auszuführen, um Ihre Datenbankmigrationen auszuführen. Die depends_on -Taste stellt sicher, dass der db -Dienst im Betrieb ist, bevor die Migrationen ausgeführt werden.
5. Der php -Dienst hängt nun vom init -Dienst ab, um sicherzustellen, dass die Datenbankmigrationen ausgeführt werden, bevor die Laravel -App startet.
6. Wir haben dem db -Dienst eine Gesundheitsprüfung hinzugefügt, um sicherzustellen, dass die PostgreSQL -Datenbank in Betrieb ist, bevor der init -Dienst die Migrationen ausgeführt wird.

Um Ihre Konfiguration zu testen, führen Sie den folgenden Befehl in Ihrem Terminal aus:

<!-- Syntax highlighted by torchlight.dev -->...
DB_CONNECTION=pgsql
DB_HOST=db
DB_PORT=5432 # default PostgreSQL port
DB_DATABASE=main
DB_USERNAME=admin
DB_PASSWORD=password

Ihre Anwendung sollte jetzt eine Verbindung zu Ihrer PostgreSQL -Datenbank herstellen, und Ihre Datenbankmigrationen werden immer ausgeführt. ?

Ihre lokale Umgebung ist jetzt bereit, Ihre Produktionsumgebung nachzuahmen. Sie können jetzt Ihre App lokal entwickeln und ein wirklich ähnliches Setup testen, das Sie in der Produktion verwenden,

#Vorbereitung für die Produktion

Es ist Zeit, die erforderlichen Änderungen für Ihre Produktionsumgebung vorzunehmen.

Der erste Schritt besteht darin, Docker mitzuteilen, welche Verzeichnisse er beim Erstellen des Produktionsbildes sicher ignorieren kann. Erstellen Sie eine neue Datei namens

im Stammermaterial Ihres Laravel -Projekts und fügen Sie den folgenden Inhalt hinzu: .dockerignore

: .dockerignore

<!-- Syntax highlighted by torchlight.dev -->FROM dunglas/frankenphp:php8.3-bookworm

RUN install-php-extensions pdo_pgsql

Diese Datei fordert Docker auf, die Verzeichnisse

, vendor und bootstrap/cache zu ignorieren. tests

Erstellen Sie dann ein Dockerfile, mit dem Ihr Produktionsbild erstellt wird:

Dockerfile:

<!-- Syntax highlighted by torchlight.dev -->...
DB_CONNECTION=pgsql
...

Dieses Dockerfile ähnelt dem Dockerfile.dev, das wir früher erstellt haben, enthält jedoch einige zusätzliche Schritte:

1. Da das Frankenphp -Bild Caddy als Standard -Webserver verwendet, haben wir die Umgebungsvariable SERVER_NAME auf :8080 festgelegt, um Caddy anzuweisen, auf Port 8080 zuzuhören.
2. Wir installieren die Erweiterung @composer PHP, um den Komponisten im Bild zu installieren.
3. composer install Der Befehl wird ausgeführt, um die Abhängigkeiten Ihrer Laravel -App zu installieren.
4. Wir haben das Arbeitsverzeichnis auf /app gesetzt und den Inhalt Ihrer Laravel -App auf das Bild kopiert.

Um Ihre Änderungen in Ihrer lokalen Umgebung zu testen, müssen Sie einen Produktionsaufbau Ihrer App erstellen. Führen Sie den folgenden Befehl in Ihrem Terminal aus:

<!-- Syntax highlighted by torchlight.dev -->services:
  php:
    image: dunglas/frankenphp:php8.3-bookworm
    environment:
      SERVER_NAME: ":8080"
    ports:
      - 8080:8080
    volumes:
      - .:/app

Dieser Befehl erstellt ein neues Docker -Bild namens my-laravel-app basierend auf dem Dockerfile im aktuellen Verzeichnis.

Verwenden Sie den folgenden Befehl:

, um Ihr neu erfasstes Produktionsbild zu testen:

<!-- Syntax highlighted by torchlight.dev -->docker compose up [-d]

<your-app-key> Ersetzen Sie APP_KEY durch den Wert der Umgebungsvariablen .env in Ihrer

-Datei oder holen Sie sich von hier einen Schlüssel.

Besuchen Sie Localhost: 8080 in Ihrem Browser, und Ihre App sollte im Produktionsmodus beginnen. Dies kann aufgrund des Fehlens einer Datenbankverbindung fehlerhaft sein, aber das wird erwartet.

#deploying an die Wolke

Jetzt, da Sie ein produktionsbereites Docker-Image haben, können Sie es für einen Cloud-Anbieter bereitstellen. ?

Dockerfile In diesem Tutorial werden wir Sevalla verwenden, einen neuen Cloud-Anbieter, der eine einfache Möglichkeit bietet,

-basierte Bereitstellungen bereitzustellen.

Da Ihre App von einer PostgreSQL -Datenbank abhängt, sind Sie zuerst eine neue PostgreSQL -Datenbank auf Sevalla vor. Sobald Sie im Sevalla Dashboard angemeldet sind,

Navigieren Sie zum Datenbankmodal erstellen
Wählen Sie die PostgreSQL -Datenbank
3. aus
Bestätigen Sie die Einstellungen und erstellen Sie die Datenbank

Sobald Ihre Datenbank fertig ist, können Sie Ihre Laravel -App auf Sevalla erstellen.

Navigieren Sie zum Modal Create App
Wählen Sie das Repository Ihrer App aus Ihrem bevorzugten Git -Anbieter
3. aus
Stellen Sie sicher
4. Setzen Sie die von Laravel APP_KEY erforderliche Umgebungsvariable
Umgebungsvariable
5. Wählen Sie Dockerfile als Build -Typ
6. Bestätigen Sie den Rest der Einstellungen und klicken Sie auf die Schaltfläche "Später einsetzen"

Wenn Ihre App fertig ist, können Sie sie jetzt mit Ihrer PostgreSQL -Datenbank verbinden.

1. Navigieren Sie zur Seite der App
2. Gehen Sie zur Registerkarte "Netzwerk"
3. Klicken Sie auf die Schaltfläche "Verbindung hinzufügen" und wählen Sie Ihre PostgreSQL -Datenbank
aus
4. Bestätigen Sie die Einstellungen und klicken Sie auf "Connect"

Stellen Sie dann die folgenden Umgebungsvariablen auf der Registerkarte "Umgebungsvariablen" mit den Verbindungsdetails Ihrer Datenbank fest:

• DB_CONNECTION
• DB_HOST
• DB_PORT
• DB_DATABASE
• DB_USERNAME
• DB_PASSWORD

Wir haben die interne Netzwerkadresse Ihrer Datenbank als DB_HOST -Werte empfohlen. Auf diese Weise kann Ihre App eine Verbindung zur Datenbank über ein privates Netzwerk herstellen.

Der letzte Schritt besteht darin, einen Jobprozess für Ihre Anwendung einzurichten, um die Datenbank -Mirgationen auszuführen, bevor die App gestartet wird.

1. Navigieren Sie zur Registerkarte "Prozesse"
2. Klicken Sie auf die Schaltfläche "Prozess erstellen" und wählen Sie "Job"
3. Setzen Sie den Befehl auf php artisan migrate --force
4. Setzen Sie die Startrichtlinie auf "Vor dem Einsatz"
5. Bestätigen Sie die Einstellungen und klicken Sie auf "Erstellen"

Wenn dies auch erfolgt, können Sie jetzt eine manuelle Bereitstellung Ihrer App auf der Registerkarte Bereitstellungen einleiten. ?

Wenn alles gut gegangen ist, herzlichen Glückwunsch! Sie haben Ihre Laravel -App erfolgreich für die Cloud vorbereitet. ?

#Conclusion

In diesem Artikel haben wir untersucht:

• So richten Sie Ihre lokale Umgebung so ein, dass Sie Ihre Produktionsumgebung mit Docker und docker compose.
nachahmen
• So erstellen Sie Ihre Laravel -App für die Bereitstellung in einer Cloud -Umgebung mit Docker, Frankenphp und Caddy.
• Wir haben auch abgedeckt, wie Sie Ihre App für einen Cloud -Anbieter wie Sevalla bereitstellen.

Wenn Sie diese Schritte befolgen, können Sie Ihre Laravel-App auf neue Höhen bringen und die Vorteile von Cloud-basierten Bereitstellungen genießen. ?

#Update: 8. September 2024

Wir haben durch eine Diskussion über X wertvolles Feedback von der Community erhalten.

Der erste Punkt hat hervorgehoben, dass die Einbeziehung des Befehls php artisan serve in die compose.yml -Datei unnötig war, da er den Frankenphp -Server umging. Wir haben dies korrigiert, indem wir die relevanten Abschnitte der Datei compose.yml aktualisiert haben.

Der zweite Punkt, der von Kévin Dunglas (Schöpfer von Frankenphp) geteilt wurde, empfohlen mit einem Debian-basierten Bild (bookworm) anstelle von Alpine (alpine), da Debian eine bessere Kompatibilität mit PHP und eine bessere Leistung mit Frankenphp bietet. Infolgedessen haben wir sowohl die Dockerfile.dev als auch die Dockerfile -Pateien aktualisiert.

Wir sind dankbar für die Unterstützung und das Feedback der Community. ? ❤️

Das obige ist der detaillierte Inhalt vonBereiten Sie Ihre Laravel -App für die Cloud vor. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!