GCP: Clean up introduction.

tmiddelkoop · May 4, 2022 · 9dcb7cc · 9dcb7cc
1 parent a945c51
commit 9dcb7cc
Showing 1 changed file with 27 additions and 34 deletions.
diff --git a/content/GCP/01_intro_to_cloud_console.ipynb b/content/GCP/01_intro_to_cloud_console.ipynb
@@ -135,8 +135,11 @@
     "\n",
     "  * Click on a product to navigate the product page\n",
     "  * You can pin frequently used items on the top of this page by clicking on the pin icon. \n",
+    "  * A product is accessed and controlled via an API and usually must be enabled (once per project). To enable a product API click on the \"ENABLE\" button shown below.\n",
     "  * Click the hamburger again to hide the Left Sidebar.\n",
     "\n",
+    "![enable-compute-api](img/enable-compute-api.png)\n",
+    "\n",
     "All the different products and resources are the \"**What**\" of the cloud.  We will start with compute, called *Google Compute Engine* in the next Episode. "
    ]
   },
@@ -149,26 +152,16 @@
    "source": [
     "*Instructor: place instructions on the screen*\n",
     "\n",
-    "```{admonition} Exercise\n",
+    "```{admonition} Exercise 1\n",
     ":class: exercise\n",
     "\n",
     "Take a few moments to navigate to a few key products and enable them.\n",
     "  * Navigate to \"Cloud Storage\" under the \"Storage\" product group.\n",
-    "  * You will need to \"Enable\" this product first by clicking on the \"Enable\" button on the \"Cloud Storage API\" page.  This will only need to be done once per project.\n",
+    "  * You may need to \"Enable\" this product first by clicking on the \"Enable\" button on the \"Cloud Storage API\" page.  This will only need to be done once per project.\n",
     "  * Navigate to the \"Compute Engine\" product under the \"Compute\" product group and enable the product as well.\n",
     "```"
    ]
   },
-  {
-   "cell_type": "markdown",
-   "id": "146358ca-d9a6-4ab5-856f-509818e6d63d",
-   "metadata": {},
-   "source": [
-    "Enable an API by clicking the \"ENABLE\" button as shown below.\n",
-    "\n",
-    "![enable-compute-api](img/enable-compute-api.png)"
-   ]
-  },
   {
    "cell_type": "markdown",
    "id": "e955eb3a-4fdc-448b-aef8-ed1dbe2a73d9",
@@ -198,28 +191,6 @@
     "   9. Google Account (avatar at the far right) - verify and switch accounts."
    ]
   },
-  {
-   "cell_type": "markdown",
-   "id": "9470567b-9966-4c07-a7ad-a94358530480",
-   "metadata": {
-    "tags": []
-   },
-   "source": [
-    "## Putting it Together\n",
-    "\n",
-    "Now that we have the basics, we can provide a bit larger picture of the cloud and all the pieces:\n",
-    "\n",
-    "![gcp-overview](img/CLASS-Essentials-GCP-Overview.svg)\n",
-    "\n",
-    "  * Project - a container to house and manage resources.\n",
-    "  * Products - The different types of resources or services within Google Cloud.\n",
-    "  * Resources - individual products running or stored within Google cloud such as compute, storage, networking, databases, etc.  Resources can belong to only one Project.\n",
-    "  * Billing Account - used to pay for resources and services consumed. Each project has only one billing account.\n",
-    "  * Account - the identity that is used to accesses resources within Google Cloud. Note: this is *NOT* the Billing Account.\n",
-    "  * Identity Access and Management (IAM) - manages access (permissions) to a resource by an account (also referred to as a principal).\n",
-    "  * Organization - projects may optionally be housed in an organization (arranged in folders), which can add permissions and restrictions in a hierarchical manner.  Projects can only belong to one Organization."
-   ]
-  },
   {
    "cell_type": "markdown",
    "id": "50fddb1f-c826-412c-bb3c-127fee6b4949",
@@ -247,6 +218,28 @@
     " * Click the **\"Close editor\"** button (the pencil icon in the top right of the window)."
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "9470567b-9966-4c07-a7ad-a94358530480",
+   "metadata": {
+    "tags": []
+   },
+   "source": [
+    "## Putting it Together\n",
+    "\n",
+    "Now that we have the basics, we can provide a bit larger picture of the cloud and all the pieces:\n",
+    "\n",
+    "![gcp-overview](img/CLASS-Essentials-GCP-Overview.svg)\n",
+    "\n",
+    "  * Project - a container to house and manage resources.\n",
+    "  * Products - The different types of resources or services within Google Cloud.\n",
+    "  * Resources - individual products running or stored within Google cloud such as compute, storage, networking, databases, etc.  Resources can belong to only one Project.\n",
+    "  * Billing Account - used to pay for resources and services consumed. Each project has only one billing account.\n",
+    "  * Account - the identity that is used to accesses resources within Google Cloud. Note: this is *NOT* the Billing Account.\n",
+    "  * Identity Access and Management (IAM) - manages access (permissions) to a resource by an account (also referred to as a principal).\n",
+    "  * Organization - projects may optionally be housed in an organization (arranged in folders), which can add permissions and restrictions in a hierarchical manner.  Projects can only belong to one Organization."
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "118254c6-a5d9-4bd0-8a0f-64d4f72b3cf0",