Docs: Update sample configurations for new Flex runtimes (#3105)

* Update sample configurations for new Flex runtimes

* Update README and create yaml files for 18 and later

* Fix header licenses

---------

Co-authored-by: Karl Weinmeister <[email protected]>

Author: kennethye1

appengine/README.md

@@ -55,7 +55,7 @@ Refer to the `README.md` file in the sample folder.
 
 Many samples in this folder can be deployed to both App Engine Node.js standard
 environment and flexible environment. Those samples come with two different
-App Engine configuration files: `app.flexible.yaml` for flexible environment,
+App Engine configuration files: `app.flexible.yaml` for flexible environment Node.js 16 and earlier, `app.flexible_os.yaml` for Node.js 18 and later
 and `app.standard.yaml` for standard environment.
 
 Samples with one single configuration file, `app.yaml`, can only be deployed
@@ -76,9 +76,13 @@ Generally speaking, to deploy a sample application:
 
         gcloud app deploy app.standard.yaml
 
-    To deploy to App Engine Node.js Flexible Environment, run
+    To deploy to App Engine Flexible Environment Node.js 16 and earlier , run
 
         gcloud app deploy app.flexible.yaml
+    
+    For App Engine Flexible Environment Node.js 18 and later, run 
+        
+        gclooud app deploy app.flexible_os.yaml
 
     For samples with one configuration file (`app.yaml`), run
 

appengine/analytics/README.md

@@ -34,12 +34,18 @@ Before you can run or deploy the sample, you need to do the following:
 gcloud app deploy app.standard.yaml
 ```
 
-## Deploying to App Engine flexible Environment
+## Deploying to App Engine flexible Environment for Node.js 16 and earlier
 
 ```
 gcloud app deploy app.flexible.yaml
 ```
 
+## Deploying to App Engine flexible Environment for Node.js 18 and later
+
+```
+gcloud app deploy app.flexible_os.yaml
+```
+
 
 ## Running the tests
 

appengine/analytics/app.flexible_os.yaml

@@ -0,0 +1,22 @@
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+runtime: nodejs
+env: flex
+runtime_config:
+  operating_system: ubuntu22
+  runtime_version: 18
+
+env_variables:
+  GA_TRACKING_ID: YOUR_TRACKING_ID

appengine/datastore/README.md

@@ -30,10 +30,14 @@ Before you can run or deploy the sample, you need to do the following:
 
 	gcloud app deploy app.standard.yaml
 
-## Deploying to App Engine flexible environment
+## Deploying to App Engine flexible environment for Node.js 16 and earlier
 
 	gcloud app deploy app.flexible.yaml
 
+## Deploying to App Engine flexible environment for Node.js 18 and later
+
+	gcloud app deploy app.flexible_os.yaml
+
 ## Running the tests
 
 See [Contributing][contributing].

appengine/datastore/app.flexible_os.yaml

@@ -0,0 +1,19 @@
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+runtime: nodejs
+env: flex
+runtime_config:
+  operating_system: ubuntu22
+  runtime_version: 18

appengine/hello-world/flexible/app.yaml

@@ -1,9 +1,10 @@
-# Copyright 2017, Google, Inc.
+# Copyright 2023 Google LLC
+#
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
-#    http://www.apache.org/licenses/LICENSE-2.0
+#      http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
 # distributed under the License is distributed on an "AS IS" BASIS,
@@ -14,7 +15,8 @@
 # [START gae_flex_quickstart_yaml]
 runtime: nodejs
 env: flex
-
+runtime_config:
+  operating_system: ubuntu22
 # This sample incurs costs to run on the App Engine flexible environment.
 # The settings below are to reduce costs during testing and are not appropriate
 # for production use. For more information, see:

appengine/hello-world/flexible/package.json

@@ -10,7 +10,7 @@
     "url": "https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git"
   },
   "engines": {
-    "node": "=v16.19.1"
+    "node": ">=18.x.x"
   },
   "scripts": {
     "start": "node app.js",

appengine/metadata/flexible/app.yaml

@@ -1,9 +1,10 @@
-# Copyright 2016, Google, Inc.
+# Copyright 2023 Google LLC
+#
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
-#    http://www.apache.org/licenses/LICENSE-2.0
+#      http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
 # distributed under the License is distributed on an "AS IS" BASIS,
@@ -13,3 +14,5 @@
 
 runtime: nodejs
 env: flex
+runtime_config:
+  operating_system: ubuntu22

appengine/metadata/flexible/package.json

@@ -10,7 +10,7 @@
     "url": "https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git"
   },
   "engines": {
-    "node": "16.x.x"
+    "node": ">= 18.x.x"
   },
   "scripts": {
     "system-test": "mocha --exit test/*.test.js",

appengine/pubsub/README.md

@@ -96,8 +96,12 @@ In the current directory, deploy using `gcloud`:
 
         gcloud app deploy app.standard.yaml
 
-To deploy to App Engine Node.js Flexible Environment, run
+To deploy to App Engine Node.js Flexible Environment for Node.js 16 and earlier, run:
 
         gcloud app deploy app.flexible.yaml
 
+For App Engine Flexible deployments for 18 and later, deploy via:
+        
+        gcloud app deploy app.flexible_os.yaml
+
 You can now access the application at https://[your-app-id].appspot.com. You can use the form to submit messages, but it's non-deterministic which instance of your application will receive the notification. You can send multiple messages and refresh the page to see the received message.