Kurzanleitung: Kotlin-Dienst in Cloud Run bereitstellen

Beispielanwendung schreiben

So schreiben Sie eine Anwendung in Kotlin:

Erstellen Sie eine Spring Boot-Anwendung.

1. Erstellen Sie über die Konsole mit den Befehlen "cURL" und "unzip" ein neues, leeres Webprojekt:

   curl https://start.spring.io/starter.zip \
       -d language=kotlin \
       -d type=gradle-project-kotlin \
       -d bootVersion=3.2.5 \
       -d dependencies=webflux \
       -d javaVersion=17 \
       -d name=Demo \
       -d artifactId=helloworld \
       -d baseDir=helloworld \
       -d packageName=demo \
       -o helloworld.zip
   unzip helloworld.zip
   cd helloworld
   

   Dadurch wird ein Spring Boot-Projekt erstellt.

   Verwenden Sie zum Erstellen des Projekts eine der folgenden Befehlszeilen oder optional Spring Initializr (Konfiguration vorab geladen), um diesen cURL-Befehl in Microsoft Windows nutzen zu können:

   • WSL (bevorzugt)
   • cygwin

2. Aktualisieren Sie die Klasse DemoApplication in src/main/kotlin/DemoApplication.kt. Fügen Sie dazu einen @RestController hinzu, um die /-Zuordnung zu verarbeiten:

   package demo
   
   import kotlinx.coroutines.delay
   import org.springframework.boot.autoconfigure.SpringBootApplication
   import org.springframework.boot.runApplication
   import org.springframework.web.bind.annotation.GetMapping
   import org.springframework.web.bind.annotation.RestController
   
   @SpringBootApplication
   @RestController
   class DemoApplication {
   
       @GetMapping("/")
       suspend fun index() = run {
           delay(10)
           "hello, world"
       }
   }
   
   fun main(args: Array<String>) {
       runApplication<DemoApplication>(*args)
   }
   

3. Legen Sie den Serverport fest, der durch die in application.properties durch die Umgebungsvariable „PORT“ definiert werden soll:

   server.port=${PORT:8080}
   

   Mit diesem Code wird ein einfacher Webserver erstellt, der den von der Umgebungsvariable PORT definierten Port überwacht.

4. Erstellen Sie im Stammverzeichnis eine project.toml-Datei, um eine Java-Version anzugeben:

   [[build.env]]
   name =  "GOOGLE_RUNTIME_VERSION"
   value = "17"
   

Die Anwendung ist fertig und kann bereitgestellt werden.

Für Cloud Run aus Quelle bereitstellen

Wichtig: In dieser Kurzanleitung wird davon ausgegangen, dass Sie Inhaber- oder Bearbeiterrollen in dem Projekt haben, das Sie für die Kurzanleitung verwenden. Andernfalls finden Sie in der Rolle „Cloud Run Source Developer“ die erforderlichen Berechtigungen zum Bereitstellen einer Cloud Run-Ressource aus der Quelle.

Beim Bereitstellen aus dem Quellcode wird automatisch ein Container-Image aus dem Quellcode erstellt und bereitgestellt.

So stellen Sie aus der Quelle bereit:

1. Stellen Sie in Ihrem Quellcodeverzeichnis mit dem folgenden Befehl aus der Quelle bereit:

   gcloud run deploy

   Wenn Sie aufgefordert werden, die API zu aktivieren, antworten Sie mit y, um dies zu tun.

   1. Wenn Sie zur Eingabe des Quellcodes aufgefordert werden, drücken Sie die Eingabetaste, um den aktuellen Ordner bereitzustellen.

   2. Wenn Sie zur Eingabe des Dienstnamens aufgefordert werden, drücken Sie die Eingabetaste, um den Standardnamen zu akzeptieren, z. B. helloworld.

   3. Wenn Sie aufgefordert werden, APIs für das Projekt zu aktivieren, z. B. die Artifact Registry API, antworten Sie durch Drücken von y.

   4. Wenn Sie zur Eingabe der Region aufgefordert werden, wählen Sie die Region Ihrer Wahl aus, zum Beispiel us-central1.

   5. Wenn Sie aufgefordert werden, ein Repository in der angegebenen Region zu erstellen, antworten Sie durch Drücken von y.

   6. Wenn Sie aufgefordert werden, nicht authentifizierte Aufrufe zuzulassen, antworten Sie mit y. Diese Eingabeaufforderung wird möglicherweise nicht angezeigt, wenn eine Organisationsrichtlinie zur Domaineinschränkung dies verhindert. Weitere Informationen finden Sie im Abschnitt Vorbereitung.

   Warten Sie dann einige Sekunden, bis die Bereitstellung abgeschlossen ist. Bei Erfolg wird in der Befehlszeile die Dienst-URL angezeigt.

2. Rufen Sie den bereitgestellten Service auf. Dazu öffnen Sie in einem Webbrowser die Dienst-URL.

Glückwunsch! Sie haben gerade ein Container-Image aus Quellcode in Cloud Run bereitgestellt. Cloud Run skaliert das Container-Image automatisch horizontal aus, damit die empfangenen Anfragen bearbeitet werden können, und skaliert es wieder herunter, wenn der Bedarf sinkt. Es fallen nur Kosten für die CPU-, Arbeitsspeicher- und Netzwerkressourcen an, die während der Anfrageverarbeitung verbraucht werden.