Add a deprecation notice (#965)

* Add a deprecation notice 1. Main README 2. Test w/ appidentity README * mention java 7 runtime turndown on samples
GoogleCloudPlatform · Dec 20, 2017 · 2c1b297 · 2c1b297
1 parent 458868e
commit 2c1b297
Show file tree

Hide file tree

Showing 32 changed files with 204 additions and 9 deletions.
diff --git a/appengine/README.md b/appengine/README.md
@@ -1,5 +1,12 @@
 # Google App Engine Standard Environment Java Samples
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
+
 This is a repository that contains Java code samples for [Google App Engine
 standard environment][ae-docs].
 

diff --git a/appengine/appidentity/README.md b/appengine/appidentity/README.md
@@ -1,5 +1,11 @@
 # App Identity sample for Google App Engine
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This sample demonstrates how to use the [App Identity API][appid] on [Google App
 Engine][ae-docs].
 

diff --git a/appengine/cloudsql/README.md b/appengine/cloudsql/README.md
@@ -1,4 +1,11 @@
 # Cloud SQL sample for Google App Engine
+
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This sample demonstrates how to use [Cloud SQL](https://cloud.google.com/sql/) on Google App Engine
 
 ## Setup

diff --git a/appengine/datastore/README.md b/appengine/datastore/README.md
@@ -1,5 +1,11 @@
 # Google Cloud Datastore Sample
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This sample demonstrates how to use [Google Cloud Datastore][java-datastore]
 from [Google App Engine standard environment][ae-docs].
 

diff --git a/appengine/endpoints-frameworks-v2/README.md b/appengine/endpoints-frameworks-v2/README.md
@@ -1,5 +1,11 @@
 # Google Cloud Endpoints Frameworks for App Engine Standard
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This directory contains Google Cloud Endpoints Frameworks for App Engine for
 App Engine Standard samples. The [`backend/`](backend/) directory contains the
 sample code for the [quickstart][4] for Cloud Endpoints Frameworks on App Engine

diff --git a/appengine/firebase-event-proxy/README.md b/appengine/firebase-event-proxy/README.md
@@ -1,5 +1,11 @@
 # App Engine Firebase Event Proxy
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 An example app that illustrates how to create a Java App Engine Standard Environment
 app that proxies Firebase events to another App Engine app.
 

diff --git a/appengine/firebase-tictactoe/README.md b/appengine/firebase-tictactoe/README.md
@@ -1,5 +1,11 @@
 # Tic Tac Toe on Google App Engine Standard using Firebase
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This directory contains a project that implements a realtime two-player game of
 Tic Tac Toe on Google [App Engine Standard][standard], using the [Firebase] database
 for realtime notifications when the board changes.

diff --git a/appengine/gaeinfo/README.md b/appengine/gaeinfo/README.md
@@ -1,5 +1,11 @@
 # Google App Engine Information
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This sample displays what's going on in your app. It dumps the environment and lots more.
 
 See the [Google App Engine standard environment documentation][ae-docs] for more

diff --git a/appengine/guestbook-cloud-datastore/README.md b/appengine/guestbook-cloud-datastore/README.md
@@ -1,5 +1,11 @@
 # appengine/guestbook-cloud-datastore
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 An App Engine guestbook using Java, Maven, and the Cloud Datastore API via
 [google-cloud-java](https://github.com/GoogleCloudPlatform/google-cloud-java).
 

diff --git a/appengine/guestbook-objectify/README.md b/appengine/guestbook-objectify/README.md
@@ -1,5 +1,11 @@
 # appengine/guestbook-objectify
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 An App Engine guestbook using Java, Maven, and Objectify.
 
 Data access using [Objectify](https://github.com/objectify/objectify)

diff --git a/appengine/helloworld-new-plugins/README.md b/appengine/helloworld-new-plugins/README.md
@@ -1,5 +1,11 @@
 # Google App Engine Standard Environment Hello World Sample
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This sample demonstrates how to deploy an application on Google App Engine.
 
 See the [Google App Engine standard environment documentation][ae-docs] for more

diff --git a/appengine/helloworld/README.md b/appengine/helloworld/README.md
@@ -1,5 +1,11 @@
 # Google App Engine Standard Environment Hello World Sample
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This sample demonstrates how to deploy an application on Google App Engine.
 
 See the [Google App Engine standard environment documentation][ae-docs] for more

diff --git a/appengine/iap/README.md b/appengine/iap/README.md
@@ -1,5 +1,11 @@
 # Cloud Identity-Aware Proxy sample for Google App Engine
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This sample demonstrates how to use the [Cloud Identity-Aware Proxy][iap-docs] on [Google App
 Engine][ae-docs].
 

diff --git a/appengine/images/README.md b/appengine/images/README.md
@@ -1,5 +1,11 @@
 # Google App Engine Standard Environment Images Sample
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This sample demonstrates how to use the Images Java API.
 
 See the [Google App Engine standard environment documentation][ae-docs] for more

diff --git a/appengine/logs/README.md b/appengine/logs/README.md
@@ -1,5 +1,11 @@
 # Users Authentication sample for Google App Engine
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This sample demonstrates how to use the [Logs API][log-docs] on [Google App
 Engine][ae-docs].
 

diff --git a/appengine/mail/README.md b/appengine/mail/README.md
@@ -1,5 +1,11 @@
 # JavaMail API Email Sample for Google App Engine Standard Environment
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This sample demonstrates how to use [JavaMail][javamail-api] on [Google App Engine
 standard environment][ae-docs].
 

diff --git a/appengine/mailgun/README.md b/appengine/mailgun/README.md
@@ -1,5 +1,11 @@
 # Java Mailgun Email Sample for Google App Engine Standard Environment
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This sample demonstrates how to use [Mailgun][mailgun-api] on [Google App Engine
 standard environment][ae-docs].
 

diff --git a/appengine/mailjet/README.md b/appengine/mailjet/README.md
@@ -1,4 +1,11 @@
 # Mailjet sample for Google App Engine
+
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This sample demonstrates how to use [Mailjet](https://www.mailjet.com/) on Google Managed VMs to
 send emails from a verified sender you own.
 

diff --git a/appengine/multitenancy/README.md b/appengine/multitenancy/README.md
@@ -1,5 +1,11 @@
 # Multitenancy Java sample
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 Shows the usage of the Namespaces API.
 
 An App Engine guestbook using Java, Maven, and Objectify.

diff --git a/appengine/oauth2/README.md b/appengine/oauth2/README.md
@@ -1,4 +1,11 @@
 # Google App Engine Standard Environment
+
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 ## Oauth2 Sample
 
 This sample demonstrates using the Oauth2 apis to create an authenticaion filter.

diff --git a/appengine/pusher-chat/README.md b/appengine/pusher-chat/README.md
@@ -1,5 +1,11 @@
 # Pusher sample for Google App Engine
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This sample demonstrates how to use the [Pusher][pusher] on [Google App Engine][ae-docs].
 Pusher enables you to create public / private channels with presence information for real time messaging.
 This application demonstrates presence channels in Pusher using chat rooms.
@@ -42,6 +48,6 @@ You should now be able to view both the users within the chat application window
 - Deploy the application to the project
   ```
        mvn clean appengine:deploy
-      
+
   ```
   Access `https://YOUR_PROJECT_ID.appspot.com`
diff --git a/appengine/remote/README.md b/appengine/remote/README.md
@@ -1,9 +1,15 @@
 # Google App Engine Standard Environment Remote API Sample
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This sample demonstrates how to access App Engine Standard Environment APIs remotely,
 using the [Remote API](https://cloud.google.com/appengine/docs/java/tools/remoteapi).
 
-## Set up the server component of Remote API 
+## Set up the server component of Remote API
 1. Navigate to the remote-server directory
 1. Update the `<application>` tag in `src/main/webapp/WEB-INF/appengine-web.xml`
    with your project name.

diff --git a/appengine/requests/README.md b/appengine/requests/README.md
@@ -1,12 +1,18 @@
 # Request Handling sample for Google App Engine
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This sample provides Java code samples in support of the "Handling Requests" description  [Requests][requests-doc] on [Google App
 Engine][ae-docs].
 
 [requests-doc]: https://cloud.google.com/appengine/docs/java/requests
 [ae-docs]: https://cloud.google.com/appengine/docs/java/
 
-## Running locally 
+## Running locally
 This example uses the
 [Maven gcloud plugin](https://cloud.google.com/appengine/docs/java/managed-vms/maven).
 To run this sample locally:
@@ -20,7 +26,7 @@ and examine the logs to see the actual messages.
 
 ## Deploying
 In the following command, replace YOUR-PROJECT-ID with your
-[Google Cloud Project ID](https://developers.google.com/console/help/new/#projectnumber) 
+[Google Cloud Project ID](https://developers.google.com/console/help/new/#projectnumber)
 and SOME-VERSION with a valid version number.
 
     $ mvn appengine:update -Dappengine.appId=YOUR-PROJECT-ID -Dappengine.version=SOME-VERSION

diff --git a/appengine/search/README.md b/appengine/search/README.md
@@ -1,5 +1,11 @@
 # Google App Engine Standard Environment Search API Sample
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This sample demonstrates how to use App Engine Search API.
 
 See the [Google App Engine Search API documentation][search-api-docs] for more
@@ -17,4 +23,4 @@ detailed instructions.
     $ mvn appengine:devserver
 
 ## Deploying
-    $ mvn appengine:update
+    $ mvn appengine:update
diff --git a/appengine/sendgrid/README.md b/appengine/sendgrid/README.md
@@ -1,5 +1,11 @@
 # Java SendGrid Email Sample for Google App Engine Standard Environment
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This sample demonstrates how to use [SendGrid](https://www.sendgrid.com) on
 [Google App Engine standard environment][ae-docs].
 

diff --git a/appengine/sockets/README.md b/appengine/sockets/README.md
@@ -1,6 +1,12 @@
 
 # Java Socket API Example App: Whois Client
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 This sample displays what's going on in your app. It dumps the environment and lots more.
 
 See the [Google App Engine standard environment documentation][ae-docs] for more

diff --git a/appengine/sockets/README_LIBS.md b/appengine/sockets/README_LIBS.md
@@ -1,6 +1,12 @@
 
 # Using the Socket API with Some Common Third-Party Libraries
 
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
+
 ## Using the Socket API with JavaPNS
 
 **Note:** <a href="http://code.google.com/p/javapns/">JavaPNS</a>

diff --git a/appengine/taskqueue/defer-samples/README.md b/appengine/taskqueue/defer-samples/README.md
@@ -1,5 +1,10 @@
 App Engine Java Guestbook
-Copyright (C) 2010-2012 Google Inc.
+
+**Java 7 runtime support on App Engine standard was [deprecated](https://cloud.google.com/appengine/docs/deprecations/java7) on
+December 13, 2017 and will be shut down entirely on January 16, 2019. It is replaced by the
+[Java 8 Runtime Environment](https://cloud.google.com/appengine/docs/standard/java/runtime-java8).**
+
+Samples for the Java 8 runtime can be found [here](/appengine-java8).
 
 ## Sample guestbook for use with App Engine Java.
 
@@ -21,4 +26,4 @@ For further information, consult the [Java App Engine](https://developers.google
 
 To see all the available goals for the App Engine plugin, run
 
-    mvn help:describe -Dplugin=appengine
+    mvn help:describe -Dplugin=appengine