From cb8c4b80d078f6208224b23d14f0146afd6bebc0 Mon Sep 17 00:00:00 2001 From: Christopher C <37060219+cavonac@users.noreply.github.com> Date: Fri, 23 Jul 2021 16:58:43 -0700 Subject: [PATCH] wording, removing ref to "bootstrap" (#15187) * wording, removing ref to "bootstrap" * removing configure-ag nb; unfinished --- .../notebooks/hybridbook/_data/toc.yml | 4 +- .../hybridbook/content/Assessments/readme.md | 2 +- ...{VisualBootstrapperNB.PNG => AdpSetup.png} | Bin .../content/data-portability/setup-adp.ipynb | 77 +++++----- .../content/hadr/configure-ag.ipynb | 143 ------------------ .../hybridbook/content/hadr/readme.md | 2 +- .../offline-migration/db-to-SQLDB.ipynb | 1 - .../notebooks/hybridbook/content/readme.md | 6 +- 8 files changed, 44 insertions(+), 191 deletions(-) rename extensions/azurehybridtoolkit/notebooks/hybridbook/content/data-portability/{VisualBootstrapperNB.PNG => AdpSetup.png} (100%) delete mode 100644 extensions/azurehybridtoolkit/notebooks/hybridbook/content/hadr/configure-ag.ipynb diff --git a/extensions/azurehybridtoolkit/notebooks/hybridbook/_data/toc.yml b/extensions/azurehybridtoolkit/notebooks/hybridbook/_data/toc.yml index ef494546a2..b2f146f2d3 100644 --- a/extensions/azurehybridtoolkit/notebooks/hybridbook/_data/toc.yml +++ b/extensions/azurehybridtoolkit/notebooks/hybridbook/_data/toc.yml @@ -59,8 +59,8 @@ url: hadr/backup-to-blob - title: Create Failover Cluster url: hadr/configure-failover - - title: Create Availability Group - url: hadr/configure-ag +# - title: Create Availability Group +# url: hadr/configure-ag - title: Offline Migration url: /offline-migration/readme not_numbered: true diff --git a/extensions/azurehybridtoolkit/notebooks/hybridbook/content/Assessments/readme.md b/extensions/azurehybridtoolkit/notebooks/hybridbook/content/Assessments/readme.md index 7e0678aabe..93fd2cb537 100644 --- a/extensions/azurehybridtoolkit/notebooks/hybridbook/content/Assessments/readme.md +++ b/extensions/azurehybridtoolkit/notebooks/hybridbook/content/Assessments/readme.md @@ -7,4 +7,4 @@ Preparing for the cloud requires a crawl-walk-run mentality. The first step, or ## Notebooks in this Chapter - [SQL Server Best Practices Assessment](sql-server-assessment.ipynb) - demonstrates the use of the [SQL Server Assessment API](https://docs.microsoft.com/en-us/sql/sql-assessment-api/sql-assessment-api-overview), a tool to review the configuration of a SQL Server and Databases for best practices. -- [Compatibility Assessment](compatibility-assessment.ipynb) - Analzye an on-premises SQL Server instance or database for compatibility for migration to SQL Azure. The assessment will provide guidance on features not currently supported in Azure and remediation actions that can be taken to prepare for migration. \ No newline at end of file +- [Compatibility Assessment](compatibility-assessment.ipynb) - Analyze an on-premises SQL Server instance or database for compatibility for migration to SQL Azure. The assessment will provide guidance on features not currently supported in Azure and remediation actions that can be taken to prepare for migration. \ No newline at end of file diff --git a/extensions/azurehybridtoolkit/notebooks/hybridbook/content/data-portability/VisualBootstrapperNB.PNG b/extensions/azurehybridtoolkit/notebooks/hybridbook/content/data-portability/AdpSetup.png similarity index 100% rename from extensions/azurehybridtoolkit/notebooks/hybridbook/content/data-portability/VisualBootstrapperNB.PNG rename to extensions/azurehybridtoolkit/notebooks/hybridbook/content/data-portability/AdpSetup.png diff --git a/extensions/azurehybridtoolkit/notebooks/hybridbook/content/data-portability/setup-adp.ipynb b/extensions/azurehybridtoolkit/notebooks/hybridbook/content/data-portability/setup-adp.ipynb index 0bf1d69ab6..249549f4d4 100644 --- a/extensions/azurehybridtoolkit/notebooks/hybridbook/content/data-portability/setup-adp.ipynb +++ b/extensions/azurehybridtoolkit/notebooks/hybridbook/content/data-portability/setup-adp.ipynb @@ -20,33 +20,33 @@ "source": [ "# Application and Data Portability Setup Notebook\n", "\n", - "This notebook provisions SQL ADP services to an Azure Subscription for migration purposes such as importing and exporting Azure SQL Server database(s). The following scenarios are covered:\n", + "This notebook provisions SQL Data Portability services to an Azure Subscription for migration purposes such as importing and exporting Azure SQL Server database(s). The following scenarios are covered:\n", "\n", - "- [x] Azure to Azure migration\n", - "- [x] Azure to Air-gapped Azure (highly secured Azure offer)\n", - "- [x] Azure to !Azure (3rd party or on-premises)\n", + "- Azure to Azure migration\n", + "- Azure to Air-gapped Azure (highly secured Azure offer)\n", + "- Azure to on-premises\n", "\n", - "This bootstrapper is designed to be ran from a client workstation or laptop with minimal modification. The notebook will attempt to locate three different Azure Resources in a customer subscription. If not found it will install the following to a given Resource Group. If the resources group specified doesn't exist, it will create a new one:\n", + "This notebook is designed to be ran from a client workstation or laptop with minimal modification. It will locate three different Azure Resources in a customer subscription. If not found, it will install a service to the given Resource Group. If the resource group specified does not exist. The following is installed during setup:\n", "\n", - "1. A **Custom Azure ADP Function** to orchestrate the Azure Batch and Storage (see \\[Github\\](........\\\\Program Files\\\\Azure Data Studio\\\\resources\\\\app\\\\out\\\\vs\\\\code\\\\electron-browser\\\\workbench\\\\workbench.html))\n", - "2. An Azure **Storage Account** for storage\n", - "3. An **Azure Batch** resource\n", + "1. A **Custom Azure ADP Function** to orchestrate the Azure Batch and Storage\n", + "2. An Azure **Storage Account** for storage\n", + "3. An **Azure Batch** resource\n", "\n", - "This notebook will help accomplish the below steps as a part of Bootstrapping an ADP Resource Group\n", + "This notebook will help accomplish the below steps as a part of setting up an ADP Resource Group\n", "\n", - "![](VisualBootstrapperNB.PNG)\n", + "![](AdpSetup.png)\n", "\n", - "1. Set Environment Variables\n", - "2. Define Notebook Functions\n", - "3. MS Azure Login\n", - "4. Validate/ Create ADP Resource Group\n", - "5. Provision Virtual Network\n", - "6. Provision ADP Storage Account\n", - "7. Provision ADP Portability Function\n", - "8. Provision ADP Batch Account\n", - "9. Provision Contributor access (RBAC) to Portability function over ADP Resource Group\n", + "1. Set Environment Variables\n", + "2. Define Notebook Functions\n", + "3. MS Azure Login\n", + "4. Validate/ Create ADP Resource Group\n", + "5. Provision Virtual Network\n", + "6. Provision ADP Storage Account\n", + "7. Provision ADP Portability Function\n", + "8. Provision ADP Batch Account\n", + "9. Provision Contributor access (RBAC) to Portability function over ADP Resource Group\n", "\n", - "Setup _will not_ perform tasks on existing Azure assets such as Microsoft SQL Servers, databases, VMs, etc. Other notebooks cover the import or export operations. This notebook will only check for the existence of these ADP resources and their setup." + "Setup will not perform tasks on existing Azure assets such as Microsoft SQL Servers, databases, VMs, etc. Other notebooks cover the import or export operations. This notebook will only check for the existence of these ADP resources and their setup." ], "metadata": { "azdata_cell_guid": "c5d49b77-973b-47bc-92ef-7bcfe05e4885" @@ -56,25 +56,22 @@ "cell_type": "code", "source": [ "# Setup client environment variables that the rest of the notebook will use\r\n", - "$AdpResourceGroup = \"\" # Target Resource Group to bootstrap with ADP components - A new one will be created if the specified Resource Group doesn't exist\r\n", - "$AdpRegion = \"eastus\" # Region/Location of the resource group to be bootstrapped\r\n", + "$AdpResourceGroup = \"\" # Target Resource Group\r\n", + "$AdpRegion = \"eastus\" # Region/Location of the resource group\r\n", "\r\n", "# Derived settings\r\n", - "$AdpSubscription = \"\" # Target Azure Subscription Name or ID to bootstrap data portability resources\r\n", + "$AdpSubscription = \"\" # Target Azure Subscription Name or ID\r\n", "$AdpFunc = $AdpResourceGroup + \"Control\"\r\n", "$AdpStorage = $AdpResourceGroup.ToLower() + \"storage\"\r\n", "$AdpBatch = $AdpResourceGroup.ToLower() + \"batch\"\r\n", "$AdpVNET = $AdpResourceGroup + \"VNet\"\r\n", "\r\n", - "# Bootstrapper URLs - Update with the recommended toolkit version and build\r\n", + "# URLs - Update with the recommended toolkit version and build\r\n", "$BaseToolkitUrl = \"https://hybridtoolkit.blob.core.windows.net/components\"\r\n", "$ReleaseVersion = \"0.13\"\r\n", "$BuildNumber = \"74938\"\r\n", "$AdpDownloadUrl = \"$BaseToolkitUrl/$ReleaseVersion/ADPControl-$BuildNumber.zip\"\r\n", - "$AdpWrapperUrl = \"$BaseToolkitUrl/$ReleaseVersion/BatchWrapper-$BuildNumber.zip\"\r\n", - "\r\n", - "Write-Output \"Setting the Environment:\"\r\n", - "Get-ChildItem Env: | Where-Object Name -Match \"BOOTSTRAP\"" + "$AdpWrapperUrl = \"$BaseToolkitUrl/$ReleaseVersion/BatchWrapper-$BuildNumber.zip\"" ], "metadata": { "azdata_cell_guid": "5896a9a8-5ba8-4888-967a-10c3ceaccf12", @@ -147,7 +144,7 @@ " } \r\n", "}\r\n", "\r\n", - "function Bootstrap-AzResourceGroup\r\n", + "function Setup-AzResourceGroup\r\n", "{\r\n", " [CmdletBinding()]\r\n", " param(\r\n", @@ -185,7 +182,7 @@ " } \r\n", "}\r\n", "\r\n", - "function Bootstrap-AzVirtualNetwork\r\n", + "function Setup-AzVirtualNetwork\r\n", "{ \r\n", " [CmdletBinding()]\r\n", " param(\r\n", @@ -216,7 +213,7 @@ " }\r\n", "}\r\n", "\r\n", - "function Bootstrap-AzStorageAccount\r\n", + "function Setup-AzStorageAccount\r\n", "{ \r\n", " [CmdletBinding()]\r\n", " param(\r\n", @@ -262,7 +259,7 @@ " }\r\n", "}\r\n", "\r\n", - "function Bootstrap-AzFunctionApp\r\n", + "function Setup-AzFunctionApp\r\n", "{\r\n", " [CmdletBinding()]\r\n", " param(\r\n", @@ -329,7 +326,7 @@ " }\r\n", "}\r\n", "\r\n", - "function Bootstrap-AzBatchAccount\r\n", + "function Setup-AzBatchAccount\r\n", "{\r\n", " [CmdletBinding()]\r\n", " param(\r\n", @@ -408,7 +405,7 @@ " } \r\n", "}\r\n", "\r\n", - "function Bootstrap-FuncRBAC {\r\n", + "function Setup-FuncRBAC {\r\n", " [CmdletBinding()]\r\n", " param (\r\n", " [Parameter(Mandatory=$true)][ValidateNotNullOrEmpty()][string]$Subscription,\r\n", @@ -511,7 +508,7 @@ { "cell_type": "code", "source": [ - "Bootstrap-AzResourceGroup -ResourceGroupName $AdpResourceGroup -ResourceGroupLocation $AdpRegion -Subscription $AdpSubscription" + "Setup-AzResourceGroup -ResourceGroupName $AdpResourceGroup -ResourceGroupLocation $AdpRegion -Subscription $AdpSubscription" ], "metadata": { "azdata_cell_guid": "9beb8d22-4560-4c7e-917b-5a3c0d58e1a2", @@ -536,7 +533,7 @@ { "cell_type": "code", "source": [ - "Bootstrap-AzVirtualNetwork -VNetName $AdpVNET -ResourceGroupName $AdpResourceGroup -Subscription $AdpSubscription" + "Setup-AzVirtualNetwork -VNetName $AdpVNET -ResourceGroupName $AdpResourceGroup -Subscription $AdpSubscription" ], "metadata": { "azdata_cell_guid": "d014a6a6-57ff-4de7-8210-b3360bf34daa" @@ -558,7 +555,7 @@ { "cell_type": "code", "source": [ - "Bootstrap-AzStorageAccount -StorageAccountName $AdpStorage -ResourceGroupName $AdpResourceGroup -Subscription $AdpSubscription" + "Setup-AzStorageAccount -StorageAccountName $AdpStorage -ResourceGroupName $AdpResourceGroup -Subscription $AdpSubscription" ], "metadata": { "azdata_cell_guid": "290498ee-3f31-4395-adab-a5fa93d28c80", @@ -583,7 +580,7 @@ { "cell_type": "code", "source": [ - "Bootstrap-AzFunctionApp -FunctionName $AdpFunc -StorageAccountName $AdpStorage -FunctionAppPackageURL $AdpDownloadUrl `\r\n", + "Setup-AzFunctionApp -FunctionName $AdpFunc -StorageAccountName $AdpStorage -FunctionAppPackageURL $AdpDownloadUrl `\r\n", " -ConsumptionPlanLocation $AdpRegion -ResourceGroupName $AdpResourceGroup -Subscription $AdpSubscription" ], "metadata": { @@ -608,7 +605,7 @@ { "cell_type": "code", "source": [ - "Bootstrap-AzBatchAccount -BatchAccountName $AdpBatch -StorageAccountName $AdpStorage -BatchAccountLocation $AdpRegion `\r\n", + "Setup-AzBatchAccount -BatchAccountName $AdpBatch -StorageAccountName $AdpStorage -BatchAccountLocation $AdpRegion `\r\n", " -ApplicationPackageURL $AdpWrapperUrl -ResourceGroupName $AdpResourceGroup -Subscription $AdpSubscription" ], "metadata": { @@ -631,7 +628,7 @@ { "cell_type": "code", "source": [ - "Bootstrap-FuncRBAC -AzFunctionName $AdpFunc -ResourceGroupName $AdpResourceGroup -Subscription $AdpSubscription" + "Setup-FuncRBAC -AzFunctionName $AdpFunc -ResourceGroupName $AdpResourceGroup -Subscription $AdpSubscription" ], "metadata": { "azdata_cell_guid": "75882d3a-2004-4304-ab8f-e5146e14500c", diff --git a/extensions/azurehybridtoolkit/notebooks/hybridbook/content/hadr/configure-ag.ipynb b/extensions/azurehybridtoolkit/notebooks/hybridbook/content/hadr/configure-ag.ipynb deleted file mode 100644 index c02d7b4c6d..0000000000 --- a/extensions/azurehybridtoolkit/notebooks/hybridbook/content/hadr/configure-ag.ipynb +++ /dev/null @@ -1,143 +0,0 @@ -{ - "metadata": { - "kernelspec": { - "name": "powershell", - "display_name": "PowerShell", - "language": "powershell" - }, - "language_info": { - "name": "powershell", - "codemirror_mode": "shell", - "mimetype": "text/x-sh", - "file_extension": ".ps1" - } - }, - "nbformat_minor": 2, - "nbformat": 4, - "cells": [ - { - "cell_type": "markdown", - "source": [ - "# Create and Configure Availability Group\n", - "\n", - "## Description\n", - "\n", - "Notebook to walk through creating an Availability Group via PowerShell commands" - ], - "metadata": { - "azdata_cell_guid": "ff486dfd-93d4-4a5d-8985-6a352b87ad5e" - } - }, - { - "cell_type": "markdown", - "source": [ - "Note: before running the steps below, make sure that the following requirements have been satisfied:\n", - "\n", - "- Verify host instances of SQL Server each resides on a different node of a single failover cluster.\n", - "- Verify server instances met the other server-instance prerequisites.\n", - "- All the other Always On availability groups requirements are met and that all recommendations are considered.\n", - "- Primary server must have at least one user made database in order to create secondary replicas.\n", - "- Domain account must have sysadmin fixed server role, andeither CREATE AVAILABILITY GROUP server permission, ALTER ANY AVAILABILITY GROUP permission, or CONTROL SERVER permission.\n", - "\n", - "More information can be found in the [Prerequisites for Always On Availability](https://docs.microsoft.com/sql/database-engine/availability-groups/windows/prereqs-restrictions-recommendations-always-on-availability?view=sql-server-ver15).\n", - "\n", - "SQL Server Failover Cluster Instances (FCI) do not support automatic failover by availability groups, so any availability replica hosted by an FCI can only be configured for manual failover. Here is a listing of variables that will be used to create the availability group:\n", - "\n", - "| Line # | Name | Description | Example |\n", - "| --- | --- | --- | --- |\n", - "| 1 | **ResourceGroupName** | Name of existing resource group (RG) hosting the Availability Group. An Azure Resource Group is a collection of Azure resources that share the same permissions, policies, etc. | \"TestRG1\" |\n", - "| 9 | **SqlVmName** | Name of the first (primary) SQL server replica added on the domain and used in cluster creation as shown in the previous notebook. | \"Server1\" |\n", - "| 2 | **Instance** | Name of the instance hosted on the primary server. If unnamed, by default it is \"MSSQLSERVER\". Include the SQLVM name as part of the path. | \"sqlvmname\\\\MSSQLSERVER\" |\n", - "| 3 | **DatabaseNames** | Names of user made databases hosted on the primary server. Databases must not end with AUTO\\_CLOSE, cannot be in another availability group, and cannot be configured for database mirroring. | \"MyDatabase\" |\n", - "| 5 | **EndpointURL** | Endpoint URL for a node in the cluster, used to listen for Always On availability group messages from Availability Replicas hosted by other server instances. | \"TCP://PrimaryComputer.domain.com:5022\" |\n", - "| 6 | **PrimaryBackupFile** | Backup of a database located on the primary replica, used for restore on secondary replica. | \"\\\\share\\\\backups\\\\MyDatabase.bak\" |\n", - "| 7 | **PrimaryBackupLog** | Transaction log of a database located on the primary replica, used for restore on secondary replica. | \"\\\\share\\\\backups\\\\MyDatabase.log\" |" - ], - "metadata": { - "azdata_cell_guid": "1ec5da17-225c-4161-95a9-846ba3fbda57" - } - }, - { - "cell_type": "code", - "source": [ - "#Set Parameters\r\n", - "\r\n", - "$ResourceGroupName = \"\"\r\n", - "$SqlVmName = \"\"\r\n", - "$Instance = \"\"\r\n", - "$DatabaseNames = \"\"\r\n", - "$EndpointURL = \"TCP://:5022\"\r\n", - "$PrimaryBackupFile = \"\"\r\n", - "$PrimaryBackupLog = \"\"\r\n", - "" - ], - "metadata": { - "azdata_cell_guid": "4dd15d1c-29fe-44e9-bb1b-7191ec4676ea", - "tags": [] - }, - "outputs": [ - { - "output_type": "stream", - "name": "stdout", - "text": "" - } - ], - "execution_count": 2 - }, - { - "cell_type": "markdown", - "source": [ - "### **Install SQLServer Module**\n", - "\n", - "###This module is required to run the commands below. **(This process may take a very long time, please wait for the process to finish.)**" - ], - "metadata": { - "azdata_cell_guid": "abb93904-a184-4126-b150-e72790e7476a" - } - }, - { - "cell_type": "code", - "source": [ - "#Creating temporary file to store Install Module command\r\n", - "echo \"[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12\" >> InstallModuleCommand.ps1\r\n", - "echo \"Install-PackageProvider -Name NuGet -Force\" >> InstallModuleCommand.ps1\r\n", - "echo \"Install-Module -Name SqlServer -AllowClobber -Force\" >> InstallModuleCommand.ps1\r\n", - "\r\n", - "#Running command on SQL VM\r\n", - "$run = Invoke-AzVMRunCommand -ResourceGroupName $ResourceGroupName -VMName $SqlVmName -CommandId \"RunPowerShellScript\" -ScriptPath \"InstallModuleCommand.ps1\"\r\n", - "Write-Output $run\r\n", - "\r\n", - "#Deleting Test-Cluster temporary file.\r\n", - "if (Test-Path \"InstallModuleCommand.ps1\") {\r\n", - " Remove-Item \"InstallModuleCommand.ps1\"\r\n", - "}" - ], - "metadata": { - "azdata_cell_guid": "44d71a3e-937b-4d7f-b77b-03dbc063d6b0", - "tags": [] - }, - "outputs": [], - "execution_count": null - }, - { - "cell_type": "markdown", - "source": [ - "### **Create in-memory representation of the primary replica. (To be added)**" - ], - "metadata": { - "azdata_cell_guid": "5e4f50b8-2762-44b5-9cb3-9e1c2b20be81" - } - }, - { - "cell_type": "code", - "source": [ - "# To be added. " - ], - "metadata": { - "azdata_cell_guid": "d203ace2-52ab-400f-8f3c-121cebaf45c3" - }, - "outputs": [], - "execution_count": null - } - ] -} diff --git a/extensions/azurehybridtoolkit/notebooks/hybridbook/content/hadr/readme.md b/extensions/azurehybridtoolkit/notebooks/hybridbook/content/hadr/readme.md index 09bcfce4d4..c7cff79f18 100644 --- a/extensions/azurehybridtoolkit/notebooks/hybridbook/content/hadr/readme.md +++ b/extensions/azurehybridtoolkit/notebooks/hybridbook/content/hadr/readme.md @@ -11,4 +11,4 @@ Notebooks to help with HADR tasks in a Hybrid Cloud environment. ### Availability Group Configuration: - [Create Failover Cluster](configure-failover.ipynb) -- [Create Availability Group](configure-ag.ipynb) +- [Create Availability Group]() (Coming Soon...) \ No newline at end of file diff --git a/extensions/azurehybridtoolkit/notebooks/hybridbook/content/offline-migration/db-to-SQLDB.ipynb b/extensions/azurehybridtoolkit/notebooks/hybridbook/content/offline-migration/db-to-SQLDB.ipynb index a2264827d1..b30630333b 100644 --- a/extensions/azurehybridtoolkit/notebooks/hybridbook/content/offline-migration/db-to-SQLDB.ipynb +++ b/extensions/azurehybridtoolkit/notebooks/hybridbook/content/offline-migration/db-to-SQLDB.ipynb @@ -58,7 +58,6 @@ "$loc = \"\"\r\n", "$vNetName = \"\"\r\n", "$Subnet = Subnet1\r\n", - "#$dmsSku = Basic_2vCores # unclear which is correct, listing both for now\r\n", "$dmsSku = GeneralPurpose_4vCores \r\n", "$TargetSqlServer = \"\"\r\n", "$SourceDb = \"\"\r\n", diff --git a/extensions/azurehybridtoolkit/notebooks/hybridbook/content/readme.md b/extensions/azurehybridtoolkit/notebooks/hybridbook/content/readme.md index 748e4c268a..da0e87fe70 100644 --- a/extensions/azurehybridtoolkit/notebooks/hybridbook/content/readme.md +++ b/extensions/azurehybridtoolkit/notebooks/hybridbook/content/readme.md @@ -19,9 +19,9 @@ The **Azure SQL Hybrid Toolkit** is a [Jupyter Book](https://jupyterbook.org/int * [Offline Migration](offline-migration/readme.md) - Notebooks to manage SQL migration tasks to the cloud -* [Glossary](glossary.md) - set of defined terms. +* [Glossary](glossary.md) - set of defined terms -* [Appendices](Appendices.ipynb) - misc info. +* [Appendices](Appendices.ipynb) - Additional information ## Goals and Methodology The toolkit better positions a customer with regards to planning, migrating, and thriving in a hybrid cloud environment by: @@ -29,7 +29,7 @@ The toolkit better positions a customer with regards to planning, migrating, and * Providing SQL Azure users with reliable free software and content that is well-written and executable * Greatly simplifying the integration of Azure Data services into an existing environment * Positioning Azure to be the natural cloud services choice with a low-friction experience -* Notebooks are executable by a normal user (unless otherwise specificed) on minimal hardware +* Notebooks are executable by a normal user (unless otherwise specified) on minimal hardware * Most notebooks require some configuration. If so, the proper configurations should be clearly located towards the top of the notebook or cell, whichever is most appropriate * By design, Notebooks are written to be executed from top-to-bottom. Therefore, each notebook has a specific task to perform and should focus only on that task. It may contain several cells to execute but it will adhere to the one-task per notebook paradigm