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.

    For example, a macOS setup might look something like this:

    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

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

    build.gradle

    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' ]
    23. }
    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 http://localhost:8080/ and the admin in .

    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:

    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
    8. Beginning interaction for module default...
    9. 0% Scanning for jsp files.
    10. 0% Generated git repository information file.
    12. Services to deploy:
    14. descriptor:      [/Users/user/projects/ktor-samples/deployment/google-appengine-standard/build/staged-app/app.yaml]
    15. source:          [/Users/user/projects/ktor-samples/deployment/google-appengine-standard/build/staged-app]
    16. target project:  [demo-demo-123456]
    17. target service:  [default]
    18. target version:  [20180323t063212]
    19. target url:      [https://demo-demo-123456.appspot.com]
    22. Beginning deployment of service [default]...
    23. Some files were skipped. Pass `--verbosity=info` to see which ones.
    24. You may also view the gcloud log file, found at
    25. [/Users/user/.config/gcloud/logs/2018.03.23/06.32.10.739209.log].
    26. #============================================================#
    27. #= Uploading 38 files to Google Cloud Storage               =#
    28. #============================================================#
    29. File upload done.
    30. Updating service [default]...
    31. ..............done.
    32. Setting traffic split for service [default]...
    33. .......done.
    34. Deployed service [default] to [https://demo-demo-123456.appspot.com]
    36. You can stream logs from the command line by running:
    37.   $ gcloud app logs tail -s default
    39. To view your application in the web browser run:
    40.   $ gcloud app browse
    42. BUILD SUCCESSFUL in 42s

    Now you can view your application in your browser with . It will openthe application. In this case: