Migrieren einer App Engine-Anwendung mit flexibler Umgebung zu Cloud Run

Container-Images bereitstellen

Wenn Ihre App Engine-Dienste mit einem manuell erstellten Container bereitgestellt werden, können Sie dasselbe Container-Image verwenden, um Ihren Dienst in Cloud Run bereitzustellen. So stellen Sie Ihr App Engine-Container-Image in Cloud Run bereit:

1. Notieren Sie sich die Registry-URL, unter der sich Ihr Container-Image befindet. Das ist dieselbe URL, die Sie im Flag --image-url angeben, wenn Sie die Anwendung in der App Engine bereitstellen.

2. Stellen Sie das Container-Image bereit:

   Console

   1. Wechseln Sie in der Google Cloud Console zur Seite Cloud Run.

      Öffnen Sie Cloud Run.

   2. Klicken Sie auf Dienst erstellen.

   3. Klicken Sie im Feld Container-Image-URL auf die Schaltfläche Auswählen und wählen Sie das Container-Image aus, das Sie für die App Engine bereitgestellt haben.

   4. Geben Sie einen Namen für den Dienst ein. Wählen Sie einen eindeutigen Namen für die App aus, die Sie bereitstellen.

   5. Wählen Sie im Bereich Authentifizierung die Option Nicht authentifizierte Aufrufe zulassen aus.

   6. Sie müssen für Cloud Run dieselben Umgebungsvariablen erstellen, die Sie in der Datei app.yaml Ihrer App Engine-Anwendung definiert haben. Maximieren Sie den Bereich Container, Netzwerk, Sicherheit und erstellen Sie die folgenden Umgebungsvariablen, indem Sie unter Umgebungsvariablen auf Variable hinzufügen klicken.

      • Für Unix-Sockets fügen Sie Folgendes hinzu:

          INSTANCE_UNIX_SOCKET: /cloudsql/INSTANCE_CONNECTION_NAME
        

      • Für Cloud SQL-Connectors fügen Sie Folgendes hinzu:

          INSTANCE_CONNECTION_NAME:INSTANCE_CONNECTION_NAME
        

        Ersetzen Sie INSTANCE_CONNECTION_NAME durch Ihre Projekt-ID, Region und Instanz im Format von project:region:instance-id. Sie finden ihn in der Google Cloud Console auf der Seite Übersicht für Ihre Instanz.

        Solche Verbindungen werden ohne zusätzliche Konfiguration automatisch verschlüsselt.

      • DB_NAME: Name Ihrer Datenbank.

      • DB_USER: Nutzername des Datenbanknutzers.

      • DB_PASS: Das Passwort, das Sie beim Erstellen der Datenbank angegeben haben.

   7. Klicken Sie im Abschnitt Cloud SQL-Verbindungen auf die Schaltfläche Verbindung hinzufügen und wählen Sie die Instanz aus, die Sie zuvor für die App Engine erstellt haben.

   8. Klicken Sie auf Bereitstellen. Sobald der Cloud Run-Dienst bereitgestellt ist, wird oben auf der Seite Dienstdetails eine URL angezeigt. Klicken Sie auf den Link URL, um in Cloud Run die bereitgestellte Anwendung zu sehen, die mit Cloud SQL verbunden ist.

   gcloud

   Führen Sie den folgenden Befehl aus, um einen neuen Dienst in Cloud Run zu erstellen. Sie müssen Konfigurations-Flags festlegen, um dieselben SQL-Verbindungsumgebungsvariablen einzuschließen, die in der app.yaml-Datei Ihrer App Engine-Anwendung definiert sind:

   gcloud run deploy run-sql --image IMAGE \
     --allow-unauthenticated \
     --add-cloudsql-instances INSTANCE_CONNECTION_NAME\
     --set-env-vars INSTANCE_UNIX_SOCKET="/cloudsql/INSTANCE_CONNECTION_NAME" \
     --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME" \
     --set-env-vars DB_NAME="DB_NAME" \
     --set-env-vars DB_USER="DB_USER" \
     --set-env-vars DB_PASS="DB_PASS"
   

   Ersetzen Sie:

   • IMAGE durch das Image, das Sie bereitstellen

   • INSTANCE_CONNECTION_NAME durch den Namen der Verbindung Ihrer Cloud SQL-Instanz oder eine durch Kommas getrennte Liste von Verbindungsnamen. Sie können die INSTANCE_CONNECTION_NAME mit folgendem Befehl ermitteln:

       gcloud instances describe INSTANCE_NAME
     

   • DB_NAME durch den Namen Ihrer Datenbank.

   • DB_USER durch den Nutzernamen Ihrer Datenbank.

   • DB_PASS durch das Passwort Ihres Datenbanknutzers.

Quellcode bereitstellen

Cloud Run verwendet intern buildpacks und Cloud Build, um automatisch Container-Images aus Ihrem Quellcode zu erstellen. Sie müssen also keinen Container manuell erstellen oder ein Dockerfile angeben. Wenn aber ein Dockerfile vorhanden ist, wird es verwendet.

Da die Bereitstellung eines Cloud Run-Dienstes aus der Quelle Artifact Registry verwendet, ist diese Funktion nur in von Artifact Registry unterstützten Regionen verfügbar.

So stellen Sie denselben Quellcode bereit, den Sie zuvor in App Engine bereitgestellt haben:

1. Wechseln Sie in das Quellverzeichnis, in dem sich der Quellcode Ihrer Anwendung befindet.

     cd YOUR_APPENGINE_CODE_DIR
   

2. In Cloud Run bereitstellen

   Führen Sie den Befehl „deploy“ mit dem Flag --source aus, um den Quellcode zu erstellen und die Anwendung bereitzustellen. Sie müssen Konfigurations-Flags festlegen, um dieselben SQL-Verbindungsumgebungsvariablen einzuschließen, die in der app.yaml-Datei Ihrer App Engine-Anwendung definiert sind:

     gcloud run deploy run-sql --source SOURCE \
       --allow-unauthenticated \
       --add-cloudsql-instances INSTANCE_CONNECTION_NAME\
       --set-env-vars INSTANCE_UNIX_SOCKET="/cloudsql/INSTANCE_CONNECTION_NAME" \
       --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME" \
       --set-env-vars DB_NAME="DB_NAME" \
       --set-env-vars DB_USER="DB_USER" \
       --set-env-vars DB_PASS="DB_PASS"
   

   Ersetzen Sie:

   • SOURCE durch den Pfad zum App Engine-Quellverzeichnis
   • INSTANCE_CONNECTION_NAME durch den Namen der Verbindung Ihrer Cloud SQL-Instanz oder eine durch Kommas getrennte Liste von Verbindungsnamen Sie können den INSTANCE_CONNECTION_NAME mit dem folgenden Befehl finden:

       gcloud instances describe INSTANCE_NAME
   

   • DB_NAME durch den Namen Ihrer Datenbank.
   • DB_USER durch den Nutzernamen Ihrer Datenbank.
   • DB_PASS durch das Passwort Ihres Datenbanknutzers.

3. Geben Sie einen Namen für den SERVICE ein, wenn Sie dazu aufgefordert werden.

4. Beantworten Sie die Aufforderungen, die erforderlichen APIs zu installieren, indem Sie nach Aufforderung y antworten. Dies ist nur einmal für ein Projekt erforderlich. Warten Sie, bis der Build und die Bereitstellung abgeschlossen sind. Anschließend wird eine Meldung wie die folgende angezeigt:

   Service [my-app] revision [my-app-00000-xxx] has been deployed and is serving 100 percent of traffic. Service URL: https://sample.run.app
   

   Weitere Informationen zum Bereitstellen von Quellcode in Cloud Run finden Sie unter Aus Quellcode bereitstellen.