Google App Engine

You first need to install the cli. You can grab it from here: https://cloud.google.com/sdk/docs/ and follow the described steps to install it.

After that, you can start a new shell, and you should have access to the gcloud cli. For example:

  1. > gcloud --version
  2. Google Cloud SDK 194.0.0
  3. bq 2.0.30
  4. core 2018.03.16
  5. gsutil 4.29

You will also need to install some components with the cli (gcloud components install app-engine-java):

For your project, you can use gradle and the official appengine-gradle-plugin. So a build.gradle would look like this:

  1. buildscript {
  2.     ext.appengine_version = '1.9.60'
  3.     ext.appengine_plugin_version = '1.3.4'
  5.     repositories {
  6.         jcenter()
  7.     }
  8.     dependencies {
  9.         classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
  10.         classpath "com.google.cloud.tools:appengine-gradle-plugin:$appengine_plugin_version"
  11.     }
  12. }
  14. apply plugin: 'kotlin'
  15. apply plugin: 'war'
  16. apply plugin: 'com.google.cloud.tools.appengine'
  18. // appengine does not honor this property, so we are forced to use deep Maven tree layout
  19. // webAppDirName = file('webapp')
  21. sourceSets {
  22.     main.kotlin.srcDirs = [ 'src/main/kotlin' ]
  24. repositories {
  25.     jcenter()
  26. }
  28. dependencies {
  29.     compile "org.jetbrains.kotlin:kotlin-stdlib-jdk8:$kotlin_version"
  30.     compile "io.ktor:ktor-server-servlet:$ktor_version"
  31.     compile "io.ktor:ktor-html-builder:$ktor_version"
  32.     compile "org.slf4j:slf4j-jdk14:$slf4j_version"
  34.     providedCompile "com.google.appengine:appengine:$appengine_version"
  35. }
  37. kotlin.experimental.coroutines = 'enable'
  39. task run(dependsOn: appengineRun)

Once everything is configured, you can now run the application locally, using the gradle task appengineRun:

It should start the server in and the admin in http://localhost:8080/_ah/admin.

Deploying

First, we need to create a project gcloud projects create demo-demo-123456 --set-as-default:

  1. > gcloud projects create demo-demo-123456 --set-as-default
  2. Create in progress for [https://cloudresourcemanager.googleapis.com/v1/projects/demo-demo-123456].
  3. Waiting for [operations/pc.7618150612308930095] to finish...done.
  4. Updated property [core/project] to [demo-demo-123456].

And then we need to create an application using gcloud app create:

Now we can deploy the application using gradle appengineDeploy:

  1. > gradle :google-appengine-standard:appengineDeploy
  2. Starting a Gradle Daemon (subsequent builds will be faster)
  3. Reading application configuration data...
  4. Mar 23, 2018 6:32:09 AM com.google.apphosting.utils.config.IndexesXmlReader readConfigXml
  5. INFORMATION: Successfully processed /Users/user/projects/ktor-samples/deployment/google-appengine-standard/build/exploded-google-appengine-standard/WEB-INF/appengine-generated/datastore-indexes-auto.xml
  7. Beginning interaction for module default...
  8. 0% Scanning for jsp files.
  10. Success.
  11. Services to deploy:
  13. descriptor:      [/Users/user/projects/ktor-samples/deployment/google-appengine-standard/build/staged-app/app.yaml]
  14. source:          [/Users/user/projects/ktor-samples/deployment/google-appengine-standard/build/staged-app]
  15. target project:  [demo-demo-123456]
  16. target service:  [default]
  17. target version:  [20180323t063212]
  18. target url:      [https://demo-demo-123456.appspot.com]
  20. Beginning deployment of service [default]...
  21. Some files were skipped. Pass `--verbosity=info` to see which ones.
  22. You may also view the gcloud log file, found at
  23. [/Users/user/.config/gcloud/logs/2018.03.23/06.32.10.739209.log].
  24. #============================================================#
  25. #= Uploading 38 files to Google Cloud Storage               =#
  26. #============================================================#
  27. File upload done.
  28. Updating service [default]...
  29. ..............done.
  30. Setting traffic split for service [default]...
  31. .......done.
  32. Deployed service [default] to [https://demo-demo-123456.appspot.com]
  34. You can stream logs from the command line by running:
  35.   $ gcloud app logs tail -s default
  37. To view your application in the web browser run:
  38.   $ gcloud app browse
  40. BUILD SUCCESSFUL in 42s