[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-08-28。"],[],[],null,["# Introduction to Vertex AI Workbench user-managed notebooks\n\nIntroduction to user-managed notebooks\n======================================\n\n\n| Vertex AI Workbench user-managed notebooks is\n| [deprecated](/vertex-ai/docs/deprecations). On\n| April 14, 2025, support for\n| user-managed notebooks will end and the ability to create user-managed notebooks instances\n| will be removed. Existing instances will continue to function\n| but patches, updates, and upgrades won't be available. To continue using\n| Vertex AI Workbench, we recommend that you\n| [migrate\n| your user-managed notebooks instances to Vertex AI Workbench instances](/vertex-ai/docs/workbench/user-managed/migrate-to-instances).\n\n\u003cbr /\u003e\n\nVertex AI Workbench user-managed notebooks instances\nlet you create and manage deep learning virtual machine\n(VM) instances that are prepackaged with\n[JupyterLab](https://jupyterlab.readthedocs.io/en/stable/getting_started/overview.html).\n\nUser-managed notebooks instances have\na preinstalled suite of deep learning packages,\nincluding support for the TensorFlow and PyTorch\nframeworks. You can configure either CPU-only or GPU-enabled instances.\n\nYour user-managed notebooks instances are protected\nby Google Cloud\nauthentication and authorization and are available by using a\nuser-managed notebooks instance URL.\nUser-managed notebooks instances also integrate with\n[GitHub](https://github.com/)\nand can sync with a GitHub repository.\n\nUser-managed notebooks instances save you\nthe difficulty of creating and\nconfiguring a [Deep Learning virtual machine](/deep-learning-vm/docs)\nby providing verified, optimized, and tested images\nfor your chosen framework.\n\nPreinstalled software\n---------------------\n\nYou can configure a user-managed notebooks instance\nto include the following:\n\n- JupyterLab ([see version details](#jupyterlab-version))\n\n- Python 3, with key packages:\n\n - numpy\n - sklearn\n - scipy\n - pandas\n - nltk\n - pillow\n - [fairness-indicators](https://www.tensorflow.org/responsible_ai/fairness_indicators/guide) for TensorFlow 2.3 and 2.4 user-managed notebooks instances\n - many others\n- R version 4.*x*, with key packages:\n\n - xgboost\n - ggplot2\n - caret\n - nnet\n - rpy2 (an R package for accessing R in Python notebooks)\n - randomForest\n - many others\n- Anaconda\n\n- Nvidia packages with the latest Nvidia driver for GPU-enabled instances:\n\n - CUDA 11.*x* and 12.*x*\n - CuDNN 7.*x*\n - NCCL 2.*x*\n\nJupyterLab version details\n--------------------------\n\nJupyterLab 3.*x* is preinstalled on\nnew user-managed notebooks instances\nby default. For instances created before\nthe [M80 Deep Learning VM\nrelease](/deep-learning-vm/docs/release-notes#September_24_2021),\nJupyterLab 1.*x* was preinstalled.\n\nTo create an earlier version of a user-managed notebooks instance,\nsee [Create a specific version of a user-managed notebooks\ninstance](/vertex-ai/docs/workbench/user-managed/create-specific-version).\n\nVPC Service Controls\n--------------------\n\nVPC Service Controls provides additional security for your\nuser-managed notebooks instances.\nFor more information, see the [Overview of\nVPC Service Controls](/vpc-service-controls/docs/overview). To use\nuser-managed notebooks within a service perimeter, see [Use\na user-managed notebooks instance within a service\nperimeter](/vertex-ai/docs/workbench/user-managed/service-perimeter).\n\nUpgrades\n--------\n\nYou can upgrade your environment to use new capabilities and to benefit from\nframework updates, package updates, and bug fixes. You can\nupgrade environments manually or through an automatic update setting.\nTo learn more, see [Upgrade the environment of\na user-managed notebooks instance](/vertex-ai/docs/workbench/user-managed/upgrade).\n\nUser-managed notebooks and Dataproc Hub\n---------------------------------------\n\nDataproc Hub is a customized\n[JupyterHub](https://jupyter.org/hub) server.\nAdministrators can create Dataproc Hub instances that can\nspawn single-user [Dataproc](/dataproc/docs) clusters to host\nuser-managed notebooks environments. For more information, see\n[Configure Dataproc Hub](/dataproc/docs/tutorials/dataproc-hub-admins).\n\nUser-managed notebooks and Dataflow\n-----------------------------------\n\nYou can use user-managed notebooks within a pipeline,\nand then run\nthe pipeline on [Dataflow](/dataflow/docs). For information about\nhow to create an\n[Apache Beam](https://beam.apache.org/documentation/)\nuser-managed notebooks instance that you can use with\nDataflow, see [Developing interactively with Apache Beam\nnotebooks](/dataflow/docs/guides/interactive-pipeline-development).\n\nLimitations\n-----------\n\nConsider the following limitations of\nuser-managed notebooks when planning your project:\n\n- User-managed notebooks instances are highly\n customizable and can be\n ideal for users who need a lot of control over their environment.\n Therefore, user-managed notebooks instances\n can require more time to set up and manage than\n managed notebooks instances.\n Managed notebooks instances can be\n more ideal for users who don't need a lot of control over their environment.\n For more information, see [Introduction to\n managed notebooks](/vertex-ai/docs/workbench/managed/introduction).\n\n- Third party JupyterLab extensions are not supported.\n\n- The Dataproc JupyterLab plugin isn't supported for\n user-managed notebooks, but you can use the plugin in\n Vertex AI Workbench instances. See [Create a\n Dataproc-enabled\n instance](/vertex-ai/docs/workbench/instances/create-dataproc-enabled).\n\n- For Dataproc Hub user-managed notebooks instances,\n disabling file downloading from the JupyterLab user interface\n is not supported. User-managed notebooks instances\n that use the Dataproc Hub framework permit file downloading even\n if you don't select **Enable file downloading from JupyterLab UI**\n when you create the instance.\n\n- When you use [Access Context Manager](/access-context-manager/docs/create-basic-access-level#corporate-network-example)\n and [Chrome Enterprise Premium](/chrome-enterprise-premium/docs/access-levels)\n to protect managed notebooks instances with\n context-aware access controls, access is evaluated each time\n the user authenticates to the instance. For example, access\n is evaluated the first time the user accesses JupyterLab and\n whenever they access it thereafter if their web browser's\n cookie has expired.\n\nPricing\n-------\n\n[Learn more about Vertex AI Workbench\npricing](/vertex-ai/pricing).\n\nWhat's next\n-----------\n\nTo get started with user-managed notebooks, [create\na user-managed notebooks\ninstance](/vertex-ai/docs/workbench/user-managed/create-new),\nopen JupyterLab, and try\none of the samples in the **tutorials** folder.\n\nThen [install\ndependencies](/vertex-ai/docs/workbench/user-managed/dependencies) that you'll need\nto do your work."]]