Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Sign in / Register
Toggle navigation
J
Jupyter Docker Stacks
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Locked Files
Issues
0
Issues
0
List
Boards
Labels
Service Desk
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Security & Compliance
Security & Compliance
Dependency List
License Compliance
Packages
Packages
List
Container Registry
Analytics
Analytics
CI / CD
Code Review
Insights
Issues
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
nanahira
Jupyter Docker Stacks
Commits
ae5f7e10
Commit
ae5f7e10
authored
Apr 26, 2019
by
Peter Parente
Committed by
GitHub
Apr 26, 2019
Browse files
Options
Browse Files
Download
Plain Diff
Merge pull request #854 from parente/update-txs
tx pull -all manually
parents
576f26fd
4fb91ee6
Changes
13
Show whitespace changes
Inline
Side-by-side
Showing
13 changed files
with
7818 additions
and
8 deletions
+7818
-8
docs/.tx/config
docs/.tx/config
+8
-8
docs/locale/it/LC_MESSAGES/contributing.po
docs/locale/it/LC_MESSAGES/contributing.po
+631
-0
docs/locale/it/LC_MESSAGES/index.po
docs/locale/it/LC_MESSAGES/index.po
+175
-0
docs/locale/it/LC_MESSAGES/maintaining.po
docs/locale/it/LC_MESSAGES/maintaining.po
+277
-0
docs/locale/it/LC_MESSAGES/using.po
docs/locale/it/LC_MESSAGES/using.po
+1530
-0
docs/locale/pt_BR/LC_MESSAGES/contributing.po
docs/locale/pt_BR/LC_MESSAGES/contributing.po
+631
-0
docs/locale/pt_BR/LC_MESSAGES/index.po
docs/locale/pt_BR/LC_MESSAGES/index.po
+177
-0
docs/locale/pt_BR/LC_MESSAGES/maintaining.po
docs/locale/pt_BR/LC_MESSAGES/maintaining.po
+277
-0
docs/locale/pt_BR/LC_MESSAGES/using.po
docs/locale/pt_BR/LC_MESSAGES/using.po
+1530
-0
docs/locale/zh/LC_MESSAGES/contributing.po
docs/locale/zh/LC_MESSAGES/contributing.po
+635
-0
docs/locale/zh/LC_MESSAGES/index.po
docs/locale/zh/LC_MESSAGES/index.po
+140
-0
docs/locale/zh/LC_MESSAGES/maintaining.po
docs/locale/zh/LC_MESSAGES/maintaining.po
+277
-0
docs/locale/zh/LC_MESSAGES/using.po
docs/locale/zh/LC_MESSAGES/using.po
+1530
-0
No files found.
docs/.tx/config
View file @
ae5f7e10
[main]
[main]
host = https://www.transifex.com
host = https://www.transifex.com
[jupyter-docker-stacks-1.using]
[jupyter-docker-stacks-1.using
-po--master
]
file_filter = locale/<lang>/LC_MESSAGES/using.po
file_filter = locale/<lang>/LC_MESSAGES/using.po
source_file =
_build/gettext/using.pot
source_file =
locale/en/LC_MESSAGES/using.po
source_lang = en
source_lang = en
type = PO
type = PO
[jupyter-docker-stacks-1.maintaining]
[jupyter-docker-stacks-1.maintaining
-po--master
]
file_filter = locale/<lang>/LC_MESSAGES/maintaining.po
file_filter = locale/<lang>/LC_MESSAGES/maintaining.po
source_file =
_build/gettext
/maintaining.pot
source_file =
locale/en/LC_MESSAGES
/maintaining.pot
source_lang = en
source_lang = en
type = PO
type = PO
[jupyter-docker-stacks-1.index]
[jupyter-docker-stacks-1.index
-po--master
]
file_filter = locale/<lang>/LC_MESSAGES/index.po
file_filter = locale/<lang>/LC_MESSAGES/index.po
source_file =
_build/gettext
/index.pot
source_file =
locale/en/LC_MESSAGES
/index.pot
source_lang = en
source_lang = en
type = PO
type = PO
[jupyter-docker-stacks-1.contributing]
[jupyter-docker-stacks-1.contributing
-po--master
]
file_filter = locale/<lang>/LC_MESSAGES/contributing.po
file_filter = locale/<lang>/LC_MESSAGES/contributing.po
source_file =
_build/gettext
/contributing.pot
source_file =
locale/en/LC_MESSAGES
/contributing.pot
source_lang = en
source_lang = en
type = PO
type = PO
docs/locale/it/LC_MESSAGES/contributing.po
0 → 100644
View file @
ae5f7e10
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2018- Project Jupyter
# This file is distributed under the same license as the docker-stacks package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: docker-stacks latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-04-21 17:25-0400\n"
"PO-Revision-Date: 2019-04-22 13:45+0000\n"
"Language-Team: Italian (https://www.transifex.com/project-jupyter/teams/97886/it/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: it\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# 9527c87037fb4592a05d144d80f69f89
#: ../../contributing/features.md:1
msgid "New Features"
msgstr ""
# 81de205103144b289398603fa4aee789
#: ../../contributing/features.md:3
msgid ""
"Thank you for contributing to the Jupyter Docker Stacks! We review pull "
"requests of new features (e.g., new packages, new scripts, new flags) to "
"balance the value of the images to the Jupyter community with the cost of "
"maintaining the images over time."
msgstr ""
# b35331d86206420aa8235d20ef037215
#: ../../contributing/features.md:5
msgid "Suggesting a New Feature"
msgstr ""
# 6c6b00518c1f4dc88049b82f213a36cc
#: ../../contributing/features.md:7
msgid ""
"Please follow the process below to suggest a new feature for inclusion in "
"one of the core stacks:"
msgstr ""
# a9cd9d0730cc4159aa227e970ae2d9d0
#: ../../contributing/features.md:9
msgid "Open a GitHub issue describing the feature you'd like to contribute."
msgstr ""
# 8433ea2c70b94556b9a62c35cb88a4c8
#: ../../contributing/features.md:10
msgid ""
"Discuss with the maintainers whether the addition makes sense in one of the "
"core stacks, as a recipe in the documentation, as a community stack, or as "
"something else entirely."
msgstr ""
# a995c15adfb7424e9852693b90569d7a
#: ../../contributing/features.md:12
msgid "Selection Criteria"
msgstr ""
# 981cef217f4e4225984c5c7989f592f8
#: ../../contributing/features.md:14
msgid ""
"Roughly speaking, we evaluate new features based on the following criteria:"
msgstr ""
# 32194c09119e428a871acb859d696500
#: ../../contributing/features.md:16
msgid ""
"Usefulness to Jupyter users: Is the feature generally applicable across "
"domains? Does it work with Jupyter Notebook, JupyterLab, JupyterHub, etc.?"
msgstr ""
# 7b5acf7ef5854ac4b2c55b1a51464796
#: ../../contributing/features.md:17
msgid ""
"Fit with the image purpose: Does the feature match the theme of the stack in"
" which it will be added? Would it fit better in a new, community stack?"
msgstr ""
# 55d1f51c3b264dcfb252771c83d8ca36
#: ../../contributing/features.md:18
msgid ""
"Complexity of build / runtime configuration: How many lines of code does the"
" feature require in one of the Dockerfiles or startup scripts? Does it "
"require new scripts entirely? Do users need to adjust how they use the "
"images?"
msgstr ""
# 2a332f3b95064b43a1833166fd84f53c
#: ../../contributing/features.md:19
msgid ""
"Impact on image metrics: How many bytes does the feature and its "
"dependencies add to the image(s)? How many minutes do they add to the build "
"time?"
msgstr ""
# 30966a8cde0844bd85f6114c65f79ec4
#: ../../contributing/features.md:20
msgid ""
"Ability to support the addition: Can existing maintainers answer user "
"questions and address future build issues? Are the contributors interested "
"in helping with long-term maintenance? Can we write tests to ensure the "
"feature continues to work over time?"
msgstr ""
# 6085a8c0829e411588a37777bfe5e0f4
#: ../../contributing/features.md:22
msgid "Submitting a Pull Request"
msgstr ""
# fa5dc8dbaedb483b888622cc9d1e94ae
#: ../../contributing/features.md:24
msgid ""
"If there's agreement that the feature belongs in one or more of the core "
"stacks:"
msgstr ""
# 23ae2ae62bdb4a35bc42d9efc7759944
#: ../../contributing/features.md:26
msgid ""
"Implement the feature in a local clone of the jupyter/docker-stacks project."
msgstr ""
# ef476261493c48d998fb384d651b4012
#: ../../contributing/features.md:27
msgid ""
"Please build the image locally before submitting a pull request. Building "
"the image locally shortens the debugging cycle by taking some load off "
"Travis CI, which graciously provides free build services for open source "
"projects like this one. If you use make, call:"
msgstr ""
# 6bd20fd181f44e39a4913154db0c7221
# 4277e486510d49a08448d209a5cdad69
# f8c596a67a4f43c1a1c82a0f38a846f7
#: ../../contributing/features.md:31 ../../contributing/packages.md:13
#: ../../contributing/tests.md:20
msgid "Submit a pull request (PR) with your changes."
msgstr ""
# a7aa4a8d9d3d44eda2f1cf757e569c4e
# d8f1d1f00b2a4e9690b4e0da736ac662
# e4f93545f2284342a2b3ad1f52eaf26c
#: ../../contributing/features.md:32 ../../contributing/packages.md:14
#: ../../contributing/tests.md:21
msgid ""
"Watch for Travis to report a build success or failure for your PR on GitHub."
msgstr ""
# f80657a299424b8685d452d70479bae6
#: ../../contributing/features.md:33
msgid "Discuss changes with the maintainers and address any build issues."
msgstr ""
# 57ead3e81b9b4ebaa7a3491818f60089
#: ../../contributing/issues.md:1
msgid "Project Issues"
msgstr ""
# f27080bf0c8d43a08f283b3c5e28ddc7
#: ../../contributing/issues.md:3
msgid ""
"We appreciate your taking the time to report an issue you encountered using "
"the Jupyter Docker Stacks. Please review the following guidelines when "
"reporting your problem."
msgstr ""
# 3713984479614d4aa9237328bc2e233b
#: ../../contributing/issues.md:7
msgid ""
"If you believe you’ve found a security vulnerability in any of the Jupyter "
"projects included in Jupyter Docker Stacks images, please report it to "
"security@ipython.org, not in the issue trackers on GitHub. If you prefer to "
"encrypt your security reports, you can use this PGP public key."
msgstr ""
# 0c7fad6ee9304bbe80baf1737d0f478c
#: ../../contributing/issues.md:13
msgid ""
"If you think your problem is unique to the Jupyter Docker Stacks images, "
"please search the jupyter/docker-stacks issue tracker to see if someone else"
" has already reported the same problem. If not, please open a new issue and "
"provide all of the information requested in the issue template."
msgstr ""
# 70860cacf75b40a687363712f3bf00ce
#: ../../contributing/issues.md:19
msgid ""
"If the issue you're seeing is with one of the open source libraries included"
" in the Docker images and is reproducible outside the images, please file a "
"bug with the appropriate open source project."
msgstr ""
# 76822159e56f40f3bb38ea93e054238c
#: ../../contributing/issues.md:22
msgid ""
"If you have a general question about how to use the Jupyter Docker Stacks in"
" your environment, in conjunction with other tools, with customizations, and"
" so on, please post your question on the Jupyter Discourse site."
msgstr ""
# 3815aec9c791444cbdf26a71e28a1f7c
#: ../../contributing/packages.md:1
msgid "Package Updates"
msgstr ""
# 0bc1f6af65c74cc5a812a14b9c5a055f
#: ../../contributing/packages.md:3
msgid ""
"We actively seek pull requests which update packages already included in the"
" project Dockerfiles. This is a great way for first-time contributors to "
"participate in developing the Jupyter Docker Stacks."
msgstr ""
# ff8faef49758489fb97ddaba60763a0e
#: ../../contributing/packages.md:5
msgid "Please follow the process below to update a package version:"
msgstr ""
# e3878a1a1a444bb592fe32f468693ed7
#: ../../contributing/packages.md:7
msgid ""
"Locate the Dockerfile containing the library you wish to update (e.g., base-"
"notebook/Dockerfile, scipy-notebook/Dockerfile)"
msgstr ""
# d5aac81ecab24592860296ab74936724
#: ../../contributing/packages.md:8
msgid ""
"Adjust the version number for the package. We prefer to pin the major and "
"minor version number of packages so as to minimize rebuild side-effects when"
" users submit pull requests (PRs). For example, you'll find the Jupyter "
"Notebook package, notebook, installed using conda with notebook=5.4.*."
msgstr ""
# 0eed3a80d95146bab769d4456addcce4
#: ../../contributing/packages.md:9
msgid ""
"Please build the image locally before submitting a pull request. Building "
"the image locally shortens the debugging cycle by taking some load off "
"Travis CI, which graciously provides free build services for open source "
"projects like this one. If you use make, call:"
msgstr ""
# 1be104e942024f2b98eb10e0006b9de3
#: ../../contributing/packages.md:15
msgid ""
"Discuss changes with the maintainers and address any build issues. Version "
"conflicts are the most common problem. You may need to upgrade additional "
"packages to fix build failures."
msgstr ""
# adf5db8b690d466a8d339c756a5a153c
#: ../../contributing/recipes.md:1
msgid "New Recipes"
msgstr ""
# 7d306f8fe4a641e4a48b61111c16b8e8
#: ../../contributing/recipes.md:3
msgid ""
"We welcome contributions of recipes, short examples of using, configuring, "
"or extending the Docker Stacks, for inclusion in the documentation site. "
"Follow the process below to add a new recipe:"
msgstr ""
# 5b84ed1b594845ec81f39b87e7c5d82b
#: ../../contributing/recipes.md:5
msgid "Open the docs/using/recipes.md source file."
msgstr ""
# 52f2b459bff447fe82c60ea02c4e751c
#: ../../contributing/recipes.md:6
msgid ""
"Add a second-level Markdown heading naming your recipe at the bottom of the "
"file (e.g., `## Add the RISE extension``)"
msgstr ""
# 56b4b4356d3e45f5bbe6eb14f9540628
#: ../../contributing/recipes.md:7
msgid ""
"Write the body of your recipe under the heading, including whatever command "
"line, Dockerfile, links, etc. you need."
msgstr ""
# 6a3115ec07cf42a28c755a607658f855
# f4f9a3d6544b4e4087e97124098459eb
#: ../../contributing/recipes.md:8 ../../contributing/stacks.md:111
msgid ""
"Submit a pull request (PR) with your changes. Maintainers will respond and "
"work with you to address any formatting or content issues."
msgstr ""
# 0b8332c390304a1ab29a4b2b030e7997
#: ../../contributing/stacks.md:1
msgid "Community Stacks"
msgstr ""
# 69ee7d697c7240b78ea8c7873fc1528b
#: ../../contributing/stacks.md:3
msgid ""
"We love to see the community create and share new Jupyter Docker images. "
"We've put together a cookiecutter project and the documentation below to "
"help you get started defining, building, and sharing your Jupyter "
"environments in Docker. Following these steps will:"
msgstr ""
# 0f392d5680ba4ea2812ff450f8e19d44
#: ../../contributing/stacks.md:5
msgid ""
"Setup a project on GitHub containing a Dockerfile based on either the "
"jupyter/base-notebook or jupyter/minimal-notebook image."
msgstr ""
# c05df9d2cf8c4505b0951f0ea88f1daf
#: ../../contributing/stacks.md:6
msgid ""
"Configure Travis CI to build and test your image when users submit pull "
"requests to your repository."
msgstr ""
# 077482de9feb4fa2b1e5e477fd5591f1
#: ../../contributing/stacks.md:7
msgid ""
"Configure Docker Cloud to build and host your images for others to use."
msgstr ""
# e2fe70e1ea6e4322a8dfa4380f8e54bb
#: ../../contributing/stacks.md:8
msgid ""
"Update the list of community stacks in this documentation to include your "
"image."
msgstr ""
# 3af1a3dc1eae4a7d96a883b911fc5894
#: ../../contributing/stacks.md:10
msgid ""
"This approach mirrors how we build and share the core stack images. Feel "
"free to follow it or pave your own path using alternative services and build"
" tools."
msgstr ""
# 0107f213096c41c8b1cb367b84fee30d
#: ../../contributing/stacks.md:12
msgid "Creating a Project"
msgstr ""
# cb35d196dc42402f9b338e56fcd3faa6
#: ../../contributing/stacks.md:14
msgid "First, install cookiecutter using pip or conda:"
msgstr ""
# 09066f77e38c42889844dafb226df4bd
#: ../../contributing/stacks.md:20
msgid ""
"Run the cookiecutter command pointing to the jupyter/cookiecutter-docker-"
"stacks project on GitHub."
msgstr ""
# 26f05981d3fe49abb07bba85a4a3890f
#: ../../contributing/stacks.md:26
msgid ""
"Enter a name for your new stack image. This will serve as both the git "
"repository name and the part of the Docker image name after the slash."
msgstr ""
# c6aba910076b49ca97dcb902f13d2a4d
#: ../../contributing/stacks.md:33
msgid ""
"Enter the user or organization name under which this stack will reside on "
"Docker Cloud / Hub. You must have access to manage this Docker Cloud org in "
"order to push images here and setup automated builds."
msgstr ""
# 176a346034074822b7634c6c86dace42
#: ../../contributing/stacks.md:41
msgid ""
"Select an image from the jupyter/docker-stacks project that will serve as "
"the base for your new image."
msgstr ""
# 3611e7452640414d9d0535292abd113d
#: ../../contributing/stacks.md:48
msgid "Enter a longer description of the stack for your README."
msgstr ""
# 782321361a3b4116a2d3dafa7cc1424f
#: ../../contributing/stacks.md:54
msgid "Initialize your project as a Git repository and push it to GitHub."
msgstr ""
# b699fe5155774c93938427a241d0f239
#: ../../contributing/stacks.md:66
msgid "Configuring Travis"
msgstr ""
# 6440a7c3a9444dda88445913807d1a48
#: ../../contributing/stacks.md:68
msgid ""
"Next, link your GitHub project to Travis CI to build your Docker image "
"whenever you or someone else submits a pull request."
msgstr ""
# c0613debece54f82a922700157994c5b
#: ../../contributing/stacks.md:70
msgid ""
"Visit https://docs.travis-ci.com/user/getting-started/#To-get-started-with-"
"Travis-CI and follow the instructions to add the Travis CI application to "
"your GitHub account."
msgstr ""
# 4cf36f34a47b410a982be3237af720cd
#: ../../contributing/stacks.md:71
msgid "Visit https://travis-ci.org."
msgstr ""
# fdd694f5ebf443ce9d2d220d5945c299
#: ../../contributing/stacks.md:72
msgid "Click the + symbol at the top of the left sidebar."
msgstr ""
# 05acff6addad4f919fe21c27329b1e51
#: ../../contributing/stacks.md:74
msgid ""
"Locate your project repository either in your primary user account or in one"
" of the organizations to which you belong."
msgstr ""
# a1917b1360434fb18a3522e0a9806a11
#: ../../contributing/stacks.md:75
msgid "Click the toggle to enable builds for the project repository."
msgstr ""
# 7dcbafc96c4a4ef88d7bc34e31a0af04
#: ../../contributing/stacks.md:76
msgid "Click the Settings button for that repository."
msgstr ""
# dd006e53f5cc4c1ea1501d62119f526e
#: ../../contributing/stacks.md:78
msgid ""
"Enable Build only if .travis.yml is present and Build pushed pull requests."
msgstr ""
# 0a5e54cd5f294a52983c2ec73559f810
#: ../../contributing/stacks.md:80
msgid "Disable Build pushed branches."
msgstr ""
# 2ddf5289794648a3b7d1f604ce744331
#: ../../contributing/stacks.md:82
msgid "Configuring Docker Cloud"
msgstr ""
# 5108ce3f722a430eb29e1a5928a86fcf
#: ../../contributing/stacks.md:84
msgid ""
"Now, configure Docker Cloud to build your stack image and push it to Docker "
"Hub repository whenever you merge a GitHub pull request to the master branch"
" of your project."
msgstr ""
# 7ab258ec2f1e4942a983996a6c5e6fa5
#: ../../contributing/stacks.md:86
msgid "Visit https://cloud.docker.com/ and login."
msgstr ""
# 3677166ebbc04b2aafc4f117e33f6bf5
#: ../../contributing/stacks.md:87
msgid ""
"Select the account or organization matching the one you entered when "
"prompted with stack_org by the cookiecutter."
msgstr ""
# 0997628fd41449c5b0598e7e1bf1f005
#: ../../contributing/stacks.md:89
msgid "Scroll to the bottom of the page and click Create repository."
msgstr ""
# 8504105c95594c288fdd9066006757b0
#: ../../contributing/stacks.md:90
msgid ""
"Enter the name of the image matching the one you entered when prompted with "
"stack_name by the cookiecutter."
msgstr ""
# c92796a106c846f585c88fb5a015fa6d
#: ../../contributing/stacks.md:92
msgid "Enter a description for your image."
msgstr ""
# fba832c82f3042499563598365fedfd5
#: ../../contributing/stacks.md:93
msgid ""
"Click GitHub under the Build Settings and follow the prompts to connect your"
" account if it is not already connected."
msgstr ""
# bff3581410014975943ca77637142f14
#: ../../contributing/stacks.md:94
msgid ""
"Select the GitHub organization and repository containing your image "
"definition from the dropdowns."
msgstr ""
# 72cbc93bfe354e279e9384e7c95c801b
#: ../../contributing/stacks.md:96
msgid "Click the Create and Build button."
msgstr ""
# bbb495328efd4fe7b339b7a7ffe908b0
#: ../../contributing/stacks.md:98
msgid "Defining Your Image"
msgstr ""
# 60052c2d1afc4a57baa59c1bf22d321c
#: ../../contributing/stacks.md:100
msgid ""
"Make edits the Dockerfile in your project to add third-party libraries and "
"configure Jupyter applications. Refer to the Dockerfiles for the core stacks"
" (e.g., jupyter/datascience-notebook) to get a feel for what's possible and "
"best practices."
msgstr ""
# 0855b53115ae4b6780cc82c9389224cb
#: ../../contributing/stacks.md:102
msgid ""
"Submit pull requests to your project repository on GitHub. Ensure your image"
" builds properly on Travis before merging to master. Refer to Docker Cloud "
"for builds of your master branch that you can docker pull."
msgstr ""
# de4bcc6e0ac1468ea761c038661ca19f
#: ../../contributing/stacks.md:104
msgid "Sharing Your Image"
msgstr ""
# a67495f9ae984a368364a698084f060e
#: ../../contributing/stacks.md:106
msgid ""
"Finally, if you'd like to add a link to your project to this documentation "
"site, please do the following:"
msgstr ""
# 7357ed96047e42e6ae9e4bf123a00bed
#: ../../contributing/stacks.md:108
msgid "Clone ths jupyter/docker-stacks GitHub repository."
msgstr ""
# ee9284fe69244dcd8d44b25b8dc8b3a2
#: ../../contributing/stacks.md:109
msgid ""
"Open the docs/using/selecting.md source file and locate the Community Stacks"
" section."
msgstr ""
# aa0e41b99c354b5b88336489084e2006
#: ../../contributing/stacks.md:110
msgid ""
"Add a bullet with a link to your project and a short description of what "
"your Docker image contains."
msgstr ""
# 0f652c5259d544b595e847365dfe843a
#: ../../contributing/tests.md:1
msgid "Image Tests"
msgstr ""
# 569da0112572470b9bc5f045bcfb49d0
#: ../../contributing/tests.md:3
msgid ""
"We greatly appreciate pull requests that extend the automated tests that vet"
" the basic functionality of the Docker images."
msgstr ""
# 67b27592447e47af8b0b00eeb745fc70
#: ../../contributing/tests.md:5
msgid "How the Tests Work"
msgstr ""
# e2c3d76accff489eb2a6eab7b55ae3be
#: ../../contributing/tests.md:7
msgid ""
"Travis executes make build-test-all against every pull request submitted to "
"the jupyter/docker-stacks repository. The make command builds every docker "
"image. After building each image, the make command executes pytest to run "
"both image-specific tests like those in base-notebook/test/ and common tests"
" defined in test/. Both kinds of tests make use of global pytest fixtures "
"defined in the conftest.py file at the root of the projects."
msgstr ""
# 15207b72b26741f0a6a77949a4d9d0f4
#: ../../contributing/tests.md:9
msgid "Contributing New Tests"
msgstr ""
# 5470865e6d144e51a428221e49e448fb
#: ../../contributing/tests.md:11
msgid "Please follow the process below to add new tests:"
msgstr ""
# 36aedaa2624c4e4493af145bc5f246e0
#: ../../contributing/tests.md:13
msgid ""
"If the test should run against every image built, add your test code to one "
"of the modules in test/ or create a new module."
msgstr ""
# dccbb0425be7438db7ade2f4892c6c25
#: ../../contributing/tests.md:14
msgid ""
"If your test should run against a single image, add your test code to one of"
" the modules in some-notebook/test/ or create a new module."
msgstr ""
# 33ab248b51d24fa0b29923489bf6dfbf
#: ../../contributing/tests.md:15
msgid ""
"Build one or more images you intend to test and run the tests locally. If "
"you use make, call:"
msgstr ""
# 0453d92037cb4e47a025bc9021bdc7db
#: ../../contributing/tests.md:22
msgid ""
"Discuss changes with the maintainers and address any issues running the "
"tests on Travis."
msgstr ""
docs/locale/it/LC_MESSAGES/index.po
0 → 100644
View file @
ae5f7e10
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2018- Project Jupyter
# This file is distributed under the same license as the docker-stacks package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Nicola Landolfi <ncl.lnd769@gmail.com>, 2019
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: docker-stacks latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-04-21 17:25-0400\n"
"PO-Revision-Date: 2019-04-22 13:45+0000\n"
"Last-Translator: Nicola Landolfi <ncl.lnd769@gmail.com>, 2019\n"
"Language-Team: Italian (https://www.transifex.com/project-jupyter/teams/97886/it/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: it\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# 85291a2c92d440a089cf156fba58b86a
#: ../../index.rst:32 ../../index.rst:32
msgid "User Guide"
msgstr "Guida Utente"
# e4a3fd32059d4486b6b0f3a6fb5065b5
#: ../../index.rst:42 ../../index.rst:42
msgid "Contributor Guide"
msgstr "Come contribuire"
# 45de48c8617d4ebe83b7ff7141295836
#: ../../index.rst:53 ../../index.rst:53
msgid "Maintainer Guide"
msgstr "Guida per i Maintainer"
# aa99c4562d8d4cb3abfea375470e8af3
#: ../../index.rst:59 ../../index.rst:59
msgid "Getting Help"
msgstr "Assistenza"
# 76df09037a6147c8a85be8ef14c15532
#: ../../index.rst:2
msgid "Jupyter Docker Stacks"
msgstr "Jupyter Docker Stacks"
# b3fb253184e64174b26a2da73f221cc1
#: ../../index.rst:4
msgid ""
"Jupyter Docker Stacks are a set of ready-to-run Docker images containing "
"Jupyter applications and interactive computing tools. You can use a stack "
"image to do any of the following (and more):"
msgstr ""
"Jupyter Docker Stacks consiste in una collezione di immagini Docker pronte "
"all'uso, contenenti applicazioni Jupyter e strumenti per l'interactive "
"computing. Esse permettono di (e non solo):"
# 8cd55fb113a049e7be445b21084df7ea
#: ../../index.rst:6
msgid "Start a personal Jupyter Notebook server in a local Docker container"
msgstr ""
"Avviare un server personale Jupyter Notebook all'interno di un container "
"Docker in locale"
# 285fa13bed8547b4af0cfc480adf4861
#: ../../index.rst:7
msgid "Run JupyterLab servers for a team using JupyterHub"
msgstr "Configurare un server JupyterLab da utilizzare con JupyterHub"
# a49d31cedd4946ea98d7a4c720340d84
#: ../../index.rst:8
msgid "Write your own project Dockerfile"
msgstr "Creare Dockerfile personalizzati"
# 0aff0df2e46a44b4bc8070545e83c42c
#: ../../index.rst:11
msgid "Quick Start"
msgstr "Per iniziare"
# 3262accd283140058db73005072be200
#: ../../index.rst:13
msgid ""
"You can try a `recent build of the jupyter/base-notebook image on "
"mybinder.org <https://mybinder.org/v2/gh/jupyter/docker-"
"stacks/master?filepath=README.ipynb>`_ by simply clicking the preceding "
"link. Otherwise, the two examples below may help you get started if you "
"`have Docker installed <https://docs.docker.com/install/>`_, know "
":doc:`which Docker image <using/selecting>` you want to use, and want to "
"launch a single Jupyter Notebook server in a container."
msgstr ""
"Potete provare `una build recente dell'immagine jupyter/base-notebook su "
"mybinder.org <https://mybinder.org/v2/gh/jupyter/docker-"
"stacks/master?filepath=README.ipynb>`_ cliccando sul link precedente. "
"Oppure, i due esempi in basso potrebbero aiutarvi a muovere i primi passi se"
" `avete installato Docker <https://docs.docker.com/install/>`_, avete scelto"
" :doc:` l'immagine da utilizzare <using/selecting>` e volete lanciare un "
"solo server Jupyter Notebook in un container."
# 9e4094e8de264e20bca0af8f6cf888b7
#: ../../index.rst:15
msgid ""
"The other pages in this documentation describe additional uses and features "
"in detail."
msgstr ""
"Le altre pagine di questa documentazione descrivono nel dettaglio le varie "
"funzionalità ed ulteriori casi d'uso."
# 8b75310f2eaa4aac95d9387e0a4db9e8
#: ../../index.rst:17
msgid ""
"**Example 1:** This command pulls the ``jupyter/scipy-notebook`` image "
"tagged ``17aba6048f44`` from Docker Hub if it is not already present on the "
"local host. It then starts a container running a Jupyter Notebook server and"
" exposes the server on host port 8888. The server logs appear in the "
"terminal. Visiting ``http://<hostname>:8888/?token=<token>`` in a browser "
"loads the Jupyter Notebook dashboard page, where ``hostname`` is the name of"
" the computer running docker and ``token`` is the secret token printed in "
"the console. The container remains intact for restart after the notebook "
"server exits.::"
msgstr ""
"**Esempio 1:** Questo comando esegue il pull dell'immagine ``jupyter/scipy-"
"notebook`` avente tag ``17aba6048f44`` da Docker Hub se non dovesse essere "
"già presente sull'host locale. Poi avvia un container con un server Jupyter "
"Notebook in ascolto sulla porta 8888 dell'host. I log del server compaiono "
"nel terminale. All'indirizzo ``http://<hostname>:8888/?token=<token>`` è "
"presente la dashboard di Jupyter Notebook. ``hostname`` indica il nome del "
"computer dove Docker è avviato mentre ``token`` è il token segreto mostrato "
"sul terminale. L'uscita dal server del notebook lascia intatto il container:"
# 9e0229c99f404aceb7e517387ae88365
#: ../../index.rst:21
msgid ""
"**Example 2:** This command performs the same operations as **Example 1**, "
"but it exposes the server on host port 10000 instead of port 8888. Visiting "
"``http://<hostname>:10000/?token=<token>`` in a browser loads JupyterLab, "
"where ``hostname`` is the name of the computer running docker and ``token`` "
"is the secret token printed in the console.::"
msgstr ""
"**Esempio 2:** Questo comando esegue le stesse operazioni dell'**Esempio "
"1**, ma mette in ascolto il server sulla porta 10000 anziché 8888:"
# 02c25d3f0abe48348100dd878c243a75
#: ../../index.rst:25
msgid ""
"**Example 3:** This command pulls the ``jupyter/datascience-notebook`` image"
" tagged ``9b06df75e445`` from Docker Hub if it is not already present on the"
" local host. It then starts an *ephemeral* container running a Jupyter "
"Notebook server and exposes the server on host port 10000. The command "
"mounts the current working directory on the host as ``/home/jovyan/work`` in"
" the container. The server logs appear in the terminal. Visiting "
"``http://<hostname>:10000/?token=<token>`` in a browser loads JupyterLab, "
"where ``hostname`` is the name of the computer running docker and ``token`` "
"is the secret token printed in the console. Docker destroys the container "
"after notebook server exit, but any files written to ``~/work`` in the "
"container remain intact on the host.::"
msgstr ""
"**Esempio 3:** Questo comando esegue il pull dell'immagine ``jupyter"
"/datascience-notebook`` avente tag ``9b06df75e445`` da Docker Hub se non "
"dovesse essere già presente sull'host locale. Poi avvia un container "
"*effimero* con un server Jupyter Notebook in ascolto sulla porta 10000. "
"Inoltre, il comando monta la directory di lavoro corrente dell'host come "
"``/home/jovyan/work`` all'interno del container. I log del server compaiono "
"nel terminale. All'indirizzo ``http://<hostname>:10000/?token=<token>`` è "
"presente la dashboard di Jupyter Notebook. ``hostname`` indica il nome del "
"computer dove Docker è avviato mentre ``token`` è il token segreto mostrato "
"sul terminale. Docker distrugge il container all'uscita del server del "
"notebook, tuttavia i file salvati in ``~/work`` all'interno del container "
"restano inalterati sull'host:"
# 1bc0c7d54cd343d689362047c0b00122
#: ../../index.rst:30
msgid "Table of Contents"
msgstr "Indice"
docs/locale/it/LC_MESSAGES/maintaining.po
0 → 100644
View file @
ae5f7e10
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2018- Project Jupyter
# This file is distributed under the same license as the docker-stacks package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: docker-stacks latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-04-21 17:25-0400\n"
"PO-Revision-Date: 2019-04-22 13:45+0000\n"
"Language-Team: Italian (https://www.transifex.com/project-jupyter/teams/97886/it/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: it\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# cefae71d9a804ab69c7e9f0a53eb7475
#: ../../maintaining/tasks.md:1
msgid "Maintainer Playbook"
msgstr ""
# af6a24b053794e55bddfe6e2e21ae74f
#: ../../maintaining/tasks.md:3
msgid "Merging Pull Requests"
msgstr ""
# c34b1d3b543346689adbca91331ac048
#: ../../maintaining/tasks.md:5
msgid ""
"To build new images on Docker Cloud and publish them to the Docker Hub "
"registry, do the following:"
msgstr ""
# 1597bb99448f41b994d1c7073b9c8721
#: ../../maintaining/tasks.md:7
msgid "Make sure Travis is green for a PR."
msgstr ""
# 401ed2733771440e8ef089f54cf2984d
#: ../../maintaining/tasks.md:8
msgid "Merge the PR."
msgstr ""
# 6d0bf2e7538640a0989e56df3c9d1106
#: ../../maintaining/tasks.md:9
msgid ""
"Monitor the Docker Cloud build status for each of the stacks, starting with "
"jupyter/base-notebook and ending with jupyter/all-spark-notebook. See the "
"stack hierarchy diagram for the current, complete build order."
msgstr ""
# 428124fa830d4c74a618d7b3c696599c
#: ../../maintaining/tasks.md:10
msgid ""
"Manually click the retry button next to any build that fails to resume that "
"build and any dependent builds."
msgstr ""
# c4034a02dab8435f8d76c2d32321a262
#: ../../maintaining/tasks.md:11
msgid ""
"Try to avoid merging another PR to master until all outstanding builds "
"complete. There's no way at present to propagate the git SHA to build "
"through the Docker Cloud build trigger API. Every build trigger works off of"
" master HEAD."
msgstr ""
# 62ddd25e15064cea950f9f13a663dcdb
#: ../../maintaining/tasks.md:13
msgid "Updating the Ubuntu Base Image"
msgstr ""
# 091b1ce707f44bc6ae9742cf55b92ebf
#: ../../maintaining/tasks.md:15
msgid ""
"When there's a security fix in the Ubuntu base image or after some time "
"passes, it's a good idea to update the pinned SHA in the jupyter/base-"
"notebook Dockerfile. Submit it as a regular PR and go through the build "
"process. Expect the build to take a while to complete: every image layer "
"will rebuild."
msgstr ""
# d834495e774a4fee952324e4cc5ab514
#: ../../maintaining/tasks.md:17
msgid "Adding a New Core Image to Docker Cloud"
msgstr ""
# b765140c2d1446849b747351532d6290
#: ../../maintaining/tasks.md:19
msgid ""
"When there's a new stack definition, do the following before merging the PR "
"with the new stack:"
msgstr ""
# b7b25a83cd3246bd886926722c30ac1a
#: ../../maintaining/tasks.md:21
msgid ""
"Ensure the PR includes an update to the stack overview diagram in the "
"documentation. The image links to the blockdiag source used to create it."
msgstr ""
# 50edc8e02aa9497d81dc312eafe5d2bf
#: ../../maintaining/tasks.md:22
msgid ""
"Ensure the PR updates the Makefile which is used to build the stacks in "
"order on Travis CI."
msgstr ""
# fabcb32a80a04a639aebd8b55d38119e
#: ../../maintaining/tasks.md:23
msgid ""
"Create a new repository in the jupyter org on Docker Cloud named after the "
"stack folder in the git repo."
msgstr ""
# 1811dcec60e3433d94514eaeebecb44b
#: ../../maintaining/tasks.md:24
msgid "Grant the stacks team permission to write to the repo."
msgstr ""
# afa7b1fcb0224380a111fe94f7781d60
#: ../../maintaining/tasks.md:25
msgid "Click Builds and then Configure Automated Builds for the repository."
msgstr ""
# 35b969b9f7a442d99f54a73494033d90
#: ../../maintaining/tasks.md:26
msgid "Select jupyter/docker-stacks as the source repository."
msgstr ""
# fe715af4446d409cb4d5ee81255bd86e
#: ../../maintaining/tasks.md:27
msgid ""
"Choose Build on Docker Cloud's infrastructure using a Small node unless you "
"have reason to believe a bigger host is required."
msgstr ""
# dc41895431b64657b5e24a8c96779ca6
#: ../../maintaining/tasks.md:28
msgid ""
"Update the Build Context in the default build rule to be /<name-of-the-"
"stack>."
msgstr ""
# e4d220bf1cb54781bc03f16a17ddafb8
#: ../../maintaining/tasks.md:29
msgid ""
"Toggle Autobuild to disabled unless the stack is a new root stack (e.g., "
"like jupyter/base-notebook)."
msgstr ""
# c5a459d038714ff78d4f156ee227d9ca
#: ../../maintaining/tasks.md:30
msgid ""
"If the new stack depends on the build of another stack in the hierarchy:"
msgstr ""
# 611376c2ec6942479f60129177d312cc
#: ../../maintaining/tasks.md:31
msgid "Hit Save and then click Configure Automated Builds."
msgstr ""
# 81cc56c63891432d89d4df3001f1bcde
#: ../../maintaining/tasks.md:32
msgid "At the very bottom, add a build trigger named Stack hierarchy trigger."
msgstr ""
# 9e55682a966a422c846a3463c7a30cfe
#: ../../maintaining/tasks.md:33
msgid "Copy the build trigger URL."
msgstr ""
# a9d853a1d45b4ead965813822a96c934
#: ../../maintaining/tasks.md:34
msgid ""
"Visit the parent repository Builds page and click Configure Automated "
"Builds."
msgstr ""
# 327d4522c3884247871aa406bbe19402
#: ../../maintaining/tasks.md:35
msgid ""
"Add the URL you copied to the NEXT_BUILD_TRIGGERS environment variable comma"
" separated list of URLs, creating that environment variable if it does not "
"already exist."
msgstr ""
# 1aa0e4b95ab847e0be8ac9647433c991
# 7dfff62380a041968ee6e739b1ca271f
#: ../../maintaining/tasks.md:36 ../../maintaining/tasks.md:40
msgid "Hit Save."
msgstr ""
# 8315ed043efb40238227f8be0ad61b52
#: ../../maintaining/tasks.md:37
msgid "If the new stack should trigger other dependent builds:"
msgstr ""
# 6e0e15d05a544476b91794d10b8732ff
#: ../../maintaining/tasks.md:38
msgid "Add an environment variable named NEXT_BUILD_TRIGGERS."
msgstr ""
# 9dc2029e6360433ab7181187f7040d48
#: ../../maintaining/tasks.md:39
msgid ""
"Copy the build trigger URLs from the dependent builds into the "
"NEXT_BUILD_TRIGGERS comma separated list of URLs."
msgstr ""
# 89165b279d9142e9b8e5d7a923fca2be
#: ../../maintaining/tasks.md:41
msgid ""
"Adjust other NEXT_BUILD_TRIGGERS values as needed so that the build order "
"matches that in the stack hierarchy diagram."
msgstr ""
# 51c8151943794bc8b1d51d65ccd84736
#: ../../maintaining/tasks.md:43
msgid "Adding a New Maintainer Account"
msgstr ""
# 1994c19e7a734b2cad9af0afcd7da31e
#: ../../maintaining/tasks.md:45
msgid "Visit https://cloud.docker.com/app/jupyter/team/stacks/users"
msgstr ""
# 390ccdde528146bbbc3d2f62717a647c
#: ../../maintaining/tasks.md:46
msgid "Add the maintainer's Docker Cloud username."
msgstr ""
# b0227c37244c4b82848cc2655f134d21
#: ../../maintaining/tasks.md:47
msgid ""
"Visit https://github.com/orgs/jupyter/teams/docker-image-maintainers/members"
msgstr ""
# b0fdbdd14b1444d1b696d8367aa111fb
#: ../../maintaining/tasks.md:48
msgid "Add the maintainer's GitHub username."
msgstr ""
# abe2cb04fcb9447496bf3bc9fb230cdc
#: ../../maintaining/tasks.md:50
msgid "Pushing a Build Manually"
msgstr ""
# 3ef85ec6ea0a4a84aecc2bc7e7a5a5fd
#: ../../maintaining/tasks.md:52
msgid ""
"If automated builds on Docker Cloud have got you down, do the following to "
"push a build manually:"
msgstr ""
# 3ebef623fa2f46f49ef639ad17105d4a
#: ../../maintaining/tasks.md:54
msgid "Clone this repository."
msgstr ""
# dcf8e9e8c72e40b9aa23c090311d6ea2
#: ../../maintaining/tasks.md:55
msgid "Check out the git SHA you want to build and publish."
msgstr ""
# fe788ad30f694b1f9b013cabfa820343
#: ../../maintaining/tasks.md:56
msgid "docker login with your Docker Hub/Cloud credentials."
msgstr ""
# 649dc474ffaa483eb625ed8061cb0097
#: ../../maintaining/tasks.md:57
msgid "Run make retry/release-all."
msgstr ""
docs/locale/it/LC_MESSAGES/using.po
0 → 100644
View file @
ae5f7e10
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2018- Project Jupyter
# This file is distributed under the same license as the docker-stacks package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: docker-stacks latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-04-21 17:25-0400\n"
"PO-Revision-Date: 2019-04-22 13:45+0000\n"
"Language-Team: Italian (https://www.transifex.com/project-jupyter/teams/97886/it/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: it\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
# 22b65331d42e414b9320143d30499447
#: ../../using/common.md:1
msgid "Common Features"
msgstr ""
# dd3cb2a88856437aad5f76b607f80deb
#: ../../using/common.md:3
msgid ""
"A container launched from any Jupyter Docker Stacks image runs a Jupyter "
"Notebook server by default. The container does so by executing a start-"
"notebook.sh script. This script configures the internal container "
"environment and then runs jupyter notebook, passing it any command line "
"arguments received."
msgstr ""
# 4bc2911886254b1cafcffcce7d7ef9b3
#: ../../using/common.md:5
msgid ""
"This page describes the options supported by the startup script as well as "
"how to bypass it to run alternative commands."
msgstr ""
# bb55c8d7786e4c1f8e11c1e309931c41
#: ../../using/common.md:7
msgid "Notebook Options"
msgstr ""
# 66f14be1ff1746c1abdccafb894fa2e6
#: ../../using/common.md:9
msgid ""
"You can pass Jupyter command line options to the start-notebook.sh script "
"when launching the container. For example, to secure the Notebook server "
"with a custom password hashed using IPython.lib.passwd() instead of the "
"default token, you can run the following:"
msgstr ""
# 5d73f06cae2c4990a942c76988f19c1f
#: ../../using/common.md:15
msgid ""
"For example, to set the base URL of the notebook server, you can run the "
"following:"
msgstr ""
# 9d43ee0e147b43469f56c4895720f682
#: ../../using/common.md:21
msgid "Docker Options"
msgstr ""
# 3f0f5c9d0b254d829e6f07e0a2ca2544
#: ../../using/common.md:23
msgid ""
"You may instruct the start-notebook.sh script to customize the container "
"environment before launching the notebook server. You do so by passing "
"arguments to the docker run command."
msgstr ""
# 4621c78dfaeb43379c5d3437238b2ef8
#: ../../using/common.md:26
msgid ""
"-e NB_USER=jovyan - Instructs the startup script to change the default "
"container username from jovyan to the provided value. Causes the script to "
"rename the jovyan user home folder. For this option to take effect, you must"
" run the container with --user root and set the working directory -w "
"/home/$NB_USER. This feature is useful when mounting host volumes with "
"specific home folder."
msgstr ""
# 9120ad3c28c84f3fbb2433c79a83907a
#: ../../using/common.md:27
msgid ""
"-e NB_UID=1000 - Instructs the startup script to switch the numeric user ID "
"of $NB_USER to the given value. This feature is useful when mounting host "
"volumes with specific owner permissions. For this option to take effect, you"
" must run the container with --user root. (The startup script will su "
"$NB_USER after adjusting the user ID.) You might consider using modern "
"Docker options --user and --group-add instead. See the last bullet below for"
" details."
msgstr ""
# f2a9954159b546468e50a4d9665dd534
#: ../../using/common.md:28
msgid ""
"-e NB_GID=100 - Instructs the startup script to change the primary group "
"of$NB_USER to $NB_GID (the new group is added with a name of $NB_GROUP if it"
" is defined, otherwise the group is named $NB_USER). This feature is useful"
" when mounting host volumes with specific group permissions. For this option"
" to take effect, you must run the container with --user root. (The startup "
"script will su $NB_USER after adjusting the group ID.) You might consider "
"using modern Docker options --user and --group-add instead. See the last "
"bullet below for details. The user is added to supplemental group users "
"(gid 100) in order to allow write access to the home directory and "
"/opt/conda. If you override the user/group logic, ensure the user stays in "
"group users if you want them to be able to modify files in the image."
msgstr ""
# 1d362c57a99b47e1b3cb571f23c17e67
#: ../../using/common.md:29
msgid ""
"-e NB_GROUP=<name> - The name used for $NB_GID, which defaults to $NB_USER."
" This is only used if $NB_GID is specified and completely optional: there "
"is only cosmetic effect."
msgstr ""
# de1cd66f1e174d519cfcf764a0286773
#: ../../using/common.md:30
msgid ""
"-e NB_UMASK=<umask> - Configures Jupyter to use a different umask value from"
" default, i.e. 022. For example, if setting umask to 002, new files will be "
"readable and writable by group members instead of just writable by the "
"owner. Wikipedia has a good article about umask. Feel free to read it in "
"order to choose the value that better fits your needs. Default value should "
"fit most situations. Note that NB_UMASK when set only applies to the Jupyter"
" process itself - you cannot use it to set a umask for additional files "
"created during run-hooks e.g. via pip or conda - if you need to set a umask "
"for these you must set umask for each command."
msgstr ""
# 325f270ee0484e728c638fb0ca4c9c93
#: ../../using/common.md:31
msgid ""
"-e CHOWN_HOME=yes - Instructs the startup script to change the $NB_USER home"
" directory owner and group to the current value of $NB_UID and $NB_GID. This"
" change will take effect even if the user home directory is mounted from the"
" host using -v as described below. The change is not applied recursively by "
"default. You can change modify the chown behavior by setting CHOWN_HOME_OPTS"
" (e.g., -e CHOWN_HOME_OPTS='-R')."
msgstr ""
# 85b3d1d9890c46b08bb62370c6ed93a2
#: ../../using/common.md:32
msgid ""
"-e CHOWN_EXTRA=\"<some dir>,<some other dir>\" - Instructs the startup "
"script to change the owner and group of each comma-separated container "
"directory to the current value of $NB_UID and $NB_GID. The change is not "
"applied recursively by default. You can change modify the chown behavior by "
"setting CHOWN_EXTRA_OPTS (e.g., -e CHOWN_EXTRA_OPTS='-R')."
msgstr ""
# bb7a47817b734d7ab9d95e4c4f18911f
#: ../../using/common.md:33
msgid ""
"-e GRANT_SUDO=yes - Instructs the startup script to grant the NB_USER user "
"passwordless sudo capability. You do not need this option to allow the user "
"to conda or pip install additional packages. This option is useful, however,"
" when you wish to give $NB_USER the ability to install OS packages with apt "
"or modify other root-owned files in the container. For this option to take "
"effect, you must run the container with --user root. (The start-notebook.sh "
"script will su $NB_USER after adding $NB_USER to sudoers.) You should only "
"enable sudo if you trust the user or if the container is running on an "
"isolated host."
msgstr ""
# d148b1f0275342b0bf231ae5e819590f
#: ../../using/common.md:34
msgid ""
"-e GEN_CERT=yes - Instructs the startup script to generates a self-signed "
"SSL certificate and configure Jupyter Notebook to use it to accept encrypted"
" HTTPS connections."
msgstr ""
# aafdc956c76142a0acfe467ffde5ce68
#: ../../using/common.md:35
msgid ""
"-e JUPYTER_ENABLE_LAB=yes - Instructs the startup script to run jupyter lab "
"instead of the default jupyter notebook command. Useful in container "
"orchestration environments where setting environment variables is easier "
"than change command line parameters."
msgstr ""
# 9a4fc69536fa4e8580ed4f5e77d338f0
#: ../../using/common.md:36
msgid ""
"-v /some/host/folder/for/work:/home/jovyan/work - Mounts a host machine "
"directory as folder in the container. Useful when you want to preserve "
"notebooks and other work even after the container is destroyed. You must "
"grant the within-container notebook user or group (NB_UID or NB_GID) write "
"access to the host directory (e.g., sudo chown 1000 "
"/some/host/folder/for/work)."
msgstr ""
# 684334b1f55b42e4a05e194f3a3a3497
#: ../../using/common.md:37
msgid ""
"--user 5000 --group-add users - Launches the container with a specific user "
"ID and adds that user to the users group so that it can modify files in the "
"default home directory and /opt/conda. You can use these arguments as "
"alternatives to setting $NB_UID and $NB_GID."
msgstr ""
# 42df7956876a4592be13f4ce3c9c8f54
#: ../../using/common.md:39
msgid "Startup Hooks"
msgstr ""
# c8d2e31d4d0544a486a070c4cc7d8afd
#: ../../using/common.md:41
msgid ""
"You can further customize the container environment by adding shell scripts "
"(*.sh) to be sourced or executables (chmod +x) to be run to the paths below:"
msgstr ""
# 473e6aea1cbc4e50b75eec179a476b46
#: ../../using/common.md:44
msgid ""
"/usr/local/bin/start-notebook.d/ - handled before any of the standard "
"options noted above are applied"
msgstr ""
# f9d0cc48b06f4cbfa911ef6169222f6b
#: ../../using/common.md:46
msgid ""
"/usr/local/bin/before-notebook.d/ - handled after all of the standard "
"options noted above are applied and just before the notebook server launches"
msgstr ""
# 68e7bf5e72d747f886129a962ae84eef
#: ../../using/common.md:49
msgid ""
"See the run-hooks function in the jupyter/base-notebook start.sh script for "
"execution details."
msgstr ""
# 7a9436da93a34647a59ee4cc77be5300
#: ../../using/common.md:52
msgid "SSL Certificates"
msgstr ""
# e69958fe476445eda760433dcc2fac24
#: ../../using/common.md:54
msgid ""
"You may mount SSL key and certificate files into a container and configure "
"Jupyter Notebook to use them to accept HTTPS connections. For example, to "
"mount a host folder containing a notebook.key and notebook.crt and use them,"
" you might run the following:"
msgstr ""
# b38385bb5753460397e87480c71d621f
#: ../../using/common.md:64
msgid ""
"Alternatively, you may mount a single PEM file containing both the key and "
"certificate. For example:"
msgstr ""
# 7867b25df06444e8b7bd0c87292cafd8
#: ../../using/common.md:73
msgid ""
"In either case, Jupyter Notebook expects the key and certificate to be a "
"base64 encoded text file. The certificate file or PEM may contain one or "
"more certificates (e.g., server, intermediate, and root)."
msgstr ""
# 030c5c35440b45d8b1a82abdb946609f
#: ../../using/common.md:75
msgid "For additional information about using SSL, see the following:"
msgstr ""
# a50ac1b5bbc749e8a5c4f9ecbd523d14
#: ../../using/common.md:77
msgid ""
"The docker-stacks/examples for information about how to use Let's Encrypt "
"certificates when you run these stacks on a publicly visible domain."
msgstr ""
# 9cc027cb57c044a782068bf45d3bc22e
#: ../../using/common.md:78
msgid ""
"The jupyter_notebook_config.py file for how this Docker image generates a "
"self-signed certificate."
msgstr ""
# dbfcfb88b099481781c8f3b3011a73e9
#: ../../using/common.md:79
msgid ""
"The Jupyter Notebook documentation for best practices about securing a "
"public notebook server in general."
msgstr ""
# f8fcaea33627485799126c6b6e08e7dc
#: ../../using/common.md:81
msgid "Alternative Commands"
msgstr ""
# 10a9b432d6dd4a8a804da1976d27127e
#: ../../using/common.md:83
msgid "start.sh"
msgstr ""
# 3dca69ef1ed44f08a99c8a3f82645ffa
#: ../../using/common.md:85
msgid ""
"The start-notebook.sh script actually inherits most of its option handling "
"capability from a more generic start.sh script. The start.sh script supports"
" all of the features described above, but allows you to specify an arbitrary"
" command to execute. For example, to run the text-based ipython console in a"
" container, do the following:"
msgstr ""
# f9ade4ab67f54867a79b59937239d9a7
#: ../../using/common.md:91
msgid ""
"Or, to run JupyterLab instead of the classic notebook, run the following:"
msgstr ""
# 4575181991e844a1bc113b6c2821d0d8
#: ../../using/common.md:97
msgid ""
"This script is particularly useful when you derive a new Dockerfile from "
"this image and install additional Jupyter applications with subcommands like"
" jupyter console, jupyter kernelgateway, etc."
msgstr ""
# d4d085e167a942709b72de803ee03bc0
#: ../../using/common.md:99
msgid "Others"
msgstr ""
# 34c4fb744a514987b41ad23dba573c46
#: ../../using/common.md:101
msgid ""
"You can bypass the provided scripts and specify your an arbitrary start "
"command. If you do, keep in mind that features supported by the start.sh "
"script and its kin will not function (e.g., GRANT_SUDO)."
msgstr ""
# bcd8d95440b2493a9ffbca0678a14ed9
#: ../../using/common.md:103
msgid "Conda Environments"
msgstr ""
# 9f62047ae18e44e3bad5b3a183a3683a
#: ../../using/common.md:105
msgid ""
"The default Python 3.x Conda environment resides in /opt/conda. The "
"/opt/conda/bin directory is part of the default jovyan user's $PATH. That "
"directory is also whitelisted for use in sudo commands by the start.sh "
"script."
msgstr ""
# 6c8c478e872d444b904fecd01e9911da
#: ../../using/common.md:107
msgid ""
"The jovyan user has full read/write access to the /opt/conda directory. You "
"can use either conda or pip to install new packages without any additional "
"permissions."
msgstr ""
# cdff04cd2c814d2a993dcf793c1a32a0
#: ../../using/recipes.md:1
msgid "Contributed Recipes"
msgstr ""
# 674d282d2bc64a07b2d1aae14a954453
#: ../../using/recipes.md:3
msgid ""
"Users sometimes share interesting ways of using the Jupyter Docker Stacks. "
"We encourage users to contribute these recipes to the documentation in case "
"they prove useful to other members of the community by submitting a pull "
"request to docs/using/recipes.md. The sections below capture this knowledge."
msgstr ""
# a01a0ec46bc8469290ee140a69d6b0a4
#: ../../using/recipes.md:5
msgid "Using pip install or conda install in a Child Docker image"
msgstr ""
# 95d414d34880400bb6f17842eaacdb47
#: ../../using/recipes.md:7
msgid "Create a new Dockerfile like the one shown below."
msgstr ""
# 1fa3f126a9a6401d9941748e79380f8e
#: ../../using/recipes.md:16
msgid "Then build a new image."
msgstr ""
# 1bff41f678f847d98ffa744cf037c502
#: ../../using/recipes.md:22
msgid ""
"To use a requirements.txt file, first create your requirements.txt file with"
" the listing of packages desired. Next, create a new Dockerfile like the "
"one shown below."
msgstr ""
# a11c4c3379f64b4f8028d4b4c7437292
#: ../../using/recipes.md:35
msgid "For conda, the Dockerfile is similar:"
msgstr ""
# 42213789b3a14b02a491455f3bcdfa9a
#: ../../using/recipes.md:47
msgid "Ref: docker-stacks/commit/79169618d571506304934a7b29039085e77db78c"
msgstr ""
# 471f68531d274ce4a7ad2a9f4274d8a9
#: ../../using/recipes.md:49
msgid "Add a Python 2.x environment"
msgstr ""
# c721d45a7e9e4ce99799d587a7aa0921
#: ../../using/recipes.md:51
msgid ""
"Python 2.x was removed from all images on August 10th, 2017, starting in tag"
" cc9feab481f7. You can add a Python 2.x environment by defining your own "
"Dockerfile inheriting from one of the images like so:"
msgstr ""
# e07ac0abd67c4bb2a746953b44cd2ba8
#: ../../using/recipes.md:73
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/440"
msgstr ""
# 88ae461b17e140a1ae71a9c175b4bd0d
#: ../../using/recipes.md:75
msgid "Run JupyterLab"
msgstr ""
# dbf08b368b5346ec8f6549737e561e5f
#: ../../using/recipes.md:77
msgid ""
"JupyterLab is preinstalled as a notebook extension starting in tag "
"c33a7dc0eece."
msgstr ""
# 866e89573c5d4a70abd44bf374ed2e62
#: ../../using/recipes.md:79
msgid ""
"Run jupyterlab using a command such as docker run -it --rm -p 8888:8888 "
"jupyter/datascience-notebook start.sh jupyter lab"
msgstr ""
# 1531d01600af476b8401421c9305cdf3
#: ../../using/recipes.md:81
msgid "Let's Encrypt a Notebook server"
msgstr ""
# ac1d8a654ce64ec3b318d9c341602e1a
#: ../../using/recipes.md:83
msgid ""
"See the README for the simple automation here https://github.com/jupyter"
"/docker-stacks/tree/master/examples/make-deploy which includes steps for "
"requesting and renewing a Let's Encrypt certificate."
msgstr ""
# 17ac8453774a4b028df89f2bdb3feec1
#: ../../using/recipes.md:85
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/78"
msgstr ""
# 020d1144ff094e49ba690fd3292bad1a
#: ../../using/recipes.md:87
msgid "Slideshows with Jupyter and RISE"
msgstr ""
# b84e3e74e66349a695be5f2eb177757b
#: ../../using/recipes.md:89
msgid ""
"RISE allows via extension to create live slideshows of your notebooks, with "
"no conversion, adding javascript Reveal.js:"
msgstr ""
# 14fd425e7dad41c9b00fee87d7d2225e
#: ../../using/recipes.md:95
msgid "Credit: Paolo D. based on docker-stacks/issues/43"
msgstr ""
# 3e38842bbf0244f5897f995d7744d4ed
#: ../../using/recipes.md:97
msgid "xgboost"
msgstr ""
# daf9711129e84131ad1f676e646f9e03
#: ../../using/recipes.md:99
msgid ""
"You need to install conda's gcc for Python xgboost to work properly. "
"Otherwise, you'll get an exception about libgomp.so.1 missing GOMP_4.0."
msgstr ""
# faf7639219434c4d902b0e9bd6e626c2
#: ../../using/recipes.md:109
msgid "Running behind a nginx proxy"
msgstr ""
# 912ad155cb4a45069d9e8ec8b1b87cb0
#: ../../using/recipes.md:111
msgid ""
"Sometimes it is useful to run the Jupyter instance behind a nginx proxy, for"
" instance:"
msgstr ""
# 7adc9717c9f84756963824bb3b851eda
#: ../../using/recipes.md:113
msgid ""
"you would prefer to access the notebook at a server URL with a path "
"(https://example.com/jupyter) rather than a port (https://example.com:8888)"
msgstr ""
# 1ed3d2d40ad948b19f6d1b5777c13f5f
#: ../../using/recipes.md:114
msgid ""
"you may have many different services in addition to Jupyter running on the "
"same server, and want to nginx to help improve server performance in manage "
"the connections"
msgstr ""
# 276ccfb626504c1fbe8d645f1c82a24f
#: ../../using/recipes.md:116
msgid ""
"Here is a quick example NGINX configuration to get started. You'll need a "
"server, a .crt and .key file for your server, and docker & docker-compose "
"installed. Then just download the files at that gist and run docker-compose"
" up -d to test it out. Customize the nginx.conf file to set the desired "
"paths and add other services."
msgstr ""
# ba9a795db881452d8a815f3bf2f3aa7a
#: ../../using/recipes.md:118
msgid "Host volume mounts and notebook errors"
msgstr ""
# 3cecb98fa6e54f99a09a04b81a4bc04e
#: ../../using/recipes.md:120
msgid ""
"If you are mounting a host directory as /home/jovyan/work in your container "
"and you receive permission errors or connection errors when you create a "
"notebook, be sure that the jovyan user (UID=1000 by default) has read/write "
"access to the directory on the host. Alternatively, specify the UID of the "
"jovyan user on container startup using the -e NB_UID option described in the"
" Common Features, Docker Options section"
msgstr ""
# b71f0c2e0f184959a9a6f0765b9f0b4e
#: ../../using/recipes.md:122
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/199"
msgstr ""
# 29b6203639a444d38051b7dd23195ad5
#: ../../using/recipes.md:124
msgid "Manpage installation"
msgstr ""
# a4261a1c819e48ef848fb16bacd237dd
#: ../../using/recipes.md:126
msgid ""
"Most containers, including our Ubuntu base image, ship without manpages "
"installed to save space. You can use the following dockerfile to inherit "
"from one of our images to enable manpages:"
msgstr ""
# df6c0841b76247a893a7494d446d63ad
#: ../../using/recipes.md:151
msgid ""
"Adding the documentation on top of an existing singleuser image wastes a lot"
" of space and requires reinstalling every system package, which can take "
"additional time and bandwidth; the datascience-notebook image has been shown"
" to grow by almost 3GB when adding manapages in this way. Enabling manpages "
"in the base Ubuntu layer prevents this container bloat:"
msgstr ""
# b41452481f5d421fa005b0e1a33bf9b4
#: ../../using/recipes.md:173
msgid ""
"Be sure to check the current base image in base-notebook before building."
msgstr ""
# 7b0274764c614b46b0a2e663231e59b7
#: ../../using/recipes.md:175
msgid "JupyterHub"
msgstr ""
# ccf49b18478443ecbd9fd7fc9c171cd9
#: ../../using/recipes.md:177
msgid "We also have contributed recipes for using JupyterHub."
msgstr ""
# e5835af60f9c4bfeb8e6995d703f730e
#: ../../using/recipes.md:179
msgid "Use JupyterHub's dockerspawner"
msgstr ""
# 9305102339904086861ef2246beb8f08
#: ../../using/recipes.md:181
msgid ""
"In most cases for use with DockerSpawner, given any image that already has a"
" notebook stack set up, you would only need to add:"
msgstr ""
# 5d92054033604627ae5b3161c3d0b903
#: ../../using/recipes.md:183
msgid "install the jupyterhub-singleuser script (for the right Python)"
msgstr ""
# fcf37a1789f84906bde9085583cff95b
#: ../../using/recipes.md:184
msgid "change the command to launch the single-user server"
msgstr ""
# e6f1488b2ffb4beaa2414ca545f10261
#: ../../using/recipes.md:186
msgid ""
"Swapping out the FROM line in the jupyterhub/singleuser Dockerfile should be"
" enough for most cases."
msgstr ""
# bbd864e6695a4cca862d9fa909b51dc0
#: ../../using/recipes.md:188
msgid ""
"Credit: Justin Tyberg, quanghoc, and Min RK based on docker-"
"stacks/issues/124 and docker-stacks/pull/185"
msgstr ""
# 260577d0e15f4102bbad7486357528d4
#: ../../using/recipes.md:190
msgid "Containers with a specific version of JupyterHub"
msgstr ""
# 041f84f19f0e4d4c8b050a2ccc2cb812
#: ../../using/recipes.md:192
msgid ""
"To use a specific version of JupyterHub, the version of jupyterhub in your "
"image should match the version in the Hub itself."
msgstr ""
# 41410dcc4e264932b64e96e6857b1bd3
#: ../../using/recipes.md:199
msgid "Credit: MinRK"
msgstr ""
# 68fe2ae525474d91af1d8647378f078b
#: ../../using/recipes.md:202
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/177"
msgstr ""
# 3b6b7a3b35aa42a8a70a5c9e91af21d2
#: ../../using/recipes.md:204
msgid "Spark"
msgstr ""
# 8d1092f2b1a64da292134b240b621f48
#: ../../using/recipes.md:206
msgid ""
"A few suggestions have been made regarding using Docker Stacks with spark."
msgstr ""
# 54e47498667747d1a7f576895d140c6f
#: ../../using/recipes.md:208
msgid "Using PySpark with AWS S3"
msgstr ""
# 127111e623114603b4c841b66ce8f16f
#: ../../using/recipes.md:210
msgid "Using Spark session for hadoop 2.7.3"
msgstr ""
# 5454399deea24bb2a166ddd1fd168752
#: ../../using/recipes.md:230
msgid "Using Spark context for hadoop 2.6.0"
msgstr ""
# af0c5beb70664b74b6798a869023b3ca
#: ../../using/recipes.md:252
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/127"
msgstr ""
# 56531d33de8c46bb853db7ecef65d1ef
#: ../../using/recipes.md:254
msgid "Using Local Spark JARs"
msgstr ""
# 783af638cf454b6ea8bfd04df9da967f
#: ../../using/recipes.md:270
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/154"
msgstr ""
# 80df4b671dc64d9bad9bd2915524fe02
#: ../../using/recipes.md:272
msgid "Using spark-packages.org"
msgstr ""
# 14c79ea3fbf446fc92ab63c36e874f96
#: ../../using/recipes.md:274
msgid ""
"If you'd like to use packages from spark-packages.org, see "
"https://gist.github.com/parente/c95fdaba5a9a066efaab for an example of how "
"to specify the package identifier in the environment before creating a "
"SparkContext."
msgstr ""
# 5a1cab88fa6c477a99f4352670b6cf76
#: ../../using/recipes.md:276
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/43"
msgstr ""
# 753a64e86395492481c9541dcb91f0ed
#: ../../using/recipes.md:278
msgid "Use jupyter/all-spark-notebooks with an existing Spark/YARN cluster"
msgstr ""
# 53fbe7a910d84359af93acf195711ffd
#: ../../using/recipes.md:342
msgid "Credit: britishbadger from docker-stacks/issues/369"
msgstr ""
# c82c3fc2484d48d5889dd8e3e79723b2
#: ../../using/recipes.md:344
msgid ""
"Run Jupyter Notebook/Lab inside an already secured environment (i.e., with "
"no token)"
msgstr ""
# 53c63d298efa42cab5d39c3b242d44e0
#: ../../using/recipes.md:346
msgid "(Adapted from issue 728)"
msgstr ""
# cb4bd116d7334212b7fa5a78602e370d
#: ../../using/recipes.md:348
msgid ""
"The default security is very good. There are use cases, encouraged by "
"containers, where the jupyter container and the system it runs within, lie "
"inside the security boundary. In these use cases it is convenient to launch "
"the server without a password or token. In this case, you should use the "
"start.sh script to launch the server with no token:"
msgstr ""
# 59cd4c1e695f42c09ea911048769f8b7
#: ../../using/recipes.md:354
msgid "For jupyterlab:"
msgstr ""
# 49d382c7a9c14ddda58b2e88521dc3bc
#: ../../using/recipes.md:360
msgid "For jupyter classic:"
msgstr ""
# 297f3ad3d8504a75a0fd5659fa73b67c
#: ../../using/recipes.md:365
msgid ""
"Enable nbextension spellchecker for markdown (or any other nbextension)"
msgstr ""
# e2b10f15c91e4db9b7898a1a191526c7
#: ../../using/recipes.md:367
msgid "NB: this works for classic notebooks only"
msgstr ""
# 158be3dba029417b832640f01cd22f75
#: ../../using/recipes.md:380
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/675"
msgstr ""
# ade5800ecee24c9eb4f16af9585951fc
#: ../../using/running.md:1
msgid "Running a Container"
msgstr ""
# da480368616a4ffa976061bdc0128763
# 1b0a0481a9454392a32c005d7513e453
#: ../../using/running.md:3 ../../using/selecting.md:7
msgid "Using one of the Jupyter Docker Stacks requires two choices:"
msgstr ""
# d94683d29b6341a98420c4e6adebc4bb
# 436b43aa9da944d281cf51ea731d286a
#: ../../using/running.md:5 ../../using/selecting.md:9
msgid "Which Docker image you wish to use"
msgstr ""
# de5bb072aa194beebbf587038b36bdcf
# fca43aa36e854a9ab4d2b2816c015847
#: ../../using/running.md:6 ../../using/selecting.md:10
msgid "How you wish to start Docker containers from that image"
msgstr ""
# 19634063eb14436daa48af3b1ee3fcc5
#: ../../using/running.md:8
msgid "This section provides details about the second."
msgstr ""
# b855cc98da54497fa98956b68d00e840
#: ../../using/running.md:10
msgid "Using the Docker CLI"
msgstr ""
# 555174be66b049e2ad53de52d8e37aa0
#: ../../using/running.md:12
msgid ""
"You can launch a local Docker container from the Jupyter Docker Stacks using"
" the Docker command line interface. There are numerous ways to configure "
"containers using the CLI. The following are some common patterns."
msgstr ""
# d433157f1f834a66b66143513ffe8c9d
#: ../../using/running.md:14
msgid ""
"Example 1 This command pulls the jupyter/scipy-notebook image tagged "
"2c80cf3537ca from Docker Hub if it is not already present on the local host."
" It then starts a container running a Jupyter Notebook server and exposes "
"the server on host port 8888. The server logs appear in the terminal and "
"include a URL to the notebook server."
msgstr ""
# 3a56c8c4932644e6b938b5401fb98d26
#: ../../using/running.md:36
msgid ""
"Pressing Ctrl-C shuts down the notebook server but leaves the container "
"intact on disk for later restart or permanent deletion using commands like "
"the following:"
msgstr ""
# e3f24ae3050d452aa42f3a92ba36f61c
#: ../../using/running.md:55
msgid ""
"Example 2 This command pulls the jupyter/r-notebook image tagged "
"e5c5a7d3e52d from Docker Hub if it is not already present on the local host."
" It then starts a container running a Jupyter Notebook server and exposes "
"the server on host port 10000. The server logs appear in the terminal and "
"include a URL to the notebook server, but with the internal container port "
"(8888) instead of the the correct host port (10000)."
msgstr ""
# d54172836b0349cb8e8ccbcb6c33ec45
#: ../../using/running.md:77
msgid ""
"Pressing Ctrl-C shuts down the notebook server and immediately destroys the "
"Docker container. Files written to ~/work in the container remain touched. "
"Any other changes made in the container are lost."
msgstr ""
# 0d90bfa0543f4669a0b2bb4b62e2e7dc
#: ../../using/running.md:79
msgid ""
"Example 3 This command pulls the jupyter/all-spark-notebook image currently "
"tagged latest from Docker Hub if an image tagged latest is not already "
"present on the local host. It then starts a container named notebook running"
" a JupyterLab server and exposes the server on a randomly selected port."
msgstr ""
# 04e49785faff4511b8576e9d997bea67
#: ../../using/running.md:85
msgid ""
"The assigned port and notebook server token are visible using other Docker "
"commands."
msgstr ""
# f88af44236f948ccbda342b1c93364d3
#: ../../using/running.md:99
msgid ""
"Together, the URL to visit on the host machine to access the server in this "
"case is "
"http://localhost:32769?token=15914ca95f495075c0aa7d0e060f1a78b6d94f70ea373b00."
msgstr ""
# ed09c347d7aa4dd79e505562f4f5efdd
#: ../../using/running.md:101
msgid ""
"The container runs in the background until stopped and/or removed by "
"additional Docker commands."
msgstr ""
# 7fdc11c0394e4af88bb3c3178814d184
#: ../../using/running.md:113
msgid "Using Binder"
msgstr ""
# 69b162f507f14323b3dbf8758e2964b2
#: ../../using/running.md:115
msgid ""
"Binder is a service that allows you to create and share custom computing "
"environments for projects in version control. You can use any of the Jupyter"
" Docker Stacks images as a basis for a Binder-compatible Dockerfile. See the"
" docker-stacks example and Using a Dockerfile sections in the Binder "
"documentation for instructions."
msgstr ""
# f148f5335f354e549f00dce0cc630475
#: ../../using/running.md:117
msgid "Using JupyterHub"
msgstr ""
# a23469fb52db4edfb3e98c1dc3115b50
#: ../../using/running.md:119
msgid ""
"You can configure JupyterHub to launcher Docker containers from the Jupyter "
"Docker Stacks images. If you've been following the Zero to JupyterHub with "
"Kubernetes guide, see the Use an existing Docker image section for details. "
"If you have a custom JupyterHub deployment, see the Picking or building a "
"Docker image instructions for the dockerspawner instead."
msgstr ""
# bb8d103e20df4ebab2321ae4eee584e7
#: ../../using/running.md:121
msgid "Using Other Tools and Services"
msgstr ""
# c6ef8c5aac54431d931df9f5d5f890d5
#: ../../using/running.md:123
msgid ""
"You can use the Jupyter Docker Stacks with any Docker-compatible technology "
"(e.g., Docker Compose, docker-py, your favorite cloud container service). "
"See the documentation of the tool, library, or service for details about how"
" to reference, configure, and launch containers from these images."
msgstr ""
# d34ba542e6ed43a7b490cfa65b67d9c3
#: ../../using/selecting.md:1
msgid "Selecting an Image"
msgstr ""
# 70b39f1dbdb242599b33cd78bbe6a850
# cb08cf9b24364322a943a40bea1fd39f
#: ../../using/selecting.md:3 ../../using/selecting.md:14
msgid "Core Stacks"
msgstr ""
# 7a8f664007004185a07b672d25205ca2
# 5040afcacc8d4cdeb5bc9b0ed6a06c88
#: ../../using/selecting.md:4 ../../using/selecting.md:123
msgid "Image Relationships"
msgstr ""
# e364abca4ff948f5a6dba4d5685f9fe8
# ae86feb2ae9c4ed081379460d4a559fb
#: ../../using/selecting.md:5 ../../using/selecting.md:141
msgid "Community Stacks"
msgstr ""
# 27b83c7429d142b89e0e425b662e94a9
#: ../../using/selecting.md:12
msgid "This section provides details about the first."
msgstr ""
# b24fe11f42e84aaf8d2378535737148e
#: ../../using/selecting.md:16
msgid ""
"The Jupyter team maintains a set of Docker image definitions in the "
"https://github.com/jupyter/docker-stacks GitHub repository. The following "
"sections describe these images including their contents, relationships, and "
"versioning strategy."
msgstr ""
# 6562071d34574731baa6241fc067690c
#: ../../using/selecting.md:18
msgid "jupyter/base-notebook"
msgstr ""
# 79c95b7cb9df4670a0fab5737942396f
# 2d8e2926bd6f4db69959f5f0456c4682
# 6d074c8de6fd4895b715a3525ccb8bb4
# 7337ce8d03e5474887cd6affc21ec03b
# 2fb0a6afd5b24c33820ccaed19dd886d
# 1ad0f64aec2c4439937fa4d02ee0fe49
# f955c9a3be324d2db1f47a643b9d51a3
# 667016f994f84648853707ce13241d45
#: ../../using/selecting.md:20 ../../using/selecting.md:37
#: ../../using/selecting.md:49 ../../using/selecting.md:63
#: ../../using/selecting.md:76 ../../using/selecting.md:87
#: ../../using/selecting.md:100 ../../using/selecting.md:112
msgid "Source on GitHub | Dockerfile commit history | Docker Hub image tags"
msgstr ""
# 864aa76e1043469fa96b27f26dcad7d1
#: ../../using/selecting.md:24
msgid ""
"jupyter/base-notebook is a small image supporting the options common across "
"all core stacks. It is the basis for all other stacks."
msgstr ""
# d869d6c4081e483180f51de5f5e225a7
#: ../../using/selecting.md:26
msgid ""
"Minimally-functional Jupyter Notebook server (e.g., no pandoc for saving "
"notebooks as PDFs)"
msgstr ""
# d6384943a3394b9d9a5a505e2387d392
#: ../../using/selecting.md:27
msgid "Miniconda Python 3.x in /opt/conda"
msgstr ""
# 031a321f6173495daef86225cd234a72
#: ../../using/selecting.md:28
msgid "No preinstalled scientific computing packages"
msgstr ""
# e37862b78262475182c34461d2fae08e
#: ../../using/selecting.md:29
msgid ""
"Unprivileged user jovyan (uid=1000, configurable, see options) in group "
"users (gid=100) with ownership over the /home/jovyan and /opt/conda paths"
msgstr ""
# cdd04f4dbb864e82b8b993ccb1670687
#: ../../using/selecting.md:30
msgid ""
"tini as the container entrypoint and a start-notebook.sh script as the "
"default command"
msgstr ""
# 0e3cf3b3a6e540be861ef295f1808099
#: ../../using/selecting.md:31
msgid ""
"A start-singleuser.sh script useful for launching containers in JupyterHub"
msgstr ""
# 3b561d51339f422d801a408007ca16f3
#: ../../using/selecting.md:32
msgid ""
"A start.sh script useful for running alternative commands in the container "
"(e.g. ipython, jupyter kernelgateway, jupyter lab)"
msgstr ""
# 9e8346716bc148fb8df45bce44fa7c38
#: ../../using/selecting.md:33
msgid "Options for a self-signed HTTPS certificate and passwordless sudo"
msgstr ""
# ee56473bbb334a9b96db5870f6be611c
#: ../../using/selecting.md:35
msgid "jupyter/minimal-notebook"
msgstr ""
# eec9e5e3162343eba481b73cc223fa49
#: ../../using/selecting.md:41
msgid ""
"jupyter/minimal-notebook adds command line tools useful when working in "
"Jupyter applications."
msgstr ""
# cf19dcbf0d084508924f166d2b0fa7e3
#: ../../using/selecting.md:43
msgid "Everything in jupyter/base-notebook"
msgstr ""
# 52d17abfd2f14628a9937f1b7584582d
#: ../../using/selecting.md:44
msgid "Pandoc and TeX Live for notebook document conversion"
msgstr ""
# b81070edc9c849c184be4687ce17b786
#: ../../using/selecting.md:45
msgid "git, emacs, jed, nano, tzdata, and unzip"
msgstr ""
# aa65fcb5d17649bb88ded23f0880e147
#: ../../using/selecting.md:47
msgid "jupyter/r-notebook"
msgstr ""
# 54b4b695a8ed493bb79993e62dd164c2
#: ../../using/selecting.md:53
msgid "jupyter/r-notebook includes popular packages from the R ecosystem."
msgstr ""
# d83a0f40bfc34554a0c362f02c656e55
# c27e75f042064ae0a64447053b46785e
#: ../../using/selecting.md:55 ../../using/selecting.md:69
msgid "Everything in jupyter/minimal-notebook and its ancestor images"
msgstr ""
# 99e3f1d20553480c81dda15a66369f52
#: ../../using/selecting.md:56
msgid "The R interpreter and base environment"
msgstr ""
# 34bc2c80ad014b019fb54fc1fad024c4
# 8c5a996a6b0c4309810071f5194f532a
#: ../../using/selecting.md:57 ../../using/selecting.md:119
msgid "IRKernel to support R code in Jupyter notebooks"
msgstr ""
# a24d121e485e4bd9bbe4df9883a7c148
#: ../../using/selecting.md:58
msgid ""
"tidyverse packages, including ggplot2, dplyr, tidyr, readr, purrr, tibble, "
"stringr, lubridate, and broom from conda-forge"
msgstr ""
# d49e405f45dd40a69e64b1636f69381d
#: ../../using/selecting.md:59
msgid ""
"plyr, devtools, shiny, rmarkdown, forecast, rsqlite, reshape2, nycflights13,"
" caret, rcurl, and randomforest packages from conda-forge"
msgstr ""
# 9cfe9452daa04dfc982c2d99948a37eb
#: ../../using/selecting.md:61
msgid "jupyter/scipy-notebook"
msgstr ""
# 47f831c00a78451bb75de1467d90d34c
#: ../../using/selecting.md:67
msgid ""
"jupyter/scipy-notebook includes popular packages from the scientific Python "
"ecosystem."
msgstr ""
# da192888520b4b2ca9ae8ca5162aba6c
#: ../../using/selecting.md:70
msgid ""
"pandas, numexpr, matplotlib, scipy, seaborn, scikit-learn, scikit-image, "
"sympy, cython, patsy, statsmodel, cloudpickle, dill, numba, bokeh, "
"sqlalchemy, hdf5, vincent, beautifulsoup, protobuf, and xlrd packages"
msgstr ""
# be048a3494074da99c0f5b98454feda8
#: ../../using/selecting.md:71
msgid "ipywidgets for interactive visualizations in Python notebooks"
msgstr ""
# c3e92433ff5f4702beeaea78d6ee6fd7
#: ../../using/selecting.md:72
msgid "Facets for visualizing machine learning datasets"
msgstr ""
# ff01e76ad1544fb48e024a617ae932b5
#: ../../using/selecting.md:74
msgid "jupyter/tensorflow-notebook"
msgstr ""
# bf2f117cf3a047aa8be8cd73f4080455
#: ../../using/selecting.md:80
msgid ""
"jupyter/tensorflow-notebook includes popular Python deep learning libraries."
msgstr ""
# 1fccef5b590549ffb4ea6933eaf12674
# 1140d31915eb42fc89725521ec90c1dc
#: ../../using/selecting.md:82 ../../using/selecting.md:106
msgid "Everything in jupyter/scipy-notebook and its ancestor images"
msgstr ""
# 099eb36a6961440b8bea7901b226a96d
#: ../../using/selecting.md:83
msgid "tensorflow and keras machine learning libraries"
msgstr ""
# 13413eabaac34b94b4bc5ae28e445dda
#: ../../using/selecting.md:85
msgid "jupyter/datascience-notebook"
msgstr ""
# 23244942c9ef4eb8aba10cd558bf5fe9
#: ../../using/selecting.md:91
msgid ""
"jupyter/datascience-notebook includes libraries for data analysis from the "
"Julia, Python, and R communities."
msgstr ""
# 7e65863f6a0840729876d3669158c4ce
#: ../../using/selecting.md:93
msgid ""
"Everything in the jupyter/scipy-notebook and jupyter/r-notebook images, and "
"their ancestor images"
msgstr ""
# 6246f4a0d2454714860e4ffa80aef958
#: ../../using/selecting.md:94
msgid "The Julia compiler and base environment"
msgstr ""
# 143e63b9b0a9418a8c93870f6186808e
#: ../../using/selecting.md:95
msgid "IJulia to support Julia code in Jupyter notebooks"
msgstr ""
# 7a170fe5f6a949cc939d2f40200b3336
#: ../../using/selecting.md:96
msgid "HDF5, Gadfly, and RDatasets packages"
msgstr ""
# 4b741debc1e84661ab63b8bf0d9c3bbe
#: ../../using/selecting.md:98
msgid "jupyter/pyspark-notebook"
msgstr ""
# 815f62ec44f54dbfaa5a052d15580b94
#: ../../using/selecting.md:104
msgid ""
"jupyter/pyspark-notebook includes Python support for Apache Spark, "
"optionally on Mesos."
msgstr ""
# 0cb03ee6cd9d488597be17be045f3b74
#: ../../using/selecting.md:107
msgid "Apache Spark with Hadoop binaries"
msgstr ""
# 977ee95d9f664fe2a62505e0a78b1447
#: ../../using/selecting.md:108
msgid "Mesos client libraries"
msgstr ""
# 43c0814f5a024a598dd26a4af0212cea
#: ../../using/selecting.md:110
msgid "jupyter/all-spark-notebook"
msgstr ""
# 0c1536b3ff6d40a885e9cdd881dc19bd
#: ../../using/selecting.md:116
msgid ""
"jupyter/all-spark-notebook includes Python, R, and Scala support for Apache "
"Spark, optionally on Mesos."
msgstr ""
# ecf9548ffc5e4e0eb4bbdf6cb458cf32
#: ../../using/selecting.md:118
msgid "Everything in jupyter/pyspark-notebook and its ancestor images"
msgstr ""
# 5f6081607cab47739c306516cf84a814
#: ../../using/selecting.md:120
msgid ""
"Apache Toree and spylon-kernel to support Scala code in Jupyter notebooks"
msgstr ""
# a4b50e47f8684dfbbe71e0c3353199dd
#: ../../using/selecting.md:121
msgid "ggplot2, sparklyr, and rcurl packages"
msgstr ""
# ebbdf9189d96433e9323aae035f37ec2
#: ../../using/selecting.md:125
msgid ""
"The following diagram depicts the build dependency tree of the core images. "
"(i.e., the FROM statements in their Dockerfiles). Any given image inherits "
"the complete content of all ancestor images pointing to it."
msgstr ""
# df2da8e55aa740a485fd638aa7397b8a
#: ../../using/selecting.md:129
msgid "Builds"
msgstr ""
# 56066ef1cd834061b3c3aea7567221c7
#: ../../using/selecting.md:131
msgid ""
"Pull requests to the jupyter/docker-stacks repository trigger builds of all "
"images on Travis CI. These images are for testing purposes only and are not "
"saved for use. When pull requests merge to master, all images rebuild on "
"Docker Cloud and become available to docker pull from Docker Hub."
msgstr ""
# f4781cd0f2c040458a15b80846026405
#: ../../using/selecting.md:133
msgid "Versioning"
msgstr ""
# 28addf6682f24cbdb1b6cd1836a6dc74
#: ../../using/selecting.md:135
msgid ""
"The latest tag in each Docker Hub repository tracks the master branch HEAD "
"reference on GitHub. latest is a moving target, by definition, and will have"
" backward-incompatible changes regularly."
msgstr ""
# 92c07d80753b4fda9406b3b2694684e7
#: ../../using/selecting.md:137
msgid ""
"Every image on Docker Hub also receives a 12-character tag which corresponds"
" with the git commit SHA that triggered the image build. You can inspect the"
" state of the jupyter/docker-stacks repository for that commit to review the"
" definition of the image (e.g., images with tag 7c45ec67c8e7 were built from"
" https://github.com/jupyter/docker-stacks/tree/7c45ec67c8e7)."
msgstr ""
# 5bdfd71620394fa4812120220718ffeb
#: ../../using/selecting.md:139
msgid ""
"You must refer to git-SHA image tags when stability and reproducibility are "
"important in your work. (e.g. FROM jupyter/scipy-notebook:7c45ec67c8e7, "
"docker run -it --rm jupyter/scipy-notebook:7c45ec67c8e7). You should only "
"use latest when a one-off container instance is acceptable (e.g., you want "
"to briefly try a new library in a notebook)."
msgstr ""
# 90cc227d51734f8586d42982f3b7a559
#: ../../using/selecting.md:143
msgid ""
"The core stacks are just a tiny sample of what's possible when combining "
"Jupyter with other technologies. We encourage members of the Jupyter "
"community to create their own stacks based on the core images and link them "
"below."
msgstr ""
# f1c9edb79eae4a5f929fdc1e0e2d4366
#: ../../using/selecting.md:145
msgid "This list only has 2 examples. You can be the next!"
msgstr ""
# 7346986f864848708411fa0788d3b4e4
#: ../../using/selecting.md:147
msgid ""
"csharp-notebook is a community Jupyter Docker Stack image. Try C# in Jupyter"
" Notebooks. The image includes more than 200 Jupyter Notebooks with example "
"C# code and can readily be tried online via mybinder.org. Click here to "
"launch ."
msgstr ""
# a2e061cf04bf4e96a4d40c03790d64bc
#: ../../using/selecting.md:149
msgid ""
"education-notebook is a community Jupyter Docker Stack image. The image "
"includes nbgrader and RISE on top of the datascience-notebook image. Click "
"here to launch it on ."
msgstr ""
# c3720b9d103947499b34ebd19567733f
#: ../../using/selecting.md:151
msgid ""
"See the contributing guide for information about how to create your own "
"Jupyter Docker Stack."
msgstr ""
# b9f784eaaa0a4072929bc51254fa322e
#: ../../using/specifics.md:1
msgid "Image Specifics"
msgstr ""
# dfb2958ae819459383ad8c75ba65dd39
#: ../../using/specifics.md:3
msgid ""
"This page provides details about features specific to one or more images."
msgstr ""
# 9cfa68a10a3c4eb8b63c435e43bf77fc
#: ../../using/specifics.md:5
msgid "Apache Spark"
msgstr ""
# 536591b439514687b086cf6a4c6f7a93
#: ../../using/specifics.md:7
msgid ""
"The jupyter/pyspark-notebook and jupyter/all-spark-notebook images support "
"the use of Apache Spark in Python, R, and Scala notebooks. The following "
"sections provide some examples of how to get started using them."
msgstr ""
# 21d870dca44845948d9ab959f8ccc105
#: ../../using/specifics.md:9
msgid "Using Spark Local Mode"
msgstr ""
# bda9eb0bb22b4e8e8662fcd037d9d585
#: ../../using/specifics.md:11
msgid ""
"Spark local mode is useful for experimentation on small data when you do not"
" have a Spark cluster available."
msgstr ""
# 91033be3c31b48d4a1a6a235491bd897
# 6cc19049cacb4403989934496ecc4375
#: ../../using/specifics.md:13 ../../using/specifics.md:71
msgid "In a Python Notebook"
msgstr ""
# 556a0ebdcab54a87b01f1b8bed45628e
# 823b89e12a514c54b10255bcc2081397
#: ../../using/specifics.md:24 ../../using/specifics.md:98
msgid "In a R Notebook"
msgstr ""
# a42af3a3c0a44602b15d8d7ed52d267b
# cb0340653342464892f57379cf775ea9
#: ../../using/specifics.md:36 ../../using/specifics.md:119
msgid "In a Spylon Kernel Scala Notebook"
msgstr ""
# f6efc67ea4d14900a978e0d581e6448a
#: ../../using/specifics.md:38
msgid ""
"Spylon kernel instantiates a SparkContext for you in variable sc after you "
"configure Spark options in a %%init_spark magic cell."
msgstr ""
# 48c05ebdfde54ea6b8794b47171a6c10
# 66315cf3b7554105bfeaf6a3a5b43b73
#: ../../using/specifics.md:52 ../../using/specifics.md:134
msgid "In an Apache Toree Scala Notebook"
msgstr ""
# 5d8060e95aa941e58a64d0465dbacafa
#: ../../using/specifics.md:54
msgid ""
"Apache Toree instantiates a local SparkContext for you in variable sc when "
"the kernel starts."
msgstr ""
# 1a30fe3a85fa44b1860efb1e8bf123e3
#: ../../using/specifics.md:61
msgid "Connecting to a Spark Cluster on Mesos"
msgstr ""
# 74263d337820458d851a4b869d14f1cf
#: ../../using/specifics.md:63
msgid ""
"This configuration allows your compute cluster to scale with your data."
msgstr ""
# c7ca76d01c6e4f10ad8f793b65dc41db
#: ../../using/specifics.md:65
msgid "Deploy Spark on Mesos."
msgstr ""
# 296f9c1d6f2a4950a1147913198bc1bc
#: ../../using/specifics.md:66
msgid ""
"Configure each slave with the --no-switch_user flag or create the $NB_USER "
"account on every slave node."
msgstr ""
# 2d988e27cde44fa09feaed27ce3b7a06
# 6045e72f079c4fc2ab9e3ce622968bc8
#: ../../using/specifics.md:67 ../../using/specifics.md:163
msgid ""
"Run the Docker container with --net=host in a location that is network "
"addressable by all of your Spark workers. (This is a Spark networking "
"requirement.)"
msgstr ""
# f20142628b0f40379f87031abd6461b2
# b00bbd0a10d4480db69f870cdf5fe094
#: ../../using/specifics.md:68 ../../using/specifics.md:164
msgid ""
"NOTE: When using --net=host, you must also use the flags --pid=host -e "
"TINI_SUBREAPER=true. See https://github.com/jupyter/docker-stacks/issues/64 "
"for details."
msgstr ""
# 46c5b891e7ce4fa78d3c0eeff0e22635
#: ../../using/specifics.md:69
msgid "Follow the language specific instructions below."
msgstr ""
# 90c742c66172412c862fcf09a2661bf5
#: ../../using/specifics.md:136
msgid ""
"The Apache Toree kernel automatically creates a SparkContext when it starts "
"based on configuration information from its command line arguments and "
"environment variables. You can pass information about your Mesos cluster via"
" the SPARK_OPTS environment variable when you spawn a container."
msgstr ""
# 7c2b15ef25ba4cd29ff222b808a8fd68
#: ../../using/specifics.md:138
msgid ""
"For instance, to pass information about a Mesos master, Spark binary "
"location in HDFS, and an executor options, you could start the container "
"like so:"
msgstr ""
# 94f9511094e044f08129c273ce3efaf0
#: ../../using/specifics.md:146
msgid ""
"Note that this is the same information expressed in a notebook in the Python"
" case above. Once the kernel spec has your cluster information, you can test"
" your cluster in an Apache Toree notebook like so:"
msgstr ""
# e0c67007d0cc4c9da0fb73d5ed25356d
#: ../../using/specifics.md:157
msgid "Connecting to a Spark Cluster in Standalone Mode"
msgstr ""
# 6c6f7d3049814b25a3acf211e2587ec2
#: ../../using/specifics.md:159
msgid ""
"Connection to Spark Cluster on Standalone Mode requires the following set of"
" steps:"
msgstr ""
# 4634540d7990421fb60e85b6241dd816
#: ../../using/specifics.md:161
msgid ""
"Verify that the docker image (check the Dockerfile) and the Spark Cluster "
"which is being deployed, run the same version of Spark."
msgstr ""
# d6b4329933e24b69879a4621b26bf454
#: ../../using/specifics.md:162
msgid "Deploy Spark in Standalone Mode."
msgstr ""
# 3dfcc2e12ca34c92ac8ebf96e4a37066
#: ../../using/specifics.md:165
msgid ""
"The language specific instructions are almost same as mentioned above for "
"Mesos, only the master url would now be something like "
"spark://10.10.10.10:7077"
msgstr ""
# 9e271f07799e4cb0a4b79df224a5639f
#: ../../using/specifics.md:167
msgid "Tensorflow"
msgstr ""
# 2a525d328e6f419f98d2ed3b99978e25
#: ../../using/specifics.md:169
msgid ""
"The jupyter/tensorflow-notebook image supports the use of Tensorflow in "
"single machine or distributed mode."
msgstr ""
# 4440ceaa200f4029b5cbaf9c895a8e5c
#: ../../using/specifics.md:171
msgid "Single Machine Mode"
msgstr ""
# d82de0694427429fa44d9988c1db4851
#: ../../using/specifics.md:185
msgid "Distributed Mode"
msgstr ""
docs/locale/pt_BR/LC_MESSAGES/contributing.po
0 → 100644
View file @
ae5f7e10
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2018- Project Jupyter
# This file is distributed under the same license as the docker-stacks package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: docker-stacks latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-04-21 17:25-0400\n"
"PO-Revision-Date: 2019-04-22 13:45+0000\n"
"Language-Team: Portuguese (Brazil) (https://www.transifex.com/project-jupyter/teams/97886/pt_BR/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: pt_BR\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
# 9527c87037fb4592a05d144d80f69f89
#: ../../contributing/features.md:1
msgid "New Features"
msgstr ""
# 81de205103144b289398603fa4aee789
#: ../../contributing/features.md:3
msgid ""
"Thank you for contributing to the Jupyter Docker Stacks! We review pull "
"requests of new features (e.g., new packages, new scripts, new flags) to "
"balance the value of the images to the Jupyter community with the cost of "
"maintaining the images over time."
msgstr ""
# b35331d86206420aa8235d20ef037215
#: ../../contributing/features.md:5
msgid "Suggesting a New Feature"
msgstr ""
# 6c6b00518c1f4dc88049b82f213a36cc
#: ../../contributing/features.md:7
msgid ""
"Please follow the process below to suggest a new feature for inclusion in "
"one of the core stacks:"
msgstr ""
# a9cd9d0730cc4159aa227e970ae2d9d0
#: ../../contributing/features.md:9
msgid "Open a GitHub issue describing the feature you'd like to contribute."
msgstr ""
# 8433ea2c70b94556b9a62c35cb88a4c8
#: ../../contributing/features.md:10
msgid ""
"Discuss with the maintainers whether the addition makes sense in one of the "
"core stacks, as a recipe in the documentation, as a community stack, or as "
"something else entirely."
msgstr ""
# a995c15adfb7424e9852693b90569d7a
#: ../../contributing/features.md:12
msgid "Selection Criteria"
msgstr ""
# 981cef217f4e4225984c5c7989f592f8
#: ../../contributing/features.md:14
msgid ""
"Roughly speaking, we evaluate new features based on the following criteria:"
msgstr ""
# 32194c09119e428a871acb859d696500
#: ../../contributing/features.md:16
msgid ""
"Usefulness to Jupyter users: Is the feature generally applicable across "
"domains? Does it work with Jupyter Notebook, JupyterLab, JupyterHub, etc.?"
msgstr ""
# 7b5acf7ef5854ac4b2c55b1a51464796
#: ../../contributing/features.md:17
msgid ""
"Fit with the image purpose: Does the feature match the theme of the stack in"
" which it will be added? Would it fit better in a new, community stack?"
msgstr ""
# 55d1f51c3b264dcfb252771c83d8ca36
#: ../../contributing/features.md:18
msgid ""
"Complexity of build / runtime configuration: How many lines of code does the"
" feature require in one of the Dockerfiles or startup scripts? Does it "
"require new scripts entirely? Do users need to adjust how they use the "
"images?"
msgstr ""
# 2a332f3b95064b43a1833166fd84f53c
#: ../../contributing/features.md:19
msgid ""
"Impact on image metrics: How many bytes does the feature and its "
"dependencies add to the image(s)? How many minutes do they add to the build "
"time?"
msgstr ""
# 30966a8cde0844bd85f6114c65f79ec4
#: ../../contributing/features.md:20
msgid ""
"Ability to support the addition: Can existing maintainers answer user "
"questions and address future build issues? Are the contributors interested "
"in helping with long-term maintenance? Can we write tests to ensure the "
"feature continues to work over time?"
msgstr ""
# 6085a8c0829e411588a37777bfe5e0f4
#: ../../contributing/features.md:22
msgid "Submitting a Pull Request"
msgstr ""
# fa5dc8dbaedb483b888622cc9d1e94ae
#: ../../contributing/features.md:24
msgid ""
"If there's agreement that the feature belongs in one or more of the core "
"stacks:"
msgstr ""
# 23ae2ae62bdb4a35bc42d9efc7759944
#: ../../contributing/features.md:26
msgid ""
"Implement the feature in a local clone of the jupyter/docker-stacks project."
msgstr ""
# ef476261493c48d998fb384d651b4012
#: ../../contributing/features.md:27
msgid ""
"Please build the image locally before submitting a pull request. Building "
"the image locally shortens the debugging cycle by taking some load off "
"Travis CI, which graciously provides free build services for open source "
"projects like this one. If you use make, call:"
msgstr ""
# 6bd20fd181f44e39a4913154db0c7221
# 4277e486510d49a08448d209a5cdad69
# f8c596a67a4f43c1a1c82a0f38a846f7
#: ../../contributing/features.md:31 ../../contributing/packages.md:13
#: ../../contributing/tests.md:20
msgid "Submit a pull request (PR) with your changes."
msgstr ""
# a7aa4a8d9d3d44eda2f1cf757e569c4e
# d8f1d1f00b2a4e9690b4e0da736ac662
# e4f93545f2284342a2b3ad1f52eaf26c
#: ../../contributing/features.md:32 ../../contributing/packages.md:14
#: ../../contributing/tests.md:21
msgid ""
"Watch for Travis to report a build success or failure for your PR on GitHub."
msgstr ""
# f80657a299424b8685d452d70479bae6
#: ../../contributing/features.md:33
msgid "Discuss changes with the maintainers and address any build issues."
msgstr ""
# 57ead3e81b9b4ebaa7a3491818f60089
#: ../../contributing/issues.md:1
msgid "Project Issues"
msgstr ""
# f27080bf0c8d43a08f283b3c5e28ddc7
#: ../../contributing/issues.md:3
msgid ""
"We appreciate your taking the time to report an issue you encountered using "
"the Jupyter Docker Stacks. Please review the following guidelines when "
"reporting your problem."
msgstr ""
# 3713984479614d4aa9237328bc2e233b
#: ../../contributing/issues.md:7
msgid ""
"If you believe you’ve found a security vulnerability in any of the Jupyter "
"projects included in Jupyter Docker Stacks images, please report it to "
"security@ipython.org, not in the issue trackers on GitHub. If you prefer to "
"encrypt your security reports, you can use this PGP public key."
msgstr ""
# 0c7fad6ee9304bbe80baf1737d0f478c
#: ../../contributing/issues.md:13
msgid ""
"If you think your problem is unique to the Jupyter Docker Stacks images, "
"please search the jupyter/docker-stacks issue tracker to see if someone else"
" has already reported the same problem. If not, please open a new issue and "
"provide all of the information requested in the issue template."
msgstr ""
# 70860cacf75b40a687363712f3bf00ce
#: ../../contributing/issues.md:19
msgid ""
"If the issue you're seeing is with one of the open source libraries included"
" in the Docker images and is reproducible outside the images, please file a "
"bug with the appropriate open source project."
msgstr ""
# 76822159e56f40f3bb38ea93e054238c
#: ../../contributing/issues.md:22
msgid ""
"If you have a general question about how to use the Jupyter Docker Stacks in"
" your environment, in conjunction with other tools, with customizations, and"
" so on, please post your question on the Jupyter Discourse site."
msgstr ""
# 3815aec9c791444cbdf26a71e28a1f7c
#: ../../contributing/packages.md:1
msgid "Package Updates"
msgstr ""
# 0bc1f6af65c74cc5a812a14b9c5a055f
#: ../../contributing/packages.md:3
msgid ""
"We actively seek pull requests which update packages already included in the"
" project Dockerfiles. This is a great way for first-time contributors to "
"participate in developing the Jupyter Docker Stacks."
msgstr ""
# ff8faef49758489fb97ddaba60763a0e
#: ../../contributing/packages.md:5
msgid "Please follow the process below to update a package version:"
msgstr ""
# e3878a1a1a444bb592fe32f468693ed7
#: ../../contributing/packages.md:7
msgid ""
"Locate the Dockerfile containing the library you wish to update (e.g., base-"
"notebook/Dockerfile, scipy-notebook/Dockerfile)"
msgstr ""
# d5aac81ecab24592860296ab74936724
#: ../../contributing/packages.md:8
msgid ""
"Adjust the version number for the package. We prefer to pin the major and "
"minor version number of packages so as to minimize rebuild side-effects when"
" users submit pull requests (PRs). For example, you'll find the Jupyter "
"Notebook package, notebook, installed using conda with notebook=5.4.*."
msgstr ""
# 0eed3a80d95146bab769d4456addcce4
#: ../../contributing/packages.md:9
msgid ""
"Please build the image locally before submitting a pull request. Building "
"the image locally shortens the debugging cycle by taking some load off "
"Travis CI, which graciously provides free build services for open source "
"projects like this one. If you use make, call:"
msgstr ""
# 1be104e942024f2b98eb10e0006b9de3
#: ../../contributing/packages.md:15
msgid ""
"Discuss changes with the maintainers and address any build issues. Version "
"conflicts are the most common problem. You may need to upgrade additional "
"packages to fix build failures."
msgstr ""
# adf5db8b690d466a8d339c756a5a153c
#: ../../contributing/recipes.md:1
msgid "New Recipes"
msgstr ""
# 7d306f8fe4a641e4a48b61111c16b8e8
#: ../../contributing/recipes.md:3
msgid ""
"We welcome contributions of recipes, short examples of using, configuring, "
"or extending the Docker Stacks, for inclusion in the documentation site. "
"Follow the process below to add a new recipe:"
msgstr ""
# 5b84ed1b594845ec81f39b87e7c5d82b
#: ../../contributing/recipes.md:5
msgid "Open the docs/using/recipes.md source file."
msgstr ""
# 52f2b459bff447fe82c60ea02c4e751c
#: ../../contributing/recipes.md:6
msgid ""
"Add a second-level Markdown heading naming your recipe at the bottom of the "
"file (e.g., `## Add the RISE extension``)"
msgstr ""
# 56b4b4356d3e45f5bbe6eb14f9540628
#: ../../contributing/recipes.md:7
msgid ""
"Write the body of your recipe under the heading, including whatever command "
"line, Dockerfile, links, etc. you need."
msgstr ""
# 6a3115ec07cf42a28c755a607658f855
# f4f9a3d6544b4e4087e97124098459eb
#: ../../contributing/recipes.md:8 ../../contributing/stacks.md:111
msgid ""
"Submit a pull request (PR) with your changes. Maintainers will respond and "
"work with you to address any formatting or content issues."
msgstr ""
# 0b8332c390304a1ab29a4b2b030e7997
#: ../../contributing/stacks.md:1
msgid "Community Stacks"
msgstr ""
# 69ee7d697c7240b78ea8c7873fc1528b
#: ../../contributing/stacks.md:3
msgid ""
"We love to see the community create and share new Jupyter Docker images. "
"We've put together a cookiecutter project and the documentation below to "
"help you get started defining, building, and sharing your Jupyter "
"environments in Docker. Following these steps will:"
msgstr ""
# 0f392d5680ba4ea2812ff450f8e19d44
#: ../../contributing/stacks.md:5
msgid ""
"Setup a project on GitHub containing a Dockerfile based on either the "
"jupyter/base-notebook or jupyter/minimal-notebook image."
msgstr ""
# c05df9d2cf8c4505b0951f0ea88f1daf
#: ../../contributing/stacks.md:6
msgid ""
"Configure Travis CI to build and test your image when users submit pull "
"requests to your repository."
msgstr ""
# 077482de9feb4fa2b1e5e477fd5591f1
#: ../../contributing/stacks.md:7
msgid ""
"Configure Docker Cloud to build and host your images for others to use."
msgstr ""
# e2fe70e1ea6e4322a8dfa4380f8e54bb
#: ../../contributing/stacks.md:8
msgid ""
"Update the list of community stacks in this documentation to include your "
"image."
msgstr ""
# 3af1a3dc1eae4a7d96a883b911fc5894
#: ../../contributing/stacks.md:10
msgid ""
"This approach mirrors how we build and share the core stack images. Feel "
"free to follow it or pave your own path using alternative services and build"
" tools."
msgstr ""
# 0107f213096c41c8b1cb367b84fee30d
#: ../../contributing/stacks.md:12
msgid "Creating a Project"
msgstr ""
# cb35d196dc42402f9b338e56fcd3faa6
#: ../../contributing/stacks.md:14
msgid "First, install cookiecutter using pip or conda:"
msgstr ""
# 09066f77e38c42889844dafb226df4bd
#: ../../contributing/stacks.md:20
msgid ""
"Run the cookiecutter command pointing to the jupyter/cookiecutter-docker-"
"stacks project on GitHub."
msgstr ""
# 26f05981d3fe49abb07bba85a4a3890f
#: ../../contributing/stacks.md:26
msgid ""
"Enter a name for your new stack image. This will serve as both the git "
"repository name and the part of the Docker image name after the slash."
msgstr ""
# c6aba910076b49ca97dcb902f13d2a4d
#: ../../contributing/stacks.md:33
msgid ""
"Enter the user or organization name under which this stack will reside on "
"Docker Cloud / Hub. You must have access to manage this Docker Cloud org in "
"order to push images here and setup automated builds."
msgstr ""
# 176a346034074822b7634c6c86dace42
#: ../../contributing/stacks.md:41
msgid ""
"Select an image from the jupyter/docker-stacks project that will serve as "
"the base for your new image."
msgstr ""
# 3611e7452640414d9d0535292abd113d
#: ../../contributing/stacks.md:48
msgid "Enter a longer description of the stack for your README."
msgstr ""
# 782321361a3b4116a2d3dafa7cc1424f
#: ../../contributing/stacks.md:54
msgid "Initialize your project as a Git repository and push it to GitHub."
msgstr ""
# b699fe5155774c93938427a241d0f239
#: ../../contributing/stacks.md:66
msgid "Configuring Travis"
msgstr ""
# 6440a7c3a9444dda88445913807d1a48
#: ../../contributing/stacks.md:68
msgid ""
"Next, link your GitHub project to Travis CI to build your Docker image "
"whenever you or someone else submits a pull request."
msgstr ""
# c0613debece54f82a922700157994c5b
#: ../../contributing/stacks.md:70
msgid ""
"Visit https://docs.travis-ci.com/user/getting-started/#To-get-started-with-"
"Travis-CI and follow the instructions to add the Travis CI application to "
"your GitHub account."
msgstr ""
# 4cf36f34a47b410a982be3237af720cd
#: ../../contributing/stacks.md:71
msgid "Visit https://travis-ci.org."
msgstr ""
# fdd694f5ebf443ce9d2d220d5945c299
#: ../../contributing/stacks.md:72
msgid "Click the + symbol at the top of the left sidebar."
msgstr ""
# 05acff6addad4f919fe21c27329b1e51
#: ../../contributing/stacks.md:74
msgid ""
"Locate your project repository either in your primary user account or in one"
" of the organizations to which you belong."
msgstr ""
# a1917b1360434fb18a3522e0a9806a11
#: ../../contributing/stacks.md:75
msgid "Click the toggle to enable builds for the project repository."
msgstr ""
# 7dcbafc96c4a4ef88d7bc34e31a0af04
#: ../../contributing/stacks.md:76
msgid "Click the Settings button for that repository."
msgstr ""
# dd006e53f5cc4c1ea1501d62119f526e
#: ../../contributing/stacks.md:78
msgid ""
"Enable Build only if .travis.yml is present and Build pushed pull requests."
msgstr ""
# 0a5e54cd5f294a52983c2ec73559f810
#: ../../contributing/stacks.md:80
msgid "Disable Build pushed branches."
msgstr ""
# 2ddf5289794648a3b7d1f604ce744331
#: ../../contributing/stacks.md:82
msgid "Configuring Docker Cloud"
msgstr ""
# 5108ce3f722a430eb29e1a5928a86fcf
#: ../../contributing/stacks.md:84
msgid ""
"Now, configure Docker Cloud to build your stack image and push it to Docker "
"Hub repository whenever you merge a GitHub pull request to the master branch"
" of your project."
msgstr ""
# 7ab258ec2f1e4942a983996a6c5e6fa5
#: ../../contributing/stacks.md:86
msgid "Visit https://cloud.docker.com/ and login."
msgstr ""
# 3677166ebbc04b2aafc4f117e33f6bf5
#: ../../contributing/stacks.md:87
msgid ""
"Select the account or organization matching the one you entered when "
"prompted with stack_org by the cookiecutter."
msgstr ""
# 0997628fd41449c5b0598e7e1bf1f005
#: ../../contributing/stacks.md:89
msgid "Scroll to the bottom of the page and click Create repository."
msgstr ""
# 8504105c95594c288fdd9066006757b0
#: ../../contributing/stacks.md:90
msgid ""
"Enter the name of the image matching the one you entered when prompted with "
"stack_name by the cookiecutter."
msgstr ""
# c92796a106c846f585c88fb5a015fa6d
#: ../../contributing/stacks.md:92
msgid "Enter a description for your image."
msgstr ""
# fba832c82f3042499563598365fedfd5
#: ../../contributing/stacks.md:93
msgid ""
"Click GitHub under the Build Settings and follow the prompts to connect your"
" account if it is not already connected."
msgstr ""
# bff3581410014975943ca77637142f14
#: ../../contributing/stacks.md:94
msgid ""
"Select the GitHub organization and repository containing your image "
"definition from the dropdowns."
msgstr ""
# 72cbc93bfe354e279e9384e7c95c801b
#: ../../contributing/stacks.md:96
msgid "Click the Create and Build button."
msgstr ""
# bbb495328efd4fe7b339b7a7ffe908b0
#: ../../contributing/stacks.md:98
msgid "Defining Your Image"
msgstr ""
# 60052c2d1afc4a57baa59c1bf22d321c
#: ../../contributing/stacks.md:100
msgid ""
"Make edits the Dockerfile in your project to add third-party libraries and "
"configure Jupyter applications. Refer to the Dockerfiles for the core stacks"
" (e.g., jupyter/datascience-notebook) to get a feel for what's possible and "
"best practices."
msgstr ""
# 0855b53115ae4b6780cc82c9389224cb
#: ../../contributing/stacks.md:102
msgid ""
"Submit pull requests to your project repository on GitHub. Ensure your image"
" builds properly on Travis before merging to master. Refer to Docker Cloud "
"for builds of your master branch that you can docker pull."
msgstr ""
# de4bcc6e0ac1468ea761c038661ca19f
#: ../../contributing/stacks.md:104
msgid "Sharing Your Image"
msgstr ""
# a67495f9ae984a368364a698084f060e
#: ../../contributing/stacks.md:106
msgid ""
"Finally, if you'd like to add a link to your project to this documentation "
"site, please do the following:"
msgstr ""
# 7357ed96047e42e6ae9e4bf123a00bed
#: ../../contributing/stacks.md:108
msgid "Clone ths jupyter/docker-stacks GitHub repository."
msgstr ""
# ee9284fe69244dcd8d44b25b8dc8b3a2
#: ../../contributing/stacks.md:109
msgid ""
"Open the docs/using/selecting.md source file and locate the Community Stacks"
" section."
msgstr ""
# aa0e41b99c354b5b88336489084e2006
#: ../../contributing/stacks.md:110
msgid ""
"Add a bullet with a link to your project and a short description of what "
"your Docker image contains."
msgstr ""
# 0f652c5259d544b595e847365dfe843a
#: ../../contributing/tests.md:1
msgid "Image Tests"
msgstr ""
# 569da0112572470b9bc5f045bcfb49d0
#: ../../contributing/tests.md:3
msgid ""
"We greatly appreciate pull requests that extend the automated tests that vet"
" the basic functionality of the Docker images."
msgstr ""
# 67b27592447e47af8b0b00eeb745fc70
#: ../../contributing/tests.md:5
msgid "How the Tests Work"
msgstr ""
# e2c3d76accff489eb2a6eab7b55ae3be
#: ../../contributing/tests.md:7
msgid ""
"Travis executes make build-test-all against every pull request submitted to "
"the jupyter/docker-stacks repository. The make command builds every docker "
"image. After building each image, the make command executes pytest to run "
"both image-specific tests like those in base-notebook/test/ and common tests"
" defined in test/. Both kinds of tests make use of global pytest fixtures "
"defined in the conftest.py file at the root of the projects."
msgstr ""
# 15207b72b26741f0a6a77949a4d9d0f4
#: ../../contributing/tests.md:9
msgid "Contributing New Tests"
msgstr ""
# 5470865e6d144e51a428221e49e448fb
#: ../../contributing/tests.md:11
msgid "Please follow the process below to add new tests:"
msgstr ""
# 36aedaa2624c4e4493af145bc5f246e0
#: ../../contributing/tests.md:13
msgid ""
"If the test should run against every image built, add your test code to one "
"of the modules in test/ or create a new module."
msgstr ""
# dccbb0425be7438db7ade2f4892c6c25
#: ../../contributing/tests.md:14
msgid ""
"If your test should run against a single image, add your test code to one of"
" the modules in some-notebook/test/ or create a new module."
msgstr ""
# 33ab248b51d24fa0b29923489bf6dfbf
#: ../../contributing/tests.md:15
msgid ""
"Build one or more images you intend to test and run the tests locally. If "
"you use make, call:"
msgstr ""
# 0453d92037cb4e47a025bc9021bdc7db
#: ../../contributing/tests.md:22
msgid ""
"Discuss changes with the maintainers and address any issues running the "
"tests on Travis."
msgstr ""
docs/locale/pt_BR/LC_MESSAGES/index.po
0 → 100644
View file @
ae5f7e10
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2018- Project Jupyter
# This file is distributed under the same license as the docker-stacks package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Allan Neri Fernandes da Silva <allan.nerifs@gmail.com>, 2019
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: docker-stacks latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-04-21 17:25-0400\n"
"PO-Revision-Date: 2019-04-22 13:45+0000\n"
"Last-Translator: Allan Neri Fernandes da Silva <allan.nerifs@gmail.com>, 2019\n"
"Language-Team: Portuguese (Brazil) (https://www.transifex.com/project-jupyter/teams/97886/pt_BR/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: pt_BR\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
# 85291a2c92d440a089cf156fba58b86a
#: ../../index.rst:32 ../../index.rst:32
msgid "User Guide"
msgstr "Guia de uso"
# e4a3fd32059d4486b6b0f3a6fb5065b5
#: ../../index.rst:42 ../../index.rst:42
msgid "Contributor Guide"
msgstr "Guia de contribuição"
# 45de48c8617d4ebe83b7ff7141295836
#: ../../index.rst:53 ../../index.rst:53
msgid "Maintainer Guide"
msgstr "Guia de manutenção"
# aa99c4562d8d4cb3abfea375470e8af3
#: ../../index.rst:59 ../../index.rst:59
msgid "Getting Help"
msgstr "Obtendo ajuda"
# 76df09037a6147c8a85be8ef14c15532
#: ../../index.rst:2
msgid "Jupyter Docker Stacks"
msgstr "Jupyter Docker Stacks"
# b3fb253184e64174b26a2da73f221cc1
#: ../../index.rst:4
msgid ""
"Jupyter Docker Stacks are a set of ready-to-run Docker images containing "
"Jupyter applications and interactive computing tools. You can use a stack "
"image to do any of the following (and more):"
msgstr ""
"Jupyter Docker Stacks são um conjunto de imagens Docker prontas para uso "
"contendo aplicações Jupyter e ferramentas interativas. Você pode usar uma "
"pilha de imagens para fazer qualquer uma dessas coisas (e muito mais):"
# 8cd55fb113a049e7be445b21084df7ea
#: ../../index.rst:6
msgid "Start a personal Jupyter Notebook server in a local Docker container"
msgstr "Rodar um servidor Jupyter Notebook em um container Docker local"
# 285fa13bed8547b4af0cfc480adf4861
#: ../../index.rst:7
msgid "Run JupyterLab servers for a team using JupyterHub"
msgstr "Rode um servidor JupyterLab para uma equipe usando JupyterHub"
# a49d31cedd4946ea98d7a4c720340d84
#: ../../index.rst:8
msgid "Write your own project Dockerfile"
msgstr "Escrever seu próprio Dockerfile"
# 0aff0df2e46a44b4bc8070545e83c42c
#: ../../index.rst:11
msgid "Quick Start"
msgstr "Guia rápido"
# 3262accd283140058db73005072be200
#: ../../index.rst:13
msgid ""
"You can try a `recent build of the jupyter/base-notebook image on "
"mybinder.org <https://mybinder.org/v2/gh/jupyter/docker-"
"stacks/master?filepath=README.ipynb>`_ by simply clicking the preceding "
"link. Otherwise, the two examples below may help you get started if you "
"`have Docker installed <https://docs.docker.com/install/>`_, know "
":doc:`which Docker image <using/selecting>` you want to use, and want to "
"launch a single Jupyter Notebook server in a container."
msgstr ""
"Você pode tentar um `build recente da imagem do jupyter/base-notebook em "
"mybinder.org <https://mybinder.org/v2/gh/jupyter/docker-"
"stacks/master?filepath=README.ipynb>`_ simplesmente clicando neste link. "
"Caso contrário, os dois exemplos abaixo podem te ajudar a começar se você "
"`já tem o Docker instalado <https://docs.docker.com/install/>`_ , sabe "
":doc:`qual imagem <using/selecting>` usar, e quer iniciar um servidor "
"Jupyter Notebook em um contêiner."
# 9e4094e8de264e20bca0af8f6cf888b7
#: ../../index.rst:15
msgid ""
"The other pages in this documentation describe additional uses and features "
"in detail."
msgstr ""
"As próximas paginas desta documentação descrevem os usos e as "
"funcionalidades adicionais com mais detalhes"
# 8b75310f2eaa4aac95d9387e0a4db9e8
#: ../../index.rst:17
msgid ""
"**Example 1:** This command pulls the ``jupyter/scipy-notebook`` image "
"tagged ``17aba6048f44`` from Docker Hub if it is not already present on the "
"local host. It then starts a container running a Jupyter Notebook server and"
" exposes the server on host port 8888. The server logs appear in the "
"terminal. Visiting ``http://<hostname>:8888/?token=<token>`` in a browser "
"loads the Jupyter Notebook dashboard page, where ``hostname`` is the name of"
" the computer running docker and ``token`` is the secret token printed in "
"the console. The container remains intact for restart after the notebook "
"server exits.::"
msgstr ""
"**Exemplo 1:** Este comando faz um pull da imagem ``jupyter/scipy-notebook``"
" com a tag ``17aba6048f44`` do Docker Hub se ela ainda não estiver em sua "
"maquina local. Em seguida inicia um contêiner executando um servidor Jupyter"
" Notebook e expondo a porta 8888 do host. Os logs do servidor aparecem no "
"terminal. Acessando o endereço ``http://<hostname>:8888/?token=<token>`` "
"através de um navegador carregará o painel de controle do Jupyter Notebook, "
"onde ``hostname`` é o nome do computador executando o docker e ``token`` é o"
" token secreto exibido no console. O contêiner permanece intacto para "
"reinicialização após o termino do servidor.::"
# 9e0229c99f404aceb7e517387ae88365
#: ../../index.rst:21
msgid ""
"**Example 2:** This command performs the same operations as **Example 1**, "
"but it exposes the server on host port 10000 instead of port 8888. Visiting "
"``http://<hostname>:10000/?token=<token>`` in a browser loads JupyterLab, "
"where ``hostname`` is the name of the computer running docker and ``token`` "
"is the secret token printed in the console.::"
msgstr ""
"**Exemplo 2:** Este comando faz as mesma coisas do **Exemplo 1**, mas expõe "
"a porta 10000 do host em vez da 8888. Acessando o endereço "
"``http://<hostname>:10000/?token=<token>`` através de um navegador carregará"
" o JupyterLab, onde ``hostname`` é o nome do computador executando o docker "
"e ``token`` é o token secreto exibido no console.::"
# 02c25d3f0abe48348100dd878c243a75
#: ../../index.rst:25
msgid ""
"**Example 3:** This command pulls the ``jupyter/datascience-notebook`` image"
" tagged ``9b06df75e445`` from Docker Hub if it is not already present on the"
" local host. It then starts an *ephemeral* container running a Jupyter "
"Notebook server and exposes the server on host port 10000. The command "
"mounts the current working directory on the host as ``/home/jovyan/work`` in"
" the container. The server logs appear in the terminal. Visiting "
"``http://<hostname>:10000/?token=<token>`` in a browser loads JupyterLab, "
"where ``hostname`` is the name of the computer running docker and ``token`` "
"is the secret token printed in the console. Docker destroys the container "
"after notebook server exit, but any files written to ``~/work`` in the "
"container remain intact on the host.::"
msgstr ""
"**Exemplo 3:** Este comando faz um pull da imagem ``jupyter/datascience-"
"notebook`` com a tag ``9b06df75e445`` do Docker Hub se ela ainda não estiver"
" em sua maquina local. Em seguida inicia um contêiner *passageiro* rodando "
"um servidor Jupyter Notebook expondo no host a porta 10000 do servidor. O "
"comando associa o diretório atual do host com o diretório "
"``/home/jovyan/work`` do contêiner. Os logs do servidor aparecem no "
"terminal. Acessando o endereço ``http://<hostname>:10000/?token=<token>`` "
"através de um navegador carregará o JupyterLab, onde ``hostname`` é o nome "
"do computador executando o docker e ``token`` é o token secreto exibido no "
"console. O Docker destrói o contêiner depois que o servidor for finalizado, "
"mas os arquivos escritos em ``~work`` do contêiner permanecem intactos no "
"host.::"
# 1bc0c7d54cd343d689362047c0b00122
#: ../../index.rst:30
msgid "Table of Contents"
msgstr "Índice"
docs/locale/pt_BR/LC_MESSAGES/maintaining.po
0 → 100644
View file @
ae5f7e10
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2018- Project Jupyter
# This file is distributed under the same license as the docker-stacks package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: docker-stacks latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-04-21 17:25-0400\n"
"PO-Revision-Date: 2019-04-22 13:45+0000\n"
"Language-Team: Portuguese (Brazil) (https://www.transifex.com/project-jupyter/teams/97886/pt_BR/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: pt_BR\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
# cefae71d9a804ab69c7e9f0a53eb7475
#: ../../maintaining/tasks.md:1
msgid "Maintainer Playbook"
msgstr ""
# af6a24b053794e55bddfe6e2e21ae74f
#: ../../maintaining/tasks.md:3
msgid "Merging Pull Requests"
msgstr ""
# c34b1d3b543346689adbca91331ac048
#: ../../maintaining/tasks.md:5
msgid ""
"To build new images on Docker Cloud and publish them to the Docker Hub "
"registry, do the following:"
msgstr ""
# 1597bb99448f41b994d1c7073b9c8721
#: ../../maintaining/tasks.md:7
msgid "Make sure Travis is green for a PR."
msgstr ""
# 401ed2733771440e8ef089f54cf2984d
#: ../../maintaining/tasks.md:8
msgid "Merge the PR."
msgstr ""
# 6d0bf2e7538640a0989e56df3c9d1106
#: ../../maintaining/tasks.md:9
msgid ""
"Monitor the Docker Cloud build status for each of the stacks, starting with "
"jupyter/base-notebook and ending with jupyter/all-spark-notebook. See the "
"stack hierarchy diagram for the current, complete build order."
msgstr ""
# 428124fa830d4c74a618d7b3c696599c
#: ../../maintaining/tasks.md:10
msgid ""
"Manually click the retry button next to any build that fails to resume that "
"build and any dependent builds."
msgstr ""
# c4034a02dab8435f8d76c2d32321a262
#: ../../maintaining/tasks.md:11
msgid ""
"Try to avoid merging another PR to master until all outstanding builds "
"complete. There's no way at present to propagate the git SHA to build "
"through the Docker Cloud build trigger API. Every build trigger works off of"
" master HEAD."
msgstr ""
# 62ddd25e15064cea950f9f13a663dcdb
#: ../../maintaining/tasks.md:13
msgid "Updating the Ubuntu Base Image"
msgstr ""
# 091b1ce707f44bc6ae9742cf55b92ebf
#: ../../maintaining/tasks.md:15
msgid ""
"When there's a security fix in the Ubuntu base image or after some time "
"passes, it's a good idea to update the pinned SHA in the jupyter/base-"
"notebook Dockerfile. Submit it as a regular PR and go through the build "
"process. Expect the build to take a while to complete: every image layer "
"will rebuild."
msgstr ""
# d834495e774a4fee952324e4cc5ab514
#: ../../maintaining/tasks.md:17
msgid "Adding a New Core Image to Docker Cloud"
msgstr ""
# b765140c2d1446849b747351532d6290
#: ../../maintaining/tasks.md:19
msgid ""
"When there's a new stack definition, do the following before merging the PR "
"with the new stack:"
msgstr ""
# b7b25a83cd3246bd886926722c30ac1a
#: ../../maintaining/tasks.md:21
msgid ""
"Ensure the PR includes an update to the stack overview diagram in the "
"documentation. The image links to the blockdiag source used to create it."
msgstr ""
# 50edc8e02aa9497d81dc312eafe5d2bf
#: ../../maintaining/tasks.md:22
msgid ""
"Ensure the PR updates the Makefile which is used to build the stacks in "
"order on Travis CI."
msgstr ""
# fabcb32a80a04a639aebd8b55d38119e
#: ../../maintaining/tasks.md:23
msgid ""
"Create a new repository in the jupyter org on Docker Cloud named after the "
"stack folder in the git repo."
msgstr ""
# 1811dcec60e3433d94514eaeebecb44b
#: ../../maintaining/tasks.md:24
msgid "Grant the stacks team permission to write to the repo."
msgstr ""
# afa7b1fcb0224380a111fe94f7781d60
#: ../../maintaining/tasks.md:25
msgid "Click Builds and then Configure Automated Builds for the repository."
msgstr ""
# 35b969b9f7a442d99f54a73494033d90
#: ../../maintaining/tasks.md:26
msgid "Select jupyter/docker-stacks as the source repository."
msgstr ""
# fe715af4446d409cb4d5ee81255bd86e
#: ../../maintaining/tasks.md:27
msgid ""
"Choose Build on Docker Cloud's infrastructure using a Small node unless you "
"have reason to believe a bigger host is required."
msgstr ""
# dc41895431b64657b5e24a8c96779ca6
#: ../../maintaining/tasks.md:28
msgid ""
"Update the Build Context in the default build rule to be /<name-of-the-"
"stack>."
msgstr ""
# e4d220bf1cb54781bc03f16a17ddafb8
#: ../../maintaining/tasks.md:29
msgid ""
"Toggle Autobuild to disabled unless the stack is a new root stack (e.g., "
"like jupyter/base-notebook)."
msgstr ""
# c5a459d038714ff78d4f156ee227d9ca
#: ../../maintaining/tasks.md:30
msgid ""
"If the new stack depends on the build of another stack in the hierarchy:"
msgstr ""
# 611376c2ec6942479f60129177d312cc
#: ../../maintaining/tasks.md:31
msgid "Hit Save and then click Configure Automated Builds."
msgstr ""
# 81cc56c63891432d89d4df3001f1bcde
#: ../../maintaining/tasks.md:32
msgid "At the very bottom, add a build trigger named Stack hierarchy trigger."
msgstr ""
# 9e55682a966a422c846a3463c7a30cfe
#: ../../maintaining/tasks.md:33
msgid "Copy the build trigger URL."
msgstr ""
# a9d853a1d45b4ead965813822a96c934
#: ../../maintaining/tasks.md:34
msgid ""
"Visit the parent repository Builds page and click Configure Automated "
"Builds."
msgstr ""
# 327d4522c3884247871aa406bbe19402
#: ../../maintaining/tasks.md:35
msgid ""
"Add the URL you copied to the NEXT_BUILD_TRIGGERS environment variable comma"
" separated list of URLs, creating that environment variable if it does not "
"already exist."
msgstr ""
# 1aa0e4b95ab847e0be8ac9647433c991
# 7dfff62380a041968ee6e739b1ca271f
#: ../../maintaining/tasks.md:36 ../../maintaining/tasks.md:40
msgid "Hit Save."
msgstr ""
# 8315ed043efb40238227f8be0ad61b52
#: ../../maintaining/tasks.md:37
msgid "If the new stack should trigger other dependent builds:"
msgstr ""
# 6e0e15d05a544476b91794d10b8732ff
#: ../../maintaining/tasks.md:38
msgid "Add an environment variable named NEXT_BUILD_TRIGGERS."
msgstr ""
# 9dc2029e6360433ab7181187f7040d48
#: ../../maintaining/tasks.md:39
msgid ""
"Copy the build trigger URLs from the dependent builds into the "
"NEXT_BUILD_TRIGGERS comma separated list of URLs."
msgstr ""
# 89165b279d9142e9b8e5d7a923fca2be
#: ../../maintaining/tasks.md:41
msgid ""
"Adjust other NEXT_BUILD_TRIGGERS values as needed so that the build order "
"matches that in the stack hierarchy diagram."
msgstr ""
# 51c8151943794bc8b1d51d65ccd84736
#: ../../maintaining/tasks.md:43
msgid "Adding a New Maintainer Account"
msgstr ""
# 1994c19e7a734b2cad9af0afcd7da31e
#: ../../maintaining/tasks.md:45
msgid "Visit https://cloud.docker.com/app/jupyter/team/stacks/users"
msgstr ""
# 390ccdde528146bbbc3d2f62717a647c
#: ../../maintaining/tasks.md:46
msgid "Add the maintainer's Docker Cloud username."
msgstr ""
# b0227c37244c4b82848cc2655f134d21
#: ../../maintaining/tasks.md:47
msgid ""
"Visit https://github.com/orgs/jupyter/teams/docker-image-maintainers/members"
msgstr ""
# b0fdbdd14b1444d1b696d8367aa111fb
#: ../../maintaining/tasks.md:48
msgid "Add the maintainer's GitHub username."
msgstr ""
# abe2cb04fcb9447496bf3bc9fb230cdc
#: ../../maintaining/tasks.md:50
msgid "Pushing a Build Manually"
msgstr ""
# 3ef85ec6ea0a4a84aecc2bc7e7a5a5fd
#: ../../maintaining/tasks.md:52
msgid ""
"If automated builds on Docker Cloud have got you down, do the following to "
"push a build manually:"
msgstr ""
# 3ebef623fa2f46f49ef639ad17105d4a
#: ../../maintaining/tasks.md:54
msgid "Clone this repository."
msgstr ""
# dcf8e9e8c72e40b9aa23c090311d6ea2
#: ../../maintaining/tasks.md:55
msgid "Check out the git SHA you want to build and publish."
msgstr ""
# fe788ad30f694b1f9b013cabfa820343
#: ../../maintaining/tasks.md:56
msgid "docker login with your Docker Hub/Cloud credentials."
msgstr ""
# 649dc474ffaa483eb625ed8061cb0097
#: ../../maintaining/tasks.md:57
msgid "Run make retry/release-all."
msgstr ""
docs/locale/pt_BR/LC_MESSAGES/using.po
0 → 100644
View file @
ae5f7e10
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2018- Project Jupyter
# This file is distributed under the same license as the docker-stacks package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: docker-stacks latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-04-21 17:25-0400\n"
"PO-Revision-Date: 2019-04-22 13:45+0000\n"
"Language-Team: Portuguese (Brazil) (https://www.transifex.com/project-jupyter/teams/97886/pt_BR/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: pt_BR\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
# 22b65331d42e414b9320143d30499447
#: ../../using/common.md:1
msgid "Common Features"
msgstr ""
# dd3cb2a88856437aad5f76b607f80deb
#: ../../using/common.md:3
msgid ""
"A container launched from any Jupyter Docker Stacks image runs a Jupyter "
"Notebook server by default. The container does so by executing a start-"
"notebook.sh script. This script configures the internal container "
"environment and then runs jupyter notebook, passing it any command line "
"arguments received."
msgstr ""
# 4bc2911886254b1cafcffcce7d7ef9b3
#: ../../using/common.md:5
msgid ""
"This page describes the options supported by the startup script as well as "
"how to bypass it to run alternative commands."
msgstr ""
# bb55c8d7786e4c1f8e11c1e309931c41
#: ../../using/common.md:7
msgid "Notebook Options"
msgstr ""
# 66f14be1ff1746c1abdccafb894fa2e6
#: ../../using/common.md:9
msgid ""
"You can pass Jupyter command line options to the start-notebook.sh script "
"when launching the container. For example, to secure the Notebook server "
"with a custom password hashed using IPython.lib.passwd() instead of the "
"default token, you can run the following:"
msgstr ""
# 5d73f06cae2c4990a942c76988f19c1f
#: ../../using/common.md:15
msgid ""
"For example, to set the base URL of the notebook server, you can run the "
"following:"
msgstr ""
# 9d43ee0e147b43469f56c4895720f682
#: ../../using/common.md:21
msgid "Docker Options"
msgstr ""
# 3f0f5c9d0b254d829e6f07e0a2ca2544
#: ../../using/common.md:23
msgid ""
"You may instruct the start-notebook.sh script to customize the container "
"environment before launching the notebook server. You do so by passing "
"arguments to the docker run command."
msgstr ""
# 4621c78dfaeb43379c5d3437238b2ef8
#: ../../using/common.md:26
msgid ""
"-e NB_USER=jovyan - Instructs the startup script to change the default "
"container username from jovyan to the provided value. Causes the script to "
"rename the jovyan user home folder. For this option to take effect, you must"
" run the container with --user root and set the working directory -w "
"/home/$NB_USER. This feature is useful when mounting host volumes with "
"specific home folder."
msgstr ""
# 9120ad3c28c84f3fbb2433c79a83907a
#: ../../using/common.md:27
msgid ""
"-e NB_UID=1000 - Instructs the startup script to switch the numeric user ID "
"of $NB_USER to the given value. This feature is useful when mounting host "
"volumes with specific owner permissions. For this option to take effect, you"
" must run the container with --user root. (The startup script will su "
"$NB_USER after adjusting the user ID.) You might consider using modern "
"Docker options --user and --group-add instead. See the last bullet below for"
" details."
msgstr ""
# f2a9954159b546468e50a4d9665dd534
#: ../../using/common.md:28
msgid ""
"-e NB_GID=100 - Instructs the startup script to change the primary group "
"of$NB_USER to $NB_GID (the new group is added with a name of $NB_GROUP if it"
" is defined, otherwise the group is named $NB_USER). This feature is useful"
" when mounting host volumes with specific group permissions. For this option"
" to take effect, you must run the container with --user root. (The startup "
"script will su $NB_USER after adjusting the group ID.) You might consider "
"using modern Docker options --user and --group-add instead. See the last "
"bullet below for details. The user is added to supplemental group users "
"(gid 100) in order to allow write access to the home directory and "
"/opt/conda. If you override the user/group logic, ensure the user stays in "
"group users if you want them to be able to modify files in the image."
msgstr ""
# 1d362c57a99b47e1b3cb571f23c17e67
#: ../../using/common.md:29
msgid ""
"-e NB_GROUP=<name> - The name used for $NB_GID, which defaults to $NB_USER."
" This is only used if $NB_GID is specified and completely optional: there "
"is only cosmetic effect."
msgstr ""
# de1cd66f1e174d519cfcf764a0286773
#: ../../using/common.md:30
msgid ""
"-e NB_UMASK=<umask> - Configures Jupyter to use a different umask value from"
" default, i.e. 022. For example, if setting umask to 002, new files will be "
"readable and writable by group members instead of just writable by the "
"owner. Wikipedia has a good article about umask. Feel free to read it in "
"order to choose the value that better fits your needs. Default value should "
"fit most situations. Note that NB_UMASK when set only applies to the Jupyter"
" process itself - you cannot use it to set a umask for additional files "
"created during run-hooks e.g. via pip or conda - if you need to set a umask "
"for these you must set umask for each command."
msgstr ""
# 325f270ee0484e728c638fb0ca4c9c93
#: ../../using/common.md:31
msgid ""
"-e CHOWN_HOME=yes - Instructs the startup script to change the $NB_USER home"
" directory owner and group to the current value of $NB_UID and $NB_GID. This"
" change will take effect even if the user home directory is mounted from the"
" host using -v as described below. The change is not applied recursively by "
"default. You can change modify the chown behavior by setting CHOWN_HOME_OPTS"
" (e.g., -e CHOWN_HOME_OPTS='-R')."
msgstr ""
# 85b3d1d9890c46b08bb62370c6ed93a2
#: ../../using/common.md:32
msgid ""
"-e CHOWN_EXTRA=\"<some dir>,<some other dir>\" - Instructs the startup "
"script to change the owner and group of each comma-separated container "
"directory to the current value of $NB_UID and $NB_GID. The change is not "
"applied recursively by default. You can change modify the chown behavior by "
"setting CHOWN_EXTRA_OPTS (e.g., -e CHOWN_EXTRA_OPTS='-R')."
msgstr ""
# bb7a47817b734d7ab9d95e4c4f18911f
#: ../../using/common.md:33
msgid ""
"-e GRANT_SUDO=yes - Instructs the startup script to grant the NB_USER user "
"passwordless sudo capability. You do not need this option to allow the user "
"to conda or pip install additional packages. This option is useful, however,"
" when you wish to give $NB_USER the ability to install OS packages with apt "
"or modify other root-owned files in the container. For this option to take "
"effect, you must run the container with --user root. (The start-notebook.sh "
"script will su $NB_USER after adding $NB_USER to sudoers.) You should only "
"enable sudo if you trust the user or if the container is running on an "
"isolated host."
msgstr ""
# d148b1f0275342b0bf231ae5e819590f
#: ../../using/common.md:34
msgid ""
"-e GEN_CERT=yes - Instructs the startup script to generates a self-signed "
"SSL certificate and configure Jupyter Notebook to use it to accept encrypted"
" HTTPS connections."
msgstr ""
# aafdc956c76142a0acfe467ffde5ce68
#: ../../using/common.md:35
msgid ""
"-e JUPYTER_ENABLE_LAB=yes - Instructs the startup script to run jupyter lab "
"instead of the default jupyter notebook command. Useful in container "
"orchestration environments where setting environment variables is easier "
"than change command line parameters."
msgstr ""
# 9a4fc69536fa4e8580ed4f5e77d338f0
#: ../../using/common.md:36
msgid ""
"-v /some/host/folder/for/work:/home/jovyan/work - Mounts a host machine "
"directory as folder in the container. Useful when you want to preserve "
"notebooks and other work even after the container is destroyed. You must "
"grant the within-container notebook user or group (NB_UID or NB_GID) write "
"access to the host directory (e.g., sudo chown 1000 "
"/some/host/folder/for/work)."
msgstr ""
# 684334b1f55b42e4a05e194f3a3a3497
#: ../../using/common.md:37
msgid ""
"--user 5000 --group-add users - Launches the container with a specific user "
"ID and adds that user to the users group so that it can modify files in the "
"default home directory and /opt/conda. You can use these arguments as "
"alternatives to setting $NB_UID and $NB_GID."
msgstr ""
# 42df7956876a4592be13f4ce3c9c8f54
#: ../../using/common.md:39
msgid "Startup Hooks"
msgstr ""
# c8d2e31d4d0544a486a070c4cc7d8afd
#: ../../using/common.md:41
msgid ""
"You can further customize the container environment by adding shell scripts "
"(*.sh) to be sourced or executables (chmod +x) to be run to the paths below:"
msgstr ""
# 473e6aea1cbc4e50b75eec179a476b46
#: ../../using/common.md:44
msgid ""
"/usr/local/bin/start-notebook.d/ - handled before any of the standard "
"options noted above are applied"
msgstr ""
# f9d0cc48b06f4cbfa911ef6169222f6b
#: ../../using/common.md:46
msgid ""
"/usr/local/bin/before-notebook.d/ - handled after all of the standard "
"options noted above are applied and just before the notebook server launches"
msgstr ""
# 68e7bf5e72d747f886129a962ae84eef
#: ../../using/common.md:49
msgid ""
"See the run-hooks function in the jupyter/base-notebook start.sh script for "
"execution details."
msgstr ""
# 7a9436da93a34647a59ee4cc77be5300
#: ../../using/common.md:52
msgid "SSL Certificates"
msgstr ""
# e69958fe476445eda760433dcc2fac24
#: ../../using/common.md:54
msgid ""
"You may mount SSL key and certificate files into a container and configure "
"Jupyter Notebook to use them to accept HTTPS connections. For example, to "
"mount a host folder containing a notebook.key and notebook.crt and use them,"
" you might run the following:"
msgstr ""
# b38385bb5753460397e87480c71d621f
#: ../../using/common.md:64
msgid ""
"Alternatively, you may mount a single PEM file containing both the key and "
"certificate. For example:"
msgstr ""
# 7867b25df06444e8b7bd0c87292cafd8
#: ../../using/common.md:73
msgid ""
"In either case, Jupyter Notebook expects the key and certificate to be a "
"base64 encoded text file. The certificate file or PEM may contain one or "
"more certificates (e.g., server, intermediate, and root)."
msgstr ""
# 030c5c35440b45d8b1a82abdb946609f
#: ../../using/common.md:75
msgid "For additional information about using SSL, see the following:"
msgstr ""
# a50ac1b5bbc749e8a5c4f9ecbd523d14
#: ../../using/common.md:77
msgid ""
"The docker-stacks/examples for information about how to use Let's Encrypt "
"certificates when you run these stacks on a publicly visible domain."
msgstr ""
# 9cc027cb57c044a782068bf45d3bc22e
#: ../../using/common.md:78
msgid ""
"The jupyter_notebook_config.py file for how this Docker image generates a "
"self-signed certificate."
msgstr ""
# dbfcfb88b099481781c8f3b3011a73e9
#: ../../using/common.md:79
msgid ""
"The Jupyter Notebook documentation for best practices about securing a "
"public notebook server in general."
msgstr ""
# f8fcaea33627485799126c6b6e08e7dc
#: ../../using/common.md:81
msgid "Alternative Commands"
msgstr ""
# 10a9b432d6dd4a8a804da1976d27127e
#: ../../using/common.md:83
msgid "start.sh"
msgstr ""
# 3dca69ef1ed44f08a99c8a3f82645ffa
#: ../../using/common.md:85
msgid ""
"The start-notebook.sh script actually inherits most of its option handling "
"capability from a more generic start.sh script. The start.sh script supports"
" all of the features described above, but allows you to specify an arbitrary"
" command to execute. For example, to run the text-based ipython console in a"
" container, do the following:"
msgstr ""
# f9ade4ab67f54867a79b59937239d9a7
#: ../../using/common.md:91
msgid ""
"Or, to run JupyterLab instead of the classic notebook, run the following:"
msgstr ""
# 4575181991e844a1bc113b6c2821d0d8
#: ../../using/common.md:97
msgid ""
"This script is particularly useful when you derive a new Dockerfile from "
"this image and install additional Jupyter applications with subcommands like"
" jupyter console, jupyter kernelgateway, etc."
msgstr ""
# d4d085e167a942709b72de803ee03bc0
#: ../../using/common.md:99
msgid "Others"
msgstr ""
# 34c4fb744a514987b41ad23dba573c46
#: ../../using/common.md:101
msgid ""
"You can bypass the provided scripts and specify your an arbitrary start "
"command. If you do, keep in mind that features supported by the start.sh "
"script and its kin will not function (e.g., GRANT_SUDO)."
msgstr ""
# bcd8d95440b2493a9ffbca0678a14ed9
#: ../../using/common.md:103
msgid "Conda Environments"
msgstr ""
# 9f62047ae18e44e3bad5b3a183a3683a
#: ../../using/common.md:105
msgid ""
"The default Python 3.x Conda environment resides in /opt/conda. The "
"/opt/conda/bin directory is part of the default jovyan user's $PATH. That "
"directory is also whitelisted for use in sudo commands by the start.sh "
"script."
msgstr ""
# 6c8c478e872d444b904fecd01e9911da
#: ../../using/common.md:107
msgid ""
"The jovyan user has full read/write access to the /opt/conda directory. You "
"can use either conda or pip to install new packages without any additional "
"permissions."
msgstr ""
# cdff04cd2c814d2a993dcf793c1a32a0
#: ../../using/recipes.md:1
msgid "Contributed Recipes"
msgstr ""
# 674d282d2bc64a07b2d1aae14a954453
#: ../../using/recipes.md:3
msgid ""
"Users sometimes share interesting ways of using the Jupyter Docker Stacks. "
"We encourage users to contribute these recipes to the documentation in case "
"they prove useful to other members of the community by submitting a pull "
"request to docs/using/recipes.md. The sections below capture this knowledge."
msgstr ""
# a01a0ec46bc8469290ee140a69d6b0a4
#: ../../using/recipes.md:5
msgid "Using pip install or conda install in a Child Docker image"
msgstr ""
# 95d414d34880400bb6f17842eaacdb47
#: ../../using/recipes.md:7
msgid "Create a new Dockerfile like the one shown below."
msgstr ""
# 1fa3f126a9a6401d9941748e79380f8e
#: ../../using/recipes.md:16
msgid "Then build a new image."
msgstr ""
# 1bff41f678f847d98ffa744cf037c502
#: ../../using/recipes.md:22
msgid ""
"To use a requirements.txt file, first create your requirements.txt file with"
" the listing of packages desired. Next, create a new Dockerfile like the "
"one shown below."
msgstr ""
# a11c4c3379f64b4f8028d4b4c7437292
#: ../../using/recipes.md:35
msgid "For conda, the Dockerfile is similar:"
msgstr ""
# 42213789b3a14b02a491455f3bcdfa9a
#: ../../using/recipes.md:47
msgid "Ref: docker-stacks/commit/79169618d571506304934a7b29039085e77db78c"
msgstr ""
# 471f68531d274ce4a7ad2a9f4274d8a9
#: ../../using/recipes.md:49
msgid "Add a Python 2.x environment"
msgstr ""
# c721d45a7e9e4ce99799d587a7aa0921
#: ../../using/recipes.md:51
msgid ""
"Python 2.x was removed from all images on August 10th, 2017, starting in tag"
" cc9feab481f7. You can add a Python 2.x environment by defining your own "
"Dockerfile inheriting from one of the images like so:"
msgstr ""
# e07ac0abd67c4bb2a746953b44cd2ba8
#: ../../using/recipes.md:73
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/440"
msgstr ""
# 88ae461b17e140a1ae71a9c175b4bd0d
#: ../../using/recipes.md:75
msgid "Run JupyterLab"
msgstr ""
# dbf08b368b5346ec8f6549737e561e5f
#: ../../using/recipes.md:77
msgid ""
"JupyterLab is preinstalled as a notebook extension starting in tag "
"c33a7dc0eece."
msgstr ""
# 866e89573c5d4a70abd44bf374ed2e62
#: ../../using/recipes.md:79
msgid ""
"Run jupyterlab using a command such as docker run -it --rm -p 8888:8888 "
"jupyter/datascience-notebook start.sh jupyter lab"
msgstr ""
# 1531d01600af476b8401421c9305cdf3
#: ../../using/recipes.md:81
msgid "Let's Encrypt a Notebook server"
msgstr ""
# ac1d8a654ce64ec3b318d9c341602e1a
#: ../../using/recipes.md:83
msgid ""
"See the README for the simple automation here https://github.com/jupyter"
"/docker-stacks/tree/master/examples/make-deploy which includes steps for "
"requesting and renewing a Let's Encrypt certificate."
msgstr ""
# 17ac8453774a4b028df89f2bdb3feec1
#: ../../using/recipes.md:85
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/78"
msgstr ""
# 020d1144ff094e49ba690fd3292bad1a
#: ../../using/recipes.md:87
msgid "Slideshows with Jupyter and RISE"
msgstr ""
# b84e3e74e66349a695be5f2eb177757b
#: ../../using/recipes.md:89
msgid ""
"RISE allows via extension to create live slideshows of your notebooks, with "
"no conversion, adding javascript Reveal.js:"
msgstr ""
# 14fd425e7dad41c9b00fee87d7d2225e
#: ../../using/recipes.md:95
msgid "Credit: Paolo D. based on docker-stacks/issues/43"
msgstr ""
# 3e38842bbf0244f5897f995d7744d4ed
#: ../../using/recipes.md:97
msgid "xgboost"
msgstr ""
# daf9711129e84131ad1f676e646f9e03
#: ../../using/recipes.md:99
msgid ""
"You need to install conda's gcc for Python xgboost to work properly. "
"Otherwise, you'll get an exception about libgomp.so.1 missing GOMP_4.0."
msgstr ""
# faf7639219434c4d902b0e9bd6e626c2
#: ../../using/recipes.md:109
msgid "Running behind a nginx proxy"
msgstr ""
# 912ad155cb4a45069d9e8ec8b1b87cb0
#: ../../using/recipes.md:111
msgid ""
"Sometimes it is useful to run the Jupyter instance behind a nginx proxy, for"
" instance:"
msgstr ""
# 7adc9717c9f84756963824bb3b851eda
#: ../../using/recipes.md:113
msgid ""
"you would prefer to access the notebook at a server URL with a path "
"(https://example.com/jupyter) rather than a port (https://example.com:8888)"
msgstr ""
# 1ed3d2d40ad948b19f6d1b5777c13f5f
#: ../../using/recipes.md:114
msgid ""
"you may have many different services in addition to Jupyter running on the "
"same server, and want to nginx to help improve server performance in manage "
"the connections"
msgstr ""
# 276ccfb626504c1fbe8d645f1c82a24f
#: ../../using/recipes.md:116
msgid ""
"Here is a quick example NGINX configuration to get started. You'll need a "
"server, a .crt and .key file for your server, and docker & docker-compose "
"installed. Then just download the files at that gist and run docker-compose"
" up -d to test it out. Customize the nginx.conf file to set the desired "
"paths and add other services."
msgstr ""
# ba9a795db881452d8a815f3bf2f3aa7a
#: ../../using/recipes.md:118
msgid "Host volume mounts and notebook errors"
msgstr ""
# 3cecb98fa6e54f99a09a04b81a4bc04e
#: ../../using/recipes.md:120
msgid ""
"If you are mounting a host directory as /home/jovyan/work in your container "
"and you receive permission errors or connection errors when you create a "
"notebook, be sure that the jovyan user (UID=1000 by default) has read/write "
"access to the directory on the host. Alternatively, specify the UID of the "
"jovyan user on container startup using the -e NB_UID option described in the"
" Common Features, Docker Options section"
msgstr ""
# b71f0c2e0f184959a9a6f0765b9f0b4e
#: ../../using/recipes.md:122
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/199"
msgstr ""
# 29b6203639a444d38051b7dd23195ad5
#: ../../using/recipes.md:124
msgid "Manpage installation"
msgstr ""
# a4261a1c819e48ef848fb16bacd237dd
#: ../../using/recipes.md:126
msgid ""
"Most containers, including our Ubuntu base image, ship without manpages "
"installed to save space. You can use the following dockerfile to inherit "
"from one of our images to enable manpages:"
msgstr ""
# df6c0841b76247a893a7494d446d63ad
#: ../../using/recipes.md:151
msgid ""
"Adding the documentation on top of an existing singleuser image wastes a lot"
" of space and requires reinstalling every system package, which can take "
"additional time and bandwidth; the datascience-notebook image has been shown"
" to grow by almost 3GB when adding manapages in this way. Enabling manpages "
"in the base Ubuntu layer prevents this container bloat:"
msgstr ""
# b41452481f5d421fa005b0e1a33bf9b4
#: ../../using/recipes.md:173
msgid ""
"Be sure to check the current base image in base-notebook before building."
msgstr ""
# 7b0274764c614b46b0a2e663231e59b7
#: ../../using/recipes.md:175
msgid "JupyterHub"
msgstr ""
# ccf49b18478443ecbd9fd7fc9c171cd9
#: ../../using/recipes.md:177
msgid "We also have contributed recipes for using JupyterHub."
msgstr ""
# e5835af60f9c4bfeb8e6995d703f730e
#: ../../using/recipes.md:179
msgid "Use JupyterHub's dockerspawner"
msgstr ""
# 9305102339904086861ef2246beb8f08
#: ../../using/recipes.md:181
msgid ""
"In most cases for use with DockerSpawner, given any image that already has a"
" notebook stack set up, you would only need to add:"
msgstr ""
# 5d92054033604627ae5b3161c3d0b903
#: ../../using/recipes.md:183
msgid "install the jupyterhub-singleuser script (for the right Python)"
msgstr ""
# fcf37a1789f84906bde9085583cff95b
#: ../../using/recipes.md:184
msgid "change the command to launch the single-user server"
msgstr ""
# e6f1488b2ffb4beaa2414ca545f10261
#: ../../using/recipes.md:186
msgid ""
"Swapping out the FROM line in the jupyterhub/singleuser Dockerfile should be"
" enough for most cases."
msgstr ""
# bbd864e6695a4cca862d9fa909b51dc0
#: ../../using/recipes.md:188
msgid ""
"Credit: Justin Tyberg, quanghoc, and Min RK based on docker-"
"stacks/issues/124 and docker-stacks/pull/185"
msgstr ""
# 260577d0e15f4102bbad7486357528d4
#: ../../using/recipes.md:190
msgid "Containers with a specific version of JupyterHub"
msgstr ""
# 041f84f19f0e4d4c8b050a2ccc2cb812
#: ../../using/recipes.md:192
msgid ""
"To use a specific version of JupyterHub, the version of jupyterhub in your "
"image should match the version in the Hub itself."
msgstr ""
# 41410dcc4e264932b64e96e6857b1bd3
#: ../../using/recipes.md:199
msgid "Credit: MinRK"
msgstr ""
# 68fe2ae525474d91af1d8647378f078b
#: ../../using/recipes.md:202
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/177"
msgstr ""
# 3b6b7a3b35aa42a8a70a5c9e91af21d2
#: ../../using/recipes.md:204
msgid "Spark"
msgstr ""
# 8d1092f2b1a64da292134b240b621f48
#: ../../using/recipes.md:206
msgid ""
"A few suggestions have been made regarding using Docker Stacks with spark."
msgstr ""
# 54e47498667747d1a7f576895d140c6f
#: ../../using/recipes.md:208
msgid "Using PySpark with AWS S3"
msgstr ""
# 127111e623114603b4c841b66ce8f16f
#: ../../using/recipes.md:210
msgid "Using Spark session for hadoop 2.7.3"
msgstr ""
# 5454399deea24bb2a166ddd1fd168752
#: ../../using/recipes.md:230
msgid "Using Spark context for hadoop 2.6.0"
msgstr ""
# af0c5beb70664b74b6798a869023b3ca
#: ../../using/recipes.md:252
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/127"
msgstr ""
# 56531d33de8c46bb853db7ecef65d1ef
#: ../../using/recipes.md:254
msgid "Using Local Spark JARs"
msgstr ""
# 783af638cf454b6ea8bfd04df9da967f
#: ../../using/recipes.md:270
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/154"
msgstr ""
# 80df4b671dc64d9bad9bd2915524fe02
#: ../../using/recipes.md:272
msgid "Using spark-packages.org"
msgstr ""
# 14c79ea3fbf446fc92ab63c36e874f96
#: ../../using/recipes.md:274
msgid ""
"If you'd like to use packages from spark-packages.org, see "
"https://gist.github.com/parente/c95fdaba5a9a066efaab for an example of how "
"to specify the package identifier in the environment before creating a "
"SparkContext."
msgstr ""
# 5a1cab88fa6c477a99f4352670b6cf76
#: ../../using/recipes.md:276
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/43"
msgstr ""
# 753a64e86395492481c9541dcb91f0ed
#: ../../using/recipes.md:278
msgid "Use jupyter/all-spark-notebooks with an existing Spark/YARN cluster"
msgstr ""
# 53fbe7a910d84359af93acf195711ffd
#: ../../using/recipes.md:342
msgid "Credit: britishbadger from docker-stacks/issues/369"
msgstr ""
# c82c3fc2484d48d5889dd8e3e79723b2
#: ../../using/recipes.md:344
msgid ""
"Run Jupyter Notebook/Lab inside an already secured environment (i.e., with "
"no token)"
msgstr ""
# 53c63d298efa42cab5d39c3b242d44e0
#: ../../using/recipes.md:346
msgid "(Adapted from issue 728)"
msgstr ""
# cb4bd116d7334212b7fa5a78602e370d
#: ../../using/recipes.md:348
msgid ""
"The default security is very good. There are use cases, encouraged by "
"containers, where the jupyter container and the system it runs within, lie "
"inside the security boundary. In these use cases it is convenient to launch "
"the server without a password or token. In this case, you should use the "
"start.sh script to launch the server with no token:"
msgstr ""
# 59cd4c1e695f42c09ea911048769f8b7
#: ../../using/recipes.md:354
msgid "For jupyterlab:"
msgstr ""
# 49d382c7a9c14ddda58b2e88521dc3bc
#: ../../using/recipes.md:360
msgid "For jupyter classic:"
msgstr ""
# 297f3ad3d8504a75a0fd5659fa73b67c
#: ../../using/recipes.md:365
msgid ""
"Enable nbextension spellchecker for markdown (or any other nbextension)"
msgstr ""
# e2b10f15c91e4db9b7898a1a191526c7
#: ../../using/recipes.md:367
msgid "NB: this works for classic notebooks only"
msgstr ""
# 158be3dba029417b832640f01cd22f75
#: ../../using/recipes.md:380
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/675"
msgstr ""
# ade5800ecee24c9eb4f16af9585951fc
#: ../../using/running.md:1
msgid "Running a Container"
msgstr ""
# da480368616a4ffa976061bdc0128763
# 1b0a0481a9454392a32c005d7513e453
#: ../../using/running.md:3 ../../using/selecting.md:7
msgid "Using one of the Jupyter Docker Stacks requires two choices:"
msgstr ""
# d94683d29b6341a98420c4e6adebc4bb
# 436b43aa9da944d281cf51ea731d286a
#: ../../using/running.md:5 ../../using/selecting.md:9
msgid "Which Docker image you wish to use"
msgstr ""
# de5bb072aa194beebbf587038b36bdcf
# fca43aa36e854a9ab4d2b2816c015847
#: ../../using/running.md:6 ../../using/selecting.md:10
msgid "How you wish to start Docker containers from that image"
msgstr ""
# 19634063eb14436daa48af3b1ee3fcc5
#: ../../using/running.md:8
msgid "This section provides details about the second."
msgstr ""
# b855cc98da54497fa98956b68d00e840
#: ../../using/running.md:10
msgid "Using the Docker CLI"
msgstr ""
# 555174be66b049e2ad53de52d8e37aa0
#: ../../using/running.md:12
msgid ""
"You can launch a local Docker container from the Jupyter Docker Stacks using"
" the Docker command line interface. There are numerous ways to configure "
"containers using the CLI. The following are some common patterns."
msgstr ""
# d433157f1f834a66b66143513ffe8c9d
#: ../../using/running.md:14
msgid ""
"Example 1 This command pulls the jupyter/scipy-notebook image tagged "
"2c80cf3537ca from Docker Hub if it is not already present on the local host."
" It then starts a container running a Jupyter Notebook server and exposes "
"the server on host port 8888. The server logs appear in the terminal and "
"include a URL to the notebook server."
msgstr ""
# 3a56c8c4932644e6b938b5401fb98d26
#: ../../using/running.md:36
msgid ""
"Pressing Ctrl-C shuts down the notebook server but leaves the container "
"intact on disk for later restart or permanent deletion using commands like "
"the following:"
msgstr ""
# e3f24ae3050d452aa42f3a92ba36f61c
#: ../../using/running.md:55
msgid ""
"Example 2 This command pulls the jupyter/r-notebook image tagged "
"e5c5a7d3e52d from Docker Hub if it is not already present on the local host."
" It then starts a container running a Jupyter Notebook server and exposes "
"the server on host port 10000. The server logs appear in the terminal and "
"include a URL to the notebook server, but with the internal container port "
"(8888) instead of the the correct host port (10000)."
msgstr ""
# d54172836b0349cb8e8ccbcb6c33ec45
#: ../../using/running.md:77
msgid ""
"Pressing Ctrl-C shuts down the notebook server and immediately destroys the "
"Docker container. Files written to ~/work in the container remain touched. "
"Any other changes made in the container are lost."
msgstr ""
# 0d90bfa0543f4669a0b2bb4b62e2e7dc
#: ../../using/running.md:79
msgid ""
"Example 3 This command pulls the jupyter/all-spark-notebook image currently "
"tagged latest from Docker Hub if an image tagged latest is not already "
"present on the local host. It then starts a container named notebook running"
" a JupyterLab server and exposes the server on a randomly selected port."
msgstr ""
# 04e49785faff4511b8576e9d997bea67
#: ../../using/running.md:85
msgid ""
"The assigned port and notebook server token are visible using other Docker "
"commands."
msgstr ""
# f88af44236f948ccbda342b1c93364d3
#: ../../using/running.md:99
msgid ""
"Together, the URL to visit on the host machine to access the server in this "
"case is "
"http://localhost:32769?token=15914ca95f495075c0aa7d0e060f1a78b6d94f70ea373b00."
msgstr ""
# ed09c347d7aa4dd79e505562f4f5efdd
#: ../../using/running.md:101
msgid ""
"The container runs in the background until stopped and/or removed by "
"additional Docker commands."
msgstr ""
# 7fdc11c0394e4af88bb3c3178814d184
#: ../../using/running.md:113
msgid "Using Binder"
msgstr ""
# 69b162f507f14323b3dbf8758e2964b2
#: ../../using/running.md:115
msgid ""
"Binder is a service that allows you to create and share custom computing "
"environments for projects in version control. You can use any of the Jupyter"
" Docker Stacks images as a basis for a Binder-compatible Dockerfile. See the"
" docker-stacks example and Using a Dockerfile sections in the Binder "
"documentation for instructions."
msgstr ""
# f148f5335f354e549f00dce0cc630475
#: ../../using/running.md:117
msgid "Using JupyterHub"
msgstr ""
# a23469fb52db4edfb3e98c1dc3115b50
#: ../../using/running.md:119
msgid ""
"You can configure JupyterHub to launcher Docker containers from the Jupyter "
"Docker Stacks images. If you've been following the Zero to JupyterHub with "
"Kubernetes guide, see the Use an existing Docker image section for details. "
"If you have a custom JupyterHub deployment, see the Picking or building a "
"Docker image instructions for the dockerspawner instead."
msgstr ""
# bb8d103e20df4ebab2321ae4eee584e7
#: ../../using/running.md:121
msgid "Using Other Tools and Services"
msgstr ""
# c6ef8c5aac54431d931df9f5d5f890d5
#: ../../using/running.md:123
msgid ""
"You can use the Jupyter Docker Stacks with any Docker-compatible technology "
"(e.g., Docker Compose, docker-py, your favorite cloud container service). "
"See the documentation of the tool, library, or service for details about how"
" to reference, configure, and launch containers from these images."
msgstr ""
# d34ba542e6ed43a7b490cfa65b67d9c3
#: ../../using/selecting.md:1
msgid "Selecting an Image"
msgstr ""
# 70b39f1dbdb242599b33cd78bbe6a850
# cb08cf9b24364322a943a40bea1fd39f
#: ../../using/selecting.md:3 ../../using/selecting.md:14
msgid "Core Stacks"
msgstr ""
# 7a8f664007004185a07b672d25205ca2
# 5040afcacc8d4cdeb5bc9b0ed6a06c88
#: ../../using/selecting.md:4 ../../using/selecting.md:123
msgid "Image Relationships"
msgstr ""
# e364abca4ff948f5a6dba4d5685f9fe8
# ae86feb2ae9c4ed081379460d4a559fb
#: ../../using/selecting.md:5 ../../using/selecting.md:141
msgid "Community Stacks"
msgstr ""
# 27b83c7429d142b89e0e425b662e94a9
#: ../../using/selecting.md:12
msgid "This section provides details about the first."
msgstr ""
# b24fe11f42e84aaf8d2378535737148e
#: ../../using/selecting.md:16
msgid ""
"The Jupyter team maintains a set of Docker image definitions in the "
"https://github.com/jupyter/docker-stacks GitHub repository. The following "
"sections describe these images including their contents, relationships, and "
"versioning strategy."
msgstr ""
# 6562071d34574731baa6241fc067690c
#: ../../using/selecting.md:18
msgid "jupyter/base-notebook"
msgstr ""
# 79c95b7cb9df4670a0fab5737942396f
# 2d8e2926bd6f4db69959f5f0456c4682
# 6d074c8de6fd4895b715a3525ccb8bb4
# 7337ce8d03e5474887cd6affc21ec03b
# 2fb0a6afd5b24c33820ccaed19dd886d
# 1ad0f64aec2c4439937fa4d02ee0fe49
# f955c9a3be324d2db1f47a643b9d51a3
# 667016f994f84648853707ce13241d45
#: ../../using/selecting.md:20 ../../using/selecting.md:37
#: ../../using/selecting.md:49 ../../using/selecting.md:63
#: ../../using/selecting.md:76 ../../using/selecting.md:87
#: ../../using/selecting.md:100 ../../using/selecting.md:112
msgid "Source on GitHub | Dockerfile commit history | Docker Hub image tags"
msgstr ""
# 864aa76e1043469fa96b27f26dcad7d1
#: ../../using/selecting.md:24
msgid ""
"jupyter/base-notebook is a small image supporting the options common across "
"all core stacks. It is the basis for all other stacks."
msgstr ""
# d869d6c4081e483180f51de5f5e225a7
#: ../../using/selecting.md:26
msgid ""
"Minimally-functional Jupyter Notebook server (e.g., no pandoc for saving "
"notebooks as PDFs)"
msgstr ""
# d6384943a3394b9d9a5a505e2387d392
#: ../../using/selecting.md:27
msgid "Miniconda Python 3.x in /opt/conda"
msgstr ""
# 031a321f6173495daef86225cd234a72
#: ../../using/selecting.md:28
msgid "No preinstalled scientific computing packages"
msgstr ""
# e37862b78262475182c34461d2fae08e
#: ../../using/selecting.md:29
msgid ""
"Unprivileged user jovyan (uid=1000, configurable, see options) in group "
"users (gid=100) with ownership over the /home/jovyan and /opt/conda paths"
msgstr ""
# cdd04f4dbb864e82b8b993ccb1670687
#: ../../using/selecting.md:30
msgid ""
"tini as the container entrypoint and a start-notebook.sh script as the "
"default command"
msgstr ""
# 0e3cf3b3a6e540be861ef295f1808099
#: ../../using/selecting.md:31
msgid ""
"A start-singleuser.sh script useful for launching containers in JupyterHub"
msgstr ""
# 3b561d51339f422d801a408007ca16f3
#: ../../using/selecting.md:32
msgid ""
"A start.sh script useful for running alternative commands in the container "
"(e.g. ipython, jupyter kernelgateway, jupyter lab)"
msgstr ""
# 9e8346716bc148fb8df45bce44fa7c38
#: ../../using/selecting.md:33
msgid "Options for a self-signed HTTPS certificate and passwordless sudo"
msgstr ""
# ee56473bbb334a9b96db5870f6be611c
#: ../../using/selecting.md:35
msgid "jupyter/minimal-notebook"
msgstr ""
# eec9e5e3162343eba481b73cc223fa49
#: ../../using/selecting.md:41
msgid ""
"jupyter/minimal-notebook adds command line tools useful when working in "
"Jupyter applications."
msgstr ""
# cf19dcbf0d084508924f166d2b0fa7e3
#: ../../using/selecting.md:43
msgid "Everything in jupyter/base-notebook"
msgstr ""
# 52d17abfd2f14628a9937f1b7584582d
#: ../../using/selecting.md:44
msgid "Pandoc and TeX Live for notebook document conversion"
msgstr ""
# b81070edc9c849c184be4687ce17b786
#: ../../using/selecting.md:45
msgid "git, emacs, jed, nano, tzdata, and unzip"
msgstr ""
# aa65fcb5d17649bb88ded23f0880e147
#: ../../using/selecting.md:47
msgid "jupyter/r-notebook"
msgstr ""
# 54b4b695a8ed493bb79993e62dd164c2
#: ../../using/selecting.md:53
msgid "jupyter/r-notebook includes popular packages from the R ecosystem."
msgstr ""
# d83a0f40bfc34554a0c362f02c656e55
# c27e75f042064ae0a64447053b46785e
#: ../../using/selecting.md:55 ../../using/selecting.md:69
msgid "Everything in jupyter/minimal-notebook and its ancestor images"
msgstr ""
# 99e3f1d20553480c81dda15a66369f52
#: ../../using/selecting.md:56
msgid "The R interpreter and base environment"
msgstr ""
# 34bc2c80ad014b019fb54fc1fad024c4
# 8c5a996a6b0c4309810071f5194f532a
#: ../../using/selecting.md:57 ../../using/selecting.md:119
msgid "IRKernel to support R code in Jupyter notebooks"
msgstr ""
# a24d121e485e4bd9bbe4df9883a7c148
#: ../../using/selecting.md:58
msgid ""
"tidyverse packages, including ggplot2, dplyr, tidyr, readr, purrr, tibble, "
"stringr, lubridate, and broom from conda-forge"
msgstr ""
# d49e405f45dd40a69e64b1636f69381d
#: ../../using/selecting.md:59
msgid ""
"plyr, devtools, shiny, rmarkdown, forecast, rsqlite, reshape2, nycflights13,"
" caret, rcurl, and randomforest packages from conda-forge"
msgstr ""
# 9cfe9452daa04dfc982c2d99948a37eb
#: ../../using/selecting.md:61
msgid "jupyter/scipy-notebook"
msgstr ""
# 47f831c00a78451bb75de1467d90d34c
#: ../../using/selecting.md:67
msgid ""
"jupyter/scipy-notebook includes popular packages from the scientific Python "
"ecosystem."
msgstr ""
# da192888520b4b2ca9ae8ca5162aba6c
#: ../../using/selecting.md:70
msgid ""
"pandas, numexpr, matplotlib, scipy, seaborn, scikit-learn, scikit-image, "
"sympy, cython, patsy, statsmodel, cloudpickle, dill, numba, bokeh, "
"sqlalchemy, hdf5, vincent, beautifulsoup, protobuf, and xlrd packages"
msgstr ""
# be048a3494074da99c0f5b98454feda8
#: ../../using/selecting.md:71
msgid "ipywidgets for interactive visualizations in Python notebooks"
msgstr ""
# c3e92433ff5f4702beeaea78d6ee6fd7
#: ../../using/selecting.md:72
msgid "Facets for visualizing machine learning datasets"
msgstr ""
# ff01e76ad1544fb48e024a617ae932b5
#: ../../using/selecting.md:74
msgid "jupyter/tensorflow-notebook"
msgstr ""
# bf2f117cf3a047aa8be8cd73f4080455
#: ../../using/selecting.md:80
msgid ""
"jupyter/tensorflow-notebook includes popular Python deep learning libraries."
msgstr ""
# 1fccef5b590549ffb4ea6933eaf12674
# 1140d31915eb42fc89725521ec90c1dc
#: ../../using/selecting.md:82 ../../using/selecting.md:106
msgid "Everything in jupyter/scipy-notebook and its ancestor images"
msgstr ""
# 099eb36a6961440b8bea7901b226a96d
#: ../../using/selecting.md:83
msgid "tensorflow and keras machine learning libraries"
msgstr ""
# 13413eabaac34b94b4bc5ae28e445dda
#: ../../using/selecting.md:85
msgid "jupyter/datascience-notebook"
msgstr ""
# 23244942c9ef4eb8aba10cd558bf5fe9
#: ../../using/selecting.md:91
msgid ""
"jupyter/datascience-notebook includes libraries for data analysis from the "
"Julia, Python, and R communities."
msgstr ""
# 7e65863f6a0840729876d3669158c4ce
#: ../../using/selecting.md:93
msgid ""
"Everything in the jupyter/scipy-notebook and jupyter/r-notebook images, and "
"their ancestor images"
msgstr ""
# 6246f4a0d2454714860e4ffa80aef958
#: ../../using/selecting.md:94
msgid "The Julia compiler and base environment"
msgstr ""
# 143e63b9b0a9418a8c93870f6186808e
#: ../../using/selecting.md:95
msgid "IJulia to support Julia code in Jupyter notebooks"
msgstr ""
# 7a170fe5f6a949cc939d2f40200b3336
#: ../../using/selecting.md:96
msgid "HDF5, Gadfly, and RDatasets packages"
msgstr ""
# 4b741debc1e84661ab63b8bf0d9c3bbe
#: ../../using/selecting.md:98
msgid "jupyter/pyspark-notebook"
msgstr ""
# 815f62ec44f54dbfaa5a052d15580b94
#: ../../using/selecting.md:104
msgid ""
"jupyter/pyspark-notebook includes Python support for Apache Spark, "
"optionally on Mesos."
msgstr ""
# 0cb03ee6cd9d488597be17be045f3b74
#: ../../using/selecting.md:107
msgid "Apache Spark with Hadoop binaries"
msgstr ""
# 977ee95d9f664fe2a62505e0a78b1447
#: ../../using/selecting.md:108
msgid "Mesos client libraries"
msgstr ""
# 43c0814f5a024a598dd26a4af0212cea
#: ../../using/selecting.md:110
msgid "jupyter/all-spark-notebook"
msgstr ""
# 0c1536b3ff6d40a885e9cdd881dc19bd
#: ../../using/selecting.md:116
msgid ""
"jupyter/all-spark-notebook includes Python, R, and Scala support for Apache "
"Spark, optionally on Mesos."
msgstr ""
# ecf9548ffc5e4e0eb4bbdf6cb458cf32
#: ../../using/selecting.md:118
msgid "Everything in jupyter/pyspark-notebook and its ancestor images"
msgstr ""
# 5f6081607cab47739c306516cf84a814
#: ../../using/selecting.md:120
msgid ""
"Apache Toree and spylon-kernel to support Scala code in Jupyter notebooks"
msgstr ""
# a4b50e47f8684dfbbe71e0c3353199dd
#: ../../using/selecting.md:121
msgid "ggplot2, sparklyr, and rcurl packages"
msgstr ""
# ebbdf9189d96433e9323aae035f37ec2
#: ../../using/selecting.md:125
msgid ""
"The following diagram depicts the build dependency tree of the core images. "
"(i.e., the FROM statements in their Dockerfiles). Any given image inherits "
"the complete content of all ancestor images pointing to it."
msgstr ""
# df2da8e55aa740a485fd638aa7397b8a
#: ../../using/selecting.md:129
msgid "Builds"
msgstr ""
# 56066ef1cd834061b3c3aea7567221c7
#: ../../using/selecting.md:131
msgid ""
"Pull requests to the jupyter/docker-stacks repository trigger builds of all "
"images on Travis CI. These images are for testing purposes only and are not "
"saved for use. When pull requests merge to master, all images rebuild on "
"Docker Cloud and become available to docker pull from Docker Hub."
msgstr ""
# f4781cd0f2c040458a15b80846026405
#: ../../using/selecting.md:133
msgid "Versioning"
msgstr ""
# 28addf6682f24cbdb1b6cd1836a6dc74
#: ../../using/selecting.md:135
msgid ""
"The latest tag in each Docker Hub repository tracks the master branch HEAD "
"reference on GitHub. latest is a moving target, by definition, and will have"
" backward-incompatible changes regularly."
msgstr ""
# 92c07d80753b4fda9406b3b2694684e7
#: ../../using/selecting.md:137
msgid ""
"Every image on Docker Hub also receives a 12-character tag which corresponds"
" with the git commit SHA that triggered the image build. You can inspect the"
" state of the jupyter/docker-stacks repository for that commit to review the"
" definition of the image (e.g., images with tag 7c45ec67c8e7 were built from"
" https://github.com/jupyter/docker-stacks/tree/7c45ec67c8e7)."
msgstr ""
# 5bdfd71620394fa4812120220718ffeb
#: ../../using/selecting.md:139
msgid ""
"You must refer to git-SHA image tags when stability and reproducibility are "
"important in your work. (e.g. FROM jupyter/scipy-notebook:7c45ec67c8e7, "
"docker run -it --rm jupyter/scipy-notebook:7c45ec67c8e7). You should only "
"use latest when a one-off container instance is acceptable (e.g., you want "
"to briefly try a new library in a notebook)."
msgstr ""
# 90cc227d51734f8586d42982f3b7a559
#: ../../using/selecting.md:143
msgid ""
"The core stacks are just a tiny sample of what's possible when combining "
"Jupyter with other technologies. We encourage members of the Jupyter "
"community to create their own stacks based on the core images and link them "
"below."
msgstr ""
# f1c9edb79eae4a5f929fdc1e0e2d4366
#: ../../using/selecting.md:145
msgid "This list only has 2 examples. You can be the next!"
msgstr ""
# 7346986f864848708411fa0788d3b4e4
#: ../../using/selecting.md:147
msgid ""
"csharp-notebook is a community Jupyter Docker Stack image. Try C# in Jupyter"
" Notebooks. The image includes more than 200 Jupyter Notebooks with example "
"C# code and can readily be tried online via mybinder.org. Click here to "
"launch ."
msgstr ""
# a2e061cf04bf4e96a4d40c03790d64bc
#: ../../using/selecting.md:149
msgid ""
"education-notebook is a community Jupyter Docker Stack image. The image "
"includes nbgrader and RISE on top of the datascience-notebook image. Click "
"here to launch it on ."
msgstr ""
# c3720b9d103947499b34ebd19567733f
#: ../../using/selecting.md:151
msgid ""
"See the contributing guide for information about how to create your own "
"Jupyter Docker Stack."
msgstr ""
# b9f784eaaa0a4072929bc51254fa322e
#: ../../using/specifics.md:1
msgid "Image Specifics"
msgstr ""
# dfb2958ae819459383ad8c75ba65dd39
#: ../../using/specifics.md:3
msgid ""
"This page provides details about features specific to one or more images."
msgstr ""
# 9cfa68a10a3c4eb8b63c435e43bf77fc
#: ../../using/specifics.md:5
msgid "Apache Spark"
msgstr ""
# 536591b439514687b086cf6a4c6f7a93
#: ../../using/specifics.md:7
msgid ""
"The jupyter/pyspark-notebook and jupyter/all-spark-notebook images support "
"the use of Apache Spark in Python, R, and Scala notebooks. The following "
"sections provide some examples of how to get started using them."
msgstr ""
# 21d870dca44845948d9ab959f8ccc105
#: ../../using/specifics.md:9
msgid "Using Spark Local Mode"
msgstr ""
# bda9eb0bb22b4e8e8662fcd037d9d585
#: ../../using/specifics.md:11
msgid ""
"Spark local mode is useful for experimentation on small data when you do not"
" have a Spark cluster available."
msgstr ""
# 91033be3c31b48d4a1a6a235491bd897
# 6cc19049cacb4403989934496ecc4375
#: ../../using/specifics.md:13 ../../using/specifics.md:71
msgid "In a Python Notebook"
msgstr ""
# 556a0ebdcab54a87b01f1b8bed45628e
# 823b89e12a514c54b10255bcc2081397
#: ../../using/specifics.md:24 ../../using/specifics.md:98
msgid "In a R Notebook"
msgstr ""
# a42af3a3c0a44602b15d8d7ed52d267b
# cb0340653342464892f57379cf775ea9
#: ../../using/specifics.md:36 ../../using/specifics.md:119
msgid "In a Spylon Kernel Scala Notebook"
msgstr ""
# f6efc67ea4d14900a978e0d581e6448a
#: ../../using/specifics.md:38
msgid ""
"Spylon kernel instantiates a SparkContext for you in variable sc after you "
"configure Spark options in a %%init_spark magic cell."
msgstr ""
# 48c05ebdfde54ea6b8794b47171a6c10
# 66315cf3b7554105bfeaf6a3a5b43b73
#: ../../using/specifics.md:52 ../../using/specifics.md:134
msgid "In an Apache Toree Scala Notebook"
msgstr ""
# 5d8060e95aa941e58a64d0465dbacafa
#: ../../using/specifics.md:54
msgid ""
"Apache Toree instantiates a local SparkContext for you in variable sc when "
"the kernel starts."
msgstr ""
# 1a30fe3a85fa44b1860efb1e8bf123e3
#: ../../using/specifics.md:61
msgid "Connecting to a Spark Cluster on Mesos"
msgstr ""
# 74263d337820458d851a4b869d14f1cf
#: ../../using/specifics.md:63
msgid ""
"This configuration allows your compute cluster to scale with your data."
msgstr ""
# c7ca76d01c6e4f10ad8f793b65dc41db
#: ../../using/specifics.md:65
msgid "Deploy Spark on Mesos."
msgstr ""
# 296f9c1d6f2a4950a1147913198bc1bc
#: ../../using/specifics.md:66
msgid ""
"Configure each slave with the --no-switch_user flag or create the $NB_USER "
"account on every slave node."
msgstr ""
# 2d988e27cde44fa09feaed27ce3b7a06
# 6045e72f079c4fc2ab9e3ce622968bc8
#: ../../using/specifics.md:67 ../../using/specifics.md:163
msgid ""
"Run the Docker container with --net=host in a location that is network "
"addressable by all of your Spark workers. (This is a Spark networking "
"requirement.)"
msgstr ""
# f20142628b0f40379f87031abd6461b2
# b00bbd0a10d4480db69f870cdf5fe094
#: ../../using/specifics.md:68 ../../using/specifics.md:164
msgid ""
"NOTE: When using --net=host, you must also use the flags --pid=host -e "
"TINI_SUBREAPER=true. See https://github.com/jupyter/docker-stacks/issues/64 "
"for details."
msgstr ""
# 46c5b891e7ce4fa78d3c0eeff0e22635
#: ../../using/specifics.md:69
msgid "Follow the language specific instructions below."
msgstr ""
# 90c742c66172412c862fcf09a2661bf5
#: ../../using/specifics.md:136
msgid ""
"The Apache Toree kernel automatically creates a SparkContext when it starts "
"based on configuration information from its command line arguments and "
"environment variables. You can pass information about your Mesos cluster via"
" the SPARK_OPTS environment variable when you spawn a container."
msgstr ""
# 7c2b15ef25ba4cd29ff222b808a8fd68
#: ../../using/specifics.md:138
msgid ""
"For instance, to pass information about a Mesos master, Spark binary "
"location in HDFS, and an executor options, you could start the container "
"like so:"
msgstr ""
# 94f9511094e044f08129c273ce3efaf0
#: ../../using/specifics.md:146
msgid ""
"Note that this is the same information expressed in a notebook in the Python"
" case above. Once the kernel spec has your cluster information, you can test"
" your cluster in an Apache Toree notebook like so:"
msgstr ""
# e0c67007d0cc4c9da0fb73d5ed25356d
#: ../../using/specifics.md:157
msgid "Connecting to a Spark Cluster in Standalone Mode"
msgstr ""
# 6c6f7d3049814b25a3acf211e2587ec2
#: ../../using/specifics.md:159
msgid ""
"Connection to Spark Cluster on Standalone Mode requires the following set of"
" steps:"
msgstr ""
# 4634540d7990421fb60e85b6241dd816
#: ../../using/specifics.md:161
msgid ""
"Verify that the docker image (check the Dockerfile) and the Spark Cluster "
"which is being deployed, run the same version of Spark."
msgstr ""
# d6b4329933e24b69879a4621b26bf454
#: ../../using/specifics.md:162
msgid "Deploy Spark in Standalone Mode."
msgstr ""
# 3dfcc2e12ca34c92ac8ebf96e4a37066
#: ../../using/specifics.md:165
msgid ""
"The language specific instructions are almost same as mentioned above for "
"Mesos, only the master url would now be something like "
"spark://10.10.10.10:7077"
msgstr ""
# 9e271f07799e4cb0a4b79df224a5639f
#: ../../using/specifics.md:167
msgid "Tensorflow"
msgstr ""
# 2a525d328e6f419f98d2ed3b99978e25
#: ../../using/specifics.md:169
msgid ""
"The jupyter/tensorflow-notebook image supports the use of Tensorflow in "
"single machine or distributed mode."
msgstr ""
# 4440ceaa200f4029b5cbaf9c895a8e5c
#: ../../using/specifics.md:171
msgid "Single Machine Mode"
msgstr ""
# d82de0694427429fa44d9988c1db4851
#: ../../using/specifics.md:185
msgid "Distributed Mode"
msgstr ""
docs/locale/zh/LC_MESSAGES/contributing.po
0 → 100644
View file @
ae5f7e10
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2018- Project Jupyter
# This file is distributed under the same license as the docker-stacks package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Micky Chan <chanmickyyun@gmail.com>, 2019
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: docker-stacks latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-04-21 17:25-0400\n"
"PO-Revision-Date: 2019-04-22 13:45+0000\n"
"Last-Translator: Micky Chan <chanmickyyun@gmail.com>, 2019\n"
"Language-Team: Chinese (https://www.transifex.com/project-jupyter/teams/97886/zh/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: zh\n"
"Plural-Forms: nplurals=1; plural=0;\n"
# 9527c87037fb4592a05d144d80f69f89
#: ../../contributing/features.md:1
msgid "New Features"
msgstr "新功能"
# 81de205103144b289398603fa4aee789
#: ../../contributing/features.md:3
msgid ""
"Thank you for contributing to the Jupyter Docker Stacks! We review pull "
"requests of new features (e.g., new packages, new scripts, new flags) to "
"balance the value of the images to the Jupyter community with the cost of "
"maintaining the images over time."
msgstr "感谢您为Jupyter Docker Stacks做出贡献! 我们审查新功能的拉取请求"
# b35331d86206420aa8235d20ef037215
#: ../../contributing/features.md:5
msgid "Suggesting a New Feature"
msgstr "建议一个新功能"
# 6c6b00518c1f4dc88049b82f213a36cc
#: ../../contributing/features.md:7
msgid ""
"Please follow the process below to suggest a new feature for inclusion in "
"one of the core stacks:"
msgstr ""
# a9cd9d0730cc4159aa227e970ae2d9d0
#: ../../contributing/features.md:9
msgid "Open a GitHub issue describing the feature you'd like to contribute."
msgstr ""
# 8433ea2c70b94556b9a62c35cb88a4c8
#: ../../contributing/features.md:10
msgid ""
"Discuss with the maintainers whether the addition makes sense in one of the "
"core stacks, as a recipe in the documentation, as a community stack, or as "
"something else entirely."
msgstr ""
# a995c15adfb7424e9852693b90569d7a
#: ../../contributing/features.md:12
msgid "Selection Criteria"
msgstr "选择标准"
# 981cef217f4e4225984c5c7989f592f8
#: ../../contributing/features.md:14
msgid ""
"Roughly speaking, we evaluate new features based on the following criteria:"
msgstr ""
# 32194c09119e428a871acb859d696500
#: ../../contributing/features.md:16
msgid ""
"Usefulness to Jupyter users: Is the feature generally applicable across "
"domains? Does it work with Jupyter Notebook, JupyterLab, JupyterHub, etc.?"
msgstr ""
# 7b5acf7ef5854ac4b2c55b1a51464796
#: ../../contributing/features.md:17
msgid ""
"Fit with the image purpose: Does the feature match the theme of the stack in"
" which it will be added? Would it fit better in a new, community stack?"
msgstr ""
# 55d1f51c3b264dcfb252771c83d8ca36
#: ../../contributing/features.md:18
msgid ""
"Complexity of build / runtime configuration: How many lines of code does the"
" feature require in one of the Dockerfiles or startup scripts? Does it "
"require new scripts entirely? Do users need to adjust how they use the "
"images?"
msgstr ""
# 2a332f3b95064b43a1833166fd84f53c
#: ../../contributing/features.md:19
msgid ""
"Impact on image metrics: How many bytes does the feature and its "
"dependencies add to the image(s)? How many minutes do they add to the build "
"time?"
msgstr ""
# 30966a8cde0844bd85f6114c65f79ec4
#: ../../contributing/features.md:20
msgid ""
"Ability to support the addition: Can existing maintainers answer user "
"questions and address future build issues? Are the contributors interested "
"in helping with long-term maintenance? Can we write tests to ensure the "
"feature continues to work over time?"
msgstr ""
# 6085a8c0829e411588a37777bfe5e0f4
#: ../../contributing/features.md:22
msgid "Submitting a Pull Request"
msgstr ""
# fa5dc8dbaedb483b888622cc9d1e94ae
#: ../../contributing/features.md:24
msgid ""
"If there's agreement that the feature belongs in one or more of the core "
"stacks:"
msgstr ""
# 23ae2ae62bdb4a35bc42d9efc7759944
#: ../../contributing/features.md:26
msgid ""
"Implement the feature in a local clone of the jupyter/docker-stacks project."
msgstr ""
# ef476261493c48d998fb384d651b4012
#: ../../contributing/features.md:27
msgid ""
"Please build the image locally before submitting a pull request. Building "
"the image locally shortens the debugging cycle by taking some load off "
"Travis CI, which graciously provides free build services for open source "
"projects like this one. If you use make, call:"
msgstr ""
# 6bd20fd181f44e39a4913154db0c7221
# 4277e486510d49a08448d209a5cdad69
# f8c596a67a4f43c1a1c82a0f38a846f7
#: ../../contributing/features.md:31 ../../contributing/packages.md:13
#: ../../contributing/tests.md:20
msgid "Submit a pull request (PR) with your changes."
msgstr ""
# a7aa4a8d9d3d44eda2f1cf757e569c4e
# d8f1d1f00b2a4e9690b4e0da736ac662
# e4f93545f2284342a2b3ad1f52eaf26c
#: ../../contributing/features.md:32 ../../contributing/packages.md:14
#: ../../contributing/tests.md:21
msgid ""
"Watch for Travis to report a build success or failure for your PR on GitHub."
msgstr ""
# f80657a299424b8685d452d70479bae6
#: ../../contributing/features.md:33
msgid "Discuss changes with the maintainers and address any build issues."
msgstr ""
# 57ead3e81b9b4ebaa7a3491818f60089
#: ../../contributing/issues.md:1
msgid "Project Issues"
msgstr ""
# f27080bf0c8d43a08f283b3c5e28ddc7
#: ../../contributing/issues.md:3
msgid ""
"We appreciate your taking the time to report an issue you encountered using "
"the Jupyter Docker Stacks. Please review the following guidelines when "
"reporting your problem."
msgstr ""
# 3713984479614d4aa9237328bc2e233b
#: ../../contributing/issues.md:7
msgid ""
"If you believe you’ve found a security vulnerability in any of the Jupyter "
"projects included in Jupyter Docker Stacks images, please report it to "
"security@ipython.org, not in the issue trackers on GitHub. If you prefer to "
"encrypt your security reports, you can use this PGP public key."
msgstr ""
# 0c7fad6ee9304bbe80baf1737d0f478c
#: ../../contributing/issues.md:13
msgid ""
"If you think your problem is unique to the Jupyter Docker Stacks images, "
"please search the jupyter/docker-stacks issue tracker to see if someone else"
" has already reported the same problem. If not, please open a new issue and "
"provide all of the information requested in the issue template."
msgstr ""
# 70860cacf75b40a687363712f3bf00ce
#: ../../contributing/issues.md:19
msgid ""
"If the issue you're seeing is with one of the open source libraries included"
" in the Docker images and is reproducible outside the images, please file a "
"bug with the appropriate open source project."
msgstr ""
# 76822159e56f40f3bb38ea93e054238c
#: ../../contributing/issues.md:22
msgid ""
"If you have a general question about how to use the Jupyter Docker Stacks in"
" your environment, in conjunction with other tools, with customizations, and"
" so on, please post your question on the Jupyter Discourse site."
msgstr ""
# 3815aec9c791444cbdf26a71e28a1f7c
#: ../../contributing/packages.md:1
msgid "Package Updates"
msgstr ""
# 0bc1f6af65c74cc5a812a14b9c5a055f
#: ../../contributing/packages.md:3
msgid ""
"We actively seek pull requests which update packages already included in the"
" project Dockerfiles. This is a great way for first-time contributors to "
"participate in developing the Jupyter Docker Stacks."
msgstr ""
# ff8faef49758489fb97ddaba60763a0e
#: ../../contributing/packages.md:5
msgid "Please follow the process below to update a package version:"
msgstr ""
# e3878a1a1a444bb592fe32f468693ed7
#: ../../contributing/packages.md:7
msgid ""
"Locate the Dockerfile containing the library you wish to update (e.g., base-"
"notebook/Dockerfile, scipy-notebook/Dockerfile)"
msgstr ""
# d5aac81ecab24592860296ab74936724
#: ../../contributing/packages.md:8
msgid ""
"Adjust the version number for the package. We prefer to pin the major and "
"minor version number of packages so as to minimize rebuild side-effects when"
" users submit pull requests (PRs). For example, you'll find the Jupyter "
"Notebook package, notebook, installed using conda with notebook=5.4.*."
msgstr ""
# 0eed3a80d95146bab769d4456addcce4
#: ../../contributing/packages.md:9
msgid ""
"Please build the image locally before submitting a pull request. Building "
"the image locally shortens the debugging cycle by taking some load off "
"Travis CI, which graciously provides free build services for open source "
"projects like this one. If you use make, call:"
msgstr ""
# 1be104e942024f2b98eb10e0006b9de3
#: ../../contributing/packages.md:15
msgid ""
"Discuss changes with the maintainers and address any build issues. Version "
"conflicts are the most common problem. You may need to upgrade additional "
"packages to fix build failures."
msgstr ""
# adf5db8b690d466a8d339c756a5a153c
#: ../../contributing/recipes.md:1
msgid "New Recipes"
msgstr ""
# 7d306f8fe4a641e4a48b61111c16b8e8
#: ../../contributing/recipes.md:3
msgid ""
"We welcome contributions of recipes, short examples of using, configuring, "
"or extending the Docker Stacks, for inclusion in the documentation site. "
"Follow the process below to add a new recipe:"
msgstr ""
# 5b84ed1b594845ec81f39b87e7c5d82b
#: ../../contributing/recipes.md:5
msgid "Open the docs/using/recipes.md source file."
msgstr ""
# 52f2b459bff447fe82c60ea02c4e751c
#: ../../contributing/recipes.md:6
msgid ""
"Add a second-level Markdown heading naming your recipe at the bottom of the "
"file (e.g., `## Add the RISE extension``)"
msgstr ""
# 56b4b4356d3e45f5bbe6eb14f9540628
#: ../../contributing/recipes.md:7
msgid ""
"Write the body of your recipe under the heading, including whatever command "
"line, Dockerfile, links, etc. you need."
msgstr ""
# 6a3115ec07cf42a28c755a607658f855
# f4f9a3d6544b4e4087e97124098459eb
#: ../../contributing/recipes.md:8 ../../contributing/stacks.md:111
msgid ""
"Submit a pull request (PR) with your changes. Maintainers will respond and "
"work with you to address any formatting or content issues."
msgstr ""
# 0b8332c390304a1ab29a4b2b030e7997
#: ../../contributing/stacks.md:1
msgid "Community Stacks"
msgstr ""
# 69ee7d697c7240b78ea8c7873fc1528b
#: ../../contributing/stacks.md:3
msgid ""
"We love to see the community create and share new Jupyter Docker images. "
"We've put together a cookiecutter project and the documentation below to "
"help you get started defining, building, and sharing your Jupyter "
"environments in Docker. Following these steps will:"
msgstr ""
# 0f392d5680ba4ea2812ff450f8e19d44
#: ../../contributing/stacks.md:5
msgid ""
"Setup a project on GitHub containing a Dockerfile based on either the "
"jupyter/base-notebook or jupyter/minimal-notebook image."
msgstr ""
# c05df9d2cf8c4505b0951f0ea88f1daf
#: ../../contributing/stacks.md:6
msgid ""
"Configure Travis CI to build and test your image when users submit pull "
"requests to your repository."
msgstr ""
# 077482de9feb4fa2b1e5e477fd5591f1
#: ../../contributing/stacks.md:7
msgid ""
"Configure Docker Cloud to build and host your images for others to use."
msgstr ""
# e2fe70e1ea6e4322a8dfa4380f8e54bb
#: ../../contributing/stacks.md:8
msgid ""
"Update the list of community stacks in this documentation to include your "
"image."
msgstr ""
# 3af1a3dc1eae4a7d96a883b911fc5894
#: ../../contributing/stacks.md:10
msgid ""
"This approach mirrors how we build and share the core stack images. Feel "
"free to follow it or pave your own path using alternative services and build"
" tools."
msgstr ""
# 0107f213096c41c8b1cb367b84fee30d
#: ../../contributing/stacks.md:12
msgid "Creating a Project"
msgstr ""
# cb35d196dc42402f9b338e56fcd3faa6
#: ../../contributing/stacks.md:14
msgid "First, install cookiecutter using pip or conda:"
msgstr ""
# 09066f77e38c42889844dafb226df4bd
#: ../../contributing/stacks.md:20
msgid ""
"Run the cookiecutter command pointing to the jupyter/cookiecutter-docker-"
"stacks project on GitHub."
msgstr ""
# 26f05981d3fe49abb07bba85a4a3890f
#: ../../contributing/stacks.md:26
msgid ""
"Enter a name for your new stack image. This will serve as both the git "
"repository name and the part of the Docker image name after the slash."
msgstr ""
# c6aba910076b49ca97dcb902f13d2a4d
#: ../../contributing/stacks.md:33
msgid ""
"Enter the user or organization name under which this stack will reside on "
"Docker Cloud / Hub. You must have access to manage this Docker Cloud org in "
"order to push images here and setup automated builds."
msgstr ""
# 176a346034074822b7634c6c86dace42
#: ../../contributing/stacks.md:41
msgid ""
"Select an image from the jupyter/docker-stacks project that will serve as "
"the base for your new image."
msgstr ""
# 3611e7452640414d9d0535292abd113d
#: ../../contributing/stacks.md:48
msgid "Enter a longer description of the stack for your README."
msgstr ""
# 782321361a3b4116a2d3dafa7cc1424f
#: ../../contributing/stacks.md:54
msgid "Initialize your project as a Git repository and push it to GitHub."
msgstr ""
# b699fe5155774c93938427a241d0f239
#: ../../contributing/stacks.md:66
msgid "Configuring Travis"
msgstr ""
# 6440a7c3a9444dda88445913807d1a48
#: ../../contributing/stacks.md:68
msgid ""
"Next, link your GitHub project to Travis CI to build your Docker image "
"whenever you or someone else submits a pull request."
msgstr ""
# c0613debece54f82a922700157994c5b
#: ../../contributing/stacks.md:70
msgid ""
"Visit https://docs.travis-ci.com/user/getting-started/#To-get-started-with-"
"Travis-CI and follow the instructions to add the Travis CI application to "
"your GitHub account."
msgstr ""
# 4cf36f34a47b410a982be3237af720cd
#: ../../contributing/stacks.md:71
msgid "Visit https://travis-ci.org."
msgstr ""
# fdd694f5ebf443ce9d2d220d5945c299
#: ../../contributing/stacks.md:72
msgid "Click the + symbol at the top of the left sidebar."
msgstr ""
# 05acff6addad4f919fe21c27329b1e51
#: ../../contributing/stacks.md:74
msgid ""
"Locate your project repository either in your primary user account or in one"
" of the organizations to which you belong."
msgstr ""
# a1917b1360434fb18a3522e0a9806a11
#: ../../contributing/stacks.md:75
msgid "Click the toggle to enable builds for the project repository."
msgstr ""
# 7dcbafc96c4a4ef88d7bc34e31a0af04
#: ../../contributing/stacks.md:76
msgid "Click the Settings button for that repository."
msgstr ""
# dd006e53f5cc4c1ea1501d62119f526e
#: ../../contributing/stacks.md:78
msgid ""
"Enable Build only if .travis.yml is present and Build pushed pull requests."
msgstr ""
# 0a5e54cd5f294a52983c2ec73559f810
#: ../../contributing/stacks.md:80
msgid "Disable Build pushed branches."
msgstr ""
# 2ddf5289794648a3b7d1f604ce744331
#: ../../contributing/stacks.md:82
msgid "Configuring Docker Cloud"
msgstr ""
# 5108ce3f722a430eb29e1a5928a86fcf
#: ../../contributing/stacks.md:84
msgid ""
"Now, configure Docker Cloud to build your stack image and push it to Docker "
"Hub repository whenever you merge a GitHub pull request to the master branch"
" of your project."
msgstr ""
# 7ab258ec2f1e4942a983996a6c5e6fa5
#: ../../contributing/stacks.md:86
msgid "Visit https://cloud.docker.com/ and login."
msgstr ""
# 3677166ebbc04b2aafc4f117e33f6bf5
#: ../../contributing/stacks.md:87
msgid ""
"Select the account or organization matching the one you entered when "
"prompted with stack_org by the cookiecutter."
msgstr ""
# 0997628fd41449c5b0598e7e1bf1f005
#: ../../contributing/stacks.md:89
msgid "Scroll to the bottom of the page and click Create repository."
msgstr ""
# 8504105c95594c288fdd9066006757b0
#: ../../contributing/stacks.md:90
msgid ""
"Enter the name of the image matching the one you entered when prompted with "
"stack_name by the cookiecutter."
msgstr ""
# c92796a106c846f585c88fb5a015fa6d
#: ../../contributing/stacks.md:92
msgid "Enter a description for your image."
msgstr ""
# fba832c82f3042499563598365fedfd5
#: ../../contributing/stacks.md:93
msgid ""
"Click GitHub under the Build Settings and follow the prompts to connect your"
" account if it is not already connected."
msgstr ""
# bff3581410014975943ca77637142f14
#: ../../contributing/stacks.md:94
msgid ""
"Select the GitHub organization and repository containing your image "
"definition from the dropdowns."
msgstr ""
# 72cbc93bfe354e279e9384e7c95c801b
#: ../../contributing/stacks.md:96
msgid "Click the Create and Build button."
msgstr ""
# bbb495328efd4fe7b339b7a7ffe908b0
#: ../../contributing/stacks.md:98
msgid "Defining Your Image"
msgstr ""
# 60052c2d1afc4a57baa59c1bf22d321c
#: ../../contributing/stacks.md:100
msgid ""
"Make edits the Dockerfile in your project to add third-party libraries and "
"configure Jupyter applications. Refer to the Dockerfiles for the core stacks"
" (e.g., jupyter/datascience-notebook) to get a feel for what's possible and "
"best practices."
msgstr ""
# 0855b53115ae4b6780cc82c9389224cb
#: ../../contributing/stacks.md:102
msgid ""
"Submit pull requests to your project repository on GitHub. Ensure your image"
" builds properly on Travis before merging to master. Refer to Docker Cloud "
"for builds of your master branch that you can docker pull."
msgstr ""
# de4bcc6e0ac1468ea761c038661ca19f
#: ../../contributing/stacks.md:104
msgid "Sharing Your Image"
msgstr ""
# a67495f9ae984a368364a698084f060e
#: ../../contributing/stacks.md:106
msgid ""
"Finally, if you'd like to add a link to your project to this documentation "
"site, please do the following:"
msgstr ""
# 7357ed96047e42e6ae9e4bf123a00bed
#: ../../contributing/stacks.md:108
msgid "Clone ths jupyter/docker-stacks GitHub repository."
msgstr ""
# ee9284fe69244dcd8d44b25b8dc8b3a2
#: ../../contributing/stacks.md:109
msgid ""
"Open the docs/using/selecting.md source file and locate the Community Stacks"
" section."
msgstr ""
# aa0e41b99c354b5b88336489084e2006
#: ../../contributing/stacks.md:110
msgid ""
"Add a bullet with a link to your project and a short description of what "
"your Docker image contains."
msgstr ""
# 0f652c5259d544b595e847365dfe843a
#: ../../contributing/tests.md:1
msgid "Image Tests"
msgstr ""
# 569da0112572470b9bc5f045bcfb49d0
#: ../../contributing/tests.md:3
msgid ""
"We greatly appreciate pull requests that extend the automated tests that vet"
" the basic functionality of the Docker images."
msgstr ""
# 67b27592447e47af8b0b00eeb745fc70
#: ../../contributing/tests.md:5
msgid "How the Tests Work"
msgstr ""
# e2c3d76accff489eb2a6eab7b55ae3be
#: ../../contributing/tests.md:7
msgid ""
"Travis executes make build-test-all against every pull request submitted to "
"the jupyter/docker-stacks repository. The make command builds every docker "
"image. After building each image, the make command executes pytest to run "
"both image-specific tests like those in base-notebook/test/ and common tests"
" defined in test/. Both kinds of tests make use of global pytest fixtures "
"defined in the conftest.py file at the root of the projects."
msgstr ""
# 15207b72b26741f0a6a77949a4d9d0f4
#: ../../contributing/tests.md:9
msgid "Contributing New Tests"
msgstr ""
# 5470865e6d144e51a428221e49e448fb
#: ../../contributing/tests.md:11
msgid "Please follow the process below to add new tests:"
msgstr ""
# 36aedaa2624c4e4493af145bc5f246e0
#: ../../contributing/tests.md:13
msgid ""
"If the test should run against every image built, add your test code to one "
"of the modules in test/ or create a new module."
msgstr ""
# dccbb0425be7438db7ade2f4892c6c25
#: ../../contributing/tests.md:14
msgid ""
"If your test should run against a single image, add your test code to one of"
" the modules in some-notebook/test/ or create a new module."
msgstr ""
# 33ab248b51d24fa0b29923489bf6dfbf
#: ../../contributing/tests.md:15
msgid ""
"Build one or more images you intend to test and run the tests locally. If "
"you use make, call:"
msgstr ""
# 0453d92037cb4e47a025bc9021bdc7db
#: ../../contributing/tests.md:22
msgid ""
"Discuss changes with the maintainers and address any issues running the "
"tests on Travis."
msgstr ""
docs/locale/zh/LC_MESSAGES/index.po
0 → 100644
View file @
ae5f7e10
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2018- Project Jupyter
# This file is distributed under the same license as the docker-stacks package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Micky Chan <chanmickyyun@gmail.com>, 2019
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: docker-stacks latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-04-21 17:25-0400\n"
"PO-Revision-Date: 2019-04-22 13:45+0000\n"
"Last-Translator: Micky Chan <chanmickyyun@gmail.com>, 2019\n"
"Language-Team: Chinese (https://www.transifex.com/project-jupyter/teams/97886/zh/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: zh\n"
"Plural-Forms: nplurals=1; plural=0;\n"
# 85291a2c92d440a089cf156fba58b86a
#: ../../index.rst:32 ../../index.rst:32
msgid "User Guide"
msgstr "用户指南"
# e4a3fd32059d4486b6b0f3a6fb5065b5
#: ../../index.rst:42 ../../index.rst:42
msgid "Contributor Guide"
msgstr "贡献者指南"
# 45de48c8617d4ebe83b7ff7141295836
#: ../../index.rst:53 ../../index.rst:53
msgid "Maintainer Guide"
msgstr "维护者指南"
# aa99c4562d8d4cb3abfea375470e8af3
#: ../../index.rst:59 ../../index.rst:59
msgid "Getting Help"
msgstr "获取帮助"
# 76df09037a6147c8a85be8ef14c15532
#: ../../index.rst:2
msgid "Jupyter Docker Stacks"
msgstr "Jupyter Docker Stacks"
# b3fb253184e64174b26a2da73f221cc1
#: ../../index.rst:4
msgid ""
"Jupyter Docker Stacks are a set of ready-to-run Docker images containing "
"Jupyter applications and interactive computing tools. You can use a stack "
"image to do any of the following (and more):"
msgstr ""
"Jupyter Docker Stacks是一组Docker镜像包含Jupyter应用程序和交互式计算工具。您可以使用Stack镜像执行以下任何操作"
# 8cd55fb113a049e7be445b21084df7ea
#: ../../index.rst:6
msgid "Start a personal Jupyter Notebook server in a local Docker container"
msgstr "在本地Docker容器中启动个人Jupyter Notebook服务器"
# 285fa13bed8547b4af0cfc480adf4861
#: ../../index.rst:7
msgid "Run JupyterLab servers for a team using JupyterHub"
msgstr "使用JupyterHub为团队运行JupyterLab服务器"
# a49d31cedd4946ea98d7a4c720340d84
#: ../../index.rst:8
msgid "Write your own project Dockerfile"
msgstr "编写自己的Dockerfile"
# 0aff0df2e46a44b4bc8070545e83c42c
#: ../../index.rst:11
msgid "Quick Start"
msgstr "快速开始"
# 3262accd283140058db73005072be200
#: ../../index.rst:13
msgid ""
"You can try a `recent build of the jupyter/base-notebook image on "
"mybinder.org <https://mybinder.org/v2/gh/jupyter/docker-"
"stacks/master?filepath=README.ipynb>`_ by simply clicking the preceding "
"link. Otherwise, the two examples below may help you get started if you "
"`have Docker installed <https://docs.docker.com/install/>`_, know "
":doc:`which Docker image <using/selecting>` you want to use, and want to "
"launch a single Jupyter Notebook server in a container."
msgstr ""
# 9e4094e8de264e20bca0af8f6cf888b7
#: ../../index.rst:15
msgid ""
"The other pages in this documentation describe additional uses and features "
"in detail."
msgstr ""
# 8b75310f2eaa4aac95d9387e0a4db9e8
#: ../../index.rst:17
msgid ""
"**Example 1:** This command pulls the ``jupyter/scipy-notebook`` image "
"tagged ``17aba6048f44`` from Docker Hub if it is not already present on the "
"local host. It then starts a container running a Jupyter Notebook server and"
" exposes the server on host port 8888. The server logs appear in the "
"terminal. Visiting ``http://<hostname>:8888/?token=<token>`` in a browser "
"loads the Jupyter Notebook dashboard page, where ``hostname`` is the name of"
" the computer running docker and ``token`` is the secret token printed in "
"the console. The container remains intact for restart after the notebook "
"server exits.::"
msgstr ""
# 9e0229c99f404aceb7e517387ae88365
#: ../../index.rst:21
msgid ""
"**Example 2:** This command performs the same operations as **Example 1**, "
"but it exposes the server on host port 10000 instead of port 8888. Visiting "
"``http://<hostname>:10000/?token=<token>`` in a browser loads JupyterLab, "
"where ``hostname`` is the name of the computer running docker and ``token`` "
"is the secret token printed in the console.::"
msgstr ""
# 02c25d3f0abe48348100dd878c243a75
#: ../../index.rst:25
msgid ""
"**Example 3:** This command pulls the ``jupyter/datascience-notebook`` image"
" tagged ``9b06df75e445`` from Docker Hub if it is not already present on the"
" local host. It then starts an *ephemeral* container running a Jupyter "
"Notebook server and exposes the server on host port 10000. The command "
"mounts the current working directory on the host as ``/home/jovyan/work`` in"
" the container. The server logs appear in the terminal. Visiting "
"``http://<hostname>:10000/?token=<token>`` in a browser loads JupyterLab, "
"where ``hostname`` is the name of the computer running docker and ``token`` "
"is the secret token printed in the console. Docker destroys the container "
"after notebook server exit, but any files written to ``~/work`` in the "
"container remain intact on the host.::"
msgstr ""
# 1bc0c7d54cd343d689362047c0b00122
#: ../../index.rst:30
msgid "Table of Contents"
msgstr ""
docs/locale/zh/LC_MESSAGES/maintaining.po
0 → 100644
View file @
ae5f7e10
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2018- Project Jupyter
# This file is distributed under the same license as the docker-stacks package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: docker-stacks latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-04-21 17:25-0400\n"
"PO-Revision-Date: 2019-04-22 13:45+0000\n"
"Language-Team: Chinese (https://www.transifex.com/project-jupyter/teams/97886/zh/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: zh\n"
"Plural-Forms: nplurals=1; plural=0;\n"
# cefae71d9a804ab69c7e9f0a53eb7475
#: ../../maintaining/tasks.md:1
msgid "Maintainer Playbook"
msgstr ""
# af6a24b053794e55bddfe6e2e21ae74f
#: ../../maintaining/tasks.md:3
msgid "Merging Pull Requests"
msgstr ""
# c34b1d3b543346689adbca91331ac048
#: ../../maintaining/tasks.md:5
msgid ""
"To build new images on Docker Cloud and publish them to the Docker Hub "
"registry, do the following:"
msgstr ""
# 1597bb99448f41b994d1c7073b9c8721
#: ../../maintaining/tasks.md:7
msgid "Make sure Travis is green for a PR."
msgstr ""
# 401ed2733771440e8ef089f54cf2984d
#: ../../maintaining/tasks.md:8
msgid "Merge the PR."
msgstr ""
# 6d0bf2e7538640a0989e56df3c9d1106
#: ../../maintaining/tasks.md:9
msgid ""
"Monitor the Docker Cloud build status for each of the stacks, starting with "
"jupyter/base-notebook and ending with jupyter/all-spark-notebook. See the "
"stack hierarchy diagram for the current, complete build order."
msgstr ""
# 428124fa830d4c74a618d7b3c696599c
#: ../../maintaining/tasks.md:10
msgid ""
"Manually click the retry button next to any build that fails to resume that "
"build and any dependent builds."
msgstr ""
# c4034a02dab8435f8d76c2d32321a262
#: ../../maintaining/tasks.md:11
msgid ""
"Try to avoid merging another PR to master until all outstanding builds "
"complete. There's no way at present to propagate the git SHA to build "
"through the Docker Cloud build trigger API. Every build trigger works off of"
" master HEAD."
msgstr ""
# 62ddd25e15064cea950f9f13a663dcdb
#: ../../maintaining/tasks.md:13
msgid "Updating the Ubuntu Base Image"
msgstr ""
# 091b1ce707f44bc6ae9742cf55b92ebf
#: ../../maintaining/tasks.md:15
msgid ""
"When there's a security fix in the Ubuntu base image or after some time "
"passes, it's a good idea to update the pinned SHA in the jupyter/base-"
"notebook Dockerfile. Submit it as a regular PR and go through the build "
"process. Expect the build to take a while to complete: every image layer "
"will rebuild."
msgstr ""
# d834495e774a4fee952324e4cc5ab514
#: ../../maintaining/tasks.md:17
msgid "Adding a New Core Image to Docker Cloud"
msgstr ""
# b765140c2d1446849b747351532d6290
#: ../../maintaining/tasks.md:19
msgid ""
"When there's a new stack definition, do the following before merging the PR "
"with the new stack:"
msgstr ""
# b7b25a83cd3246bd886926722c30ac1a
#: ../../maintaining/tasks.md:21
msgid ""
"Ensure the PR includes an update to the stack overview diagram in the "
"documentation. The image links to the blockdiag source used to create it."
msgstr ""
# 50edc8e02aa9497d81dc312eafe5d2bf
#: ../../maintaining/tasks.md:22
msgid ""
"Ensure the PR updates the Makefile which is used to build the stacks in "
"order on Travis CI."
msgstr ""
# fabcb32a80a04a639aebd8b55d38119e
#: ../../maintaining/tasks.md:23
msgid ""
"Create a new repository in the jupyter org on Docker Cloud named after the "
"stack folder in the git repo."
msgstr ""
# 1811dcec60e3433d94514eaeebecb44b
#: ../../maintaining/tasks.md:24
msgid "Grant the stacks team permission to write to the repo."
msgstr ""
# afa7b1fcb0224380a111fe94f7781d60
#: ../../maintaining/tasks.md:25
msgid "Click Builds and then Configure Automated Builds for the repository."
msgstr ""
# 35b969b9f7a442d99f54a73494033d90
#: ../../maintaining/tasks.md:26
msgid "Select jupyter/docker-stacks as the source repository."
msgstr ""
# fe715af4446d409cb4d5ee81255bd86e
#: ../../maintaining/tasks.md:27
msgid ""
"Choose Build on Docker Cloud's infrastructure using a Small node unless you "
"have reason to believe a bigger host is required."
msgstr ""
# dc41895431b64657b5e24a8c96779ca6
#: ../../maintaining/tasks.md:28
msgid ""
"Update the Build Context in the default build rule to be /<name-of-the-"
"stack>."
msgstr ""
# e4d220bf1cb54781bc03f16a17ddafb8
#: ../../maintaining/tasks.md:29
msgid ""
"Toggle Autobuild to disabled unless the stack is a new root stack (e.g., "
"like jupyter/base-notebook)."
msgstr ""
# c5a459d038714ff78d4f156ee227d9ca
#: ../../maintaining/tasks.md:30
msgid ""
"If the new stack depends on the build of another stack in the hierarchy:"
msgstr ""
# 611376c2ec6942479f60129177d312cc
#: ../../maintaining/tasks.md:31
msgid "Hit Save and then click Configure Automated Builds."
msgstr ""
# 81cc56c63891432d89d4df3001f1bcde
#: ../../maintaining/tasks.md:32
msgid "At the very bottom, add a build trigger named Stack hierarchy trigger."
msgstr ""
# 9e55682a966a422c846a3463c7a30cfe
#: ../../maintaining/tasks.md:33
msgid "Copy the build trigger URL."
msgstr ""
# a9d853a1d45b4ead965813822a96c934
#: ../../maintaining/tasks.md:34
msgid ""
"Visit the parent repository Builds page and click Configure Automated "
"Builds."
msgstr ""
# 327d4522c3884247871aa406bbe19402
#: ../../maintaining/tasks.md:35
msgid ""
"Add the URL you copied to the NEXT_BUILD_TRIGGERS environment variable comma"
" separated list of URLs, creating that environment variable if it does not "
"already exist."
msgstr ""
# 1aa0e4b95ab847e0be8ac9647433c991
# 7dfff62380a041968ee6e739b1ca271f
#: ../../maintaining/tasks.md:36 ../../maintaining/tasks.md:40
msgid "Hit Save."
msgstr ""
# 8315ed043efb40238227f8be0ad61b52
#: ../../maintaining/tasks.md:37
msgid "If the new stack should trigger other dependent builds:"
msgstr ""
# 6e0e15d05a544476b91794d10b8732ff
#: ../../maintaining/tasks.md:38
msgid "Add an environment variable named NEXT_BUILD_TRIGGERS."
msgstr ""
# 9dc2029e6360433ab7181187f7040d48
#: ../../maintaining/tasks.md:39
msgid ""
"Copy the build trigger URLs from the dependent builds into the "
"NEXT_BUILD_TRIGGERS comma separated list of URLs."
msgstr ""
# 89165b279d9142e9b8e5d7a923fca2be
#: ../../maintaining/tasks.md:41
msgid ""
"Adjust other NEXT_BUILD_TRIGGERS values as needed so that the build order "
"matches that in the stack hierarchy diagram."
msgstr ""
# 51c8151943794bc8b1d51d65ccd84736
#: ../../maintaining/tasks.md:43
msgid "Adding a New Maintainer Account"
msgstr ""
# 1994c19e7a734b2cad9af0afcd7da31e
#: ../../maintaining/tasks.md:45
msgid "Visit https://cloud.docker.com/app/jupyter/team/stacks/users"
msgstr ""
# 390ccdde528146bbbc3d2f62717a647c
#: ../../maintaining/tasks.md:46
msgid "Add the maintainer's Docker Cloud username."
msgstr ""
# b0227c37244c4b82848cc2655f134d21
#: ../../maintaining/tasks.md:47
msgid ""
"Visit https://github.com/orgs/jupyter/teams/docker-image-maintainers/members"
msgstr ""
# b0fdbdd14b1444d1b696d8367aa111fb
#: ../../maintaining/tasks.md:48
msgid "Add the maintainer's GitHub username."
msgstr ""
# abe2cb04fcb9447496bf3bc9fb230cdc
#: ../../maintaining/tasks.md:50
msgid "Pushing a Build Manually"
msgstr ""
# 3ef85ec6ea0a4a84aecc2bc7e7a5a5fd
#: ../../maintaining/tasks.md:52
msgid ""
"If automated builds on Docker Cloud have got you down, do the following to "
"push a build manually:"
msgstr ""
# 3ebef623fa2f46f49ef639ad17105d4a
#: ../../maintaining/tasks.md:54
msgid "Clone this repository."
msgstr ""
# dcf8e9e8c72e40b9aa23c090311d6ea2
#: ../../maintaining/tasks.md:55
msgid "Check out the git SHA you want to build and publish."
msgstr ""
# fe788ad30f694b1f9b013cabfa820343
#: ../../maintaining/tasks.md:56
msgid "docker login with your Docker Hub/Cloud credentials."
msgstr ""
# 649dc474ffaa483eb625ed8061cb0097
#: ../../maintaining/tasks.md:57
msgid "Run make retry/release-all."
msgstr ""
docs/locale/zh/LC_MESSAGES/using.po
0 → 100644
View file @
ae5f7e10
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2018- Project Jupyter
# This file is distributed under the same license as the docker-stacks package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: docker-stacks latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-04-21 17:25-0400\n"
"PO-Revision-Date: 2019-04-22 13:45+0000\n"
"Language-Team: Chinese (https://www.transifex.com/project-jupyter/teams/97886/zh/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: zh\n"
"Plural-Forms: nplurals=1; plural=0;\n"
# 22b65331d42e414b9320143d30499447
#: ../../using/common.md:1
msgid "Common Features"
msgstr ""
# dd3cb2a88856437aad5f76b607f80deb
#: ../../using/common.md:3
msgid ""
"A container launched from any Jupyter Docker Stacks image runs a Jupyter "
"Notebook server by default. The container does so by executing a start-"
"notebook.sh script. This script configures the internal container "
"environment and then runs jupyter notebook, passing it any command line "
"arguments received."
msgstr ""
# 4bc2911886254b1cafcffcce7d7ef9b3
#: ../../using/common.md:5
msgid ""
"This page describes the options supported by the startup script as well as "
"how to bypass it to run alternative commands."
msgstr ""
# bb55c8d7786e4c1f8e11c1e309931c41
#: ../../using/common.md:7
msgid "Notebook Options"
msgstr ""
# 66f14be1ff1746c1abdccafb894fa2e6
#: ../../using/common.md:9
msgid ""
"You can pass Jupyter command line options to the start-notebook.sh script "
"when launching the container. For example, to secure the Notebook server "
"with a custom password hashed using IPython.lib.passwd() instead of the "
"default token, you can run the following:"
msgstr ""
# 5d73f06cae2c4990a942c76988f19c1f
#: ../../using/common.md:15
msgid ""
"For example, to set the base URL of the notebook server, you can run the "
"following:"
msgstr ""
# 9d43ee0e147b43469f56c4895720f682
#: ../../using/common.md:21
msgid "Docker Options"
msgstr ""
# 3f0f5c9d0b254d829e6f07e0a2ca2544
#: ../../using/common.md:23
msgid ""
"You may instruct the start-notebook.sh script to customize the container "
"environment before launching the notebook server. You do so by passing "
"arguments to the docker run command."
msgstr ""
# 4621c78dfaeb43379c5d3437238b2ef8
#: ../../using/common.md:26
msgid ""
"-e NB_USER=jovyan - Instructs the startup script to change the default "
"container username from jovyan to the provided value. Causes the script to "
"rename the jovyan user home folder. For this option to take effect, you must"
" run the container with --user root and set the working directory -w "
"/home/$NB_USER. This feature is useful when mounting host volumes with "
"specific home folder."
msgstr ""
# 9120ad3c28c84f3fbb2433c79a83907a
#: ../../using/common.md:27
msgid ""
"-e NB_UID=1000 - Instructs the startup script to switch the numeric user ID "
"of $NB_USER to the given value. This feature is useful when mounting host "
"volumes with specific owner permissions. For this option to take effect, you"
" must run the container with --user root. (The startup script will su "
"$NB_USER after adjusting the user ID.) You might consider using modern "
"Docker options --user and --group-add instead. See the last bullet below for"
" details."
msgstr ""
# f2a9954159b546468e50a4d9665dd534
#: ../../using/common.md:28
msgid ""
"-e NB_GID=100 - Instructs the startup script to change the primary group "
"of$NB_USER to $NB_GID (the new group is added with a name of $NB_GROUP if it"
" is defined, otherwise the group is named $NB_USER). This feature is useful"
" when mounting host volumes with specific group permissions. For this option"
" to take effect, you must run the container with --user root. (The startup "
"script will su $NB_USER after adjusting the group ID.) You might consider "
"using modern Docker options --user and --group-add instead. See the last "
"bullet below for details. The user is added to supplemental group users "
"(gid 100) in order to allow write access to the home directory and "
"/opt/conda. If you override the user/group logic, ensure the user stays in "
"group users if you want them to be able to modify files in the image."
msgstr ""
# 1d362c57a99b47e1b3cb571f23c17e67
#: ../../using/common.md:29
msgid ""
"-e NB_GROUP=<name> - The name used for $NB_GID, which defaults to $NB_USER."
" This is only used if $NB_GID is specified and completely optional: there "
"is only cosmetic effect."
msgstr ""
# de1cd66f1e174d519cfcf764a0286773
#: ../../using/common.md:30
msgid ""
"-e NB_UMASK=<umask> - Configures Jupyter to use a different umask value from"
" default, i.e. 022. For example, if setting umask to 002, new files will be "
"readable and writable by group members instead of just writable by the "
"owner. Wikipedia has a good article about umask. Feel free to read it in "
"order to choose the value that better fits your needs. Default value should "
"fit most situations. Note that NB_UMASK when set only applies to the Jupyter"
" process itself - you cannot use it to set a umask for additional files "
"created during run-hooks e.g. via pip or conda - if you need to set a umask "
"for these you must set umask for each command."
msgstr ""
# 325f270ee0484e728c638fb0ca4c9c93
#: ../../using/common.md:31
msgid ""
"-e CHOWN_HOME=yes - Instructs the startup script to change the $NB_USER home"
" directory owner and group to the current value of $NB_UID and $NB_GID. This"
" change will take effect even if the user home directory is mounted from the"
" host using -v as described below. The change is not applied recursively by "
"default. You can change modify the chown behavior by setting CHOWN_HOME_OPTS"
" (e.g., -e CHOWN_HOME_OPTS='-R')."
msgstr ""
# 85b3d1d9890c46b08bb62370c6ed93a2
#: ../../using/common.md:32
msgid ""
"-e CHOWN_EXTRA=\"<some dir>,<some other dir>\" - Instructs the startup "
"script to change the owner and group of each comma-separated container "
"directory to the current value of $NB_UID and $NB_GID. The change is not "
"applied recursively by default. You can change modify the chown behavior by "
"setting CHOWN_EXTRA_OPTS (e.g., -e CHOWN_EXTRA_OPTS='-R')."
msgstr ""
# bb7a47817b734d7ab9d95e4c4f18911f
#: ../../using/common.md:33
msgid ""
"-e GRANT_SUDO=yes - Instructs the startup script to grant the NB_USER user "
"passwordless sudo capability. You do not need this option to allow the user "
"to conda or pip install additional packages. This option is useful, however,"
" when you wish to give $NB_USER the ability to install OS packages with apt "
"or modify other root-owned files in the container. For this option to take "
"effect, you must run the container with --user root. (The start-notebook.sh "
"script will su $NB_USER after adding $NB_USER to sudoers.) You should only "
"enable sudo if you trust the user or if the container is running on an "
"isolated host."
msgstr ""
# d148b1f0275342b0bf231ae5e819590f
#: ../../using/common.md:34
msgid ""
"-e GEN_CERT=yes - Instructs the startup script to generates a self-signed "
"SSL certificate and configure Jupyter Notebook to use it to accept encrypted"
" HTTPS connections."
msgstr ""
# aafdc956c76142a0acfe467ffde5ce68
#: ../../using/common.md:35
msgid ""
"-e JUPYTER_ENABLE_LAB=yes - Instructs the startup script to run jupyter lab "
"instead of the default jupyter notebook command. Useful in container "
"orchestration environments where setting environment variables is easier "
"than change command line parameters."
msgstr ""
# 9a4fc69536fa4e8580ed4f5e77d338f0
#: ../../using/common.md:36
msgid ""
"-v /some/host/folder/for/work:/home/jovyan/work - Mounts a host machine "
"directory as folder in the container. Useful when you want to preserve "
"notebooks and other work even after the container is destroyed. You must "
"grant the within-container notebook user or group (NB_UID or NB_GID) write "
"access to the host directory (e.g., sudo chown 1000 "
"/some/host/folder/for/work)."
msgstr ""
# 684334b1f55b42e4a05e194f3a3a3497
#: ../../using/common.md:37
msgid ""
"--user 5000 --group-add users - Launches the container with a specific user "
"ID and adds that user to the users group so that it can modify files in the "
"default home directory and /opt/conda. You can use these arguments as "
"alternatives to setting $NB_UID and $NB_GID."
msgstr ""
# 42df7956876a4592be13f4ce3c9c8f54
#: ../../using/common.md:39
msgid "Startup Hooks"
msgstr ""
# c8d2e31d4d0544a486a070c4cc7d8afd
#: ../../using/common.md:41
msgid ""
"You can further customize the container environment by adding shell scripts "
"(*.sh) to be sourced or executables (chmod +x) to be run to the paths below:"
msgstr ""
# 473e6aea1cbc4e50b75eec179a476b46
#: ../../using/common.md:44
msgid ""
"/usr/local/bin/start-notebook.d/ - handled before any of the standard "
"options noted above are applied"
msgstr ""
# f9d0cc48b06f4cbfa911ef6169222f6b
#: ../../using/common.md:46
msgid ""
"/usr/local/bin/before-notebook.d/ - handled after all of the standard "
"options noted above are applied and just before the notebook server launches"
msgstr ""
# 68e7bf5e72d747f886129a962ae84eef
#: ../../using/common.md:49
msgid ""
"See the run-hooks function in the jupyter/base-notebook start.sh script for "
"execution details."
msgstr ""
# 7a9436da93a34647a59ee4cc77be5300
#: ../../using/common.md:52
msgid "SSL Certificates"
msgstr ""
# e69958fe476445eda760433dcc2fac24
#: ../../using/common.md:54
msgid ""
"You may mount SSL key and certificate files into a container and configure "
"Jupyter Notebook to use them to accept HTTPS connections. For example, to "
"mount a host folder containing a notebook.key and notebook.crt and use them,"
" you might run the following:"
msgstr ""
# b38385bb5753460397e87480c71d621f
#: ../../using/common.md:64
msgid ""
"Alternatively, you may mount a single PEM file containing both the key and "
"certificate. For example:"
msgstr ""
# 7867b25df06444e8b7bd0c87292cafd8
#: ../../using/common.md:73
msgid ""
"In either case, Jupyter Notebook expects the key and certificate to be a "
"base64 encoded text file. The certificate file or PEM may contain one or "
"more certificates (e.g., server, intermediate, and root)."
msgstr ""
# 030c5c35440b45d8b1a82abdb946609f
#: ../../using/common.md:75
msgid "For additional information about using SSL, see the following:"
msgstr ""
# a50ac1b5bbc749e8a5c4f9ecbd523d14
#: ../../using/common.md:77
msgid ""
"The docker-stacks/examples for information about how to use Let's Encrypt "
"certificates when you run these stacks on a publicly visible domain."
msgstr ""
# 9cc027cb57c044a782068bf45d3bc22e
#: ../../using/common.md:78
msgid ""
"The jupyter_notebook_config.py file for how this Docker image generates a "
"self-signed certificate."
msgstr ""
# dbfcfb88b099481781c8f3b3011a73e9
#: ../../using/common.md:79
msgid ""
"The Jupyter Notebook documentation for best practices about securing a "
"public notebook server in general."
msgstr ""
# f8fcaea33627485799126c6b6e08e7dc
#: ../../using/common.md:81
msgid "Alternative Commands"
msgstr ""
# 10a9b432d6dd4a8a804da1976d27127e
#: ../../using/common.md:83
msgid "start.sh"
msgstr ""
# 3dca69ef1ed44f08a99c8a3f82645ffa
#: ../../using/common.md:85
msgid ""
"The start-notebook.sh script actually inherits most of its option handling "
"capability from a more generic start.sh script. The start.sh script supports"
" all of the features described above, but allows you to specify an arbitrary"
" command to execute. For example, to run the text-based ipython console in a"
" container, do the following:"
msgstr ""
# f9ade4ab67f54867a79b59937239d9a7
#: ../../using/common.md:91
msgid ""
"Or, to run JupyterLab instead of the classic notebook, run the following:"
msgstr ""
# 4575181991e844a1bc113b6c2821d0d8
#: ../../using/common.md:97
msgid ""
"This script is particularly useful when you derive a new Dockerfile from "
"this image and install additional Jupyter applications with subcommands like"
" jupyter console, jupyter kernelgateway, etc."
msgstr ""
# d4d085e167a942709b72de803ee03bc0
#: ../../using/common.md:99
msgid "Others"
msgstr ""
# 34c4fb744a514987b41ad23dba573c46
#: ../../using/common.md:101
msgid ""
"You can bypass the provided scripts and specify your an arbitrary start "
"command. If you do, keep in mind that features supported by the start.sh "
"script and its kin will not function (e.g., GRANT_SUDO)."
msgstr ""
# bcd8d95440b2493a9ffbca0678a14ed9
#: ../../using/common.md:103
msgid "Conda Environments"
msgstr ""
# 9f62047ae18e44e3bad5b3a183a3683a
#: ../../using/common.md:105
msgid ""
"The default Python 3.x Conda environment resides in /opt/conda. The "
"/opt/conda/bin directory is part of the default jovyan user's $PATH. That "
"directory is also whitelisted for use in sudo commands by the start.sh "
"script."
msgstr ""
# 6c8c478e872d444b904fecd01e9911da
#: ../../using/common.md:107
msgid ""
"The jovyan user has full read/write access to the /opt/conda directory. You "
"can use either conda or pip to install new packages without any additional "
"permissions."
msgstr ""
# cdff04cd2c814d2a993dcf793c1a32a0
#: ../../using/recipes.md:1
msgid "Contributed Recipes"
msgstr ""
# 674d282d2bc64a07b2d1aae14a954453
#: ../../using/recipes.md:3
msgid ""
"Users sometimes share interesting ways of using the Jupyter Docker Stacks. "
"We encourage users to contribute these recipes to the documentation in case "
"they prove useful to other members of the community by submitting a pull "
"request to docs/using/recipes.md. The sections below capture this knowledge."
msgstr ""
# a01a0ec46bc8469290ee140a69d6b0a4
#: ../../using/recipes.md:5
msgid "Using pip install or conda install in a Child Docker image"
msgstr ""
# 95d414d34880400bb6f17842eaacdb47
#: ../../using/recipes.md:7
msgid "Create a new Dockerfile like the one shown below."
msgstr ""
# 1fa3f126a9a6401d9941748e79380f8e
#: ../../using/recipes.md:16
msgid "Then build a new image."
msgstr ""
# 1bff41f678f847d98ffa744cf037c502
#: ../../using/recipes.md:22
msgid ""
"To use a requirements.txt file, first create your requirements.txt file with"
" the listing of packages desired. Next, create a new Dockerfile like the "
"one shown below."
msgstr ""
# a11c4c3379f64b4f8028d4b4c7437292
#: ../../using/recipes.md:35
msgid "For conda, the Dockerfile is similar:"
msgstr ""
# 42213789b3a14b02a491455f3bcdfa9a
#: ../../using/recipes.md:47
msgid "Ref: docker-stacks/commit/79169618d571506304934a7b29039085e77db78c"
msgstr ""
# 471f68531d274ce4a7ad2a9f4274d8a9
#: ../../using/recipes.md:49
msgid "Add a Python 2.x environment"
msgstr ""
# c721d45a7e9e4ce99799d587a7aa0921
#: ../../using/recipes.md:51
msgid ""
"Python 2.x was removed from all images on August 10th, 2017, starting in tag"
" cc9feab481f7. You can add a Python 2.x environment by defining your own "
"Dockerfile inheriting from one of the images like so:"
msgstr ""
# e07ac0abd67c4bb2a746953b44cd2ba8
#: ../../using/recipes.md:73
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/440"
msgstr ""
# 88ae461b17e140a1ae71a9c175b4bd0d
#: ../../using/recipes.md:75
msgid "Run JupyterLab"
msgstr ""
# dbf08b368b5346ec8f6549737e561e5f
#: ../../using/recipes.md:77
msgid ""
"JupyterLab is preinstalled as a notebook extension starting in tag "
"c33a7dc0eece."
msgstr ""
# 866e89573c5d4a70abd44bf374ed2e62
#: ../../using/recipes.md:79
msgid ""
"Run jupyterlab using a command such as docker run -it --rm -p 8888:8888 "
"jupyter/datascience-notebook start.sh jupyter lab"
msgstr ""
# 1531d01600af476b8401421c9305cdf3
#: ../../using/recipes.md:81
msgid "Let's Encrypt a Notebook server"
msgstr ""
# ac1d8a654ce64ec3b318d9c341602e1a
#: ../../using/recipes.md:83
msgid ""
"See the README for the simple automation here https://github.com/jupyter"
"/docker-stacks/tree/master/examples/make-deploy which includes steps for "
"requesting and renewing a Let's Encrypt certificate."
msgstr ""
# 17ac8453774a4b028df89f2bdb3feec1
#: ../../using/recipes.md:85
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/78"
msgstr ""
# 020d1144ff094e49ba690fd3292bad1a
#: ../../using/recipes.md:87
msgid "Slideshows with Jupyter and RISE"
msgstr ""
# b84e3e74e66349a695be5f2eb177757b
#: ../../using/recipes.md:89
msgid ""
"RISE allows via extension to create live slideshows of your notebooks, with "
"no conversion, adding javascript Reveal.js:"
msgstr ""
# 14fd425e7dad41c9b00fee87d7d2225e
#: ../../using/recipes.md:95
msgid "Credit: Paolo D. based on docker-stacks/issues/43"
msgstr ""
# 3e38842bbf0244f5897f995d7744d4ed
#: ../../using/recipes.md:97
msgid "xgboost"
msgstr ""
# daf9711129e84131ad1f676e646f9e03
#: ../../using/recipes.md:99
msgid ""
"You need to install conda's gcc for Python xgboost to work properly. "
"Otherwise, you'll get an exception about libgomp.so.1 missing GOMP_4.0."
msgstr ""
# faf7639219434c4d902b0e9bd6e626c2
#: ../../using/recipes.md:109
msgid "Running behind a nginx proxy"
msgstr ""
# 912ad155cb4a45069d9e8ec8b1b87cb0
#: ../../using/recipes.md:111
msgid ""
"Sometimes it is useful to run the Jupyter instance behind a nginx proxy, for"
" instance:"
msgstr ""
# 7adc9717c9f84756963824bb3b851eda
#: ../../using/recipes.md:113
msgid ""
"you would prefer to access the notebook at a server URL with a path "
"(https://example.com/jupyter) rather than a port (https://example.com:8888)"
msgstr ""
# 1ed3d2d40ad948b19f6d1b5777c13f5f
#: ../../using/recipes.md:114
msgid ""
"you may have many different services in addition to Jupyter running on the "
"same server, and want to nginx to help improve server performance in manage "
"the connections"
msgstr ""
# 276ccfb626504c1fbe8d645f1c82a24f
#: ../../using/recipes.md:116
msgid ""
"Here is a quick example NGINX configuration to get started. You'll need a "
"server, a .crt and .key file for your server, and docker & docker-compose "
"installed. Then just download the files at that gist and run docker-compose"
" up -d to test it out. Customize the nginx.conf file to set the desired "
"paths and add other services."
msgstr ""
# ba9a795db881452d8a815f3bf2f3aa7a
#: ../../using/recipes.md:118
msgid "Host volume mounts and notebook errors"
msgstr ""
# 3cecb98fa6e54f99a09a04b81a4bc04e
#: ../../using/recipes.md:120
msgid ""
"If you are mounting a host directory as /home/jovyan/work in your container "
"and you receive permission errors or connection errors when you create a "
"notebook, be sure that the jovyan user (UID=1000 by default) has read/write "
"access to the directory on the host. Alternatively, specify the UID of the "
"jovyan user on container startup using the -e NB_UID option described in the"
" Common Features, Docker Options section"
msgstr ""
# b71f0c2e0f184959a9a6f0765b9f0b4e
#: ../../using/recipes.md:122
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/199"
msgstr ""
# 29b6203639a444d38051b7dd23195ad5
#: ../../using/recipes.md:124
msgid "Manpage installation"
msgstr ""
# a4261a1c819e48ef848fb16bacd237dd
#: ../../using/recipes.md:126
msgid ""
"Most containers, including our Ubuntu base image, ship without manpages "
"installed to save space. You can use the following dockerfile to inherit "
"from one of our images to enable manpages:"
msgstr ""
# df6c0841b76247a893a7494d446d63ad
#: ../../using/recipes.md:151
msgid ""
"Adding the documentation on top of an existing singleuser image wastes a lot"
" of space and requires reinstalling every system package, which can take "
"additional time and bandwidth; the datascience-notebook image has been shown"
" to grow by almost 3GB when adding manapages in this way. Enabling manpages "
"in the base Ubuntu layer prevents this container bloat:"
msgstr ""
# b41452481f5d421fa005b0e1a33bf9b4
#: ../../using/recipes.md:173
msgid ""
"Be sure to check the current base image in base-notebook before building."
msgstr ""
# 7b0274764c614b46b0a2e663231e59b7
#: ../../using/recipes.md:175
msgid "JupyterHub"
msgstr ""
# ccf49b18478443ecbd9fd7fc9c171cd9
#: ../../using/recipes.md:177
msgid "We also have contributed recipes for using JupyterHub."
msgstr ""
# e5835af60f9c4bfeb8e6995d703f730e
#: ../../using/recipes.md:179
msgid "Use JupyterHub's dockerspawner"
msgstr ""
# 9305102339904086861ef2246beb8f08
#: ../../using/recipes.md:181
msgid ""
"In most cases for use with DockerSpawner, given any image that already has a"
" notebook stack set up, you would only need to add:"
msgstr ""
# 5d92054033604627ae5b3161c3d0b903
#: ../../using/recipes.md:183
msgid "install the jupyterhub-singleuser script (for the right Python)"
msgstr ""
# fcf37a1789f84906bde9085583cff95b
#: ../../using/recipes.md:184
msgid "change the command to launch the single-user server"
msgstr ""
# e6f1488b2ffb4beaa2414ca545f10261
#: ../../using/recipes.md:186
msgid ""
"Swapping out the FROM line in the jupyterhub/singleuser Dockerfile should be"
" enough for most cases."
msgstr ""
# bbd864e6695a4cca862d9fa909b51dc0
#: ../../using/recipes.md:188
msgid ""
"Credit: Justin Tyberg, quanghoc, and Min RK based on docker-"
"stacks/issues/124 and docker-stacks/pull/185"
msgstr ""
# 260577d0e15f4102bbad7486357528d4
#: ../../using/recipes.md:190
msgid "Containers with a specific version of JupyterHub"
msgstr ""
# 041f84f19f0e4d4c8b050a2ccc2cb812
#: ../../using/recipes.md:192
msgid ""
"To use a specific version of JupyterHub, the version of jupyterhub in your "
"image should match the version in the Hub itself."
msgstr ""
# 41410dcc4e264932b64e96e6857b1bd3
#: ../../using/recipes.md:199
msgid "Credit: MinRK"
msgstr ""
# 68fe2ae525474d91af1d8647378f078b
#: ../../using/recipes.md:202
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/177"
msgstr ""
# 3b6b7a3b35aa42a8a70a5c9e91af21d2
#: ../../using/recipes.md:204
msgid "Spark"
msgstr ""
# 8d1092f2b1a64da292134b240b621f48
#: ../../using/recipes.md:206
msgid ""
"A few suggestions have been made regarding using Docker Stacks with spark."
msgstr ""
# 54e47498667747d1a7f576895d140c6f
#: ../../using/recipes.md:208
msgid "Using PySpark with AWS S3"
msgstr ""
# 127111e623114603b4c841b66ce8f16f
#: ../../using/recipes.md:210
msgid "Using Spark session for hadoop 2.7.3"
msgstr ""
# 5454399deea24bb2a166ddd1fd168752
#: ../../using/recipes.md:230
msgid "Using Spark context for hadoop 2.6.0"
msgstr ""
# af0c5beb70664b74b6798a869023b3ca
#: ../../using/recipes.md:252
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/127"
msgstr ""
# 56531d33de8c46bb853db7ecef65d1ef
#: ../../using/recipes.md:254
msgid "Using Local Spark JARs"
msgstr ""
# 783af638cf454b6ea8bfd04df9da967f
#: ../../using/recipes.md:270
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/154"
msgstr ""
# 80df4b671dc64d9bad9bd2915524fe02
#: ../../using/recipes.md:272
msgid "Using spark-packages.org"
msgstr ""
# 14c79ea3fbf446fc92ab63c36e874f96
#: ../../using/recipes.md:274
msgid ""
"If you'd like to use packages from spark-packages.org, see "
"https://gist.github.com/parente/c95fdaba5a9a066efaab for an example of how "
"to specify the package identifier in the environment before creating a "
"SparkContext."
msgstr ""
# 5a1cab88fa6c477a99f4352670b6cf76
#: ../../using/recipes.md:276
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/43"
msgstr ""
# 753a64e86395492481c9541dcb91f0ed
#: ../../using/recipes.md:278
msgid "Use jupyter/all-spark-notebooks with an existing Spark/YARN cluster"
msgstr ""
# 53fbe7a910d84359af93acf195711ffd
#: ../../using/recipes.md:342
msgid "Credit: britishbadger from docker-stacks/issues/369"
msgstr ""
# c82c3fc2484d48d5889dd8e3e79723b2
#: ../../using/recipes.md:344
msgid ""
"Run Jupyter Notebook/Lab inside an already secured environment (i.e., with "
"no token)"
msgstr ""
# 53c63d298efa42cab5d39c3b242d44e0
#: ../../using/recipes.md:346
msgid "(Adapted from issue 728)"
msgstr ""
# cb4bd116d7334212b7fa5a78602e370d
#: ../../using/recipes.md:348
msgid ""
"The default security is very good. There are use cases, encouraged by "
"containers, where the jupyter container and the system it runs within, lie "
"inside the security boundary. In these use cases it is convenient to launch "
"the server without a password or token. In this case, you should use the "
"start.sh script to launch the server with no token:"
msgstr ""
# 59cd4c1e695f42c09ea911048769f8b7
#: ../../using/recipes.md:354
msgid "For jupyterlab:"
msgstr ""
# 49d382c7a9c14ddda58b2e88521dc3bc
#: ../../using/recipes.md:360
msgid "For jupyter classic:"
msgstr ""
# 297f3ad3d8504a75a0fd5659fa73b67c
#: ../../using/recipes.md:365
msgid ""
"Enable nbextension spellchecker for markdown (or any other nbextension)"
msgstr ""
# e2b10f15c91e4db9b7898a1a191526c7
#: ../../using/recipes.md:367
msgid "NB: this works for classic notebooks only"
msgstr ""
# 158be3dba029417b832640f01cd22f75
#: ../../using/recipes.md:380
msgid "Ref: https://github.com/jupyter/docker-stacks/issues/675"
msgstr ""
# ade5800ecee24c9eb4f16af9585951fc
#: ../../using/running.md:1
msgid "Running a Container"
msgstr ""
# da480368616a4ffa976061bdc0128763
# 1b0a0481a9454392a32c005d7513e453
#: ../../using/running.md:3 ../../using/selecting.md:7
msgid "Using one of the Jupyter Docker Stacks requires two choices:"
msgstr ""
# d94683d29b6341a98420c4e6adebc4bb
# 436b43aa9da944d281cf51ea731d286a
#: ../../using/running.md:5 ../../using/selecting.md:9
msgid "Which Docker image you wish to use"
msgstr ""
# de5bb072aa194beebbf587038b36bdcf
# fca43aa36e854a9ab4d2b2816c015847
#: ../../using/running.md:6 ../../using/selecting.md:10
msgid "How you wish to start Docker containers from that image"
msgstr ""
# 19634063eb14436daa48af3b1ee3fcc5
#: ../../using/running.md:8
msgid "This section provides details about the second."
msgstr ""
# b855cc98da54497fa98956b68d00e840
#: ../../using/running.md:10
msgid "Using the Docker CLI"
msgstr ""
# 555174be66b049e2ad53de52d8e37aa0
#: ../../using/running.md:12
msgid ""
"You can launch a local Docker container from the Jupyter Docker Stacks using"
" the Docker command line interface. There are numerous ways to configure "
"containers using the CLI. The following are some common patterns."
msgstr ""
# d433157f1f834a66b66143513ffe8c9d
#: ../../using/running.md:14
msgid ""
"Example 1 This command pulls the jupyter/scipy-notebook image tagged "
"2c80cf3537ca from Docker Hub if it is not already present on the local host."
" It then starts a container running a Jupyter Notebook server and exposes "
"the server on host port 8888. The server logs appear in the terminal and "
"include a URL to the notebook server."
msgstr ""
# 3a56c8c4932644e6b938b5401fb98d26
#: ../../using/running.md:36
msgid ""
"Pressing Ctrl-C shuts down the notebook server but leaves the container "
"intact on disk for later restart or permanent deletion using commands like "
"the following:"
msgstr ""
# e3f24ae3050d452aa42f3a92ba36f61c
#: ../../using/running.md:55
msgid ""
"Example 2 This command pulls the jupyter/r-notebook image tagged "
"e5c5a7d3e52d from Docker Hub if it is not already present on the local host."
" It then starts a container running a Jupyter Notebook server and exposes "
"the server on host port 10000. The server logs appear in the terminal and "
"include a URL to the notebook server, but with the internal container port "
"(8888) instead of the the correct host port (10000)."
msgstr ""
# d54172836b0349cb8e8ccbcb6c33ec45
#: ../../using/running.md:77
msgid ""
"Pressing Ctrl-C shuts down the notebook server and immediately destroys the "
"Docker container. Files written to ~/work in the container remain touched. "
"Any other changes made in the container are lost."
msgstr ""
# 0d90bfa0543f4669a0b2bb4b62e2e7dc
#: ../../using/running.md:79
msgid ""
"Example 3 This command pulls the jupyter/all-spark-notebook image currently "
"tagged latest from Docker Hub if an image tagged latest is not already "
"present on the local host. It then starts a container named notebook running"
" a JupyterLab server and exposes the server on a randomly selected port."
msgstr ""
# 04e49785faff4511b8576e9d997bea67
#: ../../using/running.md:85
msgid ""
"The assigned port and notebook server token are visible using other Docker "
"commands."
msgstr ""
# f88af44236f948ccbda342b1c93364d3
#: ../../using/running.md:99
msgid ""
"Together, the URL to visit on the host machine to access the server in this "
"case is "
"http://localhost:32769?token=15914ca95f495075c0aa7d0e060f1a78b6d94f70ea373b00."
msgstr ""
# ed09c347d7aa4dd79e505562f4f5efdd
#: ../../using/running.md:101
msgid ""
"The container runs in the background until stopped and/or removed by "
"additional Docker commands."
msgstr ""
# 7fdc11c0394e4af88bb3c3178814d184
#: ../../using/running.md:113
msgid "Using Binder"
msgstr ""
# 69b162f507f14323b3dbf8758e2964b2
#: ../../using/running.md:115
msgid ""
"Binder is a service that allows you to create and share custom computing "
"environments for projects in version control. You can use any of the Jupyter"
" Docker Stacks images as a basis for a Binder-compatible Dockerfile. See the"
" docker-stacks example and Using a Dockerfile sections in the Binder "
"documentation for instructions."
msgstr ""
# f148f5335f354e549f00dce0cc630475
#: ../../using/running.md:117
msgid "Using JupyterHub"
msgstr ""
# a23469fb52db4edfb3e98c1dc3115b50
#: ../../using/running.md:119
msgid ""
"You can configure JupyterHub to launcher Docker containers from the Jupyter "
"Docker Stacks images. If you've been following the Zero to JupyterHub with "
"Kubernetes guide, see the Use an existing Docker image section for details. "
"If you have a custom JupyterHub deployment, see the Picking or building a "
"Docker image instructions for the dockerspawner instead."
msgstr ""
# bb8d103e20df4ebab2321ae4eee584e7
#: ../../using/running.md:121
msgid "Using Other Tools and Services"
msgstr ""
# c6ef8c5aac54431d931df9f5d5f890d5
#: ../../using/running.md:123
msgid ""
"You can use the Jupyter Docker Stacks with any Docker-compatible technology "
"(e.g., Docker Compose, docker-py, your favorite cloud container service). "
"See the documentation of the tool, library, or service for details about how"
" to reference, configure, and launch containers from these images."
msgstr ""
# d34ba542e6ed43a7b490cfa65b67d9c3
#: ../../using/selecting.md:1
msgid "Selecting an Image"
msgstr ""
# 70b39f1dbdb242599b33cd78bbe6a850
# cb08cf9b24364322a943a40bea1fd39f
#: ../../using/selecting.md:3 ../../using/selecting.md:14
msgid "Core Stacks"
msgstr ""
# 7a8f664007004185a07b672d25205ca2
# 5040afcacc8d4cdeb5bc9b0ed6a06c88
#: ../../using/selecting.md:4 ../../using/selecting.md:123
msgid "Image Relationships"
msgstr ""
# e364abca4ff948f5a6dba4d5685f9fe8
# ae86feb2ae9c4ed081379460d4a559fb
#: ../../using/selecting.md:5 ../../using/selecting.md:141
msgid "Community Stacks"
msgstr ""
# 27b83c7429d142b89e0e425b662e94a9
#: ../../using/selecting.md:12
msgid "This section provides details about the first."
msgstr ""
# b24fe11f42e84aaf8d2378535737148e
#: ../../using/selecting.md:16
msgid ""
"The Jupyter team maintains a set of Docker image definitions in the "
"https://github.com/jupyter/docker-stacks GitHub repository. The following "
"sections describe these images including their contents, relationships, and "
"versioning strategy."
msgstr ""
# 6562071d34574731baa6241fc067690c
#: ../../using/selecting.md:18
msgid "jupyter/base-notebook"
msgstr ""
# 79c95b7cb9df4670a0fab5737942396f
# 2d8e2926bd6f4db69959f5f0456c4682
# 6d074c8de6fd4895b715a3525ccb8bb4
# 7337ce8d03e5474887cd6affc21ec03b
# 2fb0a6afd5b24c33820ccaed19dd886d
# 1ad0f64aec2c4439937fa4d02ee0fe49
# f955c9a3be324d2db1f47a643b9d51a3
# 667016f994f84648853707ce13241d45
#: ../../using/selecting.md:20 ../../using/selecting.md:37
#: ../../using/selecting.md:49 ../../using/selecting.md:63
#: ../../using/selecting.md:76 ../../using/selecting.md:87
#: ../../using/selecting.md:100 ../../using/selecting.md:112
msgid "Source on GitHub | Dockerfile commit history | Docker Hub image tags"
msgstr ""
# 864aa76e1043469fa96b27f26dcad7d1
#: ../../using/selecting.md:24
msgid ""
"jupyter/base-notebook is a small image supporting the options common across "
"all core stacks. It is the basis for all other stacks."
msgstr ""
# d869d6c4081e483180f51de5f5e225a7
#: ../../using/selecting.md:26
msgid ""
"Minimally-functional Jupyter Notebook server (e.g., no pandoc for saving "
"notebooks as PDFs)"
msgstr ""
# d6384943a3394b9d9a5a505e2387d392
#: ../../using/selecting.md:27
msgid "Miniconda Python 3.x in /opt/conda"
msgstr ""
# 031a321f6173495daef86225cd234a72
#: ../../using/selecting.md:28
msgid "No preinstalled scientific computing packages"
msgstr ""
# e37862b78262475182c34461d2fae08e
#: ../../using/selecting.md:29
msgid ""
"Unprivileged user jovyan (uid=1000, configurable, see options) in group "
"users (gid=100) with ownership over the /home/jovyan and /opt/conda paths"
msgstr ""
# cdd04f4dbb864e82b8b993ccb1670687
#: ../../using/selecting.md:30
msgid ""
"tini as the container entrypoint and a start-notebook.sh script as the "
"default command"
msgstr ""
# 0e3cf3b3a6e540be861ef295f1808099
#: ../../using/selecting.md:31
msgid ""
"A start-singleuser.sh script useful for launching containers in JupyterHub"
msgstr ""
# 3b561d51339f422d801a408007ca16f3
#: ../../using/selecting.md:32
msgid ""
"A start.sh script useful for running alternative commands in the container "
"(e.g. ipython, jupyter kernelgateway, jupyter lab)"
msgstr ""
# 9e8346716bc148fb8df45bce44fa7c38
#: ../../using/selecting.md:33
msgid "Options for a self-signed HTTPS certificate and passwordless sudo"
msgstr ""
# ee56473bbb334a9b96db5870f6be611c
#: ../../using/selecting.md:35
msgid "jupyter/minimal-notebook"
msgstr ""
# eec9e5e3162343eba481b73cc223fa49
#: ../../using/selecting.md:41
msgid ""
"jupyter/minimal-notebook adds command line tools useful when working in "
"Jupyter applications."
msgstr ""
# cf19dcbf0d084508924f166d2b0fa7e3
#: ../../using/selecting.md:43
msgid "Everything in jupyter/base-notebook"
msgstr ""
# 52d17abfd2f14628a9937f1b7584582d
#: ../../using/selecting.md:44
msgid "Pandoc and TeX Live for notebook document conversion"
msgstr ""
# b81070edc9c849c184be4687ce17b786
#: ../../using/selecting.md:45
msgid "git, emacs, jed, nano, tzdata, and unzip"
msgstr ""
# aa65fcb5d17649bb88ded23f0880e147
#: ../../using/selecting.md:47
msgid "jupyter/r-notebook"
msgstr ""
# 54b4b695a8ed493bb79993e62dd164c2
#: ../../using/selecting.md:53
msgid "jupyter/r-notebook includes popular packages from the R ecosystem."
msgstr ""
# d83a0f40bfc34554a0c362f02c656e55
# c27e75f042064ae0a64447053b46785e
#: ../../using/selecting.md:55 ../../using/selecting.md:69
msgid "Everything in jupyter/minimal-notebook and its ancestor images"
msgstr ""
# 99e3f1d20553480c81dda15a66369f52
#: ../../using/selecting.md:56
msgid "The R interpreter and base environment"
msgstr ""
# 34bc2c80ad014b019fb54fc1fad024c4
# 8c5a996a6b0c4309810071f5194f532a
#: ../../using/selecting.md:57 ../../using/selecting.md:119
msgid "IRKernel to support R code in Jupyter notebooks"
msgstr ""
# a24d121e485e4bd9bbe4df9883a7c148
#: ../../using/selecting.md:58
msgid ""
"tidyverse packages, including ggplot2, dplyr, tidyr, readr, purrr, tibble, "
"stringr, lubridate, and broom from conda-forge"
msgstr ""
# d49e405f45dd40a69e64b1636f69381d
#: ../../using/selecting.md:59
msgid ""
"plyr, devtools, shiny, rmarkdown, forecast, rsqlite, reshape2, nycflights13,"
" caret, rcurl, and randomforest packages from conda-forge"
msgstr ""
# 9cfe9452daa04dfc982c2d99948a37eb
#: ../../using/selecting.md:61
msgid "jupyter/scipy-notebook"
msgstr ""
# 47f831c00a78451bb75de1467d90d34c
#: ../../using/selecting.md:67
msgid ""
"jupyter/scipy-notebook includes popular packages from the scientific Python "
"ecosystem."
msgstr ""
# da192888520b4b2ca9ae8ca5162aba6c
#: ../../using/selecting.md:70
msgid ""
"pandas, numexpr, matplotlib, scipy, seaborn, scikit-learn, scikit-image, "
"sympy, cython, patsy, statsmodel, cloudpickle, dill, numba, bokeh, "
"sqlalchemy, hdf5, vincent, beautifulsoup, protobuf, and xlrd packages"
msgstr ""
# be048a3494074da99c0f5b98454feda8
#: ../../using/selecting.md:71
msgid "ipywidgets for interactive visualizations in Python notebooks"
msgstr ""
# c3e92433ff5f4702beeaea78d6ee6fd7
#: ../../using/selecting.md:72
msgid "Facets for visualizing machine learning datasets"
msgstr ""
# ff01e76ad1544fb48e024a617ae932b5
#: ../../using/selecting.md:74
msgid "jupyter/tensorflow-notebook"
msgstr ""
# bf2f117cf3a047aa8be8cd73f4080455
#: ../../using/selecting.md:80
msgid ""
"jupyter/tensorflow-notebook includes popular Python deep learning libraries."
msgstr ""
# 1fccef5b590549ffb4ea6933eaf12674
# 1140d31915eb42fc89725521ec90c1dc
#: ../../using/selecting.md:82 ../../using/selecting.md:106
msgid "Everything in jupyter/scipy-notebook and its ancestor images"
msgstr ""
# 099eb36a6961440b8bea7901b226a96d
#: ../../using/selecting.md:83
msgid "tensorflow and keras machine learning libraries"
msgstr ""
# 13413eabaac34b94b4bc5ae28e445dda
#: ../../using/selecting.md:85
msgid "jupyter/datascience-notebook"
msgstr ""
# 23244942c9ef4eb8aba10cd558bf5fe9
#: ../../using/selecting.md:91
msgid ""
"jupyter/datascience-notebook includes libraries for data analysis from the "
"Julia, Python, and R communities."
msgstr ""
# 7e65863f6a0840729876d3669158c4ce
#: ../../using/selecting.md:93
msgid ""
"Everything in the jupyter/scipy-notebook and jupyter/r-notebook images, and "
"their ancestor images"
msgstr ""
# 6246f4a0d2454714860e4ffa80aef958
#: ../../using/selecting.md:94
msgid "The Julia compiler and base environment"
msgstr ""
# 143e63b9b0a9418a8c93870f6186808e
#: ../../using/selecting.md:95
msgid "IJulia to support Julia code in Jupyter notebooks"
msgstr ""
# 7a170fe5f6a949cc939d2f40200b3336
#: ../../using/selecting.md:96
msgid "HDF5, Gadfly, and RDatasets packages"
msgstr ""
# 4b741debc1e84661ab63b8bf0d9c3bbe
#: ../../using/selecting.md:98
msgid "jupyter/pyspark-notebook"
msgstr ""
# 815f62ec44f54dbfaa5a052d15580b94
#: ../../using/selecting.md:104
msgid ""
"jupyter/pyspark-notebook includes Python support for Apache Spark, "
"optionally on Mesos."
msgstr ""
# 0cb03ee6cd9d488597be17be045f3b74
#: ../../using/selecting.md:107
msgid "Apache Spark with Hadoop binaries"
msgstr ""
# 977ee95d9f664fe2a62505e0a78b1447
#: ../../using/selecting.md:108
msgid "Mesos client libraries"
msgstr ""
# 43c0814f5a024a598dd26a4af0212cea
#: ../../using/selecting.md:110
msgid "jupyter/all-spark-notebook"
msgstr ""
# 0c1536b3ff6d40a885e9cdd881dc19bd
#: ../../using/selecting.md:116
msgid ""
"jupyter/all-spark-notebook includes Python, R, and Scala support for Apache "
"Spark, optionally on Mesos."
msgstr ""
# ecf9548ffc5e4e0eb4bbdf6cb458cf32
#: ../../using/selecting.md:118
msgid "Everything in jupyter/pyspark-notebook and its ancestor images"
msgstr ""
# 5f6081607cab47739c306516cf84a814
#: ../../using/selecting.md:120
msgid ""
"Apache Toree and spylon-kernel to support Scala code in Jupyter notebooks"
msgstr ""
# a4b50e47f8684dfbbe71e0c3353199dd
#: ../../using/selecting.md:121
msgid "ggplot2, sparklyr, and rcurl packages"
msgstr ""
# ebbdf9189d96433e9323aae035f37ec2
#: ../../using/selecting.md:125
msgid ""
"The following diagram depicts the build dependency tree of the core images. "
"(i.e., the FROM statements in their Dockerfiles). Any given image inherits "
"the complete content of all ancestor images pointing to it."
msgstr ""
# df2da8e55aa740a485fd638aa7397b8a
#: ../../using/selecting.md:129
msgid "Builds"
msgstr ""
# 56066ef1cd834061b3c3aea7567221c7
#: ../../using/selecting.md:131
msgid ""
"Pull requests to the jupyter/docker-stacks repository trigger builds of all "
"images on Travis CI. These images are for testing purposes only and are not "
"saved for use. When pull requests merge to master, all images rebuild on "
"Docker Cloud and become available to docker pull from Docker Hub."
msgstr ""
# f4781cd0f2c040458a15b80846026405
#: ../../using/selecting.md:133
msgid "Versioning"
msgstr ""
# 28addf6682f24cbdb1b6cd1836a6dc74
#: ../../using/selecting.md:135
msgid ""
"The latest tag in each Docker Hub repository tracks the master branch HEAD "
"reference on GitHub. latest is a moving target, by definition, and will have"
" backward-incompatible changes regularly."
msgstr ""
# 92c07d80753b4fda9406b3b2694684e7
#: ../../using/selecting.md:137
msgid ""
"Every image on Docker Hub also receives a 12-character tag which corresponds"
" with the git commit SHA that triggered the image build. You can inspect the"
" state of the jupyter/docker-stacks repository for that commit to review the"
" definition of the image (e.g., images with tag 7c45ec67c8e7 were built from"
" https://github.com/jupyter/docker-stacks/tree/7c45ec67c8e7)."
msgstr ""
# 5bdfd71620394fa4812120220718ffeb
#: ../../using/selecting.md:139
msgid ""
"You must refer to git-SHA image tags when stability and reproducibility are "
"important in your work. (e.g. FROM jupyter/scipy-notebook:7c45ec67c8e7, "
"docker run -it --rm jupyter/scipy-notebook:7c45ec67c8e7). You should only "
"use latest when a one-off container instance is acceptable (e.g., you want "
"to briefly try a new library in a notebook)."
msgstr ""
# 90cc227d51734f8586d42982f3b7a559
#: ../../using/selecting.md:143
msgid ""
"The core stacks are just a tiny sample of what's possible when combining "
"Jupyter with other technologies. We encourage members of the Jupyter "
"community to create their own stacks based on the core images and link them "
"below."
msgstr ""
# f1c9edb79eae4a5f929fdc1e0e2d4366
#: ../../using/selecting.md:145
msgid "This list only has 2 examples. You can be the next!"
msgstr ""
# 7346986f864848708411fa0788d3b4e4
#: ../../using/selecting.md:147
msgid ""
"csharp-notebook is a community Jupyter Docker Stack image. Try C# in Jupyter"
" Notebooks. The image includes more than 200 Jupyter Notebooks with example "
"C# code and can readily be tried online via mybinder.org. Click here to "
"launch ."
msgstr ""
# a2e061cf04bf4e96a4d40c03790d64bc
#: ../../using/selecting.md:149
msgid ""
"education-notebook is a community Jupyter Docker Stack image. The image "
"includes nbgrader and RISE on top of the datascience-notebook image. Click "
"here to launch it on ."
msgstr ""
# c3720b9d103947499b34ebd19567733f
#: ../../using/selecting.md:151
msgid ""
"See the contributing guide for information about how to create your own "
"Jupyter Docker Stack."
msgstr ""
# b9f784eaaa0a4072929bc51254fa322e
#: ../../using/specifics.md:1
msgid "Image Specifics"
msgstr ""
# dfb2958ae819459383ad8c75ba65dd39
#: ../../using/specifics.md:3
msgid ""
"This page provides details about features specific to one or more images."
msgstr ""
# 9cfa68a10a3c4eb8b63c435e43bf77fc
#: ../../using/specifics.md:5
msgid "Apache Spark"
msgstr ""
# 536591b439514687b086cf6a4c6f7a93
#: ../../using/specifics.md:7
msgid ""
"The jupyter/pyspark-notebook and jupyter/all-spark-notebook images support "
"the use of Apache Spark in Python, R, and Scala notebooks. The following "
"sections provide some examples of how to get started using them."
msgstr ""
# 21d870dca44845948d9ab959f8ccc105
#: ../../using/specifics.md:9
msgid "Using Spark Local Mode"
msgstr ""
# bda9eb0bb22b4e8e8662fcd037d9d585
#: ../../using/specifics.md:11
msgid ""
"Spark local mode is useful for experimentation on small data when you do not"
" have a Spark cluster available."
msgstr ""
# 91033be3c31b48d4a1a6a235491bd897
# 6cc19049cacb4403989934496ecc4375
#: ../../using/specifics.md:13 ../../using/specifics.md:71
msgid "In a Python Notebook"
msgstr ""
# 556a0ebdcab54a87b01f1b8bed45628e
# 823b89e12a514c54b10255bcc2081397
#: ../../using/specifics.md:24 ../../using/specifics.md:98
msgid "In a R Notebook"
msgstr ""
# a42af3a3c0a44602b15d8d7ed52d267b
# cb0340653342464892f57379cf775ea9
#: ../../using/specifics.md:36 ../../using/specifics.md:119
msgid "In a Spylon Kernel Scala Notebook"
msgstr ""
# f6efc67ea4d14900a978e0d581e6448a
#: ../../using/specifics.md:38
msgid ""
"Spylon kernel instantiates a SparkContext for you in variable sc after you "
"configure Spark options in a %%init_spark magic cell."
msgstr ""
# 48c05ebdfde54ea6b8794b47171a6c10
# 66315cf3b7554105bfeaf6a3a5b43b73
#: ../../using/specifics.md:52 ../../using/specifics.md:134
msgid "In an Apache Toree Scala Notebook"
msgstr ""
# 5d8060e95aa941e58a64d0465dbacafa
#: ../../using/specifics.md:54
msgid ""
"Apache Toree instantiates a local SparkContext for you in variable sc when "
"the kernel starts."
msgstr ""
# 1a30fe3a85fa44b1860efb1e8bf123e3
#: ../../using/specifics.md:61
msgid "Connecting to a Spark Cluster on Mesos"
msgstr ""
# 74263d337820458d851a4b869d14f1cf
#: ../../using/specifics.md:63
msgid ""
"This configuration allows your compute cluster to scale with your data."
msgstr ""
# c7ca76d01c6e4f10ad8f793b65dc41db
#: ../../using/specifics.md:65
msgid "Deploy Spark on Mesos."
msgstr ""
# 296f9c1d6f2a4950a1147913198bc1bc
#: ../../using/specifics.md:66
msgid ""
"Configure each slave with the --no-switch_user flag or create the $NB_USER "
"account on every slave node."
msgstr ""
# 2d988e27cde44fa09feaed27ce3b7a06
# 6045e72f079c4fc2ab9e3ce622968bc8
#: ../../using/specifics.md:67 ../../using/specifics.md:163
msgid ""
"Run the Docker container with --net=host in a location that is network "
"addressable by all of your Spark workers. (This is a Spark networking "
"requirement.)"
msgstr ""
# f20142628b0f40379f87031abd6461b2
# b00bbd0a10d4480db69f870cdf5fe094
#: ../../using/specifics.md:68 ../../using/specifics.md:164
msgid ""
"NOTE: When using --net=host, you must also use the flags --pid=host -e "
"TINI_SUBREAPER=true. See https://github.com/jupyter/docker-stacks/issues/64 "
"for details."
msgstr ""
# 46c5b891e7ce4fa78d3c0eeff0e22635
#: ../../using/specifics.md:69
msgid "Follow the language specific instructions below."
msgstr ""
# 90c742c66172412c862fcf09a2661bf5
#: ../../using/specifics.md:136
msgid ""
"The Apache Toree kernel automatically creates a SparkContext when it starts "
"based on configuration information from its command line arguments and "
"environment variables. You can pass information about your Mesos cluster via"
" the SPARK_OPTS environment variable when you spawn a container."
msgstr ""
# 7c2b15ef25ba4cd29ff222b808a8fd68
#: ../../using/specifics.md:138
msgid ""
"For instance, to pass information about a Mesos master, Spark binary "
"location in HDFS, and an executor options, you could start the container "
"like so:"
msgstr ""
# 94f9511094e044f08129c273ce3efaf0
#: ../../using/specifics.md:146
msgid ""
"Note that this is the same information expressed in a notebook in the Python"
" case above. Once the kernel spec has your cluster information, you can test"
" your cluster in an Apache Toree notebook like so:"
msgstr ""
# e0c67007d0cc4c9da0fb73d5ed25356d
#: ../../using/specifics.md:157
msgid "Connecting to a Spark Cluster in Standalone Mode"
msgstr ""
# 6c6f7d3049814b25a3acf211e2587ec2
#: ../../using/specifics.md:159
msgid ""
"Connection to Spark Cluster on Standalone Mode requires the following set of"
" steps:"
msgstr ""
# 4634540d7990421fb60e85b6241dd816
#: ../../using/specifics.md:161
msgid ""
"Verify that the docker image (check the Dockerfile) and the Spark Cluster "
"which is being deployed, run the same version of Spark."
msgstr ""
# d6b4329933e24b69879a4621b26bf454
#: ../../using/specifics.md:162
msgid "Deploy Spark in Standalone Mode."
msgstr ""
# 3dfcc2e12ca34c92ac8ebf96e4a37066
#: ../../using/specifics.md:165
msgid ""
"The language specific instructions are almost same as mentioned above for "
"Mesos, only the master url would now be something like "
"spark://10.10.10.10:7077"
msgstr ""
# 9e271f07799e4cb0a4b79df224a5639f
#: ../../using/specifics.md:167
msgid "Tensorflow"
msgstr ""
# 2a525d328e6f419f98d2ed3b99978e25
#: ../../using/specifics.md:169
msgid ""
"The jupyter/tensorflow-notebook image supports the use of Tensorflow in "
"single machine or distributed mode."
msgstr ""
# 4440ceaa200f4029b5cbaf9c895a8e5c
#: ../../using/specifics.md:171
msgid "Single Machine Mode"
msgstr ""
# d82de0694427429fa44d9988c1db4851
#: ../../using/specifics.md:185
msgid "Distributed Mode"
msgstr ""
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment