rename mod1 folder, add folder READMEs

wescpy · wescpy · commit 81a8b3bb7f69 · 2021-03-03T21:13:49.000-08:00
diff --git a/README.md b/README.md
@@ -63,15 +63,15 @@ The table below summarizes migration module resources currently available to dev
 Module | Topic | Codelab | START repo | FINISH repo
 --- | --- | --- | --- | ---
 0|Baseline app| _N/A_ (no migration; just review the code) | _N/A_ | Module 0 [code](/mod0-baseline) (2.x)
-1|Migrate to Flask| [link](http://g.co/codelabs/pae-migrate-flask) | Module 0 [code](/mod0-baseline) (2.x) | Module 1 [code](/mod1-framework) (2.x)
-2|Migrate to Cloud NDB| [link](http://g.co/codelabs/pae-migrate-cloudndb) | Module 1 [code](/mod1-framework) (2.x) | Module 2 [code](/mod2a-cloudndb) (2.x) &amp; [code](/mod2b-cloudndb) (3.x)
+1|Migrate to Flask| [link](http://g.co/codelabs/pae-migrate-flask) | Module 0 [code](/mod0-baseline) (2.x) | Module 1 [code](/mod1-flask) (2.x)
+2|Migrate to Cloud NDB| [link](http://g.co/codelabs/pae-migrate-cloudndb) | Module 1 [code](/mod1-flask) (2.x) | Module 2 [code](/mod2a-cloudndb) (2.x) &amp; [code](/mod2b-cloudndb) (3.x)
 3|Migrate to Cloud Datastore| [link](http://g.co/codelabs/pae-migrate-datastore) | Module 2 [code](/mod2a-cloudndb) (2.x) &amp; [code](/mod2b-cloudndb) (3.x) | Module 3 [code](/mod3a-datastore) (2.x) &amp; [code](/mod3b-datastore) (3.x)
 4|Migrate to Cloud Run with Docker| [link](http://g.co/codelabs/pae-migrate-rundocker) | Module 2 [code](/mod2a-cloudndb) (2.x) &amp; Module 3 [code](/mod3b-datastore) (3.x) | Module 4 [code](/mod4a-rundocker) (2.x) &amp; [code](/mod4b-rundocker) (3.x)
 5|Migrate to Cloud Run with Buildpacks| [link](http://g.co/codelabs/pae-migrate-runbldpks) | Module 2 [code](/mod2b-cloudndb) (3.x) | Module 5 [code](/mod5-runbldpks) (3.x)
 6|Migrate to Cloud Firestore| [link](http://g.co/codelabs/pae-migrate-firestore) | Module 3 [code]() (3.x) | Module 6 [code](/mod6-firestore) (3.x)
 7|Add App Engine push tasks| [link](http://g.co/codelabs/pae-migrate-gaetasks) | Module 1 [code]() (2.x) | Module 7 [code](/mod7-gaetasks) (2.x)
 8|Migrate to Cloud Tasks| [link](http://g.co/codelabs/pae-migrate-cloudtasks) | Module 7 [code](/mod7-gaetasks) (2.x) | Module 8 [code](/mod8-cloudtasks) (2.x)
-9|Migrate to Python 3 (Cloud Datastore &amp; Cloud Tasks v2)| [link](http://g.co/codelabs/pae-migrate-py3dstasks) | Module 8 [code](/mod8-cloudtasks) (2.x) | Module 9 [code](/mod9-py3clouddstasks) (3.x)
+9|Migrate to Python 3 (Cloud Datastore &amp; Cloud Tasks v2)| [link](http://g.co/codelabs/pae-migrate-py3dstasks) | Module 8 [code](/mod8-cloudtasks) (2.x) | Module 9 [code](/mod9-py3dstasks) (3.x)
 
 
 ### Table of contents
@@ -84,15 +84,15 @@ If there is a logical codelab to do immediately after completing one, they will
         - `webapp2` does not do routing thus unsupported by App Engine (even though a [3.x port exists](https://github.com/fili/webapp2-gae-python37))
     - Python 2 only
         - START:  [Module 0 code - Baseline](/mod0-baseline) (2.x)
-        - FINISH: [Module 1 code - Framework](/mod1-framework) (2.x)
+        - FINISH: [Module 1 code - Framework](/mod1-flask) (2.x)
     - NEXT: Module 2 codelab - migrate to Cloud NDB
 
 
 - [Module 2 codelab](http://g.co/codelabs/pae-migrate-cloudndb): **Migrate from App Engine `ndb` to [Cloud NDB](https://googleapis.dev/python/python-ndb/latest)**
     - **Required** migration
         - Migration to Cloud NDB which is supported by Python 3 and the next-gen platform.
     - Python 2
-        - START:  [Module 1 code - Framework](/mod1-framework) (2.x)
+        - START:  [Module 1 code - Framework](/mod1-flask) (2.x)
         - FINISH: [Module 2 code - Cloud NDB](/mod2a-cloudndb) (2.x)
     - Codelab bonus port to Python 3.x
         - FINISH: [Module 2 code - Cloud NDB](/mod2b-cloudndb) (3.x)
@@ -106,7 +106,7 @@ If there is a logical codelab to do immediately after completing one, they will
 - [Module 7 codelab](http://g.co/codelabs/pae-migrate-gaetasks): **Add App Engine (push) Task Queues to App Engine `ndb` Flask app**
     - **Not a migration**: add GAE Task Queues to prepare for migration to Cloud Tasks
     - Python 2
-        - START:  [Module 1 code - Framework](/mod1-framework) (2.x)
+        - START:  [Module 1 code - Framework](/mod1-flask) (2.x)
         - FINISH: [Module 7 code - GAE Task Queues](/mod7-gaetasks) (2.x)
     - NEXT: Module 8 codelab - migrate App Engine push tasks to Cloud Tasks
 
@@ -127,7 +127,7 @@ If there is a logical codelab to do immediately after completing one, they will
     - Python 2
         - START:  [Module 8 code - Cloud Tasks](/mod8-cloudtasks) (2.x)
     - Python 3
-        - FINISH: [Module 9 code - Cloud Datastore &amp; Tasks](/mod9-py3clouddstasks) (3.x)
+        - FINISH: [Module 9 code - Cloud Datastore &amp; Tasks](/mod9-py3dstasks) (3.x)
     - RECOMMENDED:
         - Module 5 codelab - migrate to Cloud Run container with Cloud Buildpacks
         - Module 4 codelab - migrate to Cloud Run container with Docker
diff --git a/mod0-baseline/README.md b/mod0-baseline/README.md
@@ -0,0 +1,3 @@
+# Module 0 - Baseline migration sample app (Python 2, `webapp2`, `ndb`)
+
+This repo folder is the baseline app for the App Engine migration module codelab tutorials. It is a Python 2 App Engine app that uses the `webapp2` micro web framework implementing an "MVP" guestbook app. It stores website visits as Datastore entities using the `ndb` library. The first tutorial in this migration series is the [Module 1 codelab](http://g.co/codelabs/pae-migrate-flask), so begin there.
diff --git a/mod1-flask/.gcloudignore b/mod1-flask/.gcloudignore
diff --git a/mod1-flask/README.md b/mod1-flask/README.md
@@ -0,0 +1,3 @@
+# Module 1 - Migrate from `webapp2` to Flask
+
+This repo folder is the corresponding code to the [Module 1 codelab](http://g.co/codelabs/pae-migrate-flask). The tutorial STARTs with the Python 2 code in the [Module 0 repo folder](/mod0-baseline) and leads developers through migrating away from App Engine's `webapp2` web framework to Flask, culminating in the code in this folder.
diff --git a/mod1-flask/app.yaml b/mod1-flask/app.yaml
diff --git a/mod1-flask/appengine_config.py b/mod1-flask/appengine_config.py
diff --git a/mod1-flask/main.py b/mod1-flask/main.py
diff --git a/mod1-flask/requirements.txt b/mod1-flask/requirements.txt
diff --git a/mod1-flask/templates/index.html b/mod1-flask/templates/index.html
diff --git a/mod2a-cloudndb/README.md b/mod2a-cloudndb/README.md
@@ -0,0 +1,3 @@
+# Module 2 - Migrate from App Engine `ndb` to Google Cloud NDB
+
+This repo folder is the corresponding Python 2 code to the [Module 2 codelab](http://g.co/codelabs/pae-migrate-cloudndb). The tutorial STARTs with the Python 2 code in the [Module 1 repo folder](/mod1-flask) and leads developers through migrating away from App Engine's `ndb` to Cloud NDB to access Datastore, culminating in the code in this folder.
diff --git a/mod2b-cloudndb/README.md b/mod2b-cloudndb/README.md
@@ -0,0 +1,3 @@
+# Module 2 - Migrate from App Engine `ndb` to Google Cloud NDB
+
+This repo folder is the corresponding Python 3 code to the [Module 2 codelab](http://g.co/codelabs/pae-migrate-cloudndb). The tutorial STARTs with the Python 2 code in the [Module 1 repo folder](/mod1-flask) and leads developers through migrating away from App Engine's `ndb` to Cloud NDB to access Datastore and from Python 2 to 3, culminating in the code in this folder.
diff --git a/mod3a-datastore/README.md b/mod3a-datastore/README.md
@@ -0,0 +1,3 @@
+# Module 3 - Migrate from Google Cloud NDB to Cloud Datastore
+
+This repo folder is the corresponding Python 2 code to the [Module 3 codelab](http://g.co/codelabs/pae-migrate-datastore). The tutorial STARTs with the Python 2 code in the [Module 2 repo folder](/mod2a-cloudndb) and leads developers through migrating away from Cloud NDB to Cloud Datastore to access Datastore, culminating in the code in this folder.
diff --git a/mod3b-datastore/README.md b/mod3b-datastore/README.md
@@ -0,0 +1,3 @@
+# Module 3 - Migrate from Google Cloud NDB to Cloud Datastore
+
+This repo folder is the corresponding Python 3 code to the [Module 3 codelab](http://g.co/codelabs/pae-migrate-datastore). The tutorial STARTs with the Python 3 code in the [Module 2 repo folder](/mod2b-cloudndb) and leads developers through migrating away from Cloud NDB to Cloud Datastore to access Datastore, culminating in the code in this folder.
diff --git a/mod4a-rundocker/README.md b/mod4a-rundocker/README.md
@@ -0,0 +1,3 @@
+# Module 4 - Migrate from Google App Engine to Cloud Run with Docker
+
+This repo folder is the corresponding Python 2 code to the [Module 4 codelab](http://g.co/codelabs/pae-migrate-rundocker). The tutorial STARTs with the Python 2 code in the [Module 2 repo folder](/mod2a-cloudndb) and leads developers through migrating away from App Engine to Cloud Run using Docker, culminating in the code in this folder.
diff --git a/mod4b-rundocker/README.md b/mod4b-rundocker/README.md
@@ -0,0 +1,3 @@
+# Module 4 - Migrate from Google App Engine to Cloud Run with Docker
+
+This repo folder is the corresponding Python 3 code to the [Module 4 codelab](http://g.co/codelabs/pae-migrate-rundocker). The tutorial STARTs with the Python 3 code in the [Module 3 repo folder](/mod3b-datastore) and leads developers through migrating away from App Engine to Cloud Run using Docker, culminating in the code in this folder.
diff --git a/mod5-runbldpks/README.md b/mod5-runbldpks/README.md
@@ -0,0 +1,3 @@
+# Module 5 - Migrate from Google App Engine to Cloud Run with Cloud Buildpacks
+
+This repo folder is the corresponding Python 3 code to the [Module 5 codelab](http://g.co/codelabs/pae-migrate-runbldpks). The tutorial STARTs with the Python 3 code in the [Module 2 repo folder](/mod2b-cloudndb) and leads developers through migrating away from App Engine to Cloud Run using Cloud Buildpacks, culminating in the code in this folder.
diff --git a/mod6-firestore/README.md b/mod6-firestore/README.md
@@ -0,0 +1,3 @@
+# Module 6 - Migrate from Google Cloud Datastore to Cloud Firestore
+
+This repo folder is the corresponding Python 3 code to the [Module 6 codelab](http://g.co/codelabs/pae-migrate-firestore). The tutorial STARTs with the Python 3 code in the [Module 3 repo folder](/mod3b-datastore) and leads developers through migrating away from Cloud Datastore to Cloud Firestore, culminating in the code in this folder.
diff --git a/mod7-gaetasks/README.md b/mod7-gaetasks/README.md
@@ -0,0 +1,3 @@
+# Module 7 - Add usage of App Engine `taskqueue` to Flask `ndb` sample app
+
+This repo folder is the corresponding Python 2 code to the [Module 7 codelab](http://g.co/codelabs/pae-migrate-gaetasks). The tutorial STARTs with the Python 2 code in the [Module 1 repo folder](/mod1-flask) and leads developers through adding usage of App Engine's `taskqueue`, culminating in the code in this folder.
diff --git a/mod8-cloudtasks/README.md b/mod8-cloudtasks/README.md
@@ -0,0 +1,3 @@
+# Module 8 - Migrate from App Engine `taskqueue` to Google Cloud Tasks
+
+This repo folder is the corresponding Python 2 code to the [Module 8 codelab](http://g.co/codelabs/pae-migrate-cloudtasks). The tutorial STARTs with the Python 2 code in the [Module 7 repo folder](/mod7-gaetasks) and leads developers through migrating from `taskqueue` to Cloud Tasks, culminating in the code in this folder.
diff --git a/mod9-py3dstasks/README.md b/mod9-py3dstasks/README.md
@@ -0,0 +1,3 @@
+# Module 9 - Migrate from Python 2 to 3 and Cloud NDB to Cloud Datastore
+
+This repo folder is the corresponding Python 3 code to the [Module 9 codelab](http://g.co/codelabs/pae-migrate-py3dstasks). The tutorial STARTs with the Python 2 code in the [Module 8 repo folder](/mod7-cloudtasks) and leads developers through migrating from Python 2 to 3, Cloud NDB to Cloud Datastore (plus any changes from Cloud Tasks v1 to v2), culminating in the code in this folder.

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	+# Module 0 - Baseline migration sample app (Python 2, `webapp2`, `ndb`)
	`2`	`+`
	`3`	+This repo folder is the baseline app for the App Engine migration module codelab tutorials. It is a Python 2 App Engine app that uses the `webapp2` micro web framework implementing an "MVP" guestbook app. It stores website visits as Datastore entities using the `ndb` library. The first tutorial in this migration series is the [Module 1 codelab](http://g.co/codelabs/pae-migrate-flask), so begin there.
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	+# Module 1 - Migrate from `webapp2` to Flask
	`2`	`+`
	`3`	+This repo folder is the corresponding code to the [Module 1 codelab](http://g.co/codelabs/pae-migrate-flask). The tutorial STARTs with the Python 2 code in the [Module 0 repo folder](/mod0-baseline) and leads developers through migrating away from App Engine's `webapp2` web framework to Flask, culminating in the code in this folder.
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	+# Module 2 - Migrate from App Engine `ndb` to Google Cloud NDB
	`2`	`+`
	`3`	+This repo folder is the corresponding Python 2 code to the [Module 2 codelab](http://g.co/codelabs/pae-migrate-cloudndb). The tutorial STARTs with the Python 2 code in the [Module 1 repo folder](/mod1-flask) and leads developers through migrating away from App Engine's `ndb` to Cloud NDB to access Datastore, culminating in the code in this folder.