Краткое руководство. Клонирование записной книжкиQuickstart: Clone a notebook

Многие специалисты по обработке и анализу данных и разработчики хранят свои записные книжки в репозиториях GitHub — бесплатной службе, обеспечивающей хранилище и управление версиями для самых разных типов проектов.Many data scientists and developers store their notebooks in GitHub repositories, a free service that provides storage and version control for many different project types. GitHub часто используется в качестве средства для совместной работы над записными книжками Jupyter, которые выполняются локально.GitHub is often used as a means of collaborating on Jupyter notebooks that are run locally. В таких случаях каждый участник совместной работы использует локальную копию репозитория и запускает записные книжки из этой копии.In such cases, every collaborator maintains a local copy of the repository and runs the notebooks from that copy.

В результате же клонирования копия записной книжки GitHub создается в вашей учетной записи Записных книжек Azure.Cloning creates a copy of a GitHub notebook in your Azure Notebooks account instead. Клон не зависит от исходного репозитория. Изменения сохраняются только в учетной записи Записных книжек Azure и не влияют на исходный экземпляр.This clone is independent from its original repository; changes are stored in your Azure Notebooks account only and don't affect the original. Так как клон находится в облаке, вы можете поделиться проектом с другими участниками совместной работы, которым не нужно вносить какие-либо локальные копии или даже устанавливать Jupyter на своих компьютерах.Because your clone is in the cloud, you can share the project with other collaborators who need not make any local copies or even have Jupyter installed on their own computers. Можно также клонировать записную книжку в качестве отправной точки для собственного проекта или для получения файлов данных.You might also clone a notebook simply as a starting point for a project of your own or to obtain data files.

Клонирование записных книжек Azure Cognitive ServicesClone Azure Cognitive Services notebooks

  1. Перейдите в службу Записные книжки Azure и выполните вход.Go to Azure Notebooks and sign in. (Дополнительные сведения см. в кратком руководстве по входу в Записные книжки Azure.)(For details, see Quickstart - Sign in to Azure Notebooks).

  2. Вверху на общедоступной странице профиля щелкните Мои проекты:From your public profile page, select My Projects at the top of the page:

    Ссылка My Projects (Мои проекты) в верхней части окна браузера

  3. На странице My Projects (Мои проекты) нажмите кнопку со стрелкой вверх (сочетание клавиш: U; для этой кнопки отображается название Upload GitHub Repo (Отправить репозиторий GitHub), когда окно браузера имеет достаточную ширину):On the My Projects page, select the up arrow button (keyboard shortcut: U; the button appears as Upload GitHub Repo when the browser window is wide enough):

    Команда отправки репозитория GitHub на странице My Projects (Мои проекты)

  4. В появившемся окне Upload GitHub Repository (Отправить репозиторий GitHub) введите или укажите приведенные ниже сведения, а затем нажмите кнопку Импорт:In the Upload GitHub Repository that appears, enter or set the following details, then select Import:

    • GitHub repository (Репозиторий GitHub): Microsoft/cognitive-services-notebooks (репозиторий с этим именем клонирует записные книжки Jupyter для Azure Cognitive Services, расположенные по адресу https://github.com/Microsoft/cognitive-services-notebooks).GitHub repository: Microsoft/cognitive-services-notebooks (this name clones the Jupyter notebooks for Azure Cognitive Services at https://github.com/Microsoft/cognitive-services-notebooks).

    • Clone recursively (Клонировать рекурсивно): флажок снят.Clone recursively: (cleared)

    • Имя проекта: Cognitive Services Clone.Project name: Cognitive Services Clone

    • Идентификатор проекта: cognitive-services-clone.Project ID: cognitive-services-clone

    • Общедоступный: флажок снят.Public: (cleared)

      Всплывающее окно отправки репозитория GitHub для сбора сведений о репозитории

  5. Подождите, пока процесс завершится. Клонирование репозитория может занять несколько минут.Be patient while the process completes; cloning a repository can take a few minutes.

  6. После завершения клонирования в службе "Записные книжки Azure" откроется новый проект, где вы увидите копии всех файлов.Once cloning is finished, Azure Notebooks takes you to the new project where you can see the copies of all the files.

Совместное использование записной книжкиShare a notebook

  1. Для предоставления общего доступа к копии клонированного проекта используйте элемент управления Общий доступ или получите ссылку, получите код HTML или Markdown, содержащий ссылку, либо создайте сообщение электронной почты со ссылкой:To share your copy of the cloned project, use the Share control or obtain a link, obtain HTML or Markdown code that contains the link, or create an email message with the link:

    Команда предоставления общего доступа к проекту

  2. Так как флажок Общедоступный был снят при клонировании проекта, клон является частным.Because you cleared the Public option when cloning the project, the clone is private. Чтобы сделать свою копию общедоступной, выберите Параметры проекта, задайте вариант Public project (Открытый проект) во всплывающем окне, а затем нажмите кнопку Сохранить.To make your copy public, select Project Settings, set the Public project option in the popup, and then select Save.

  3. Выберите в проекте записную книжку, чтобы запустить ее.Select a notebook in the project to run it. Каждая записная книжка в репозитории Azure Cognitive Services, к примеру, имеет свое собственное автономное краткое руководство.Each notebook in the Azure Cognitive Services repository, for example, is its own self-contained Quickstart. На следующем рисунке показан результат использования записной книжки BingImageSearchAPI после добавления ключа подписки API Cognitive Services и изменения термина поиска "puppies" на "bunnies":The image below shows the result of using the BingImageSearchAPI notebook, after adding a Cognitive Services API subscription key and changing the search term "puppies" to "bunnies":

    Запуск записной книжки Jupyter, клонированной из GitHub

  4. По завершении работы с записной книжкой выберите File (Файл) > Close and halt (Закрыть и остановить), чтобы закрыть записную книжку и окно браузера.When you're done running the notebook, select File > Close and halt to close the notebook and its browser window.

  5. Для совместного использования отдельной записной книжки в проекте щелкните ее правой кнопкой мыши и выберите Copy link (Копировать ссылку) (сочетание клавиш: Y):To share an individual notebook in the project, right-click the notebook and select Copy link (keyboard shortcut: y):

    Команда контекстного меню, чтобы скопировать ссылку на отдельную записную книжку

  6. Чтобы изменить файлы, не являющиеся записными книжками, щелкните правой кнопкой мыши файл в проекте и выберите Edit file (Изменить файл) (сочетание клавиш: I).To edit files other than notebooks, right-click the file in the project and select Edit file (keyboard shortcut: i). Действие по умолчанию, Запустить (сочетание клавиш: r), позволяет только просматривать содержимое файла без редактированияThe default action, Run (keyboard shortcut: r), only shows the file contents and doesn't allow editing.

Дополнительная информацияNext steps