diff --git a/docs/locale/en/LC_MESSAGES/contributing.po b/docs/locale/en/LC_MESSAGES/contributing.po index c01265c5..93acc8ff 100644 --- a/docs/locale/en/LC_MESSAGES/contributing.po +++ b/docs/locale/en/LC_MESSAGES/contributing.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: docker-stacks latest\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-05-19 01:43+0000\n" +"POT-Creation-Date: 2021-05-19 02:28+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -18,12 +18,12 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" -#: ../../contributing/features.md:1 abe9470c18414fc9830fa59f6628fabf -msgid "# New Features" +#: ../../contributing/features.md:1 6c875ba064d849f8b31e8e9584a985dd +msgid "New Features" msgstr "" # 64c3ecc68ada47afada78f945253c9e9 -#: ../../contributing/features.md:3 197123fa1e2348578589d2332672fdf2 +#: ../../contributing/features.md:3 996031a6bb9f4d83ac90c45de44f3306 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 " @@ -31,24 +31,24 @@ msgid "" " maintaining the images over time." msgstr "" -#: ../../contributing/features.md:7 b7b0992cfe8d4efeb08f9d0621504061 -msgid "## Suggesting a New Feature" +#: ../../contributing/features.md:7 60901bc6bf504a04bee7999500772846 +msgid "Suggesting a New Feature" msgstr "" # c995f8cabb1d4b4fb53a9c56ae8e017b -#: ../../contributing/features.md:9 384ae79fe1744171b5570d631ecd4ddf +#: ../../contributing/features.md:9 292212c0ae9141618b21ef99cb4adbeb msgid "" "Please follow the process below to suggest a new feature for inclusion in" " one of the core stacks:" msgstr "" -#: ../../contributing/features.md:11 d94fb38c50cf431cb8f3d22ee2d346d6 +#: ../../contributing/features.md:11 99b0c3feba7d4fc2a8700d75fa95cf0f msgid "" "[Open a GitHub issue](https://github.com/jupyter/docker-stacks/issues) " "describing the feature you'd like to contribute." msgstr "" -#: ../../contributing/features.md:13 f529153f74c545b7abfda294bdbcd793 +#: ../../contributing/features.md:13 7a3a57c624064e2b94e3a849a0a5ae0d msgid "" "Discuss with the maintainers whether the addition makes sense in [one of " "the core stacks](../using/selecting.md#core-stacks), as a [recipe in the " @@ -56,32 +56,32 @@ msgid "" "something else entirely." msgstr "" -#: ../../contributing/features.md:18 b9548071be574735a89c16f2cfdcdad4 -msgid "## Selection Criteria" +#: ../../contributing/features.md:18 550cb54cdea849ee8c5217860c46d8b2 +msgid "Selection Criteria" msgstr "" # ca139cf0df684011bdf6f6f68e151796 -#: ../../contributing/features.md:20 bca9ad676e5c47a8b97c19e636be06ec +#: ../../contributing/features.md:20 8fda4a5567af4eb2888457b331a49719 msgid "" "Roughly speaking, we evaluate new features based on the following " "criteria:" msgstr "" -#: ../../contributing/features.md:22 3acd871e389442a1bec075385c6ffee2 +#: ../../contributing/features.md:22 75600ff9beb5479f8674533a96d27e26 msgid "" "**Usefulness to Jupyter users**: Is the feature generally applicable " "across domains? Does it work with Jupyter Notebook, JupyterLab, " "JupyterHub, etc.?" msgstr "" -#: ../../contributing/features.md:24 41cc6025b7dc45bf9110375eef3197ff +#: ../../contributing/features.md:24 c59631b300664a288b0ad875b811242b 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 "" -#: ../../contributing/features.md:26 bffab6df3b2145d1bb493a2b64d24ed2 +#: ../../contributing/features.md:26 2f10bee020d242599c305a1f767c25f8 msgid "" "**Complexity of build / runtime configuration**: How many lines of code " "does the feature require in one of the Dockerfiles or startup scripts? " @@ -89,14 +89,14 @@ msgid "" "use the images?" msgstr "" -#: ../../contributing/features.md:29 dd8a80d0646b4d4aa40304d9d4621a8c +#: ../../contributing/features.md:29 083985b3660a4598a7a48e2b292728e7 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 "" -#: ../../contributing/features.md:31 bdcf55959456474db421e0b6db214219 +#: ../../contributing/features.md:31 5103706d34d044259bb60d3ccfd04759 msgid "" "**Ability to support the addition**: Can existing maintainers answer user" " questions and address future build issues? Are the contributors " @@ -104,25 +104,25 @@ msgid "" "ensure the feature continues to work over time?" msgstr "" -#: ../../contributing/features.md:35 5d61dc613d504081815ee94e1fd9c71c -msgid "## Submitting a Pull Request" +#: ../../contributing/features.md:35 c0939286eb8e450da57735839e27c241 +msgid "Submitting a Pull Request" msgstr "" # f7ca9b40be90476eb97c8fcd67205e9d -#: ../../contributing/features.md:37 19a13bea39744ff0809975fb8c599ef6 +#: ../../contributing/features.md:37 2adc429317e74d988b505e3a1ea3e9c9 msgid "" "If there's agreement that the feature belongs in one or more of the core " "stacks:" msgstr "" -#: ../../contributing/features.md:39 affcd211544d4d6fba0aa49a31b61957 +#: ../../contributing/features.md:39 72664fbde64a4906a3e0c57539a630c0 msgid "" "Implement the feature in a local clone of the `jupyter/docker-stacks` " "project." msgstr "" #: ../../contributing/features.md:40 ../../contributing/packages.md:16 -#: 6b921988dd3a429d9be19b89c74f99ef a34aa7d7f24e416bb2708246cf6b663a +#: 3120c789a47c4ac5a93a6da8ba095dcb 9433dc4bbcb94e2eb8f2f7be5360e807 msgid "" "Please build the image locally before submitting a pull request. Building" " the image locally shortens the debugging cycle by taking some load off " @@ -130,14 +130,9 @@ msgid "" "source projects like this one. If you use `make`, call:" msgstr "" -#: ../../contributing/features.md:44 ../../contributing/packages.md:20 -#: 5ec1b369886b4d94a331e5353d7c1faa e0bd8a2eab0e4adc9a07e966cb476e35 -msgid "```bash make build/somestack-notebook ```" -msgstr "" - #: ../../contributing/features.md:48 ../../contributing/packages.md:24 -#: ../../contributing/tests.md:32 a6128d2f5ef349eca71eb6f59e4251e6 -#: ae7ef32adfe84d2bb12a22437288e32a d586fc5126914accb21e25c728a5263c +#: ../../contributing/tests.md:32 3505442e9d8a4a599877df6921bf7db2 +#: 4e8832548666449a8c94ec6e866ff5d4 f1258b8ac9cd4408b37fde070923811e msgid "" "[Submit a pull request](https://github.com/PointCloudLibrary/pcl/wiki/A" "-step-by-step-guide-on-preparing-and-submitting-a-pull-request) (PR) with" @@ -145,30 +140,30 @@ msgid "" msgstr "" #: ../../contributing/features.md:50 ../../contributing/packages.md:26 -#: ../../contributing/tests.md:34 094303c6e610435888fbd1f51eb97b3c -#: 370fa4bdedfc49848b5157f1615e30ac 7a023bf31bf941d0b33f20d771852c6c +#: ../../contributing/tests.md:34 58b82aca5df54dbebc867480fbefda21 +#: 6edcf8d72be5429dbd616fbcbb4e8ca8 9bb763c2f33a4bab97ebf395c78a5c3b msgid "" "Watch for GitHub to report a build success or failure for your PR on " "GitHub." msgstr "" -#: ../../contributing/features.md:51 5ef7f06ebb0944a295b04974c0307626 +#: ../../contributing/features.md:51 af4347aec77f4f229529d2e59bb86df4 msgid "Discuss changes with the maintainers and address any build issues." msgstr "" -#: ../../contributing/issues.md:1 4b99810e768e418f88f773adba441b39 -msgid "# Project Issues" +#: ../../contributing/issues.md:1 c925f19b7a26421590f04466eee16b99 +msgid "Project Issues" msgstr "" # 9c2a6e9f67354e86aca23758676fca43 -#: ../../contributing/issues.md:3 3ea9fc9e88da4095bd3b5d8c28825c4b +#: ../../contributing/issues.md:3 8e9cdff4ea17459f8498f80f2b70f921 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 "" -#: ../../contributing/issues.md:7 7a3d280396bb418fae402ada1b4a9141 +#: ../../contributing/issues.md:7 23277255db2c4bfeb0497e755c39c5d5 msgid "" "If you believe you’ve found a security vulnerability in any of the " "Jupyter projects included in Jupyter Docker Stacks images, please report " @@ -178,7 +173,7 @@ msgid "" "key](https://github.com/jupyter/jupyter.github.io/blob/master/assets/ipython_security.asc)." msgstr "" -#: ../../contributing/issues.md:13 179c33f0cce04dc683ea2f73e45487c0 +#: ../../contributing/issues.md:13 6ecb212c6fc64960b944e04057ce304f msgid "" "If you think your problem is unique to the Jupyter Docker Stacks images, " "please search the [jupyter/docker-stacks issue " @@ -189,14 +184,14 @@ msgid "" msgstr "" # 69a18cc239b34b94800599bf185f58d6 -#: ../../contributing/issues.md:19 0628b0e112ba4874aa203b49ba133432 +#: ../../contributing/issues.md:19 09164c46865d451f8d78dd1c918e0d82 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 "" -#: ../../contributing/issues.md:22 2705926687f444af9c5162a01530195d +#: ../../contributing/issues.md:22 519826d746ff49e49de4388c207b3272 msgid "" "If you have a general question about how to use the Jupyter Docker Stacks" " in your environment, in conjunction with other tools, with " @@ -204,11 +199,11 @@ msgid "" "Discourse site](https://discourse.jupyter.org)." msgstr "" -#: ../../contributing/lint.md:1 f8303a2cf3de49a185b85ae1fe627db8 -msgid "# Lint" +#: ../../contributing/lint.md:1 07491d8e7fcb4d8eb7b8f518cb7e5657 +msgid "Lint" msgstr "" -#: ../../contributing/lint.md:3 d0c20e0a31af43b1b4338c6cafc90d48 +#: ../../contributing/lint.md:3 713b7f7cef0d45e5aa3faa3f1f0b703e msgid "" "In order to enforce some rules **linters** are used in this project. " "Linters can be run either during the **development phase** (by the " @@ -217,129 +212,102 @@ msgid "" "**git hooks** through [pre-commit][pre-commit]." msgstr "" -#: ../../contributing/lint.md:7 f973486d36984f489c0b6f94f766b890 -msgid "## Pre-commit hook" +#: ../../contributing/lint.md:7 fb7b4a7fcdda41199cc1f97497b4c7be +msgid "Pre-commit hook" msgstr "" -#: ../../contributing/lint.md:9 5df8327dcce248ca8e17ef3f762abc7f -msgid "### Pre-commit hook installation" +#: ../../contributing/lint.md:9 1a53b23491c6478dbd6e76e0f1f99cbe +msgid "Pre-commit hook installation" msgstr "" -#: ../../contributing/lint.md:11 0230d29897d640c4ab518c2fd8c540f5 +#: ../../contributing/lint.md:11 ebc36317e85d45e09fdb00b7bf245575 msgid "" "pre-commit is a Python package that needs to be installed. This can be " "achieved by using the generic task used to install all Python development" " dependencies." msgstr "" -#: ../../contributing/lint.md:14 cb02b3ac6604409f9a9d4de01a8de10c -msgid "" -"```sh # Install all development dependencies for the project $ make dev-" -"env # It can also be installed directly $ pip install pre-commit ```" -msgstr "" - -#: ../../contributing/lint.md:21 a8dd6004af7345749cbe50794bf93274 +#: ../../contributing/lint.md:21 4b72942f059341e88e75660040ab041e msgid "" "Then the git hooks scripts configured for the project in `.pre-commit-" "config.yaml` need to be installed in the local git repository." msgstr "" -#: ../../contributing/lint.md:23 45d49a3f442542a2a0a0a16eeea3e107 -msgid "```sh make pre-commit-install ```" +#: ../../contributing/lint.md:27 4c8c7f2f2d304b87a1237221b7a230fa +msgid "Run" msgstr "" -#: ../../contributing/lint.md:27 c27d0a806aae450d85197bf0aebade08 -msgid "### Run" -msgstr "" - -#: ../../contributing/lint.md:29 63b25136238e437d873173204e938ab5 +#: ../../contributing/lint.md:29 d60d2a4327cf46098ec403889714c76d msgid "" "Now pre-commit (and so configured hooks) will run automatically on `git " "commit` on each changed file. However it is also possible to trigger it " "against all files." msgstr "" -#: ../../contributing/lint.md:32 5a7db25db2804679a7110111d4318370 +#: ../../contributing/lint.md:32 83fb7ab4ff5f4448a7a4df9853842a81 msgid "" "Note: Hadolint pre-commit uses docker to run, so docker should be running" " while running this command." msgstr "" -#: ../../contributing/lint.md:34 4d7b51f06a184f039675b2fc15110a64 -msgid "```sh make pre-commit-all ```" +#: ../../contributing/lint.md:38 d36dd83dcc334c77a7d24ef301a88e08 +msgid "Image Lint" msgstr "" -#: ../../contributing/lint.md:38 7f265d9a777b438588396b2fbae37fc4 -msgid "## Image Lint" -msgstr "" - -#: ../../contributing/lint.md:40 2cc99a8773cb47de95f1609ff2bea9a3 +#: ../../contributing/lint.md:40 f4831be9593245ff8ac364e0948d48a4 msgid "" "To comply with [Docker best practices][dbp], we are using the " "[Hadolint][hadolint] tool to analyse each `Dockerfile` ." msgstr "" -#: ../../contributing/lint.md:42 4e05074f2df54b2c97282de9130fb844 -msgid "### Ignoring Rules" +#: ../../contributing/lint.md:42 aa294430576f4b18a9787b2d9f1792c1 +msgid "Ignoring Rules" msgstr "" -#: ../../contributing/lint.md:44 84295d171d91464b9298aac6b4ad3c2e +#: ../../contributing/lint.md:44 f19e16bb4e574684b726a32f79f13335 msgid "" "Sometimes it is necessary to ignore [some rules][rules]. The following " "rules are ignored by default for all images in the `.hadolint.yaml` file." msgstr "" -#: ../../contributing/lint.md:47 df38f6f02f4549bd8bc5cd04919e72c5 -msgid "" -"[`DL3006`][DL3006]: We use a specific policy to manage image tags. - " -"`base-notebook` `FROM` clause is fixed but based on an argument (`ARG`). " -"- Building downstream images from (`FROM`) the latest is done on purpose." +#: ../../contributing/lint.md:47 d94ed9ada97247acab2f552b3c9f21e5 +msgid "[`DL3006`][DL3006]: We use a specific policy to manage image tags." msgstr "" -#: ../../contributing/lint.md:50 c18b660f70cc4d60a89d63170ce82463 +#: ../../contributing/lint.md:48 98c4b8285e4c4fae948b49cadef8e3ff +msgid "`base-notebook` `FROM` clause is fixed but based on an argument (`ARG`)." +msgstr "" + +#: ../../contributing/lint.md:49 f25b64f74c7b46cc922178f1c7ddc041 +msgid "Building downstream images from (`FROM`) the latest is done on purpose." +msgstr "" + +#: ../../contributing/lint.md:50 b75c0c11806e4230a597b20d16971639 msgid "" "[`DL3008`][DL3008]: System packages are always updated (`apt-get`) to the" " latest version." msgstr "" -#: ../../contributing/lint.md:52 e44d1e88f89b499893f63bcca22c58b7 +#: ../../contributing/lint.md:52 8acae164c62e43578a5a8ebd1ba68b99 msgid "" "For other rules, the preferred way to do it is to flag ignored rules in " "the `Dockerfile`." msgstr "" -#: ../../contributing/lint.md:54 7d4090ca9fe142a3b3b9eb4d75da12d9 +#: ../../contributing/lint.md:54 1f1b2331d3254275805f4990b3396e24 msgid "" -"> It is also possible to ignore rules by using a special comment directly" -" above the Dockerfile instruction you want to make an exception for. " +"It is also possible to ignore rules by using a special comment directly " +"above the Dockerfile instruction you want to make an exception for. " "Ignore rule comments look like `# hadolint ignore=DL3001,SC1081`. For " "example:" msgstr "" -#: ../../contributing/lint.md:56 b2c03ad99c884927874886e13c9a96db -msgid "```dockerfile FROM ubuntu" -msgstr "" - -#: ../../contributing/lint.md:59 098a7ee721844e78a461de2b3443f736 -msgid "# hadolint ignore=DL3003,SC1035 RUN cd /tmp && echo \"hello!\" ```" -msgstr "" - -#: ../../contributing/lint.md:63 248cae61802142588668ecd5dbfdbd29 -msgid "" -"[hadolint]: https://github.com/hadolint/hadolint [dbp]: " -"https://docs.docker.com/develop/develop-images/dockerfile_best-practices " -"[rules]: https://github.com/hadolint/hadolint#rules [DL3006]: " -"https://github.com/hadolint/hadolint/wiki/DL3006 [DL3008]: " -"https://github.com/hadolint/hadolint/wiki/DL3008 [pre-commit]: https" -"://pre-commit.com/" -msgstr "" - -#: ../../contributing/packages.md:1 57f980a1ef9741bda1b8d5b26eb3a9ae -msgid "# Package Updates" +#: ../../contributing/packages.md:1 703f5d13e65a4fd39250adbae9a936fa +msgid "Package Updates" msgstr "" # 5f269a667f9a4c3ca342cfb49ecaefb2 -#: ../../contributing/packages.md:3 8318b034eec84c55bf29e46b4967bde4 +#: ../../contributing/packages.md:3 5944cdccda264f6099ff238e8d9a4394 msgid "" "We actively seek pull requests which update packages already included in " "the project Dockerfiles. This is a great way for first-time contributors " @@ -347,11 +315,11 @@ msgid "" msgstr "" # 30d4a79bce8d439d97e6e3555a088548 -#: ../../contributing/packages.md:7 02227d4a33ee4123b69b77ecaeac6351 +#: ../../contributing/packages.md:7 a1c0d6c4dd0145089ffca2cdbf85e6a6 msgid "Please follow the process below to update a package version:" msgstr "" -#: ../../contributing/packages.md:9 0b4682ec16e94da696080ae481eaa2f5 +#: ../../contributing/packages.md:9 15c8f0c97b4b409e84f2e888b72bb6d1 msgid "" "Locate the Dockerfile containing the library you wish to update (e.g., " "[base-notebook/Dockerfile](https://github.com/jupyter/docker-" @@ -360,7 +328,7 @@ msgid "" "/scipy-notebook/Dockerfile))" msgstr "" -#: ../../contributing/packages.md:12 3a9657a3b79b4fab88923a47d927fc05 +#: ../../contributing/packages.md:12 318d69385be34faa8c0e5e7f80bc62d2 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 " @@ -369,18 +337,18 @@ msgid "" "`notebook=5.4.*`." msgstr "" -#: ../../contributing/packages.md:27 18c80dc2dd404b0f8940f765b8b9250a +#: ../../contributing/packages.md:27 70097590ee7c43c19b426f6810dbe7f3 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 "" -#: ../../contributing/packages.md:30 8c696a12531e4067bae28517fc098cfc -msgid "## Notes" +#: ../../contributing/packages.md:30 c99566f117c44896b4c4adf6c943553d +msgid "Notes" msgstr "" -#: ../../contributing/packages.md:32 cfc6daa181944c65bcb81095f301eb41 +#: ../../contributing/packages.md:32 1ca46d0c53bb4c3e8b1d771827d8ca1e msgid "" "In order to help identifying packages that can be updated you can use the" " following helper tool. It will list all the packages installed in the " @@ -388,24 +356,11 @@ msgid "" "only on requested packages." msgstr "" -#: ../../contributing/packages.md:36 b0f4389e20904775bd3eb7729db29c23 -msgid "```bash $ make check-outdated/base-notebook" +#: ../../contributing/recipes.md:1 8e4087c3bd1043c694d55ecb30a197b9 +msgid "New Recipes" msgstr "" -#: ../../contributing/packages.md:39 fc1a4ab5d3684ce189bbfbd8a7ee06b0 -msgid "" -"# INFO test_outdated:test_outdated.py:80 3/8 (38%) packages could be " -"updated # INFO test_outdated:test_outdated.py:82 # Package " -"Current Newest # ---------- --------- -------- # conda 4.7.12" -" 4.8.2 # jupyterlab 1.2.5 2.0.0 # python 3.7.4 3.8.2 " -"```" -msgstr "" - -#: ../../contributing/recipes.md:1 97c458bfaba84996b5a5d0a736774b01 -msgid "# New Recipes" -msgstr "" - -#: ../../contributing/recipes.md:3 42cd4f7ebd01407fb2dfb75d73e22513 +#: ../../contributing/recipes.md:3 6ac21d4f4a0748a39a47679b3c93fdfe msgid "" "We welcome contributions of [recipes](../using/recipes.md), short " "examples of using, configuring, or extending the Docker Stacks, for " @@ -413,25 +368,25 @@ msgid "" "new recipe:" msgstr "" -#: ../../contributing/recipes.md:5 d7f77e740e114dfe982d2a4b4c7a55db +#: ../../contributing/recipes.md:5 32e89b46652e4e6d8b986540a6931a66 msgid "Open the `docs/using/recipes.md` source file." msgstr "" -#: ../../contributing/recipes.md:6 60be28c7a1d24d66a76dbfdc33c05830 +#: ../../contributing/recipes.md:6 c6ce5c8237df475b892527fda947d4e6 msgid "" "Add a second-level Markdown heading naming your recipe at the bottom of " "the file (e.g., `## Add the RISE extension`)" msgstr "" # 8838b0ff2be24c23afaca9a6f43a9b66 -#: ../../contributing/recipes.md:7 397afecbecc6441b8df3b6f61034de44 +#: ../../contributing/recipes.md:7 e2c66e89aaa44314b2d8b813a4b69787 msgid "" "Write the body of your recipe under the heading, including whatever " "command line, Dockerfile, links, etc. you need." msgstr "" #: ../../contributing/recipes.md:8 ../../contributing/stacks.md:157 -#: 0fe0c06eb1a2498ebb068bbc4ad63bc5 e4d67a9c326543798a77fe8eab291f4f +#: 602a0163d0fd48178e0e49126a546fa4 81d788bfd4854de69de7c3e79e676f42 msgid "" "[Submit a pull request](https://github.com/PointCloudLibrary/pcl/wiki/A" "-step-by-step-guide-on-preparing-and-submitting-a-pull-request) (PR) with" @@ -439,11 +394,11 @@ msgid "" "formatting or content issues." msgstr "" -#: ../../contributing/stacks.md:1 57b2948a0a2247d1ba7a646eca1b29ac -msgid "# Community Stacks" +#: ../../contributing/stacks.md:1 4941de4a06014c429a9860d756537bc6 +msgid "Community Stacks" msgstr "" -#: ../../contributing/stacks.md:3 6aec755ff45d40fa9e424da90c54eb89 +#: ../../contributing/stacks.md:3 21391478655f4b5a976418827404f87c msgid "" "We love to see the community create and share new Jupyter Docker images. " "We've put together a [cookiecutter project](https://github.com/jupyter" @@ -452,190 +407,103 @@ msgid "" "Docker. Following these steps will:" msgstr "" -#: ../../contributing/stacks.md:8 564de04e6a274bc8a5054c82d1c518e2 +#: ../../contributing/stacks.md:8 af9d5614bd464474a2b1f3d4468cf6a6 msgid "" "Setup a project on GitHub containing a Dockerfile based on either the " "`jupyter/base-notebook` or `jupyter/minimal-notebook` image." msgstr "" -#: ../../contributing/stacks.md:10 cb1e6ef2ed194fec815aa173eee9055d +#: ../../contributing/stacks.md:10 98e16a00f8584d5f82af086cb1b3c61b msgid "" "Configure GitHub Actions to build and test your image when users submit " "pull requests to your repository." msgstr "" -#: ../../contributing/stacks.md:12 69204cc3f76e4e6ca4b83b3397f1aab3 +#: ../../contributing/stacks.md:12 29773e11790f4b058d155a1e893e0fd8 msgid "Configure Docker Hub to build and host your images for others to use." msgstr "" -#: ../../contributing/stacks.md:13 c23b944ea25e4d4bbbd66a98048058ef +#: ../../contributing/stacks.md:13 1c49fc05c2904e1999561b6a87693ac4 msgid "" "Update the [list of community stacks](../using/selecting.html#community-" "stacks) in this documentation to include your image." msgstr "" # 8e0fd1dc73cc40ceab19307d0cd809c1 -#: ../../contributing/stacks.md:15 db24f17060424e3ba93d30721b08aaee +#: ../../contributing/stacks.md:15 4aff78c9ce674191be2be82cb115f23c 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 "" -#: ../../contributing/stacks.md:18 d1d1b35a0b9e46799072beeb0cb8084f -msgid "## Creating a Project" +#: ../../contributing/stacks.md:18 d49ce48fa33041a49625d182d77d4110 +msgid "Creating a Project" msgstr "" -#: ../../contributing/stacks.md:20 2f01289a5144484c9b46621dad66dbce +#: ../../contributing/stacks.md:20 60f7cd95d2b34061a87f56b2e1a7ce93 msgid "" "First, install " "[cookiecutter](https://github.com/cookiecutter/cookiecutter) using pip or" " conda:" msgstr "" -#: ../../contributing/stacks.md:22 16e0e76fdcd94759a0a19038fd389ea0 -msgid "```bash pip install cookiecutter # or conda install cookiecutter ```" -msgstr "" - -#: ../../contributing/stacks.md:26 8bfed287a72c4e3ab89a24808638e938 +#: ../../contributing/stacks.md:26 c2846ae9955e4ca3ba1bc23166ddac43 msgid "" "Run the cookiecutter command pointing to the [jupyter/cookiecutter-" "docker-stacks](https://github.com/jupyter/cookiecutter-docker-stacks) " "project on GitHub." msgstr "" -#: ../../contributing/stacks.md:30 de21e7938c9241a7bfd22374aecb5bc9 -msgid "" -"```bash cookiecutter https://github.com/jupyter/cookiecutter-docker-" -"stacks.git ```" -msgstr "" - # 676ff068156d4ca7b1043b4a4fe2d1f1 -#: ../../contributing/stacks.md:34 b241ec294e694fedbf72caeff1cbe6b7 +#: ../../contributing/stacks.md:34 e09178dcd1374d3ebadbf797740ed51d 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 "" -#: ../../contributing/stacks.md:37 19d90a21f2154122b7c722701df735bf -msgid "```lang-none stack_name [my-jupyter-stack]: ```" -msgstr "" - -#: ../../contributing/stacks.md:41 ffea1af4ab704f39bb327d5b4a3ab4d3 +#: ../../contributing/stacks.md:41 181e0f8f6c79401f8e74c077c17a8ffa msgid "" "Enter the user or organization name under which this stack will reside on" " Docker Hub. You must have access to manage this Docker Hub organization " "to push images here and set up automated builds." msgstr "" -#: ../../contributing/stacks.md:45 a752a8027c5a4beda677a6ffe7d0cee6 -msgid "```lang-none stack_org [my-project]: ```" -msgstr "" - # b796c2d7c08b4a1db5cdfd3de7d84c16 -#: ../../contributing/stacks.md:49 3c37395c6f814207afd3502928a1822e +#: ../../contributing/stacks.md:49 19e9e75f7a664311b68b61dec887a0ba msgid "" "Select an image from the jupyter/docker-stacks project that will serve as" " the base for your new image." msgstr "" -#: ../../contributing/stacks.md:52 8d3beeab4f604f1c82f9e47d459d1333 -msgid "```lang-none stack_base_image [jupyter/base-notebook]: ```" -msgstr "" - # 7ef9d73286d04b12a1350e8d9565df65 -#: ../../contributing/stacks.md:56 9a83b11b16724176a6396ec8355e332e +#: ../../contributing/stacks.md:56 a16ea00d16be465cbe652ba1f2e74021 msgid "Enter a longer description of the stack for your README." msgstr "" -#: ../../contributing/stacks.md:58 eec23b92450643148bbbbb7e666bd122 -msgid "" -"```lang-none stack_description [my-jupyter-stack is a community " -"maintained Jupyter Docker Stack image]: ```" -msgstr "" - # 479d3a5c6ef9481a9dc4033224c540fa -#: ../../contributing/stacks.md:62 ebfc92dd08d84c54a25a2c41206f47fa +#: ../../contributing/stacks.md:62 2335872a432b459da5ba4e53de9a5f7e msgid "Initialize your project as a Git repository and push it to GitHub." msgstr "" -#: ../../contributing/stacks.md:64 8870637405c844f28457e1e55894c15b -msgid "```bash cd " +#: ../../contributing/stacks.md:74 b5ff42dde44241fa856ecb746038cdad +msgid "Configuring GitHub actions" msgstr "" -#: ../../contributing/stacks.md:67 f0721f5c455245f4a60bb8b1330fcdb4 -msgid "" -"git init git add . git commit -m 'Seed repo' git remote add origin git push -u origin master ```" -msgstr "" - -#: ../../contributing/stacks.md:74 9b82b4a50333429a9510b143c4c8b1e9 -msgid "## Configuring GitHub actions" -msgstr "" - -#: ../../contributing/stacks.md:76 d9601507a800428c98a43dc4698773e6 +#: ../../contributing/stacks.md:76 320b0955f0774e3e9475a7c9aeb5e540 msgid "" "The cookiecutter template comes with a `.github/workflows/docker.yml` " "file, which allows you to use GitHub actions to build your Docker image " "whenever you or someone else submits a pull request." msgstr "" -#: ../../contributing/stacks.md:78 af2dd09874004196a73d736865c22da7 +#: ../../contributing/stacks.md:78 e3d15e622e044bf4be9fdb39bc732ebc msgid "" "By default the `.github/workflows/docker.yaml` file has the following " "triggers configuration:" msgstr "" -#: ../../contributing/stacks.md:80 7d9c6ac81c754acdbe13a125c7eaa80e -msgid "```yaml on: pull_request:" -msgstr "" - -#: ../../contributing/stacks.md:86 ../../contributing/stacks.md:95 -#: 43c224598e2a4fa181d4068d99d8aab2 bd17d7b45ba846b19ff7f81f26e1042a -msgid "paths-ignore:" -msgstr "" - -#: ../../contributing/stacks.md:84 ../../contributing/stacks.md:93 -#: d910daa0a70e46d99ddd7da80e8d0d6b e92de994532640af8d6e0f30b10b56f1 -msgid "\"*.md\"" -msgstr "" - -#: ../../contributing/stacks.md:85 ../../contributing/stacks.md:94 -#: f960db3496b44510baacfa7dd6885e85 fa54d99febf246daaaea9d44cd340f30 -msgid "\"binder/**\"" -msgstr "" - -#: ../../contributing/stacks.md:86 ../../contributing/stacks.md:95 -#: 43671f7c67ab49c9bb171c8c1aa6e1b0 8a61c0ce2530418c83b78f06745bc2e8 -msgid "\"docs/**\"" -msgstr "" - -#: ../../contributing/stacks.md:87 ../../contributing/stacks.md:96 -#: bd7268a3192743208ba3465621eaa8ea fe6da302d0e74dde816ba8b444beb732 -msgid "\"examples/**\"" -msgstr "" - -#: ../../contributing/stacks.md:95 e1a95abb91e54053811e55936d7baeb7 -msgid "push:" -msgstr "" - -#: ../../contributing/stacks.md:90 3371d2ffd8874d7cab78661e22e864e4 -msgid "branches:" -msgstr "" - -#: ../../contributing/stacks.md:90 401cf636d95c455ca2a593a20e6ad5b5 -msgid "master" -msgstr "" - -#: ../../contributing/stacks.md:91 15327b1db5094d88ae7f8eebc09b80b8 -msgid "main" -msgstr "" - -#: ../../contributing/stacks.md:97 86701c92099240709a87e72de7d2148f -msgid "```" -msgstr "" - -#: ../../contributing/stacks.md:99 6cdf947f23ff45a99191ebff2b2dbccd +#: ../../contributing/stacks.md:99 4a319229a5134321b1e0ba33286d617f msgid "" "This will trigger the CI pipeline whenever you push to your `main` or " "`master` branch and when any Pull Requests are made to your repository. " @@ -644,53 +512,52 @@ msgid "" "/events-that-trigger-workflows)." msgstr "" -#: ../../contributing/stacks.md:100 98fdff03d71040efa8ea864fdfb87cc5 +#: ../../contributing/stacks.md:100 830f0448ce964083ad07947895332d48 msgid "Commit your changes and push to GitHub." msgstr "" -#: ../../contributing/stacks.md:101 ffadc2631c0d4f3688ebfbbfe9461888 +#: ../../contributing/stacks.md:101 3c9b32437704458d81355e9b64388ab9 msgid "" -"3. Head back to your repository and click on the **Actions** tab. " -"![GitHub actions tab screenshot](../_static/github-actions-tab.png) From " -"there, you can click on the workflows on the left-hand side of the " -"screen. 4. In the next screen, you will be able to see information about " -"the workflow run and duration. If you click again on the button with the " -"workflow name, you will see the logs for the workflow steps." +"Head back to your repository and click on the **Actions** tab. ![GitHub " +"actions tab screenshot](../_static/github-actions-tab.png) From there, " +"you can click on the workflows on the left-hand side of the screen." msgstr "" -#: ../../contributing/stacks.md:105 b21ba135f5354eabaf17622c84404a19 +#: ../../contributing/stacks.md:104 f85e5857f836454eaca555298994dee8 msgid "" -"![Github actions workflow run screenshot](../_static/github-actions-" -"workflow.png)" +"In the next screen, you will be able to see information about the " +"workflow run and duration. If you click again on the button with the " +"workflow name, you will see the logs for the workflow steps. ![Github " +"actions workflow run screenshot](../_static/github-actions-workflow.png)" msgstr "" -#: ../../contributing/stacks.md:107 112545c698ed467da0ae4bfc307f7531 -msgid "## Configuring Docker Hub" +#: ../../contributing/stacks.md:107 c4fad13103744cd0a7fbf030d18af359 +msgid "Configuring Docker Hub" msgstr "" -#: ../../contributing/stacks.md:109 7ed3f42095a94972972f9347abdba55e +#: ../../contributing/stacks.md:109 b8568d12cfde43c687ab5dfa48f6e828 msgid "" "Now, configure Docker Hub 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 "" -#: ../../contributing/stacks.md:112 9970a7aa1fe64d32b93b172c5dea8cc6 +#: ../../contributing/stacks.md:112 f8c1de632a244bcc86ba70f577c222ca msgid "Visit [https://hub.docker.com/](https://hub.docker.com/) and log in." msgstr "" -#: ../../contributing/stacks.md:113 7a3b4b8070fe457487c2d5b4f98c7909 +#: ../../contributing/stacks.md:113 0e36790b82fb476f92aa6561d9ed1442 msgid "" "Select the account or organization matching the one you entered when " "prompted with `stack_org` by the cookiecutter. ![Docker account selection" " screenshot](../_static/docker-org-select.png)" msgstr "" -#: ../../contributing/stacks.md:115 699b6e9da0ac4b99a90c25a7796cd3c3 +#: ../../contributing/stacks.md:115 ac5c0eec531f490eafc70f2c5292cb92 msgid "Scroll to the bottom of the page and click **Create repository**." msgstr "" -#: ../../contributing/stacks.md:116 e9d2c46cdac9421faeb7d3349b1b22d9 +#: ../../contributing/stacks.md:116 e03e172a53094fcfa8045df820305f06 msgid "" "Enter the name of the image matching the one you entered when prompted " "with `stack_name` by the cookiecutter. ![Docker image name and " @@ -698,106 +565,87 @@ msgid "" msgstr "" # 79092e5007ba4bdead594a71e30cd58a -#: ../../contributing/stacks.md:118 fab1247288da4e69967b6e1408191835 +#: ../../contributing/stacks.md:118 05fd367b7c104533b4fa8e9d14cb48e0 msgid "Enter a description for your image." msgstr "" -#: ../../contributing/stacks.md:119 7db3ee2f8f17417488fdf6fa4520837e +#: ../../contributing/stacks.md:119 8b213ba737be4b3188ef45f4f9875835 msgid "" "Click **GitHub** under the **Build Settings** and follow the prompts to " "connect your account if it is not already connected." msgstr "" -#: ../../contributing/stacks.md:120 1e359020209043a29d4e9558bf224a06 +#: ../../contributing/stacks.md:120 5528cad888f24ce48846bb0b295ac1ce msgid "" "Select the GitHub organization and repository containing your image " "definition from the dropdowns. ![Docker from GitHub automated build " "screenshot](../_static/docker-github-settings.png)" msgstr "" -#: ../../contributing/stacks.md:122 cc936a7fd57044ee9f1230690fc61b01 +#: ../../contributing/stacks.md:122 268aa4e56a1e4041ab164712867ab84f msgid "Click the **Create and Build** button." msgstr "" -#: ../../contributing/stacks.md:123 287aec7f89dd4fd1b61850e3946c2375 +#: ../../contributing/stacks.md:123 75ad9004e529460596bd18a7f9cb3c39 msgid "" "Click on your avatar on the top-right corner and select Account settings." " ![Docker account selection screenshot](../_static/docker-org-select.png)" msgstr "" -#: ../../contributing/stacks.md:125 2e532f96e3d449d5a0e2791d6522bcee -msgid "Click on **Security** and then click on the **New Access Token** button." -msgstr "" - -#: ../../contributing/stacks.md:126 3688044ac84443c096682a686bb6e77d +#: ../../contributing/stacks.md:125 f08e053e1a4a438da88075e9363e8b39 msgid "" +"Click on **Security** and then click on the **New Access Token** button. " "![Docker account Security settings screenshot](../_static/docker-org-" "security.png)" msgstr "" -#: ../../contributing/stacks.md:127 6b3d8586d90a4237ae41f010a1bb39a5 -msgid "Enter a meaningful name for your token and click on **Create**" -msgstr "" - -#: ../../contributing/stacks.md:128 a6a72f3527a4490ebdf4d143fbe6d999 +#: ../../contributing/stacks.md:127 2647f31f7dd5402abd68b20b2cbdeaa8 msgid "" -"![Docker account create new token screenshot](../_static/docker-org-" -"create-token.png)" +"Enter a meaningful name for your token and click on **Create** ![Docker " +"account create new token screenshot](../_static/docker-org-create-" +"token.png)" msgstr "" -#: ../../contributing/stacks.md:129 cbe052242bd94c5699d898ad53a9a331 +#: ../../contributing/stacks.md:129 6e86669c3502467fa0637cea511b5063 msgid "" "Copy the personal access token displayed on the next screen. **Note that " "you will not be able to see it again after you close the pop-up window**." msgstr "" -#: ../../contributing/stacks.md:130 a6a1ca89433f49f5bf4fc2fe3659def1 -msgid "Head back to your GitHub repository and click on the **Settings tab**." -msgstr "" - -#: ../../contributing/stacks.md:131 2280caac64874fe6b42af755e28755b6 +#: ../../contributing/stacks.md:130 603d1dc229c040709e2f23e14baadeb9 msgid "" +"Head back to your GitHub repository and click on the **Settings tab**. " "![Github repository settings tab screenshot](../_static/github-create-" "secrets.png)" msgstr "" -#: ../../contributing/stacks.md:132 7475a4afc1fd4238bcd4297cfae7e2d0 +#: ../../contributing/stacks.md:132 b040de37c6c048ea9cbef2d64c503f29 msgid "" "Click on the **Secrets** section and then on the **New repository " "secret** button on the top right corner (see image above)." msgstr "" -#: ../../contributing/stacks.md:133 92dc9fa63ee044769feb88b5708533bf +#: ../../contributing/stacks.md:133 5d8441ebca5a450eb62c331d3556f28d msgid "" "Create a **DOCKERHUB_TOKEN** secret and paste the Personal Access Token " -"from DockerHub in the **value** field." +"from DockerHub in the **value** field. ![GitHub create secret token " +"screenshot](../_static/github-secret-token.png)" msgstr "" -#: ../../contributing/stacks.md:134 97008cca593b4f91bf1c095cb7de7b85 -msgid "" -"![GitHub create secret token screenshot](../_static/github-secret-" -"token.png)" -msgstr "" - -#: ../../contributing/stacks.md:135 6f90c2887fbd4c03a826b0408f2c9807 +#: ../../contributing/stacks.md:135 35f72b5f4b4d4366b66bd09a43c8f03f msgid "" "Repeat the above step but creating a **DOCKERHUB_USERNAME** and replacing" " the *value* field with your DockerHub username. Once you have completed " "these steps, your repository secrets section should look something like " -"this:" -msgstr "" - -#: ../../contributing/stacks.md:136 330f0aae1bd24f5785f3447b782e039f -msgid "" -"![GitHub repository secrets created screenshot](../_static/github-" +"this: ![GitHub repository secrets created screenshot](../_static/github-" "secrets-completed.png)" msgstr "" -#: ../../contributing/stacks.md:138 8e0004301a264d888db1b70092016908 -msgid "## Defining Your Image" +#: ../../contributing/stacks.md:138 2cbc16f9e5fa4a3ca2f01019690a80ee +msgid "Defining Your Image" msgstr "" -#: ../../contributing/stacks.md:140 8d55a9e31a1a49338d7dc7fc99354b57 +#: ../../contributing/stacks.md:140 26f64c988e534522851cd2e1e526dfa6 msgid "" "Make edits to the Dockerfile in your project to add third-party libraries" " and configure Jupyter applications. Refer to the Dockerfiles for the " @@ -807,7 +655,7 @@ msgid "" "best practices." msgstr "" -#: ../../contributing/stacks.md:145 a59d95ca54d447799f47a19a7bfcbc22 +#: ../../contributing/stacks.md:145 fa08ad85e28e42d4bd4b32659835f4cf msgid "" "[Submit pull requests](https://github.com/PointCloudLibrary/pcl/wiki/A" "-step-by-step-guide-on-preparing-and-submitting-a-pull-request) to your " @@ -816,52 +664,52 @@ msgid "" "build your master or main branch that you can `docker pull`." msgstr "" -#: ../../contributing/stacks.md:149 0d53af16d41644a08b152050856e59fd -msgid "## Sharing Your Image" +#: ../../contributing/stacks.md:149 53a4c07717164c9f96496fd03be9ddbb +msgid "Sharing Your Image" msgstr "" # d8e9f1a37f4c4a72bb630e7a3b265b92 -#: ../../contributing/stacks.md:151 a7b1d42dae7d4f8e896d6f8436067b3c +#: ../../contributing/stacks.md:151 b7ffed0090d84b1994edddb4945162fc msgid "" "Finally, if you'd like to add a link to your project to this " "documentation site, please do the following:" msgstr "" -#: ../../contributing/stacks.md:154 56a127d78c3149c79836cd8d62621288 +#: ../../contributing/stacks.md:154 435b6fc8c0cc4971b3036a212500deab msgid "" "Clone the [jupyter/docker-stacks](https://github.com/jupyter/docker-" "stacks) GitHub repository." msgstr "" -#: ../../contributing/stacks.md:155 7118ff343eb0427c88b8aee7ad43a743 +#: ../../contributing/stacks.md:155 b2afd419163f49d38b423c3a786bc4e9 msgid "" "Open the `docs/using/selecting.md` source file and locate the **Community" " Stacks** section." msgstr "" # 9d37dfec6fba48e6966c254b476e1e81 -#: ../../contributing/stacks.md:156 b0707bf19f714048aa2e1168db831318 +#: ../../contributing/stacks.md:156 6a24f117eb504b07bfc147f604b3050d msgid "" "Add a bullet with a link to your project and a short description of what " "your Docker image contains." msgstr "" -#: ../../contributing/tests.md:1 09ab764825804e1baa3a6ed5b344f84c -msgid "# Image Tests" +#: ../../contributing/tests.md:1 e957d37201b948b78775d91cf5a34641 +msgid "Image Tests" msgstr "" # 6dbd44985f3c4ba1a3823c90c5944ad0 -#: ../../contributing/tests.md:3 865369ea173746e9b37f60b27f859098 +#: ../../contributing/tests.md:3 86ee3313d30a4aaba5eac9e4d45f3bc8 msgid "" "We greatly appreciate pull requests that extend the automated tests that " "vet the basic functionality of the Docker images." msgstr "" -#: ../../contributing/tests.md:6 c254504494c346e8bf2dafdcc9c36486 -msgid "## How the Tests Work" +#: ../../contributing/tests.md:6 5617303c7d2e4e67a0978d2d74aeef14 +msgid "How the Tests Work" msgstr "" -#: ../../contributing/tests.md:8 57574d934ec6403fb00dd4605ee4d72f +#: ../../contributing/tests.md:8 f03b6a46ac304439a20fa2e76dc82da4 msgid "" "GitHub executes `make build-test-all` against pull requests submitted to " "the `jupyter/docker-stacks` repository. This `make` command builds every " @@ -876,49 +724,45 @@ msgid "" "stacks/blob/master/conftest.py) file at the root of the projects." msgstr "" -#: ../../contributing/tests.md:17 5526ac09e1784a85b98427875d32a22d -msgid "## Contributing New Tests" +#: ../../contributing/tests.md:17 4b47717544b643b3937f6af5256598d4 +msgid "Contributing New Tests" msgstr "" # d317e6be0fbf487e8528ff1fe0bbdb78 -#: ../../contributing/tests.md:19 ac048502535a47159e07194bf1d53b60 +#: ../../contributing/tests.md:19 56efffd2c0494a9c8455d2874bb3d2ed msgid "Please follow the process below to add new tests:" msgstr "" -#: ../../contributing/tests.md:21 a5dd99ebc44a4c40b74730a1634a2d94 +#: ../../contributing/tests.md:21 82bb6084876842c8b3d997c667b7d764 msgid "" "If the test should run against every image built, add your test code to " "one of the modules in [test/](https://github.com/jupyter/docker-" "stacks/tree/master/test) or create a new module." msgstr "" -#: ../../contributing/tests.md:23 cc9e0301ad014a9393151edd99c86e18 +#: ../../contributing/tests.md:23 2a00f8997cdc4b0282c8bb32184491ab 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 "" -#: ../../contributing/tests.md:25 c55027169e2240b8b5022426edc35529 +#: ../../contributing/tests.md:25 9c184f62474745e2ba59d9e15a03a790 msgid "" "Build one or more images you intend to test and run the tests locally. If" " you use `make`, call:" msgstr "" -#: ../../contributing/tests.md:27 98791fc246124b9a839890f41a7c249b -msgid "```bash make build/somestack-notebook make test/somestack-notebook ```" -msgstr "" - -#: ../../contributing/tests.md:35 3477187207c743ee85720756731aecd2 +#: ../../contributing/tests.md:35 e2d8f399800a43bb85f39dd2c6abedc3 msgid "" "Discuss changes with the maintainers and address any issues running the " "tests on GitHub." msgstr "" -#: ../../contributing/translations.md:1 a2360ac22cd0474282e991e407f72542 -msgid "# Doc Translations" +#: ../../contributing/translations.md:1 ac2865f186534840b39226e6edbd629f +msgid "Doc Translations" msgstr "" -#: ../../contributing/translations.md:3 89ef33973d924df78f80bd23199d01ec +#: ../../contributing/translations.md:3 d4fd970c40c843ba8abf4ef3387b9bcc msgid "" "We are delighted when members of the Jupyter community want to help " "translate these documentation pages to other languages. If you're " @@ -927,14 +771,14 @@ msgid "" "updating translations of the Jupyter Docker Stacks documentation." msgstr "" -#: ../../contributing/translations.md:5 73f50f9ced7a481c9de6d6470268d2da +#: ../../contributing/translations.md:5 e1a5b6e65e3f4a0389e1dbdcda94b8fa msgid "" "Follow the steps documented on the [Getting Started as a " "Translator](https://docs.transifex.com/getting-started-1/translators) " "page." msgstr "" -#: ../../contributing/translations.md:6 974799bcf94347a7b22ffc229ee81ae7 +#: ../../contributing/translations.md:6 43cfd9291e81451c92daaa7b38667f70 msgid "" "Look for *jupyter-docker-stacks* when prompted to choose a translation " "team. Alternatively, visit It is also possible to ignore" +#~ " rules by using a special comment " +#~ "directly above the Dockerfile instruction " +#~ "you want to make an exception for." +#~ " Ignore rule comments look like `#" +#~ " hadolint ignore=DL3001,SC1081`. For example:" +#~ msgstr "" + +#~ msgid "```dockerfile FROM ubuntu" +#~ msgstr "" + +#~ msgid "# hadolint ignore=DL3003,SC1035 RUN cd /tmp && echo \"hello!\" ```" +#~ msgstr "" + +#~ msgid "" +#~ "[hadolint]: https://github.com/hadolint/hadolint [dbp]:" +#~ " https://docs.docker.com/develop/develop-images" +#~ "/dockerfile_best-practices [rules]: " +#~ "https://github.com/hadolint/hadolint#rules [DL3006]: " +#~ "https://github.com/hadolint/hadolint/wiki/DL3006 [DL3008]: " +#~ "https://github.com/hadolint/hadolint/wiki/DL3008 [pre-" +#~ "commit]: https://pre-commit.com/" +#~ msgstr "" + +#~ msgid "# Package Updates" +#~ msgstr "" + +#~ msgid "## Notes" +#~ msgstr "" + +#~ msgid "```bash $ make check-outdated/base-notebook" +#~ msgstr "" + +#~ msgid "" +#~ "# INFO test_outdated:test_outdated.py:80 3/8 " +#~ "(38%) packages could be updated # " +#~ "INFO test_outdated:test_outdated.py:82 # Package" +#~ " Current Newest # ---------- " +#~ "--------- -------- # conda 4.7.12" +#~ " 4.8.2 # jupyterlab 1.2.5 2.0.0" +#~ " # python 3.7.4 3.8.2 ```" +#~ msgstr "" + +#~ msgid "# New Recipes" +#~ msgstr "" + +#~ msgid "# Community Stacks" +#~ msgstr "" + +#~ msgid "## Creating a Project" +#~ msgstr "" + +#~ msgid "```bash pip install cookiecutter # or conda install cookiecutter ```" +#~ msgstr "" + +#~ msgid "" +#~ "```bash cookiecutter https://github.com/jupyter" +#~ "/cookiecutter-docker-stacks.git ```" +#~ msgstr "" + +#~ msgid "```lang-none stack_name [my-jupyter-stack]: ```" +#~ msgstr "" + +#~ msgid "```lang-none stack_org [my-project]: ```" +#~ msgstr "" + +#~ msgid "```lang-none stack_base_image [jupyter/base-notebook]: ```" +#~ msgstr "" + +#~ msgid "" +#~ "```lang-none stack_description [my-jupyter-" +#~ "stack is a community maintained Jupyter" +#~ " Docker Stack image]: ```" +#~ msgstr "" + +#~ msgid "```bash cd " +#~ msgstr "" + +#~ msgid "" +#~ "git init git add . git commit " +#~ "-m 'Seed repo' git remote add " +#~ "origin git push " +#~ "-u origin master ```" +#~ msgstr "" + +#~ msgid "## Configuring GitHub actions" +#~ msgstr "" + +#~ msgid "```yaml on: pull_request:" +#~ msgstr "" + +#~ msgid "paths-ignore:" +#~ msgstr "" + +#~ msgid "\"*.md\"" +#~ msgstr "" + +#~ msgid "\"binder/**\"" +#~ msgstr "" + +#~ msgid "\"docs/**\"" +#~ msgstr "" + +#~ msgid "\"examples/**\"" +#~ msgstr "" + +#~ msgid "push:" +#~ msgstr "" + +#~ msgid "branches:" +#~ msgstr "" + +#~ msgid "master" +#~ msgstr "" + +#~ msgid "main" +#~ msgstr "" + +#~ msgid "```" +#~ msgstr "" + +#~ msgid "" +#~ "3. Head back to your repository " +#~ "and click on the **Actions** tab. " +#~ "![GitHub actions tab screenshot](../_static" +#~ "/github-actions-tab.png) From there, you" +#~ " can click on the workflows on " +#~ "the left-hand side of the screen." +#~ " 4. In the next screen, you " +#~ "will be able to see information " +#~ "about the workflow run and duration. " +#~ "If you click again on the button" +#~ " with the workflow name, you will " +#~ "see the logs for the workflow " +#~ "steps." +#~ msgstr "" + +#~ msgid "" +#~ "![Github actions workflow run " +#~ "screenshot](../_static/github-actions-workflow.png)" +#~ msgstr "" + +#~ msgid "## Configuring Docker Hub" +#~ msgstr "" + +#~ msgid "" +#~ "Click on **Security** and then click " +#~ "on the **New Access Token** button." +#~ msgstr "" + +#~ msgid "" +#~ "![Docker account Security settings " +#~ "screenshot](../_static/docker-org-security.png)" +#~ msgstr "" + +#~ msgid "Enter a meaningful name for your token and click on **Create**" +#~ msgstr "" + +#~ msgid "" +#~ "![Docker account create new token " +#~ "screenshot](../_static/docker-org-create-token.png)" +#~ msgstr "" + +#~ msgid "Head back to your GitHub repository and click on the **Settings tab**." +#~ msgstr "" + +#~ msgid "" +#~ "![Github repository settings tab " +#~ "screenshot](../_static/github-create-secrets.png)" +#~ msgstr "" + +#~ msgid "" +#~ "Create a **DOCKERHUB_TOKEN** secret and " +#~ "paste the Personal Access Token from " +#~ "DockerHub in the **value** field." +#~ msgstr "" + +#~ msgid "" +#~ "![GitHub create secret token " +#~ "screenshot](../_static/github-secret-token.png)" +#~ msgstr "" + +#~ msgid "" +#~ "Repeat the above step but creating " +#~ "a **DOCKERHUB_USERNAME** and replacing the " +#~ "*value* field with your DockerHub " +#~ "username. Once you have completed these" +#~ " steps, your repository secrets section " +#~ "should look something like this:" +#~ msgstr "" + +#~ msgid "" +#~ "![GitHub repository secrets created " +#~ "screenshot](../_static/github-secrets-completed.png)" +#~ msgstr "" + +#~ msgid "## Defining Your Image" +#~ msgstr "" + +#~ msgid "## Sharing Your Image" +#~ msgstr "" + +#~ msgid "# Image Tests" +#~ msgstr "" + +#~ msgid "## How the Tests Work" +#~ msgstr "" + +#~ msgid "## Contributing New Tests" +#~ msgstr "" + +#~ msgid "# Doc Translations" +#~ msgstr "" + diff --git a/docs/locale/en/LC_MESSAGES/maintaining.po b/docs/locale/en/LC_MESSAGES/maintaining.po index 621674e0..751366cd 100644 --- a/docs/locale/en/LC_MESSAGES/maintaining.po +++ b/docs/locale/en/LC_MESSAGES/maintaining.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: docker-stacks latest\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-05-19 01:43+0000\n" +"POT-Creation-Date: 2021-05-19 02:28+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -18,30 +18,30 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" -#: ../../maintaining/tasks.md:1 9f4a635faa5a421da3f17f26b105a2ab -msgid "# Maintainer Playbook" +#: ../../maintaining/tasks.md:1 3c2bc067ce4c46feb55f6b2488e93b98 +msgid "Maintainer Playbook" msgstr "" -#: ../../maintaining/tasks.md:3 11baee7c549c44d493bf95d53f046092 -msgid "## Merging Pull Requests" +#: ../../maintaining/tasks.md:3 85f7f8ddb3374f2d96a4d4a6d21c2c44 +msgid "Merging Pull Requests" msgstr "" -#: ../../maintaining/tasks.md:5 966311aafc01470e93bf1e0203f30e05 +#: ../../maintaining/tasks.md:5 f81ee280bb844ec29f31cde6584cf111 msgid "" "To build new images and publish them to the Docker Hub registry, do the " "following:" msgstr "" -#: ../../maintaining/tasks.md:7 c0efdc3ba3fd4c22bdf5d8ce15c2bf17 +#: ../../maintaining/tasks.md:7 a8a6852ea62d4583b5908f244cca5c8f msgid "Make sure GitHub Actions status checks pass for the PR." msgstr "" # db74ca47dfde4e558a20aff52176347a -#: ../../maintaining/tasks.md:8 0d7997e8fe5e437c8c3ab93e4385c3e5 +#: ../../maintaining/tasks.md:8 f70dd29cc1b0441f84267cc7728fc29d msgid "Merge the PR." msgstr "" -#: ../../maintaining/tasks.md:9 fceaeed0350f46258c75fd869eeef6e3 +#: ../../maintaining/tasks.md:9 a1a0150c58b744e9b7994ce868b6a028 msgid "" "Monitor the merge commit GitHub Actions status. **Note**: we think, " "GitHub Actions are quite reliable, so please, investigate, if some error " @@ -49,18 +49,18 @@ msgid "" "after merging to master, except there is an additional `push` step." msgstr "" -#: ../../maintaining/tasks.md:12 0e8d4f56e2454d85987441fd047c9cb7 +#: ../../maintaining/tasks.md:12 dd5996da32154cc7a0bc5e4971499bbb msgid "" "Try to avoid merging another PR to master until all pending builds " "complete. This way you will know which commit might have broken the build" " and also have correct tags for moving tags (like `python` version)." msgstr "" -#: ../../maintaining/tasks.md:15 5afaa8ab9daa4387a96ad5e5b2e24127 -msgid "## Updating the Ubuntu Base Image" +#: ../../maintaining/tasks.md:15 8dfa51663a1f45dd9febf4abfe69a6d8 +msgid "Updating the Ubuntu Base Image" msgstr "" -#: ../../maintaining/tasks.md:17 4310de5d580f46a881e1fa43a410cf7b +#: ../../maintaining/tasks.md:17 1545a1fa966549d68c921700bdd82a4f 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-" @@ -70,18 +70,18 @@ msgid "" "layer will rebuild." msgstr "" -#: ../../maintaining/tasks.md:23 601f8fabb0ca44c0a39f44318876c26e -msgid "## Adding a New Core Image to Docker Hub" +#: ../../maintaining/tasks.md:23 a4a5333072844a9fad65c90c7d613e5c +msgid "Adding a New Core Image to Docker Hub" msgstr "" # 201f0506bbb24b47b79a5db01db86557 -#: ../../maintaining/tasks.md:25 491cfa3bd124441db6eb3d49c213150b +#: ../../maintaining/tasks.md:25 6cfbce865d4d49b794f40e383f76504f msgid "" "When there's a new stack definition, do the following before merging the " "PR with the new stack:" msgstr "" -#: ../../maintaining/tasks.md:27 7603ec5cad0a4880b803fcc72886fc60 +#: ../../maintaining/tasks.md:27 d06865dd99804aada0b00e6da95acbea msgid "" "Ensure the PR includes an update to the stack overview diagram [in the " "documentation](https://github.com/jupyter/docker-" @@ -90,156 +90,156 @@ msgid "" "used to create it." msgstr "" -#: ../../maintaining/tasks.md:30 d726d8019bd642e8a5a230995ada8a95 +#: ../../maintaining/tasks.md:30 904b140ad9344a08933591a3a37b6b56 msgid "" "Ensure the PR updates the [Makefile](../../Makefile) which is used to " "build the stacks in order on GitHub Actions." msgstr "" -#: ../../maintaining/tasks.md:31 aa6f699dcd234d35be2285d9dddf2c80 +#: ../../maintaining/tasks.md:31 6ef0fed5623b429f90d763250b9a1ea6 msgid "" "Ensure necessary tags / manifests are added for the new image in the " "[tagging](../../tagging) folder." msgstr "" -#: ../../maintaining/tasks.md:32 74c03ce510f445409b00f65c820c43c2 +#: ../../maintaining/tasks.md:32 4e89927e5e304ceab8e8d2e5e5715e95 msgid "" "Create a new repository in the `jupyter` org on Docker Hub named after " "the stack folder in the git repo." msgstr "" -#: ../../maintaining/tasks.md:34 521acd0743be4007ada3e5fcdd28cb64 +#: ../../maintaining/tasks.md:34 fe25a79462f9451c9bb897284706119d msgid "Grant the `stacks` team permission to write to the repo." msgstr "" -#: ../../maintaining/tasks.md:36 1e08b0aea277438f9761ffa606df4199 -msgid "## Adding a New Maintainer Account" +#: ../../maintaining/tasks.md:36 ecd9f97984ff4cfabd379d19420306c6 +msgid "Adding a New Maintainer Account" msgstr "" -#: ../../maintaining/tasks.md:38 9bf88f1254a14462913478a1f13d6075 +#: ../../maintaining/tasks.md:38 35bb176407294ee480231d97c84096d7 msgid "Visit " msgstr "" -#: ../../maintaining/tasks.md:39 0d8de4c415544b6e8d4398dc9e0d2d7a +#: ../../maintaining/tasks.md:39 6d54d171c2094aafbeb8dd9f9dcd385f msgid "Add the maintainer's Docker Hub username." msgstr "" -#: ../../maintaining/tasks.md:40 eaa956c5e6df4afb95649e38658bede7 +#: ../../maintaining/tasks.md:40 e6bad256bb9640c387dd2a485c1f18e5 msgid "" "Visit " msgstr "" # e26ad8ffb6de489988e076e64b6a1415 -#: ../../maintaining/tasks.md:41 cba355cb8bd44dd7884b775d6ed7ff7f +#: ../../maintaining/tasks.md:41 82b5d1662c8a4ba5b459fa11cf3e273e msgid "Add the maintainer's GitHub username." msgstr "" -#: ../../maintaining/tasks.md:43 aabff0ce395c4af1ae73586f70d4e276 -msgid "## Pushing a Build Manually" +#: ../../maintaining/tasks.md:43 535518f7a6d84a9bb1e809c05a45e65f +msgid "Pushing a Build Manually" msgstr "" -#: ../../maintaining/tasks.md:45 e5789bbb49c34ce38b5b7cbf249ada0d +#: ../../maintaining/tasks.md:45 efd25c198e2b4f3e9f1d212357486aac msgid "" "If automated build in Github Actions has got you down, do the following " "to push a build manually:" msgstr "" # ead6a3a714ae4a8a9df5585c18260c16 -#: ../../maintaining/tasks.md:47 a00db3e404ef466eb6655f81eacc07a6 +#: ../../maintaining/tasks.md:47 f08ebfb8719c4e1cb41b43eb3692f4f8 msgid "Clone this repository." msgstr "" # 48e1d6954f414fe080d7b4afd9e0c391 -#: ../../maintaining/tasks.md:48 c724f3af386d4845a915513a62f33bb9 +#: ../../maintaining/tasks.md:48 7510082540e14c22a06a3c7cf530c3e6 msgid "Check out the git SHA you want to build and publish." msgstr "" -#: ../../maintaining/tasks.md:49 56e684207cb1499c993f3664df2eb0b3 +#: ../../maintaining/tasks.md:49 88a43beb874d44ad8229a20a62856b1e msgid "`docker login` with your Docker Hub credentials." msgstr "" -#: ../../maintaining/tasks.md:50 442763d3489641a29b4825f62ff75fa9 +#: ../../maintaining/tasks.md:50 5c5343cdf1d34757844873f3f9240854 msgid "Run `make push-all`." msgstr "" -#: ../../maintaining/tasks.md:52 d8873a226b04491c9be010f51330b6ac -msgid "## Enabling a New Doc Language Translation" +#: ../../maintaining/tasks.md:52 fcfadfc4096a42d595079aa658effdd1 +msgid "Enabling a New Doc Language Translation" msgstr "" # 5aafef10dc75417785a79aba203175e5 -#: ../../maintaining/tasks.md:54 599953a51bcf4617903acf724c0ee3c9 +#: ../../maintaining/tasks.md:54 0aec4b87ea88447996f13ae8a99cd7ec msgid "First enable translation on Transifex:" msgstr "" -#: ../../maintaining/tasks.md:56 e2b8976a82074d93a3b44a1f8eaf1f73 +#: ../../maintaining/tasks.md:56 a46016568f4643ee8ac10ba569e4789c msgid "" "Visit ." msgstr "" -#: ../../maintaining/tasks.md:57 e7387d258e3148dbb6ab98c7301f8474 +#: ../../maintaining/tasks.md:57 fe9ea2e3276b40c0a0f78d43c4e122cf msgid "Click _Edit Languages_ in the top right." msgstr "" # 7efe7d98a98b47bd82d697673d277cbd -#: ../../maintaining/tasks.md:58 592b20b5bb7c4423b7f0e1889081d17f +#: ../../maintaining/tasks.md:58 7c70ee307608446485a73808818d9ea2 msgid "Select the language from the dropdown." msgstr "" -#: ../../maintaining/tasks.md:59 e05833dc3c734c67b384e1e4b592b539 +#: ../../maintaining/tasks.md:59 8a0d785364f2442d99a94f6ad2e0ce7e msgid "Click _Apply_." msgstr "" # 1e3868ee7dae469f9921516dd7973766 -#: ../../maintaining/tasks.md:61 ad93e3f64589459a90d68bd64c6ab16d +#: ../../maintaining/tasks.md:61 55cc884e765b415fa559620689867ac9 msgid "Then setup a subproject on ReadTheDocs for the language:" msgstr "" -#: ../../maintaining/tasks.md:63 331a2093d0f54705b3a0396a833fe4b2 +#: ../../maintaining/tasks.md:63 2044355939cb4b20b4478dfe4d4b03cb msgid "Visit ." msgstr "" -#: ../../maintaining/tasks.md:64 ef20fa43d1ba4faf9501ca1b00a5460e +#: ../../maintaining/tasks.md:64 ae192b230fac4eca92d82fd6e61a84a3 msgid "Enter _jupyter-docker-stacks-language_abbreviation_ for the project name." msgstr "" -#: ../../maintaining/tasks.md:65 39bff34df0f94864b6929eafac9c998e +#: ../../maintaining/tasks.md:65 56e197ddf5454fd08e18014b68f073c8 msgid "Enter for the URL." msgstr "" -#: ../../maintaining/tasks.md:66 9ed12c160f0d4c6199d7ccbe46e7b535 +#: ../../maintaining/tasks.md:66 e5a370d0287b4125a79666c5d86285c9 msgid "Check _Edit advanced project options_." msgstr "" -#: ../../maintaining/tasks.md:67 0a6d4e212f984c8980d4a79e4f035bba +#: ../../maintaining/tasks.md:67 3877f9c962ca42688456e3e32af86c1b msgid "Click _Next_." msgstr "" -#: ../../maintaining/tasks.md:68 376bc8c55db0407abefd0b413eeee2d9 +#: ../../maintaining/tasks.md:68 d364680e0c614182be0afc18500e2b2c msgid "Select the _Language_ from the dropdown on the next screen." msgstr "" -#: ../../maintaining/tasks.md:69 92db2d8a739842348530dee57f2bbef4 +#: ../../maintaining/tasks.md:69 1b339f7007504d948dc5dd079e3c5011 msgid "Click _Finish_." msgstr "" # 529f3729d2474287adec0ff895100248 -#: ../../maintaining/tasks.md:71 e7f1e246e11a4479a086d1705362a33c +#: ../../maintaining/tasks.md:71 99276f9332874287b054e3e4c584ce13 msgid "Finally link the new language subproject to the top level doc project:" msgstr "" -#: ../../maintaining/tasks.md:73 f4532881ea4b4ed0a4d945996cd73da7 +#: ../../maintaining/tasks.md:73 01ad70de042b4f29b65cffde26f83650 msgid "" "Visit ." msgstr "" -#: ../../maintaining/tasks.md:74 da6d02d051f6425eb391e9e47f29e5dd +#: ../../maintaining/tasks.md:74 dc634f693ac84fc398e2ecaef76b3351 msgid "Select the subproject you created from the _Project_ dropdown." msgstr "" -#: ../../maintaining/tasks.md:75 4e3b736bc9c14a2bb7b06ffd98642c99 +#: ../../maintaining/tasks.md:75 799ef3d780b644b3a18476b81e7de1dd msgid "Click _Add_." msgstr "" @@ -733,3 +733,24 @@ msgstr "" #~ msgid "Run `make retry/release-all`." #~ msgstr "" +#~ msgid "# Maintainer Playbook" +#~ msgstr "" + +#~ msgid "## Merging Pull Requests" +#~ msgstr "" + +#~ msgid "## Updating the Ubuntu Base Image" +#~ msgstr "" + +#~ msgid "## Adding a New Core Image to Docker Hub" +#~ msgstr "" + +#~ msgid "## Adding a New Maintainer Account" +#~ msgstr "" + +#~ msgid "## Pushing a Build Manually" +#~ msgstr "" + +#~ msgid "## Enabling a New Doc Language Translation" +#~ msgstr "" + diff --git a/docs/locale/en/LC_MESSAGES/using.po b/docs/locale/en/LC_MESSAGES/using.po index 12291e4a..185b6f9f 100644 --- a/docs/locale/en/LC_MESSAGES/using.po +++ b/docs/locale/en/LC_MESSAGES/using.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: docker-stacks latest\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-05-19 01:46+0000\n" +"POT-Creation-Date: 2021-05-19 02:28+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -18,11 +18,11 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" -#: ../../using/common.md:1 83969196fd704352a79ec0fba3777b8e -msgid "# Common Features" +#: ../../using/common.md:1 aba34749603d4a69836c4bfd0e5a345f +msgid "Common Features" msgstr "" -#: ../../using/common.md:3 5077950e813640408a4d3766e75df379 +#: ../../using/common.md:3 fdd8e74983ef498ca9be7e57a4f6ed80 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-" @@ -32,17 +32,17 @@ msgid "" msgstr "" # 298bc09d3aab4abcb413ad481d6242ff -#: ../../using/common.md:5 7e2fcb90b3034d58932b1fc2d1113068 +#: ../../using/common.md:5 454f68cdeadf441ab49a7f5d087ec460 msgid "" "This page describes the options supported by the startup script as well " "as how to bypass it to run alternative commands." msgstr "" -#: ../../using/common.md:7 35955b5da0594b9e9636e6a8308584f9 -msgid "## Notebook Options" +#: ../../using/common.md:7 7a9e1f4630404b3593ed0437a373e710 +msgid "Notebook Options" msgstr "" -#: ../../using/common.md:9 98d039866a094e7a816bddb9d4266a96 +#: ../../using/common.md:9 d46e849132744400a6728f309808b767 msgid "" "You can pass [Jupyter command line options](https://jupyter-" "notebook.readthedocs.io/en/stable/config.html#options) to the `start-" @@ -52,39 +52,25 @@ msgid "" "following:" msgstr "" -#: ../../using/common.md:11 1c9ec50097744e97a6d0921a150560c4 -msgid "" -"```bash docker run -d -p 8888:8888 jupyter/base-notebook start-" -"notebook.sh " -"--NotebookApp.password='sha1:74ba40f8a388:c913541b7ee99d15d5ed31d4226bf7838f83a50e'" -" ```" -msgstr "" - # 4c08f057def247cbbfc8231e628cb792 -#: ../../using/common.md:15 ee4e24cd25f044e3a0516f11805085ce +#: ../../using/common.md:15 8ccc7e2ac3a0481793aabd96d5162d84 msgid "" "For example, to set the base URL of the notebook server, you can run the " "following:" msgstr "" -#: ../../using/common.md:17 c7463285290c40d3827ee290d44532f0 -msgid "" -"```bash docker run -d -p 8888:8888 jupyter/base-notebook start-" -"notebook.sh --NotebookApp.base_url=/some/path ```" +#: ../../using/common.md:21 728689cb19ac4ea8a9360ada19a90596 +msgid "Docker Options" msgstr "" -#: ../../using/common.md:21 e3f31079d2fe4721bded18098153cc3b -msgid "## Docker Options" -msgstr "" - -#: ../../using/common.md:23 e01ccf2a9d4f4925952c0637fc047c46 +#: ../../using/common.md:23 115aa1bc58284e239659b8a0c6977264 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 "" -#: ../../using/common.md:26 dc0f442738114e1889b0a457dc2cf6fc +#: ../../using/common.md:26 49c870d875f646f591e3608e2d22c2ad msgid "" "`-e NB_USER=jovyan` - Instructs the startup script to change the default " "container username from `jovyan` to the provided value. Causes the script" @@ -95,7 +81,7 @@ msgid "" "volumes with specific home folder." msgstr "" -#: ../../using/common.md:27 374fb3ceb3614b57b7439b42cc7ff4b8 +#: ../../using/common.md:27 988f87583dd64dd0bfba6226510513af 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 " @@ -106,7 +92,7 @@ msgid "" "See the last bullet below for details." msgstr "" -#: ../../using/common.md:28 cc99e6ed62554b8aba4ec90e3c0009bd +#: ../../using/common.md:28 bd8b45977f2144edbc67fa16f0a8d722 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 " @@ -122,14 +108,14 @@ msgid "" " if you want them to be able to modify files in the image." msgstr "" -#: ../../using/common.md:29 107aa5f42d5b48c18b72f9cc6d337d7a +#: ../../using/common.md:29 2de3f7518ebb495e9fe403cc8c70d4cd msgid "" "`-e NB_GROUP=` - 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 "" -#: ../../using/common.md:30 c034464869fe49338fb79a815d2d7ae9 +#: ../../using/common.md:30 2af6dd4812f84f078490b6b9ef0fba92 msgid "" "`-e NB_UMASK=` - Configures Jupyter to use a different umask value" " from default, i.e. `022`. For example, if setting umask to `002`, new " @@ -143,7 +129,7 @@ msgid "" "you need to set a umask for these you must set `umask` for each command." msgstr "" -#: ../../using/common.md:31 ba4ce91775374dfa8e1ae8c889ba600e +#: ../../using/common.md:31 00ffc437a41f4b50a6ec13217bc0f086 msgid "" "`-e CHOWN_HOME=yes` - Instructs the startup script to change the " "`$NB_USER` home directory owner and group to the current value of " @@ -154,7 +140,7 @@ msgid "" "CHOWN_HOME_OPTS='-R'`)." msgstr "" -#: ../../using/common.md:32 94d4734e607943fab2425309c09c95f9 +#: ../../using/common.md:32 f01d7e7cbcba49159a2b74e041087865 msgid "" "`-e CHOWN_EXTRA=\",\"` - Instructs the startup " "script to change the owner and group of each comma-separated container " @@ -164,7 +150,7 @@ msgid "" "CHOWN_EXTRA_OPTS='-R'`)." msgstr "" -#: ../../using/common.md:33 df4088f16f6940d9b40d6f0f18a889bb +#: ../../using/common.md:33 4c25dbe869d04cfc86468fb64c5ca9b7 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 " @@ -177,14 +163,14 @@ msgid "" "you trust the user or if the container is running on an isolated host.**" msgstr "" -#: ../../using/common.md:34 5cb19ba95a5142a281332a501fba5037 +#: ../../using/common.md:34 06c0c160d0e54a78b39a910247fdd8e5 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 "" -#: ../../using/common.md:35 f8ee55029127471c8ede242b817705c4 +#: ../../using/common.md:35 8409171d7340438a91370a0e6b0cba30 msgid "" "`-e JUPYTER_ENABLE_LAB=yes` - Instructs the startup script to run " "`jupyter lab` instead of the default `jupyter notebook` command. Useful " @@ -192,14 +178,14 @@ msgid "" "variables is easier than change command line parameters." msgstr "" -#: ../../using/common.md:36 646dffe9a5e045f5850393501b4ac993 +#: ../../using/common.md:36 c3455a53356446f8af9ce2890aac1980 msgid "" "`-e RESTARTABLE=yes` - Runs Jupyter in a loop so that quitting Jupyter " "does not cause the container to exit. This may be useful when you need " "to install extensions that require restarting Jupyter." msgstr "" -#: ../../using/common.md:37 4aeb991746844b71bea335ecee736b6e +#: ../../using/common.md:37 5e0b2d4f55844f81b452c5eb4477cbc7 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 " @@ -209,7 +195,7 @@ msgid "" "/some/host/folder/for/work`).**" msgstr "" -#: ../../using/common.md:38 150b2f4908ff483d9c368930b50e7a3a +#: ../../using/common.md:38 09086088a4d943adbca26e0bcc6ce66d 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 " @@ -217,42 +203,42 @@ msgid "" "arguments as alternatives to setting `$NB_UID` and `$NB_GID`." msgstr "" -#: ../../using/common.md:40 cb27b1f9c2a944f98111da534fc1b558 -msgid "## Startup Hooks" +#: ../../using/common.md:40 017de45c001941de9ed1e59efe69717f +msgid "Startup Hooks" msgstr "" -#: ../../using/common.md:42 6661799e56474ca18c2d9f29da6ae521 +#: ../../using/common.md:42 b578de73171145dea4d870cfdfe6e1de 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 "" -#: ../../using/common.md:45 a5ed9275e4ce4b398b5224db08a244a2 +#: ../../using/common.md:45 d7dd6f6e9d404ff49001ec720e9042d5 msgid "" "`/usr/local/bin/start-notebook.d/` - handled before any of the standard " "options noted above are applied" msgstr "" -#: ../../using/common.md:47 38aaafb7516d43c3afddbe7ee6da4445 +#: ../../using/common.md:47 e107300fa4c9422bb55c3f595b07f59c 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 "" -#: ../../using/common.md:50 1670488b91c2438fbeab1ad002c2c6c3 +#: ../../using/common.md:50 05a851ca44e44561a11d89f4496bb42b msgid "" "See the `run-hooks` function in the [`jupyter/base-notebook " "start.sh`](https://github.com/jupyter/docker-stacks/blob/master/base-" "notebook/start.sh) script for execution details." msgstr "" -#: ../../using/common.md:53 ce0d1db4ccf84cccb595235ed7431247 -msgid "## SSL Certificates" +#: ../../using/common.md:53 cf69371114354484a36079248a11f9ec +msgid "SSL Certificates" msgstr "" -#: ../../using/common.md:55 6a6d1f60212a434b9c527a4f6eedeb74 +#: ../../using/common.md:55 cac5f9b7e43f4a128b487d38f3b8b242 msgid "" "You may mount SSL key and certificate files into a container and " "configure Jupyter Notebook to use them to accept HTTPS connections. For " @@ -260,47 +246,15 @@ msgid "" "`notebook.crt` and use them, you might run the following:" msgstr "" -#: ../../using/common.md:57 ../../using/common.md:67 -#: 30191dd8c9c7495c82e7b43b4ac9f998 3af62a945d2d46e99e80af4656adb921 -msgid "```bash docker run -d -p 8888:8888 \\" -msgstr "" - -#: ../../using/common.md:59 fbee0c8c15d7429cb652565052a9b55f -msgid "" -"-v /some/host/folder:/etc/ssl/notebook \\ jupyter/base-notebook start-" -"notebook.sh \\ --NotebookApp.keyfile=/etc/ssl/notebook/notebook.key " -"--NotebookApp.certfile=/etc/ssl/notebook/notebook.crt" -msgstr "" - -#: ../../using/common.md:63 ../../using/common.md:72 ../../using/recipes.md:55 -#: ../../using/recipes.md:67 ../../using/recipes.md:287 -#: ../../using/recipes.md:508 ../../using/recipes.md:556 -#: ../../using/running.md:34 ../../using/running.md:75 -#: ../../using/running.md:97 22b7713c250f41baaae508a3e6a50589 -#: 311e7dc5b24b4351a349d8aad601219c 4e69977493074211b4f65ca55896bd24 -#: 69aca4f545a44c379f960f58edd3043c 8cbc2129d4634312a8c075880b750fe9 -#: ac933029e7b6432a80d9b2c1529021a8 cc06cb1934d64496831a3bd5ce6a5ddc -#: d9e46845c3914dc198d15a5dd4be96ae f5385212d0584a469983b1ba41071a65 -#: fcdd9908bf9d43e39f5e50a29a050928 -msgid "```" -msgstr "" - # e496d62ce1b7489eabf40a55471247b4 -#: ../../using/common.md:65 b9096a7ff4584901a2f3282ce9ce2c27 +#: ../../using/common.md:65 393105ed4bc04ddfae359386a9399303 msgid "" "Alternatively, you may mount a single PEM file containing both the key " "and certificate. For example:" msgstr "" -#: ../../using/common.md:69 bc6435da27b64fc8a034b00ab8c463be -msgid "" -"-v /some/host/folder/notebook.pem:/etc/ssl/notebook.pem \\ jupyter/base-" -"notebook start-notebook.sh \\ " -"--NotebookApp.certfile=/etc/ssl/notebook.pem" -msgstr "" - # 6ada67b7d1a34f59ad235d7e49e6a298 -#: ../../using/common.md:74 b927163685d64c02835598dc26a949a7 +#: ../../using/common.md:74 0630fe497d3a46e3b667ae7045a84e28 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 " @@ -308,11 +262,11 @@ msgid "" msgstr "" # c908965cf0084fc2b276b50b47b87d18 -#: ../../using/common.md:76 b7e51f3cd47047d2beea8d31b8fe4c23 +#: ../../using/common.md:76 7c493bdf981644eea2024efad710f71a msgid "For additional information about using SSL, see the following:" msgstr "" -#: ../../using/common.md:78 03412b7f8a6a4070b86137502f9eac14 +#: ../../using/common.md:78 e8296710db2140c082b1f47b051b3083 msgid "" "The [docker-stacks/examples](https://github.com/jupyter/docker-" "stacks/tree/master/examples) for information about how to use [Let's " @@ -320,14 +274,14 @@ msgid "" " on a publicly visible domain." msgstr "" -#: ../../using/common.md:79 2d872ea0cdff4741bdc57aeb1bdc1fc0 +#: ../../using/common.md:79 2c5d1fcaff44495087e06b7b97b8cd36 msgid "" "The [jupyter_notebook_config.py](https://github.com/jupyter/docker-" "stacks/blob/master/base-notebook/jupyter_notebook_config.py) file for how" " this Docker image generates a self-signed certificate." msgstr "" -#: ../../using/common.md:80 9e799822daf9402886e1f8fff9e35122 +#: ../../using/common.md:80 b88e2b529f054fc5927341fbfa8a9e81 msgid "" "The [Jupyter Notebook documentation](https://jupyter-" "notebook.readthedocs.io/en/latest/public_server.html#securing-a-notebook-" @@ -335,15 +289,15 @@ msgid "" "general." msgstr "" -#: ../../using/common.md:82 20e66d95615f41a9b68ebb20dc6627f7 -msgid "## Alternative Commands" +#: ../../using/common.md:82 433196c9e55946a8ad3a998c5f7eb46e +msgid "Alternative Commands" msgstr "" -#: ../../using/common.md:84 c52fc97d37134c5089c1e5f2ec89244d -msgid "### start.sh" +#: ../../using/common.md:84 7913dd576c2d411f87caad1a1e82d296 +msgid "start.sh" msgstr "" -#: ../../using/common.md:86 66108514d1b840cb80ce08094916a515 +#: ../../using/common.md:86 446abb704472427db9dcd656bb0597ff msgid "" "The `start-notebook.sh` script actually inherits most of its option " "handling capability from a more generic `start.sh` script. The `start.sh`" @@ -352,44 +306,34 @@ msgid "" "based `ipython` console in a container, do the following:" msgstr "" -#: ../../using/common.md:88 fd1c86123d7b47819d6b7ed93228aa51 -msgid "```bash docker run -it --rm jupyter/base-notebook start.sh ipython ```" -msgstr "" - # ad0be3e8095e4394afb367e9e56e1ca5 -#: ../../using/common.md:92 ea1988cd83b84a7995ec99868420579f +#: ../../using/common.md:92 42258c812b1b41a5a8ebc33976019849 msgid "Or, to run JupyterLab instead of the classic notebook, run the following:" msgstr "" -#: ../../using/common.md:94 b387e07ecd1042c8b3bb83abf2f535c2 -msgid "" -"```bash docker run -it --rm -p 8888:8888 jupyter/base-notebook start.sh " -"jupyter lab ```" -msgstr "" - -#: ../../using/common.md:98 72afb5c69f764a6b8222bfd81db54c6b +#: ../../using/common.md:98 6d09dd793e404e3ea313be3ea3bcf315 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 "" -#: ../../using/common.md:100 ad8c400b891c4dc9a55d3c0486ef9b0d -msgid "### Others" +#: ../../using/common.md:100 9609ae6306914331a2d301b3aa1cbbfc +msgid "Others" msgstr "" -#: ../../using/common.md:102 13888e38fb7a47749b5d9ac26ec4fda5 +#: ../../using/common.md:102 22f8de1a5a2e445a80f482898a3b884b msgid "" "You can bypass the provided scripts and specify 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 "" -#: ../../using/common.md:104 aaf387c962124dac9b7a5c461864c830 -msgid "## Conda Environments" +#: ../../using/common.md:104 05f74efbfd34486c80d02dfb5b79cb9a +msgid "Conda Environments" msgstr "" -#: ../../using/common.md:106 ccc628cdbd0347ec99908b2920389326 +#: ../../using/common.md:106 dddcb16df3fc4293a2a20e004b9f544d msgid "" "The default Python 3.x [Conda " "environment](http://conda.pydata.org/docs/using/envs.html) resides in " @@ -398,25 +342,18 @@ msgid "" "`sudo` commands by the `start.sh` script." msgstr "" -#: ../../using/common.md:108 9d723130a6084e6a88b82ea52b37071f +#: ../../using/common.md:108 7b5118a79ef24876b38dc739b6e46f3b msgid "" "The `jovyan` user has full read/write access to the `/opt/conda` " "directory. You can use either `conda`, `mamba` or `pip` to install new " "packages without any additional permissions." msgstr "" -#: ../../using/common.md:110 8d44c5f4e5534e8083ab3420cfd2e338 -msgid "" -"```bash # install a package into the default (python 3.x) environment pip" -" install some-package conda install some-package mamba install some-" -"package ```" +#: ../../using/common.md:117 a6a0f2a4270d43108e78fe3f0310a0c5 +msgid "Using alternative channels" msgstr "" -#: ../../using/common.md:117 2d2cb83fd1364b57adfe889be197bcbb -msgid "### Using alternative channels" -msgstr "" - -#: ../../using/common.md:119 fb231eb53ee14ec98d42d411bb4f32ad +#: ../../using/common.md:119 a6f3a011d8e0462c9a96af56b5579ea6 msgid "" "Conda is configured by default to use only the [`conda-" "forge`](https://anaconda.org/conda-forge) channel. However, alternative " @@ -427,19 +364,11 @@ msgid "" "to install packages." msgstr "" -#: ../../using/common.md:123 d8ec1392cb40453b8ae6c503b6f70b31 -msgid "" -"```bash # using defaults channels to install a package conda install " -"--channel defaults humanize # configure conda to add default channels at " -"the top of the list conda config --system --prepend channels defaults # " -"install a package conda install humanize ```" +#: ../../using/recipes.md:1 40a14b911f74494c8086dc1748277b27 +msgid "Contributed Recipes" msgstr "" -#: ../../using/recipes.md:1 3c256308c8d8472889409358057f300b -msgid "# Contributed Recipes" -msgstr "" - -#: ../../using/recipes.md:3 8989a72a6d534a549bf82e20a69f0d8c +#: ../../using/recipes.md:3 aa8ed7996aa2438fbf22730475499f93 msgid "" "Users sometimes share interesting ways of using the Jupyter Docker " "Stacks. We encourage users to [contribute these " @@ -449,11 +378,11 @@ msgid "" "knowledge." msgstr "" -#: ../../using/recipes.md:8 ed2f6c1b39b743119c35a194dbe3d55b -msgid "## Using `sudo` within a container" +#: ../../using/recipes.md:8 35db656d7d3b4e4ca79bec1c122600e2 +msgid "Using `sudo` within a container" msgstr "" -#: ../../using/recipes.md:10 b8d70af7af6a4fa58872be319be091db +#: ../../using/recipes.md:10 8de6d58f0808400aa311eb62ccd105b9 msgid "" "Password authentication is disabled for the `NB_USER` (e.g., `jovyan`). " "This choice was made to avoid distributing images with a weak default " @@ -461,7 +390,7 @@ msgid "" "container on a publicly accessible host." msgstr "" -#: ../../using/recipes.md:14 22f55ee212274347b15f10fe20490eb7 +#: ../../using/recipes.md:14 a5b66c340a27453aa4310c33f2a7ba02 msgid "" "You can grant the within-container `NB_USER` passwordless `sudo` access " "by adding `-e GRANT_SUDO=yes` and `--user root` to your Docker command " @@ -469,17 +398,11 @@ msgid "" msgstr "" # f75300183d66418d958651b713e3c81e -#: ../../using/recipes.md:18 e30cfb5fd3084b44a3eab9918a1fd5ef +#: ../../using/recipes.md:18 45ea6a373b1b4b0bb7ee7e0536a4f68b msgid "For example:" msgstr "" -#: ../../using/recipes.md:20 88b81bdc88c7455a81e908f2a9102c80 -msgid "" -"```bash docker run -it -e GRANT_SUDO=yes --user root jupyter/minimal-" -"notebook ```" -msgstr "" - -#: ../../using/recipes.md:24 eb7a2e953aeb44db9d8ac66064c77180 +#: ../../using/recipes.md:24 b1f932e5e1dd4ed5b4a6ce88b0346470 msgid "" "**You should only enable `sudo` if you trust the user and/or if the " "container is running on an isolated host.** See [Docker security " @@ -487,66 +410,33 @@ msgid "" " more information about running containers as `root`." msgstr "" -#: ../../using/recipes.md:27 9b98b21cd7a44f7c9e39ce886a501d59 -msgid "## Using `pip install` or `conda install` in a Child Docker image" +#: ../../using/recipes.md:27 1b3c07d8aff248968f25cd6d2a858575 +msgid "Using `pip install` or `conda install` in a Child Docker image" msgstr "" # cfb1a65ed1a4453e8b3355f1c0c23b1c -#: ../../using/recipes.md:29 ab3f8a522e1f4bbb8581d08cef554d41 +#: ../../using/recipes.md:29 335f16d4417f4d13a780cdac613a82ef msgid "Create a new Dockerfile like the one shown below." msgstr "" -#: ../../using/recipes.md:31 d3f6c882c3324a95a21f94afffc5cbea -msgid "" -"```dockerfile # Start from a core stack version FROM jupyter/datascience-" -"notebook:9f9e5ca8fe5a # Install in the default python3 environment RUN " -"pip install 'ggplot==0.6.8' ```" -msgstr "" - # 3ab615dc6fb6425d954cae4ce14f08b9 -#: ../../using/recipes.md:38 fe78fc8c022a4489b39bcba2b606d679 +#: ../../using/recipes.md:38 a48881f5ac7c44f283398b64b6e16998 msgid "Then build a new image." msgstr "" -#: ../../using/recipes.md:40 f9b9cef596ea409f8645beda213d6e37 -msgid "```bash docker build --rm -t jupyter/my-datascience-notebook . ```" -msgstr "" - -#: ../../using/recipes.md:44 5841d3fa18e44565850454e4f46c75c5 +#: ../../using/recipes.md:44 6ae19f16989b41e5a60f1044e54dd9cb 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 "" -#: ../../using/recipes.md:47 f06338d87d014257b168fb70e3da54cf -msgid "" -"```dockerfile # Start from a core stack version FROM jupyter/datascience-" -"notebook:9f9e5ca8fe5a # Install from requirements.txt file COPY " -"--chown=${NB_UID}:${NB_GID} requirements.txt /tmp/ RUN pip install " -"--requirement /tmp/requirements.txt && \\" -msgstr "" - -#: ../../using/recipes.md:53 ../../using/recipes.md:65 -#: ../../using/recipes.md:129 84d911a5e7854abb95276e9ba216d5d4 -#: e57ac49fe1ab46d2ad38b7ed0f550557 ef70ff3f8653424ea99ed786aa5384a5 -msgid "fix-permissions $CONDA_DIR && \\ fix-permissions /home/$NB_USER" -msgstr "" - # f2f035925d764425b9999b19d36c1d30 -#: ../../using/recipes.md:57 65dc6dab8fed4e9c95be4dd4a3a47cc3 +#: ../../using/recipes.md:57 b435a81d3a714e4f803c17bdf3352e79 msgid "For conda, the Dockerfile is similar:" msgstr "" -#: ../../using/recipes.md:59 16635781e564493ab0926cf9def5d6e3 -msgid "" -"```dockerfile # Start from a core stack version FROM jupyter/datascience-" -"notebook:9f9e5ca8fe5a # Install from requirements.txt file COPY " -"--chown=${NB_UID}:${NB_GID} requirements.txt /tmp/ RUN conda install " -"--yes --file /tmp/requirements.txt && \\" -msgstr "" - -#: ../../using/recipes.md:69 b3371020021f47f48bad15e512822635 +#: ../../using/recipes.md:69 0b895205d6114f0699ce5df7ddbcc868 msgid "" "Ref: [docker-" "stacks/commit/79169618d571506304934a7b29039085e77db78c](https://github.com/jupyter" @@ -554,68 +444,28 @@ msgid "" "stacks/commit/79169618d571506304934a7b29039085e77db78c#commitcomment-15960081)" msgstr "" -#: ../../using/recipes.md:72 0e8825ab6ee64417a5aeb606c5366b5e -msgid "## Add a Python 2.x environment" +#: ../../using/recipes.md:72 a09fe12c09f74e97bf3b62b1196bcf4e +msgid "Add a Python 2.x environment" msgstr "" -#: ../../using/recipes.md:74 143cc9a74b0d48589fc744de8814f927 +#: ../../using/recipes.md:74 ef51a164b05c48539d483948d02f0978 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 "" -#: ../../using/recipes.md:78 172e4c2abfb14120b0c56960b86af565 -msgid "" -"```dockerfile # Choose your desired base image FROM jupyter/scipy-" -"notebook:latest" -msgstr "" - -#: ../../using/recipes.md:82 ee97f086030e40edafd81aaec092c3c4 -msgid "" -"# Create a Python 2.x environment using conda including at least the " -"ipython kernel # and the kernda utility. Add any additional packages you " -"want available for use # in a Python 2 notebook to the first line here " -"(e.g., pandas, matplotlib, etc.) RUN conda create --quiet --yes -p " -"$CONDA_DIR/envs/python2 python=2.7 ipython ipykernel kernda && \\" -msgstr "" - -#: ../../using/recipes.md:86 ../../using/recipes.md:116 -#: 2881121575ec43f3a1f1009e871b8d6e 5ba357508d684b09b5420cbba1ead754 -msgid "conda clean --all -f -y" -msgstr "" - -#: ../../using/recipes.md:88 ../../using/recipes.md:253 -#: ../../using/recipes.md:521 ../../using/recipes.md:544 -#: 069b07b7d1334e66b34be6c52df9138b 390f7ec4fe854b70b258027b1dd59622 -#: 75138978e9cc41dd94b680912f15deef 7986b669c9764cb384940dc8095f6721 -msgid "USER root" -msgstr "" - -#: ../../using/recipes.md:90 fcd41f9f47064355984f7e8f4818952a -msgid "" -"# Create a global kernelspec in the image and modify it so that it " -"properly activates # the python2 conda environment. RUN " -"$CONDA_DIR/envs/python2/bin/python -m ipykernel install && \\ " -"$CONDA_DIR/envs/python2/bin/kernda -o -y " -"/usr/local/share/jupyter/kernels/python2/kernel.json" -msgstr "" - -#: ../../using/recipes.md:95 f9c4d4b5d5764fc8b6eb39f6799d7ba0 -msgid "USER $NB_USER ```" -msgstr "" - -#: ../../using/recipes.md:98 3b20b46fecd24bc693f7cee537459955 +#: ../../using/recipes.md:98 c583ba08b0814a24a666239eba7a9add msgid "" "Ref: [https://github.com/jupyter/docker-" "stacks/issues/440](https://github.com/jupyter/docker-stacks/issues/440)" msgstr "" -#: ../../using/recipes.md:101 945da707b7db46dc96dbad17f00ff25c -msgid "## Add a Python 3.x environment" +#: ../../using/recipes.md:101 464d4061eda74305ae9f10df0184f263 +msgid "Add a Python 3.x environment" msgstr "" -#: ../../using/recipes.md:103 2651411a4a3d4ed692d06265287ff41b +#: ../../using/recipes.md:103 a5ad8ebd0da84d44a657a68c1bf9fc1d msgid "" "The default version of Python that ships with conda/ubuntu may not be the" " version you want. To add a conda environment with a different version " @@ -623,88 +473,28 @@ msgid "" "Python 2.x but are slightly simpler (no need to switch to `root`):" msgstr "" -#: ../../using/recipes.md:106 9e7ba8eeb6a04d98b1ad2ed423488aad -msgid "" -"```dockerfile # Choose your desired base image FROM jupyter/minimal-" -"notebook:latest" +#: ../../using/recipes.md:142 dbb745f5de1e4e6795af49f40f513714 +msgid "Run JupyterLab" msgstr "" -#: ../../using/recipes.md:110 c8f3c8fd236a4f5caa390631e55d952b -msgid "" -"# name your environment and choose python 3.x version ARG " -"conda_env=python36 ARG py_ver=3.6" -msgstr "" - -#: ../../using/recipes.md:114 d5550ee4b8d8444499b4d2bcc3d4cb46 -msgid "" -"# you can add additional libraries you want conda to install by listing " -"them below the first line and ending with \"&& \\\" RUN conda create " -"--quiet --yes -p $CONDA_DIR/envs/$conda_env python=$py_ver ipython " -"ipykernel && \\" -msgstr "" - -#: ../../using/recipes.md:118 491d1237398d44d686e4b3f3ec32fa94 -msgid "" -"# alternatively, you can comment out the lines above and uncomment those " -"below # if you'd prefer to use a YAML file present in the docker build " -"context" -msgstr "" - -#: ../../using/recipes.md:121 8776887abcdb46659cd82c3bdab4353a -msgid "" -"# COPY --chown=${NB_UID}:${NB_GID} environment.yml /home/$NB_USER/tmp/ # " -"RUN cd /home/$NB_USER/tmp/ && \\ # conda env create -p " -"$CONDA_DIR/envs/$conda_env -f environment.yml && \\ # conda clean " -"--all -f -y" -msgstr "" - -#: ../../using/recipes.md:127 e73902650bbd4ad19fdd29041aca0eec -msgid "" -"# create Python 3.x environment and link it to jupyter RUN " -"$CONDA_DIR/envs/${conda_env}/bin/python -m ipykernel install --user " -"--name=${conda_env} && \\" -msgstr "" - -#: ../../using/recipes.md:132 d7252af6e4834619ae3566e9ea5ac25b -msgid "" -"# any additional pip installs can be added by uncommenting the following " -"line # RUN $CONDA_DIR/envs/${conda_env}/bin/pip install" -msgstr "" - -#: ../../using/recipes.md:135 60053658f4364f66a0667fae8d999d94 -msgid "" -"# prepend conda environment to path ENV PATH " -"$CONDA_DIR/envs/${conda_env}/bin:$PATH" -msgstr "" - -#: ../../using/recipes.md:138 72dda524e1bd45cfa740046a2e5c7901 -msgid "" -"# if you want this environment to be the default one, uncomment the " -"following line: # ENV CONDA_DEFAULT_ENV ${conda_env} ```" -msgstr "" - -#: ../../using/recipes.md:142 ec3aefd5a4af41de8271fdded3e2b92f -msgid "## Run JupyterLab" -msgstr "" - -#: ../../using/recipes.md:144 4defd62f37ea45a8a0ec69ca9f878081 +#: ../../using/recipes.md:144 10d8487da684411fa31d04891bd0ba02 msgid "" "JupyterLab is preinstalled as a notebook extension starting in tag " "[c33a7dc0eece](https://github.com/jupyter/docker-stacks/wiki/Docker-" "build-history)." msgstr "" -#: ../../using/recipes.md:147 9be396b10ff44bfaba5dc22e39271959 +#: ../../using/recipes.md:147 42fc30c452e44be0a05b4aea2526d984 msgid "" "Run jupyterlab using a command such as `docker run -it --rm -p 8888:8888 " "jupyter/datascience-notebook start.sh jupyter lab`" msgstr "" -#: ../../using/recipes.md:150 e6f5c60c4b2a4c7da630d8b3a7f4f043 -msgid "## Dask JupyterLab Extension" +#: ../../using/recipes.md:150 b054904dbbe94086b11a0913509532b5 +msgid "Dask JupyterLab Extension" msgstr "" -#: ../../using/recipes.md:152 e5609396f9624268ba79f2bab2aebd0e +#: ../../using/recipes.md:152 3c71d12974864983a16e46841b1c9680 msgid "" "[Dask JupyterLab Extension](https://github.com/dask/dask-labextension) " "provides a JupyterLab extension to manage Dask clusters, as well as embed" @@ -712,53 +502,25 @@ msgid "" "Dockerfile as:" msgstr "" -#: ../../using/recipes.md:154 b406821d43ae466d82619692b107846e -msgid "" -"```dockerfile # Start from a core stack version FROM jupyter/scipy-" -"notebook:latest" -msgstr "" - -#: ../../using/recipes.md:158 2ceccf9935fb40cd900ccd9cbd9b7e9c -msgid "# Install the Dask dashboard RUN pip install dask-labextension" -msgstr "" - -#: ../../using/recipes.md:161 e6ad617ff0b34bfa9fd3cf822086bdef -msgid "# Dask Scheduler & Bokeh ports EXPOSE 8787 EXPOSE 8786" -msgstr "" - -#: ../../using/recipes.md:165 4582ef3414524e95810cbea7f6ee84c7 -msgid "ENTRYPOINT [\"jupyter\", \"lab\", \"--ip=0.0.0.0\", \"--allow-root\"] ```" -msgstr "" - -#: ../../using/recipes.md:168 addd20fe0af747d5a774f91b496131b1 +#: ../../using/recipes.md:168 5e2e676390f44dcaba15a14fcf1ee65d msgid "And build the image as:" msgstr "" -#: ../../using/recipes.md:170 0974a4eee19e43fca90b74e1d1efeaeb -msgid "```bash docker build -t jupyter/scipy-dasklabextension:latest . ```" -msgstr "" - -#: ../../using/recipes.md:174 4fc2eaf005f545aebed6fe321361ef03 +#: ../../using/recipes.md:174 a75bda1f94034a368f3a79f826ce3be0 msgid "Once built, run using the command:" msgstr "" -#: ../../using/recipes.md:176 2d99b3d7c8ce4272b4703fcd199cdefd -msgid "" -"```bash docker run -it --rm -p 8888:8888 -p 8787:8787 jupyter/scipy-" -"dasklabextension:latest ```" -msgstr "" - -#: ../../using/recipes.md:180 2447b4b6a235485f96535acc9757d682 +#: ../../using/recipes.md:180 1013e87206d7499b99b1d590c896e467 msgid "" "Ref: [https://github.com/jupyter/docker-" "stacks/issues/999](https://github.com/jupyter/docker-stacks/issues/999)" msgstr "" -#: ../../using/recipes.md:183 3484d3caac454e34b7513ca3f4f6b403 -msgid "## Let's Encrypt a Notebook server" +#: ../../using/recipes.md:183 ba2f886bef854d52aa962377dbd2c9f9 +msgid "Let's Encrypt a Notebook server" msgstr "" -#: ../../using/recipes.md:185 a2c35f107dfe4e87ad6050cc7fb46ea7 +#: ../../using/recipes.md:185 0f85c3d15bc442dca7585ff8a4783df2 msgid "" "See the README for the simple automation here [https://github.com/jupyter" "/docker-stacks/tree/master/examples/make-" @@ -767,67 +529,52 @@ msgid "" "Encrypt certificate." msgstr "" -#: ../../using/recipes.md:189 398f91bee8634c558898d5a8e26e5c78 +#: ../../using/recipes.md:189 e219634db53346178b94fc77c61762fc msgid "" "Ref: [https://github.com/jupyter/docker-" "stacks/issues/78](https://github.com/jupyter/docker-stacks/issues/78)" msgstr "" -#: ../../using/recipes.md:192 48c20b6cb3bb4b7cbdbbbb5c84d19195 -msgid "## Slideshows with Jupyter and RISE" +#: ../../using/recipes.md:192 45d983c3ab754ff9a8120ab39ccea450 +msgid "Slideshows with Jupyter and RISE" msgstr "" -#: ../../using/recipes.md:194 2215128771804b2b94416a23a069bdeb +#: ../../using/recipes.md:194 72578d5d91244da3bc5eb9984c2f1aaf msgid "" "[RISE](https://github.com/damianavila/RISE) allows via extension to " "create live slideshows of your notebooks, with no conversion, adding " "javascript Reveal.js:" msgstr "" -#: ../../using/recipes.md:197 714d50a93c17401cb38a2779e1771082 -msgid "" -"```bash # Add Live slideshows with RISE RUN conda install -c " -"damianavila82 rise ```" -msgstr "" - -#: ../../using/recipes.md:202 af21d1b2b4b14740ab522bef822946e8 +#: ../../using/recipes.md:202 baa603e27c4947d2b23d58f6602ad155 msgid "" "Credit: [Paolo D.](https://github.com/pdonorio) based on [docker-" "stacks/issues/43](https://github.com/jupyter/docker-stacks/issues/43)" msgstr "" -#: ../../using/recipes.md:205 c35b991ff2ec4bf387b89097249940c7 -msgid "## xgboost" +#: ../../using/recipes.md:205 456748ebbb064c7882da8f12c16a7f23 +msgid "xgboost" msgstr "" # ce204678c3af4aa9a0fb55bb6de7554b -#: ../../using/recipes.md:207 3da1f1bcce9748a4810cc451b1834b4b +#: ../../using/recipes.md:207 74e27524c1604f8d8f47917f263e63c2 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 "" -#: ../../using/recipes.md:210 823b9c995adc46aea041a33133c870b2 -#, python-format -msgid "```bash %%bash conda install -y gcc pip install xgboost" -msgstr "" - -#: ../../using/recipes.md:215 302c9e4d5e834819a920841dfc029230 -msgid "import xgboost ```" -msgstr "" - -#: ../../using/recipes.md:218 4189fafdb2534716b2e8cabf1568b7dd -msgid "## Running behind a nginx proxy" +#: ../../using/recipes.md:218 65f087e94313454baf583b0eafa9c061 +msgid "Running behind a nginx proxy" msgstr "" # ca7763a5a35a47bd9fb29ae9d00feab3 -#: ../../using/recipes.md:220 8bc7973450624bd39ee324f674f83b5d +#: ../../using/recipes.md:220 030a8284e30c408297f3ecf3379ac881 msgid "" "Sometimes it is useful to run the Jupyter instance behind a nginx proxy, " "for instance:" msgstr "" -#: ../../using/recipes.md:222 6fbec78fafd44f1ba32f2b110eff556c +#: ../../using/recipes.md:222 f8ee4fa0570e49e4be3b73f873a9ee9b msgid "" "you would prefer to access the notebook at a server URL with a path " "(`https://example.com/jupyter`) rather than a port " @@ -835,14 +582,14 @@ msgid "" msgstr "" # a5129fb6e2b042f5b8161ed5318123f9 -#: ../../using/recipes.md:224 4ba820fd0ddc4ae9b484d00839f314c0 +#: ../../using/recipes.md:224 76d96b3862e34428b9871521da5f084a 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 "" -#: ../../using/recipes.md:227 0f0c38735d88494f9ba67e34aca9ccfe +#: ../../using/recipes.md:227 3bd9c61e3d2a4c8fa18d7e0fbe210676 msgid "" "Here is a [quick example NGINX " "configuration](https://gist.github.com/cboettig/8643341bd3c93b62b5c2) to " @@ -853,11 +600,11 @@ msgid "" "services." msgstr "" -#: ../../using/recipes.md:232 05b4517c01e4472792ebc2b4a995bf15 -msgid "## Host volume mounts and notebook errors" +#: ../../using/recipes.md:232 5442137d17b44cd9be441adea5fed9a7 +msgid "Host volume mounts and notebook errors" msgstr "" -#: ../../using/recipes.md:234 b20b753d63624dfbabc799b125413a7d +#: ../../using/recipes.md:234 e3e74b20c9b34986a8e890322be0693b 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" @@ -868,48 +615,25 @@ msgid "" "section](../using/common.html#Docker-Options)" msgstr "" -#: ../../using/recipes.md:240 0f9b15b5beaa4a0d846bcdb25ec80472 +#: ../../using/recipes.md:240 a393d22c846442fda6720e1ed944deef msgid "" "Ref: [https://github.com/jupyter/docker-" "stacks/issues/199](https://github.com/jupyter/docker-stacks/issues/199)" msgstr "" -#: ../../using/recipes.md:243 3123fce971a344429a5385765930a83b -msgid "## Manpage installation" +#: ../../using/recipes.md:243 57d925010749489ebee1f5cf87e2bd6a +msgid "Manpage installation" msgstr "" # 7fc6566074ee4ba3a4e579437d7f151d -#: ../../using/recipes.md:245 92cd7cb07133454183e12fe35c0e283f +#: ../../using/recipes.md:245 bb324a090ad84fdb90eba5d015bfd68d 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 "" -#: ../../using/recipes.md:248 404dced3d8134a4eb9ddca25d4d4a33e -msgid "" -"```dockerfile # Choose your desired base image ARG BASE_CONTAINER=jupyter" -"/datascience-notebook:latest FROM $BASE_CONTAINER" -msgstr "" - -#: ../../using/recipes.md:255 0b30e1b6c2354fffa15e45664345667f -msgid "" -"# Remove the manpage blacklist, install man, install docs RUN rm " -"/etc/dpkg/dpkg.cfg.d/excludes \\" -msgstr "" - -#: ../../using/recipes.md:257 a159121e42a647868f0f009cdaafcab2 -msgid "" -"&& apt-get update \\ && dpkg -l | grep ^ii | cut -d' ' -f3 | xargs apt-" -"get install -yq --no-install-recommends --reinstall man \\ && apt-get " -"clean \\ && rm -rf /var/lib/apt/lists/*" -msgstr "" - -#: ../../using/recipes.md:262 58aab6e52d0e40a7b867605dcedcc8d4 -msgid "USER $NB_UID ```" -msgstr "" - -#: ../../using/recipes.md:265 c7927c03aea84317a44a7f84b811f32f +#: ../../using/recipes.md:265 3e4bea3d2be841379c3ef52248886f1e msgid "" "Adding the documentation on top of an existing singleuser image wastes a " "lot of space and requires reinstalling every system package, which can " @@ -920,83 +644,55 @@ msgid "" "container:" msgstr "" -#: ../../using/recipes.md:271 ba72334380644ff997caa639382d9e4c -msgid "" -"```dockerfile # Ubuntu 20.04 (focal) from 2020-04-23 # https://github.com" -"/docker-library/official-" -"images/commit/4475094895093bcc29055409494cce1e11b52f94 ARG " -"BASE_CONTAINER=ubuntu:focal-20200423@sha256:238e696992ba9913d24cfc3727034985abd136e08ee3067982401acdc30cbf3f" -" ```" -msgstr "" - -#: ../../using/recipes.md:277 384b0bcbbc684d5dadfb97744e876618 +#: ../../using/recipes.md:277 77e3726777c846f5bac8ef908022c8dc msgid "" "For Ubuntu 18.04 (bionic) and earlier, you may also require to workaround" " for a mandb bug, which was fixed in mandb >= 2.8.6.1:" msgstr "" -#: ../../using/recipes.md:279 4b82acbe9c4445c5b9a08f465c4ad366 -msgid "" -"```dockerfile # https://git.savannah.gnu.org/cgit/man-" -"db.git/commit/?id=8197d7824f814c5d4b992b4c8730b5b0f7ec589a # " -"http://launchpadlibrarian.net/435841763/man-db_2.8.5-2_2.8.6-1.diff.gz" -msgstr "" - -#: ../../using/recipes.md:285 49941945c20c47a39e0fecf762d118b1 -msgid "" -"RUN echo \"MANPATH_MAP ${CONDA_DIR}/bin ${CONDA_DIR}/man\" >> " -"/etc/manpath.config \\" -msgstr "" - -#: ../../using/recipes.md:284 3127cb1434d640fca77e9c27de6f5f22 -msgid "" -"&& echo \"MANPATH_MAP ${CONDA_DIR}/bin ${CONDA_DIR}/share/man\" >> " -"/etc/manpath.config \\ && mandb" -msgstr "" - -#: ../../using/recipes.md:289 a3d1bd78bb824b12b03d2873abeb957c +#: ../../using/recipes.md:289 cce6493b2276473b8f33195734a809df msgid "" "Be sure to check the current base image in `base-notebook` before " "building." msgstr "" -#: ../../using/recipes.md:291 8f02d44795ef42d099b289e5ea7dbc34 -msgid "## JupyterHub" +#: ../../using/recipes.md:291 00635da8632644729aaa09ed6e7f63ba +msgid "JupyterHub" msgstr "" # af0ca920391b419b805ae3809388fcf2 -#: ../../using/recipes.md:293 701b1f58b9494f5ab1f3f1b92617fc77 +#: ../../using/recipes.md:293 034599b09a1b4d9087e19136204bdaa7 msgid "We also have contributed recipes for using JupyterHub." msgstr "" -#: ../../using/recipes.md:295 5b8ddf49f2774ff7b6b0d42a46427f49 -msgid "### Use JupyterHub's dockerspawner" +#: ../../using/recipes.md:295 2320542d44444e4ea70f8ccb3a3b2fb6 +msgid "Use JupyterHub's dockerspawner" msgstr "" # 81e1dbb4c1c34f4c9e88630adff3d1e9 -#: ../../using/recipes.md:297 9f83d1fd68044ec48dc93161c1826359 +#: ../../using/recipes.md:297 aef5b98017ba4111a7660cccf592a9ea 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 "" # 837b7a2dac01402e8cd2cc398bd5d785 -#: ../../using/recipes.md:300 5062dd3a8fdc45a48fd649d905cdd11d +#: ../../using/recipes.md:300 32722c56251e4a9bb77ecbb8449518ed msgid "install the jupyterhub-singleuser script (for the right Python)" msgstr "" # d9816cb5ae2041e2a5fde9cdfb91262f -#: ../../using/recipes.md:301 a8fc7790e8c04828af42f5b15fb9fd92 +#: ../../using/recipes.md:301 39a36e7083b94f1c9ae5c761214664c3 msgid "change the command to launch the single-user server" msgstr "" -#: ../../using/recipes.md:303 af15a8ca2b5b4cfb8d7ca5ee4fe083c1 +#: ../../using/recipes.md:303 42e231a2bc2f4cbfb27a127e4bf538a3 msgid "" "Swapping out the `FROM` line in the `jupyterhub/singleuser` Dockerfile " "should be enough for most cases." msgstr "" -#: ../../using/recipes.md:306 05958ee3c4744054b52361340b23a132 +#: ../../using/recipes.md:306 efeb5c8ed976402aa73325ad377f38a5 msgid "" "Credit: [Justin Tyberg](https://github.com/jtyberg), " "[quanghoc](https://github.com/quanghoc), and [Min " @@ -1006,144 +702,72 @@ msgid "" "stacks/pull/185)" msgstr "" -#: ../../using/recipes.md:311 b6f9c7b0438f43c19d709b9dd0f6e38d -msgid "### Containers with a specific version of JupyterHub" +#: ../../using/recipes.md:311 a7f26dbeead04260984d1ccdf85bf294 +msgid "Containers with a specific version of JupyterHub" msgstr "" -#: ../../using/recipes.md:313 7f4da1c0499940979b42e53ff409b2a9 +#: ../../using/recipes.md:313 d9bbd7b51bf8496aa492834567326c6c msgid "" "To use a specific version of JupyterHub, the version of `jupyterhub` in " "your image should match the version in the Hub itself." msgstr "" -#: ../../using/recipes.md:316 85db192d5c3644538a8b74ce163936a4 -msgid "" -"```dockerfile FROM jupyter/base-notebook:5ded1de07260 RUN pip install " -"jupyterhub==0.8.0b1 ```" -msgstr "" - -#: ../../using/recipes.md:321 323bb8737df84e3b9669f3f981aef282 +#: ../../using/recipes.md:321 00a56dbc410e404a949c2f85e9c7aef3 msgid "" "Credit: [MinRK](https://github.com/jupyter/docker-" "stacks/issues/423#issuecomment-322767742)" msgstr "" -#: ../../using/recipes.md:323 243019a55cfc41d1a9c11b860e661fe1 +#: ../../using/recipes.md:323 d574ec248cb04e86bb0bd54f7b306c6b msgid "" "Ref: [https://github.com/jupyter/docker-" "stacks/issues/177](https://github.com/jupyter/docker-stacks/issues/177)" msgstr "" -#: ../../using/recipes.md:326 bcb7663fc0404267834a69d5ce1c3471 -msgid "## Spark" +#: ../../using/recipes.md:326 925f5a965f01443f9a6acb5a9be14d79 +msgid "Spark" msgstr "" # 975c96d6a0b843dfabd889c753671c93 -#: ../../using/recipes.md:328 a6b4b090c3cc4a3597ea9537f7f5a9b1 +#: ../../using/recipes.md:328 ff7446c04a40413a80f5d82912d7c99b msgid "A few suggestions have been made regarding using Docker Stacks with spark." msgstr "" -#: ../../using/recipes.md:330 cc2f5219c548409682c0bb9d3cf88f5b -msgid "### Using PySpark with AWS S3" +#: ../../using/recipes.md:330 0e919d5dea9c42b19671ba9a9d14a7e8 +msgid "Using PySpark with AWS S3" msgstr "" # dc4059d42eaa495f8ebca84ebc91ac09 -#: ../../using/recipes.md:332 2fa4bbae03a24397aff644fbe5295a22 +#: ../../using/recipes.md:332 ed67f9f007314986b5ddd4f6c538e9a0 msgid "Using Spark session for hadoop 2.7.3" msgstr "" -#: ../../using/recipes.md:334 6c838fe6f52b4db599e7b5339610c828 -msgid "" -"```py import os # !ls /usr/local/spark/jars/hadoop* # to figure out what " -"version of hadoop os.environ['PYSPARK_SUBMIT_ARGS'] = '--packages " -"\"org.apache.hadoop:hadoop-aws:2.7.3\" pyspark-shell'" -msgstr "" - -#: ../../using/recipes.md:339 12ac1ad3f4ba476f86999ca1b1100622 -msgid "import pyspark myAccessKey = input() mySecretKey = input()" -msgstr "" - -#: ../../using/recipes.md:347 99f2f180070d4fdb81655a7f76164ff4 -msgid "spark = pyspark.sql.SparkSession.builder \\" -msgstr "" - -#: ../../using/recipes.md:344 500f90c7f6f1464d857d4b48c1965936 -msgid "" -".master(\"local[*]\") \\ .config(\"spark.hadoop.fs.s3a.access.key\", " -"myAccessKey) \\ .config(\"spark.hadoop.fs.s3a.secret.key\", mySecretKey) " -"\\ .getOrCreate()" -msgstr "" - -#: ../../using/recipes.md:349 b36aa26e68464ec8a3db0eac382ae531 -msgid "df = spark.read.parquet(\"s3://myBucket/myKey\") ```" -msgstr "" - # d2c12e3525bf4d9ca518fef02c4a79d3 -#: ../../using/recipes.md:352 843d34692eed4214a5c72a61c6faa0ad +#: ../../using/recipes.md:352 21c58de47da448d8821fc339e1c4f318 msgid "Using Spark context for hadoop 2.6.0" msgstr "" -#: ../../using/recipes.md:354 8e0d458cad6d4c99a09a1fc50a0ba8bd -msgid "" -"```py import os os.environ['PYSPARK_SUBMIT_ARGS'] = '--packages " -"com.amazonaws:aws-java-sdk:1.10.34,org.apache.hadoop:hadoop-aws:2.6.0 " -"pyspark-shell'" -msgstr "" - -#: ../../using/recipes.md:358 6d396cc36334461997aeece9b625efd6 -msgid "import pyspark sc = pyspark.SparkContext(\"local[*]\")" -msgstr "" - -#: ../../using/recipes.md:361 5615ba670a5544fa9cb1d16ba5c5f53d -msgid "from pyspark.sql import SQLContext sqlContext = SQLContext(sc)" -msgstr "" - -#: ../../using/recipes.md:364 5d58a092c31e40509e20caa25c64037f -msgid "" -"hadoopConf = sc._jsc.hadoopConfiguration() myAccessKey = input() " -"mySecretKey = input() hadoopConf.set(\"fs.s3.impl\", " -"\"org.apache.hadoop.fs.s3native.NativeS3FileSystem\") " -"hadoopConf.set(\"fs.s3.awsAccessKeyId\", myAccessKey) " -"hadoopConf.set(\"fs.s3.awsSecretAccessKey\", mySecretKey)" -msgstr "" - -#: ../../using/recipes.md:371 32d4deb9fa9d4bd592124b4792d05afd -msgid "df = sqlContext.read.parquet(\"s3://myBucket/myKey\") ```" -msgstr "" - -#: ../../using/recipes.md:374 dd27e0ea35c9411fb4119cb20dd0b02e +#: ../../using/recipes.md:374 81857ff4f3da4afd8a601f581de96d7a msgid "" "Ref: [https://github.com/jupyter/docker-" "stacks/issues/127](https://github.com/jupyter/docker-stacks/issues/127)" msgstr "" -#: ../../using/recipes.md:377 6c953d0c1a5c438db043d8eab1c1430d -msgid "### Using Local Spark JARs" +#: ../../using/recipes.md:377 84b4388dc4c544efb92246956432123d +msgid "Using Local Spark JARs" msgstr "" -#: ../../using/recipes.md:379 877400ca93974b43a545a0ff203bdbee -msgid "" -"```python import os os.environ['PYSPARK_SUBMIT_ARGS'] = '--jars " -"/home/jovyan/spark-streaming-kafka-assembly_2.10-1.6.1.jar pyspark-shell'" -" import pyspark from pyspark.streaming.kafka import KafkaUtils from " -"pyspark.streaming import StreamingContext sc = pyspark.SparkContext() ssc" -" = StreamingContext(sc,1) broker = \"\" directKafkaStream =" -" KafkaUtils.createDirectStream(ssc, [\"test1\"], " -"{\"metadata.broker.list\": broker}) directKafkaStream.pprint() " -"ssc.start() ```" -msgstr "" - -#: ../../using/recipes.md:393 6a177509ceca45e4841c24e69f64aa6d +#: ../../using/recipes.md:393 8df6d3885b0f4f59a110e04399c87573 msgid "" "Ref: [https://github.com/jupyter/docker-" "stacks/issues/154](https://github.com/jupyter/docker-stacks/issues/154)" msgstr "" -#: ../../using/recipes.md:396 cf39a9296f314826aeb89a8329ec2aa8 -msgid "### Using spark-packages.org" +#: ../../using/recipes.md:396 249efd8c830541818e909a1cc0d5bc68 +msgid "Using spark-packages.org" msgstr "" -#: ../../using/recipes.md:398 cdf3cc051776431faf375f1df73ee43c +#: ../../using/recipes.md:398 3a21fc5a064b4339b01930c4a291233e msgid "" "If you'd like to use packages from [spark-packages.org](https://spark-" "packages.org/), see " @@ -1152,149 +776,35 @@ msgid "" "environment before creating a SparkContext." msgstr "" -#: ../../using/recipes.md:403 b0e563b1a77f4bac9bfe99cf6334aefd +#: ../../using/recipes.md:403 b72bebeb003343bb80c2ca888eea1eb4 msgid "" "Ref: [https://github.com/jupyter/docker-" "stacks/issues/43](https://github.com/jupyter/docker-stacks/issues/43)" msgstr "" -#: ../../using/recipes.md:406 67b6b23d51a7488e87ce92f1d52ee007 -msgid "### Use jupyter/all-spark-notebooks with an existing Spark/YARN cluster" +#: ../../using/recipes.md:406 00b62d514e1347908f1071a48584c549 +msgid "Use jupyter/all-spark-notebooks with an existing Spark/YARN cluster" msgstr "" -#: ../../using/recipes.md:408 80857997206847378bf3448a693d2efe -msgid "```dockerfile FROM jupyter/all-spark-notebook" -msgstr "" - -#: ../../using/recipes.md:411 d53eeed5cbbe4a738c9af5aacb377dab -msgid "" -"# Set env vars for pydoop ENV HADOOP_HOME /usr/local/hadoop-2.7.3 ENV " -"JAVA_HOME /usr/lib/jvm/java-8-openjdk-amd64 ENV HADOOP_CONF_HOME " -"/usr/local/hadoop-2.7.3/etc/hadoop ENV HADOOP_CONF_DIR " -"/usr/local/hadoop-2.7.3/etc/hadoop" -msgstr "" - -#: ../../using/recipes.md:417 544ea877a34c446ca38025f9e6ef1f3a -msgid "" -"USER root # Add proper open-jdk-8 not just the jre, needed for pydoop RUN" -" echo 'deb http://cdn-fastly.deb.debian.org/debian jessie-backports main'" -" > /etc/apt/sources.list.d/jessie-backports.list && \\" -msgstr "" - -#: ../../using/recipes.md:420 496cc7e1f8204ec4a279e7ec7f7cf18a -msgid "" -"apt-get -y update && \\ apt-get install --no-install-recommends -t " -"jessie-backports -y openjdk-8-jdk && \\ rm /etc/apt/sources.list.d" -"/jessie-backports.list && \\ apt-get clean && \\ rm -rf " -"/var/lib/apt/lists/ && \\" -msgstr "" - -#: ../../using/recipes.md:428 2fd772f00fb94b6c8c9d16c0485fe277 -msgid "# Add hadoop binaries" -msgstr "" - -#: ../../using/recipes.md:426 34dcbda8d3be4f30a273adeb41a782af -msgid "" -"wget " -"http://mirrors.ukfast.co.uk/sites/ftp.apache.org/hadoop/common/hadoop-2.7.3/hadoop-2.7.3.tar.gz" -" && \\ tar -xvf hadoop-2.7.3.tar.gz -C /usr/local && \\ chown -R " -"$NB_USER:users /usr/local/hadoop-2.7.3 && \\ rm -f hadoop-2.7.3.tar.gz &&" -" \\" -msgstr "" - -#: ../../using/recipes.md:433 9fb7925891f34e39ba61d7052198f8e0 -msgid "# Install os dependencies required for pydoop, pyhive" -msgstr "" - -#: ../../using/recipes.md:431 772338b40d48437f82d0b937e3a2fd36 -msgid "" -"apt-get update && \\ apt-get install --no-install-recommends -y build-" -"essential python-dev libsasl2-dev && \\ apt-get clean && \\ rm -rf " -"/var/lib/apt/lists/* && \\" -msgstr "" - -#: ../../using/recipes.md:435 055b1cdb84b641a0a883e02a1aebc57d -msgid "" -"# Remove the example hadoop configs and replace # with those for our " -"cluster. # Alternatively this could be mounted as a volume" -msgstr "" - -#: ../../using/recipes.md:438 5f426debd22e4ba39123b560f86a9f0a -msgid "rm -f /usr/local/hadoop-2.7.3/etc/hadoop/*" -msgstr "" - -#: ../../using/recipes.md:440 74971c0fbf8244df933d5c2186c30aa5 -msgid "" -"# Download this from ambari / cloudera manager and copy here COPY " -"example-hadoop-conf/ /usr/local/hadoop-2.7.3/etc/hadoop/" -msgstr "" - -#: ../../using/recipes.md:443 ee57ed31ab484eea8af90af9d66a8acd -msgid "" -"# Spark-Submit doesn't work unless I set the following RUN echo " -"\"spark.driver.extraJavaOptions -Dhdp.version=2.5.3.0-37\" >> " -"/usr/local/spark/conf/spark-defaults.conf && \\" -msgstr "" - -#: ../../using/recipes.md:445 36ce4cd52ce4415c93a82bcacf14462a -msgid "" -"echo \"spark.yarn.am.extraJavaOptions -Dhdp.version=2.5.3.0-37\" >> " -"/usr/local/spark/conf/spark-defaults.conf && \\ echo " -"\"spark.master=yarn\" >> /usr/local/spark/conf/spark-defaults.conf && \\" -" echo \"spark.hadoop.yarn.timeline-service.enabled=false\" >> " -"/usr/local/spark/conf/spark-defaults.conf && \\ chown -R $NB_USER:users " -"/usr/local/spark/conf/spark-defaults.conf && \\ # Create an alternative " -"HADOOP_CONF_HOME so we can mount as a volume and repoint # using ENV var " -"if needed mkdir -p /etc/hadoop/conf/ && \\ chown $NB_USER:users " -"/etc/hadoop/conf/" -msgstr "" - -#: ../../using/recipes.md:454 ../../using/recipes.md:502 -#: 6ab0dc76c192431d9160c51e2cd59624 bf9807c575dc4feb846545024e57399d -msgid "USER $NB_USER" -msgstr "" - -#: ../../using/recipes.md:456 d5e485444fee4f65a7fc2352b25ce9a8 -msgid "" -"# Install useful jupyter extensions and python libraries like : # - " -"Dashboards # - PyDoop # - PyHive RUN pip install jupyter_dashboards faker" -" && \\" -msgstr "" - -#: ../../using/recipes.md:461 ca4193a9372147728bb34a9fa90973fa -msgid "" -"jupyter dashboards quick-setup --sys-prefix && \\ pip2 install pyhive " -"pydoop thrift sasl thrift_sasl faker" -msgstr "" - -#: ../../using/recipes.md:464 7060fc3ababd4d33b4dd05c6f254a74c -msgid "" -"USER root # Ensure we overwrite the kernel config so that toree connects " -"to cluster RUN jupyter toree install --sys-prefix --spark_opts=\"--master" -" yarn --deploy-mode client --driver-memory 512m --executor-memory 512m " -"--executor-cores 1 --driver-java-options -Dhdp.version=2.5.3.0-37 --conf " -"spark.hadoop.yarn.timeline-service.enabled=false\" USER $NB_USER ```" -msgstr "" - -#: ../../using/recipes.md:470 4acea4ae894940aabc6efbbe7d4e9310 +#: ../../using/recipes.md:470 1c1290347aa04b469515b8167de07715 msgid "" "Credit: [britishbadger](https://github.com/britishbadger) from [docker-" "stacks/issues/369](https://github.com/jupyter/docker-stacks/issues/369)" msgstr "" -#: ../../using/recipes.md:473 bb5551c5be0a453ca5750b36e8ab4425 +#: ../../using/recipes.md:473 f5d3fe9d6eeb4ca9bea7f9a990369685 msgid "" -"## Run Jupyter Notebook/Lab inside an already secured environment (i.e., " +"Run Jupyter Notebook/Lab inside an already secured environment (i.e., " "with no token)" msgstr "" -#: ../../using/recipes.md:475 7054fbcb039a40cf8e86e9330872dad9 +#: ../../using/recipes.md:475 1f61bc8dfabd49aabda94fa80189051f msgid "" "(Adapted from [issue 728](https://github.com/jupyter/docker-" "stacks/issues/728))" msgstr "" -#: ../../using/recipes.md:477 919bed2bb2ab48a896bce3094afd7026 +#: ../../using/recipes.md:477 452619627fbc465798f3a07a0d224070 msgid "" "The default security is very good. There are use cases, encouraged by " "containers, where the jupyter container and the system it runs within, " @@ -1304,102 +814,46 @@ msgid "" msgstr "" # 7476a6d5eae74ecaae966e56390c096e -#: ../../using/recipes.md:482 6018064f0e62440581eca7a4e50a2689 +#: ../../using/recipes.md:482 9bfef73255e147f28b6a0e841bff3471 msgid "For jupyterlab:" msgstr "" -#: ../../using/recipes.md:484 cd6853bb01ca45fe9719399a857b8145 -msgid "" -"```bash docker run jupyter/base-notebook:6d2a05346196 start.sh jupyter " -"lab --LabApp.token='' ```" -msgstr "" - # f2efc5a0ba6b4c53b2047cc5f22bdbaa -#: ../../using/recipes.md:488 75dbba260cec46ae84c268d94777b4e3 +#: ../../using/recipes.md:488 85d6e513ea1546929ba202fdd6470477 msgid "For jupyter classic:" msgstr "" -#: ../../using/recipes.md:490 40c99a5524714c11970d67002c441e19 -msgid "" -"```bash docker run jupyter/base-notebook:6d2a05346196 start.sh jupyter " -"notebook --NotebookApp.token='' ```" -msgstr "" - -#: ../../using/recipes.md:494 55d5b01fd59c42a79ccdf7aeb153b682 -msgid "## Enable nbextension spellchecker for markdown (or any other nbextension)" +#: ../../using/recipes.md:494 fa1a069f896240acb2aea3a011519f60 +msgid "Enable nbextension spellchecker for markdown (or any other nbextension)" msgstr "" # 8ccfbcb4264f48d0b6709fe81aa0a86d -#: ../../using/recipes.md:496 99b4bd4fc0b24bf5a1b6ca73c6193903 +#: ../../using/recipes.md:496 cdc648cc30cc4d2f8bffbff4d951c8a1 msgid "NB: this works for classic notebooks only" msgstr "" -#: ../../using/recipes.md:498 3836fd7227024c9da21d250e76ad1e93 -msgid "" -"```dockerfile # Update with your base image of choice FROM jupyter" -"/minimal-notebook:latest" -msgstr "" - -#: ../../using/recipes.md:506 d9069cb708bb42fcafa3966ea7e78110 -msgid "RUN pip install jupyter_contrib_nbextensions && \\" -msgstr "" - -#: ../../using/recipes.md:505 20da8d144e034054beede7fec1a96f58 -msgid "" -"jupyter contrib nbextension install --user && \\ # can modify or enable " -"additional extensions here jupyter nbextension enable spellchecker/main " -"--user" -msgstr "" - -#: ../../using/recipes.md:510 3274b683f66641529e25dc657e4414b3 +#: ../../using/recipes.md:510 ccc948a250204c12bdf1a32b912b19dc msgid "" "Ref: [https://github.com/jupyter/docker-" "stacks/issues/675](https://github.com/jupyter/docker-stacks/issues/675)" msgstr "" -#: ../../using/recipes.md:513 ac28091f4c374d0bbb2e400571c60bfb -msgid "## Enable auto-sklearn notebooks" +#: ../../using/recipes.md:513 e18c5216753e4ce6b4c79d2a9f0023b2 +msgid "Enable auto-sklearn notebooks" msgstr "" -#: ../../using/recipes.md:515 47790b42eee244fc80d7dde221a16861 +#: ../../using/recipes.md:515 d324c045976d4d368a3cb44f999a3b85 msgid "" "Using `auto-sklearn` requires `swig`, which the other notebook images " "lack, so it cant be experimented with. Also, there is no Conda package " "for `auto-sklearn`." msgstr "" -#: ../../using/recipes.md:517 09ab496c671941ce8610d11441267a02 -msgid "" -"```dockerfile ARG BASE_CONTAINER=jupyter/scipy-notebook FROM jupyter" -"/scipy-notebook:latest" +#: ../../using/recipes.md:535 5445a002d154426ea2a35eecf2023c9a +msgid "Enable Delta Lake in Spark notebooks" msgstr "" -#: ../../using/recipes.md:523 d8b19772f191469cbc59bd49736ad8ca -msgid "" -"# autosklearn requires swig, which no other image has RUN apt-get update " -"&& \\" -msgstr "" - -#: ../../using/recipes.md:525 ad65bf9a3c9e4a91bc81c34d6e8afab1 -msgid "" -"apt-get install -y --no-install-recommends swig && \\ apt-get clean && \\" -" rm -rf /var/lib/apt/lists/*" -msgstr "" - -#: ../../using/recipes.md:530 ../../using/recipes.md:550 -#: 03d06fdd157e4d2c823cf459b3ac090d 360a567780314ab7aeb8da0700da2430 -msgid "USER $NB_UID" -msgstr "" - -#: ../../using/recipes.md:532 7429f3c8104847ee9c62f390174e27f8 -msgid "RUN pip install --quiet --no-cache-dir auto-sklearn ```" -msgstr "" - -#: ../../using/recipes.md:535 be906660de5447dd9a145d1d2e3a9b6a -msgid "## Enable Delta Lake in Spark notebooks" -msgstr "" - -#: ../../using/recipes.md:537 c91511126c244ac28024f8f9b6580623 +#: ../../using/recipes.md:537 76ba9eab0aac4af89dc2d7f21df51a03 msgid "" "Please note that the [Delta Lake](https://delta.io/) packages are only " "available for Spark version > `3.0`. By adding the properties to `spark-" @@ -1407,75 +861,41 @@ msgid "" "notebook." msgstr "" -#: ../../using/recipes.md:539 92afe1c0e3d04ae5a01005e7002f0195 -msgid "```dockerfile FROM jupyter/pyspark-notebook:latest" -msgstr "" - -#: ../../using/recipes.md:542 4bc2e7e208c5401ebe2df56fe09ad8c8 -msgid "ARG DELTA_CORE_VERSION=\"0.8.0\"" -msgstr "" - -#: ../../using/recipes.md:548 04a5ff13226841da944afa316fe789c3 -msgid "" -"RUN echo \"spark.jars.packages io.delta:delta-" -"core_2.12:${DELTA_CORE_VERSION}\" >> $SPARK_HOME/conf/spark-defaults.conf" -" && \\" -msgstr "" - -#: ../../using/recipes.md:547 a86f91f27d6743e1af6dcc3f0ad50bd3 -msgid "" -"echo 'spark.sql.extensions io.delta.sql.DeltaSparkSessionExtension' >> " -"$SPARK_HOME/conf/spark-defaults.conf && \\ echo " -"'spark.sql.catalog.spark_catalog " -"org.apache.spark.sql.delta.catalog.DeltaCatalog' >> $SPARK_HOME/conf" -"/spark-defaults.conf" -msgstr "" - -#: ../../using/recipes.md:552 df17f8aed1f64021b20e7f39618dffdb -msgid "" -"# Run pyspark and exit to trigger the download of the delta lake jars RUN" -" echo \"quit()\" > /tmp/init-delta.py && \\" -msgstr "" - -#: ../../using/recipes.md:554 04b532a8aaf5464086b511eeb4ed3f2b -msgid "spark-submit /tmp/init-delta.py && \\ rm /tmp/init-delta.py" -msgstr "" - -#: ../../using/running.md:1 fd01421ea13c4ee29d9cccb5c5ebf181 -msgid "# Running a Container" +#: ../../using/running.md:1 fff69654a5a64da29b93086b8f5f84ff +msgid "Running a Container" msgstr "" # 1f345e7a53e94439b936b3f4bbc877da # 324906e630c646b0ae10bbff6ed587fa #: ../../using/running.md:3 ../../using/selecting.md:7 -#: 3fb99b1bd42d440ab49a151e7b0bd492 d09599aa2e604ec0ba9910d5d189fce0 +#: 05c1074fac124981a52ff1ae3d9b017f 6474d7ee857f4423b7e3bcb11f5f0f30 msgid "Using one of the Jupyter Docker Stacks requires two choices:" msgstr "" # 781cbaffaea24fb08451cc83327cfa9b # 1c6c83776a3b4a27a8ed4128a0dceeb7 #: ../../using/running.md:5 ../../using/selecting.md:9 -#: 35d12eca6f534f4caa8cd7c670f55b09 b3b93b67f46543fab82579c3c231b9ae +#: 63c95e8247c64205accc2b3f8b54dbbc b063735b55054e50a613f5bfcd9921be msgid "Which Docker image you wish to use" msgstr "" # 632f67c9207e4ed9ba01bf59c4d942f7 # ab191cfc95204429b7c0271ecdf69d33 #: ../../using/running.md:6 ../../using/selecting.md:10 -#: 1d3699f067c7499ea09cb793610f4591 ea3baf467db6400ebaa3c15b1e69c994 +#: 5d412b91c73e4ca4ba2ad19773534fe7 ad09766eb2054072a8acdc08fac16d8e msgid "How you wish to start Docker containers from that image" msgstr "" # ebf870aa1ede4e2ab8fdcb2cef0fd610 -#: ../../using/running.md:8 8e21d46a45f5415287d64898560facf7 +#: ../../using/running.md:8 43dd32fd2ea04c318e1e71810f61f6d2 msgid "This section provides details about the second." msgstr "" -#: ../../using/running.md:10 03a5a436ee6345b9940e4cf05346b6cb -msgid "## Using the Docker CLI" +#: ../../using/running.md:10 b03443c9fb1746da8162f5e6dd33131b +msgid "Using the Docker CLI" msgstr "" -#: ../../using/running.md:12 c3d7243169c14da5a1f0712dfecec33d +#: ../../using/running.md:12 d7cad9de615c4b5a8a7c4438f850846e msgid "" "You can launch a local Docker container from the Jupyter Docker Stacks " "using the [Docker command line " @@ -1484,7 +904,7 @@ msgid "" "following are some common patterns." msgstr "" -#: ../../using/running.md:14 1a3b424d67ae4d3ba1bfc1f753ec4d11 +#: ../../using/running.md:14 ee3116033d884c19a51e04883dcf5c72 msgid "" "**Example 1** This command pulls the `jupyter/scipy-notebook` image " "tagged `2c80cf3537ca` from Docker Hub if it is not already present on the" @@ -1493,70 +913,14 @@ msgid "" "terminal and include a URL to the notebook server." msgstr "" -#: ../../using/running.md:16 2d54acef45c8427b842b3528b8d3fb51 -msgid "```bash $ docker run -p 8888:8888 jupyter/scipy-notebook:2c80cf3537ca" -msgstr "" - -#: ../../using/running.md:19 ba0d9e8dd6da4467a8517a3896b21936 -msgid "" -"Executing the command: jupyter notebook [I 15:33:00.567 NotebookApp] " -"Writing notebook server cookie secret to " -"/home/jovyan/.local/share/jupyter/runtime/notebook_cookie_secret [W " -"15:33:01.084 NotebookApp] WARNING: The notebook server is listening on " -"all IP addresses and not using encryption. This is not recommended. [I " -"15:33:01.150 NotebookApp] JupyterLab alpha preview extension loaded from " -"/opt/conda/lib/python3.6/site-packages/jupyterlab [I 15:33:01.150 " -"NotebookApp] JupyterLab application directory is " -"/opt/conda/share/jupyter/lab [I 15:33:01.155 NotebookApp] Serving " -"notebooks from local directory: /home/jovyan [I 15:33:01.156 NotebookApp]" -" 0 active kernels [I 15:33:01.156 NotebookApp] The Jupyter Notebook is " -"running at: [I 15:33:01.157 NotebookApp] http://[all ip addresses on your" -" system]:8888/?token=112bb073331f1460b73768c76dffb2f87ac1d4ca7870d46a [I " -"15:33:01.157 NotebookApp] Use Control-C to stop this server and shut down" -" all kernels (twice to skip confirmation). [C 15:33:01.160 NotebookApp]" -msgstr "" - -#: ../../using/running.md:31 ../../using/running.md:72 -#: ../../using/running.md:94 2a2491db953c4b17b95d213da743c753 -#: 99f7b2295d244df7aab471edb1a6b0fc aa987eeb4cb74b66884a888445fb3c00 -msgid "" -"Copy/paste this URL into your browser when you connect for the first " -"time, to login with a token:" -msgstr "" - -#: ../../using/running.md:33 66be370123f44edfa8c2ef8d5e4a6d3d -msgid "http://localhost:8888/?token=112bb073331f1460b73768c76dffb2f87ac1d4ca7870d46a" -msgstr "" - -#: ../../using/running.md:36 5be31e38ce0948ffb344759a4dc35628 +#: ../../using/running.md:36 fcb4ea6f4a2444e5bbdb7b61da9f591f 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 "" -#: ../../using/running.md:38 4bfcd62a82484d61a723c7a05f2c120e -msgid "" -"```bash # list containers $ docker ps -a CONTAINER ID IMAGE" -" COMMAND CREATED STATUS" -" PORTS NAMES d67fe77f1a84 " -"jupyter/base-notebook \"tini -- start-noteb…\" 44 seconds ago " -"Exited (0) 39 seconds ago cocky_mirzakhani" -msgstr "" - -#: ../../using/running.md:44 cbe60a2f7c614c05b16a4222c16b533f -msgid "" -"# start the stopped container $ docker start -a d67fe77f1a84 Executing " -"the command: jupyter notebook [W 16:45:02.020 NotebookApp] WARNING: The " -"notebook server is listening on all IP addresses and not using " -"encryption. This is not recommended. ..." -msgstr "" - -#: ../../using/running.md:50 dc8fb7c14ad840c6bacfd5f60bce1550 -msgid "# remove the stopped container $ docker rm d67fe77f1a84 d67fe77f1a84 ```" -msgstr "" - -#: ../../using/running.md:55 cfc68cdbbd0a426db224d450f0b105d6 +#: ../../using/running.md:55 99c6b85138bf47b0be45625ef742858a 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 " @@ -1566,43 +930,14 @@ msgid "" "container port (8888) instead of the the correct host port (10000)." msgstr "" -#: ../../using/running.md:57 5adc361574664dd7934a66a463d0e249 -msgid "" -"```bash $ docker run --rm -p 10000:8888 -v \"$PWD\":/home/jovyan/work " -"jupyter/r-notebook:e5c5a7d3e52d" -msgstr "" - -#: ../../using/running.md:60 e474faf54d054a7a877b453174c861ac -msgid "" -"Executing the command: jupyter notebook [I 19:31:09.573 NotebookApp] " -"Writing notebook server cookie secret to " -"/home/jovyan/.local/share/jupyter/runtime/notebook_cookie_secret [W " -"19:31:11.930 NotebookApp] WARNING: The notebook server is listening on " -"all IP addresses and not using encryption. This is not recommended. [I " -"19:31:12.085 NotebookApp] JupyterLab alpha preview extension loaded from " -"/opt/conda/lib/python3.6/site-packages/jupyterlab [I 19:31:12.086 " -"NotebookApp] JupyterLab application directory is " -"/opt/conda/share/jupyter/lab [I 19:31:12.117 NotebookApp] Serving " -"notebooks from local directory: /home/jovyan [I 19:31:12.117 NotebookApp]" -" 0 active kernels [I 19:31:12.118 NotebookApp] The Jupyter Notebook is " -"running at: [I 19:31:12.119 NotebookApp] http://[all ip addresses on your" -" system]:8888/?token=3b8dce890cb65570fb0d9c4a41ae067f7604873bd604f5ac [I " -"19:31:12.120 NotebookApp] Use Control-C to stop this server and shut down" -" all kernels (twice to skip confirmation). [C 19:31:12.122 NotebookApp]" -msgstr "" - -#: ../../using/running.md:74 b5bc6f00ede443229492136e745399ef -msgid "http://localhost:8888/?token=3b8dce890cb65570fb0d9c4a41ae067f7604873bd604f5ac" -msgstr "" - -#: ../../using/running.md:77 54da1bc331304e8dba6c0126ab38a866 +#: ../../using/running.md:77 a1d774589c0f4837a165d12348a1801a 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 "" -#: ../../using/running.md:79 2bdcd2568c66405fa8d961a43674d66f +#: ../../using/running.md:79 6290dd6f35dd49c3bf4edd58e3f18fc5 msgid "" "**Example 3** This command pulls the `jupyter/all-spark-notebook` image " "currently tagged `latest` from Docker Hub if an image tagged `latest` is " @@ -1611,32 +946,14 @@ msgid "" "randomly selected port." msgstr "" -#: ../../using/running.md:81 5bfce8f37d89432cadddc981cbdc558c -msgid "```bash docker run -d -P --name notebook jupyter/all-spark-notebook ```" -msgstr "" - # 9a561b9bb5944059801c71862521d66a -#: ../../using/running.md:85 e02287f91e0e4ed88e507f130fd8c738 +#: ../../using/running.md:85 a873ac5139864153ac18f7039f849cd1 msgid "" "The assigned port and notebook server token are visible using other " "Docker commands." msgstr "" -#: ../../using/running.md:87 b07f010010bd495f911cf39f0d0a88ba -msgid "" -"```bash # get the random host port assigned to the container port 8888 $ " -"docker port notebook 8888 0.0.0.0:32769" -msgstr "" - -#: ../../using/running.md:92 e677621041ee460395cb854016560146 -msgid "# get the notebook token from the logs $ docker logs --tail 3 notebook" -msgstr "" - -#: ../../using/running.md:96 00f37a8aae9f4e27888515ff4ac687b8 -msgid "http://localhost:8888/?token=15914ca95f495075c0aa7d0e060f1a78b6d94f70ea373b00" -msgstr "" - -#: ../../using/running.md:99 581fe41cb85d4e0d8bd493a6cb7143e5 +#: ../../using/running.md:99 39d97d9d0e144ad1ae28e034ecb5f5fe msgid "" "Together, the URL to visit on the host machine to access the server in " "this case is " @@ -1644,25 +961,17 @@ msgid "" msgstr "" # bf82931e197b40ad940d9969993120a2 -#: ../../using/running.md:101 e0ba04a126454b7a83de8a0ffcbf23c1 +#: ../../using/running.md:101 6641ea51db2f4025b9934296ac952ea3 msgid "" "The container runs in the background until stopped and/or removed by " "additional Docker commands." msgstr "" -#: ../../using/running.md:103 916481d420bb4fbe9bc01ef6c8bd4958 -msgid "```bash # stop the container docker stop notebook notebook" +#: ../../using/running.md:113 c62e610b115d4fe2ad0828a107b8a81e +msgid "Using Binder" msgstr "" -#: ../../using/running.md:108 18e9abbbe09448929f3dcbfcb367c787 -msgid "# remove the container permanently docker rm notebook notebook ```" -msgstr "" - -#: ../../using/running.md:113 c02c548917284847bd387d267c19897b -msgid "## Using Binder" -msgstr "" - -#: ../../using/running.md:115 49e73c045caa40f98cefd583e243e98f +#: ../../using/running.md:115 13d29b61d9fa49179ce31dd9b15fb761 msgid "" "[Binder](https://mybinder.org/) is a service that allows you to create " "and share custom computing environments for projects in version control. " @@ -1676,11 +985,11 @@ msgid "" "instructions." msgstr "" -#: ../../using/running.md:117 efa84bebc24a43d3a1f0c32353e0eeac -msgid "## Using JupyterHub" +#: ../../using/running.md:117 39e44212ccf749c2a726bec47a02126c +msgid "Using JupyterHub" msgstr "" -#: ../../using/running.md:119 09eff7f5da834c93b3bb19dcd57f2aae +#: ../../using/running.md:119 7fa49b0ef3614d7eaf7a43c59f2d7bc4 msgid "" "You can configure JupyterHub to launcher Docker containers from the " "Jupyter Docker Stacks images. If you've been following the [Zero to " @@ -1694,11 +1003,11 @@ msgid "" "[dockerspawner](https://github.com/jupyterhub/dockerspawner) instead." msgstr "" -#: ../../using/running.md:121 29c19df515754a5bab4c3e2a7d9ddd08 -msgid "## Using Other Tools and Services" +#: ../../using/running.md:121 ca83b75aac9343378018a1d39ade960a +msgid "Using Other Tools and Services" msgstr "" -#: ../../using/running.md:123 39b3b002ea58412eb09426f4e5747a85 +#: ../../using/running.md:123 929c925424244c8a9fce6adfc130980b msgid "" "You can use the Jupyter Docker Stacks with any Docker-compatible " "technology (e.g., [Docker Compose](https://docs.docker.com/compose/), " @@ -1708,32 +1017,32 @@ msgid "" "containers from these images." msgstr "" -#: ../../using/selecting.md:1 c67550a2b9e64aeeb48ba8d37956efb5 -msgid "# Selecting an Image" +#: ../../using/selecting.md:1 ddf2c4e8b631454495bf4d5c34094ed9 +msgid "Selecting an Image" msgstr "" -#: ../../using/selecting.md:3 2a1dceb1111d4066bd0d740b63b93e4b +#: ../../using/selecting.md:3 2e24f8b41b2e495ea8218bee2914406e msgid "[Core Stacks](#core-stacks)" msgstr "" -#: ../../using/selecting.md:4 d760a840553d41f2a32e18e2d79cb837 +#: ../../using/selecting.md:4 d6a41f48ed9347a993540f589e0d855d msgid "[Image Relationships](#image-relationships)" msgstr "" -#: ../../using/selecting.md:5 e39909d1ad694ef5863ae287d7b35bcf +#: ../../using/selecting.md:5 a2ba142cbebb4399a938704a882fa661 msgid "[Community Stacks](#community-stacks)" msgstr "" # af7e19bb10ec44348e8121be4129ce8a -#: ../../using/selecting.md:12 0a3115d8552543f4967ce5be80e09452 +#: ../../using/selecting.md:12 f5633235fac045108e7d19f1407676f5 msgid "This section provides details about the first." msgstr "" -#: ../../using/selecting.md:14 a08f857cf1c34ed396f754a38f4512d2 -msgid "## Core Stacks" +#: ../../using/selecting.md:14 417db50388304fbf93ffea29e6cb1489 +msgid "Core Stacks" msgstr "" -#: ../../using/selecting.md:16 0a716cc671b6466c85c279e1ede7b424 +#: ../../using/selecting.md:16 4d6fb902db7a4f4ea9494c86ecc201cb msgid "" "The Jupyter team maintains a set of Docker image definitions in the " "[https://github.com/jupyter/docker-stacks](https://github.com/jupyter" @@ -1741,11 +1050,11 @@ msgid "" "images including their contents, relationships, and versioning strategy." msgstr "" -#: ../../using/selecting.md:21 551432ac326245558fec6b4d899ae2df -msgid "### jupyter/base-notebook" +#: ../../using/selecting.md:21 e6d848a6b77a460ab6f276a80e41c870 +msgid "jupyter/base-notebook" msgstr "" -#: ../../using/selecting.md:23 6fe22cc95947469898de734366344177 +#: ../../using/selecting.md:23 cf44e43886dc4584800594ea32124c39 msgid "" "[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/master" "/base-notebook) | [Dockerfile commit history](https://github.com/jupyter" @@ -1753,67 +1062,76 @@ msgid "" "image tags](https://hub.docker.com/r/jupyter/base-notebook/tags/)" msgstr "" -#: ../../using/selecting.md:27 038b9ef51cc04d06b577c348db557e55 +#: ../../using/selecting.md:27 8e636422039d45dea6ce43d71c8c6cdc msgid "" "`jupyter/base-notebook` is a small image supporting the [options common " "across all core stacks](common.md). It is the basis for all other stacks." msgstr "" -#: ../../using/selecting.md:30 5433ce1fdfae4b338a5d653957f5494d +#: ../../using/selecting.md:30 2e5299035bf74355a5a096a1e4a2ddd8 msgid "" "Minimally-functional Jupyter Notebook server (e.g., no LaTeX support for " "saving notebooks as PDFs)" msgstr "" -#: ../../using/selecting.md:31 32bcb2c27ab54df7a2215ac383270fc2 +#: ../../using/selecting.md:31 55c67a8090de4e5bab31ae6edcafff09 msgid "" "[Miniforge](https://github.com/conda-forge/miniforge) Python 3.x in " -"`/opt/conda` with two package managers - " +"`/opt/conda` with two package managers" +msgstr "" + +#: ../../using/selecting.md:32 4e614abb0d4941b5a7ad77ddf24cd6b1 +msgid "" "[conda](https://github.com/conda/conda): \"cross-platform, language-" -"agnostic binary package manager\". - [mamba](https://github.com/mamba-" -"org/mamba): \"reimplementation of the conda package manager in C++\"." +"agnostic binary package manager\"." +msgstr "" + +#: ../../using/selecting.md:33 0c0ab638ece249fd85033751ea782d53 +msgid "" +"[mamba](https://github.com/mamba-org/mamba): \"reimplementation of the " +"conda package manager in C++\"." msgstr "" # c5732a5536554f91b8dd7e8946beaab8 -#: ../../using/selecting.md:34 1673e0b5f34c47948109db0a2036c125 +#: ../../using/selecting.md:34 25b68bbc8a7f4224930ab59d76cb3434 msgid "No preinstalled scientific computing packages" msgstr "" -#: ../../using/selecting.md:35 5ca09ce0233f463a8d71ee464e0dfa55 +#: ../../using/selecting.md:35 35436cff1c574874a8c22cef8b4593a4 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 "" -#: ../../using/selecting.md:37 b61a4f0053954e3793574eaefa3d4ce3 +#: ../../using/selecting.md:37 1759a8b60af24020a4bbed8928104a59 msgid "" "`tini` as the container entrypoint and a `start-notebook.sh` script as " "the default command" msgstr "" -#: ../../using/selecting.md:38 33f5e77665294f708c6bf104365d8f40 +#: ../../using/selecting.md:38 9ce3b72da53b4c88bbff215af83462b4 msgid "" "A `start-singleuser.sh` script useful for launching containers in " "JupyterHub" msgstr "" -#: ../../using/selecting.md:39 6963a1cd7f774700a2bfa1020263ebdc +#: ../../using/selecting.md:39 7a47003602ec442989b7eb891f1e1758 msgid "" "A `start.sh` script useful for running alternative commands in the " "container (e.g. `ipython`, `jupyter kernelgateway`, `jupyter lab`)" msgstr "" # 075e6ffe0f5b4d508d555992f5dd6fe1 -#: ../../using/selecting.md:41 1b7385b2c4ae4742abd2c6a01ba10041 +#: ../../using/selecting.md:41 2ced2dfdc1c34f9db940c25d7c86dae8 msgid "Options for a self-signed HTTPS certificate and passwordless sudo" msgstr "" -#: ../../using/selecting.md:43 f2fd2c13e0c6404fa07594c47e649218 -msgid "### jupyter/minimal-notebook" +#: ../../using/selecting.md:43 08dbc66b267e41ceaca81c85394b48fe +msgid "jupyter/minimal-notebook" msgstr "" -#: ../../using/selecting.md:45 41a2a0ba9a0b4d12bd71bced77f8a3be +#: ../../using/selecting.md:45 ac03cfc1ce9f4f3d8af9ccc68b9de7d1 msgid "" "[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/master" "/minimal-notebook) | [Dockerfile commit " @@ -1822,32 +1140,32 @@ msgid "" "tags](https://hub.docker.com/r/jupyter/minimal-notebook/tags/)" msgstr "" -#: ../../using/selecting.md:49 d7fc36aead894ca99c18f7085136a7f2 +#: ../../using/selecting.md:49 0a9dd43d10a942f381bcab5b8397f76e msgid "" "`jupyter/minimal-notebook` adds command line tools useful when working in" " Jupyter applications." msgstr "" -#: ../../using/selecting.md:51 9d976186f3fa4f719e5d3ab4d878861e +#: ../../using/selecting.md:51 6202e61245eb4df4812aa148e0e4fb92 msgid "Everything in `jupyter/base-notebook`" msgstr "" -#: ../../using/selecting.md:52 61738ffdb03747f6b2b050a5e3f44754 +#: ../../using/selecting.md:52 d22c559bcadd4b8b947f0b046030cbf9 msgid "[TeX Live](https://www.tug.org/texlive/) for notebook document conversion" msgstr "" -#: ../../using/selecting.md:53 fc4c419a3a0547ed8620d87d75bd3d69 +#: ../../using/selecting.md:53 f234d65723df444eab9959168f733764 msgid "" "[git](https://git-scm.com/), [vi](https://www.vim.org) (actually `vim-" "tiny`), [nano](https://www.nano-editor.org/) (actually `nano-tiny`), " "tzdata, and unzip" msgstr "" -#: ../../using/selecting.md:57 e656263aba364bed9bc856c6e0c9b4fc -msgid "### jupyter/r-notebook" +#: ../../using/selecting.md:57 d34ceef2155745a5b74ddb4c62a26e44 +msgid "jupyter/r-notebook" msgstr "" -#: ../../using/selecting.md:59 ade251ee1e2a48ed9d4d216b864aa8df +#: ../../using/selecting.md:59 6aba8788eac84797835fdb3e25d18397 msgid "" "[Source on GitHub](https://github.com/jupyter/docker-" "stacks/tree/master/r-notebook) | [Dockerfile commit " @@ -1856,33 +1174,33 @@ msgid "" "tags](https://hub.docker.com/r/jupyter/r-notebook/tags/)" msgstr "" -#: ../../using/selecting.md:63 89e9ab85127541d5b4f5dc811ba9289c +#: ../../using/selecting.md:63 2996309f935e4af29910d907d7e2e452 msgid "`jupyter/r-notebook` includes popular packages from the R ecosystem." msgstr "" #: ../../using/selecting.md:65 ../../using/selecting.md:88 -#: 2f5f27ac800547d4bae6c5b8bac96c0f 59b5190ebc3848cf9652ecae5e0f1786 +#: b7f68cfd7caf407fafaa07de3a1952d2 f6c3d75c77a54d6cbf649deb150d9330 msgid "Everything in `jupyter/minimal-notebook` and its ancestor images" msgstr "" -#: ../../using/selecting.md:66 1f120778a28a4b29b2770dec881b9eea +#: ../../using/selecting.md:66 f9c9d1534d634b34b7d08b98180bca3a msgid "The [R](https://www.r-project.org/) interpreter and base environment" msgstr "" #: ../../using/selecting.md:67 ../../using/selecting.md:157 -#: 137a4ba896a4495cadfe48870f63b20d ab48cf52d3034a37bc08173a6f9fcd76 +#: 422412172d014761af941501664610dc 4e43cc04e069429c9676fae7e189468d msgid "" "[IRKernel](https://irkernel.github.io/) to support R code in Jupyter " "notebooks" msgstr "" -#: ../../using/selecting.md:68 3f122ef102fc451ca18d211cbf30f4f7 +#: ../../using/selecting.md:68 d7a1e470f7234838919b0b80d68a174c msgid "" "[tidyverse](https://www.tidyverse.org/) packages from [conda-forge](https" "://conda-forge.github.io/feedstocks)" msgstr "" -#: ../../using/selecting.md:70 a0f3e41713744fada541bc07b9b3d52d +#: ../../using/selecting.md:70 e4e9262bcfc542869872138998de3736 msgid "" "[devtools](https://cran.r-project.org/web/packages/devtools/index.html), " "[shiny](https://shiny.rstudio.com/), " @@ -1897,11 +1215,11 @@ msgid "" " packages from [conda-forge](https://conda-forge.github.io/feedstocks)" msgstr "" -#: ../../using/selecting.md:80 de325c0741394389bd42a6786db5f25d -msgid "### jupyter/scipy-notebook" +#: ../../using/selecting.md:80 2083a995e57c4505bc129119ae699bb4 +msgid "jupyter/scipy-notebook" msgstr "" -#: ../../using/selecting.md:82 f9ef43f443fa4886985c9356c629ee0f +#: ../../using/selecting.md:82 ee178f271dd94e5c8a15dd1977c04059 msgid "" "[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/master" "/scipy-notebook) | [Dockerfile commit history](https://github.com/jupyter" @@ -1909,13 +1227,13 @@ msgid "" "image tags](https://hub.docker.com/r/jupyter/scipy-notebook/tags/)" msgstr "" -#: ../../using/selecting.md:86 22bffea209144173b3aceb37bd4f8213 +#: ../../using/selecting.md:86 6515a8a003fc49ffb1ab797d6bfdd651 msgid "" "`jupyter/scipy-notebook` includes popular packages from the scientific " "Python ecosystem." msgstr "" -#: ../../using/selecting.md:89 f7e8c1797c344dd6946adff31b8dc9e6 +#: ../../using/selecting.md:89 04e8470d60a645fc9f680986534ccf49 msgid "" "[dask](https://dask.org/), [pandas](https://pandas.pydata.org/), " "[numexpr](https://github.com/pydata/numexpr), " @@ -1939,24 +1257,24 @@ msgid "" "[pytables](https://www.pytables.org/) packages" msgstr "" -#: ../../using/selecting.md:104 c8b327bbba59452cb4ee6213538a3d76 +#: ../../using/selecting.md:104 25aded99273d4caea79222622e2e9782 msgid "" "[ipywidgets](https://ipywidgets.readthedocs.io/en/stable/) and " "[ipympl](https://github.com/matplotlib/jupyter-matplotlib) for " "interactive visualizations and plots in Python notebooks" msgstr "" -#: ../../using/selecting.md:107 dc55948dc77e46ff96e18f16418ed4ce +#: ../../using/selecting.md:107 b4231786cf8a463080bfcc497f2b508a msgid "" "[Facets](https://github.com/PAIR-code/facets) for visualizing machine " "learning datasets" msgstr "" -#: ../../using/selecting.md:109 940c252f508747038206a99f6fdfd12e -msgid "### jupyter/tensorflow-notebook" +#: ../../using/selecting.md:109 2fcae1cae279413ea8c66c379b2f5eb9 +msgid "jupyter/tensorflow-notebook" msgstr "" -#: ../../using/selecting.md:111 ed7d2db034e749e78060659aa693a1b0 +#: ../../using/selecting.md:111 79710429bac34837b3c9fb0e91ac7867 msgid "" "[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/master" "/tensorflow-notebook) | [Dockerfile commit " @@ -1965,28 +1283,28 @@ msgid "" "tags](https://hub.docker.com/r/jupyter/tensorflow-notebook/tags/)" msgstr "" -#: ../../using/selecting.md:115 cea907e3dbde4ffea06e9acb63d83220 +#: ../../using/selecting.md:115 abefecb835f74e2d9549900a5ebdb370 msgid "" "`jupyter/tensorflow-notebook` includes popular Python deep learning " "libraries." msgstr "" #: ../../using/selecting.md:117 ../../using/selecting.md:145 -#: 31fc2715bdd74c4f839ef2894d9bd204 f14ff84a805b45caacb576eb3de9a40a +#: 8eecab0168114154af2e1ab9d87b8c88 cc0137c6f53349609b970041dccba925 msgid "Everything in `jupyter/scipy-notebook` and its ancestor images" msgstr "" -#: ../../using/selecting.md:118 e2a94e358ea043a19b4ab1657e768210 +#: ../../using/selecting.md:118 aab55c881b9d488493284b16c9881046 msgid "" "[tensorflow](https://www.tensorflow.org/) and [keras](https://keras.io/) " "machine learning libraries" msgstr "" -#: ../../using/selecting.md:121 855f0b14bd5e4341b1c6a89af60c0543 -msgid "### jupyter/datascience-notebook" +#: ../../using/selecting.md:121 11ab0ad065014a79aeda1dc3c9747373 +msgid "jupyter/datascience-notebook" msgstr "" -#: ../../using/selecting.md:123 30609ac1769b4caf914325d4d363bc01 +#: ../../using/selecting.md:123 c0f153b97f1442ed85681cdb30f28314 msgid "" "[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/master" "/datascience-notebook) | [Dockerfile commit " @@ -1995,40 +1313,40 @@ msgid "" "tags](https://hub.docker.com/r/jupyter/datascience-notebook/tags/)" msgstr "" -#: ../../using/selecting.md:127 929dfa9d16fa499ebc35d2545cf010df +#: ../../using/selecting.md:127 b1c9a1f3f34a4682b5abead3573f3616 msgid "" "`jupyter/datascience-notebook` includes libraries for data analysis from " "the Julia, Python, and R communities." msgstr "" -#: ../../using/selecting.md:130 95225d7dd82342fc860626c0d694cce2 +#: ../../using/selecting.md:130 e2bd628f21e746e081cf30ee27f0a08c msgid "" "Everything in the `jupyter/scipy-notebook` and `jupyter/r-notebook` " "images, and their ancestor images" msgstr "" -#: ../../using/selecting.md:132 43185495339f4d458a95ae26604b749b +#: ../../using/selecting.md:132 781e79d904054fd0ad782952c26a9e11 msgid "The [Julia](https://julialang.org/) compiler and base environment" msgstr "" -#: ../../using/selecting.md:133 dc1318ee425b43179edfba40d3ecabd4 +#: ../../using/selecting.md:133 46952f7528894018b8d0464f0d94729c msgid "" "[IJulia](https://github.com/JuliaLang/IJulia.jl) to support Julia code in" " Jupyter notebooks" msgstr "" -#: ../../using/selecting.md:134 7a6cc91e841b4064aaced1f926475e92 +#: ../../using/selecting.md:134 a42804078829405a870b50fa83cb44af msgid "" "[HDF5](https://github.com/JuliaIO/HDF5.jl), " "[Gadfly](http://gadflyjl.org/stable/), and " "[RDatasets](https://github.com/johnmyleswhite/RDatasets.jl) packages" msgstr "" -#: ../../using/selecting.md:137 59e3c8a417a64abc98f01f9e81bbe951 -msgid "### jupyter/pyspark-notebook" +#: ../../using/selecting.md:137 11f15d7660a34c45a1727becf4823c8c +msgid "jupyter/pyspark-notebook" msgstr "" -#: ../../using/selecting.md:139 d7474a65b43b4766b25e39f6864f2970 +#: ../../using/selecting.md:139 b93b45241d894f9fbdd0131d9cea12c2 msgid "" "[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/master" "/pyspark-notebook) | [Dockerfile commit " @@ -2037,19 +1355,19 @@ msgid "" "tags](https://hub.docker.com/r/jupyter/pyspark-notebook/tags/)" msgstr "" -#: ../../using/selecting.md:143 fd24a09405114e469ce53309bd487f1e +#: ../../using/selecting.md:143 0b6fe00c827d4b578a2619a949983d2e msgid "`jupyter/pyspark-notebook` includes Python support for Apache Spark." msgstr "" -#: ../../using/selecting.md:146 ce4f3c7ca83f417c8121d1f5951e64f0 +#: ../../using/selecting.md:146 17928a4f82934aebacf4684b1a913cf8 msgid "[Apache Spark](https://spark.apache.org/) with Hadoop binaries" msgstr "" -#: ../../using/selecting.md:148 5c289a439bb142cb884d72fc00cbbbdf -msgid "### jupyter/all-spark-notebook" +#: ../../using/selecting.md:148 882cc9ec46fe43e9ab019a976d13d111 +msgid "jupyter/all-spark-notebook" msgstr "" -#: ../../using/selecting.md:150 e20836ea63e8491faf96256fc98e2053 +#: ../../using/selecting.md:150 5bb6c5bcf44741dc95e39f8f1bf5474e msgid "" "[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/master" "/all-spark-notebook) | [Dockerfile commit " @@ -2058,24 +1376,24 @@ msgid "" "tags](https://hub.docker.com/r/jupyter/all-spark-notebook/tags/)" msgstr "" -#: ../../using/selecting.md:154 520b59cd9724427ea2af5f65a7261e02 +#: ../../using/selecting.md:154 4663c64fc589419f9fa6237802bf98c6 msgid "" "`jupyter/all-spark-notebook` includes Python, R, and Scala support for " "Apache Spark." msgstr "" -#: ../../using/selecting.md:156 656acd905b0a410e93844f0f372c3a57 +#: ../../using/selecting.md:156 88ac4e9d6cd6463f8f55f42dcedc4abb msgid "Everything in `jupyter/pyspark-notebook` and its ancestor images" msgstr "" -#: ../../using/selecting.md:158 953d11d8cea144c7af11e8d1ed59ed2b +#: ../../using/selecting.md:158 5e5819c0e2e44f1ab4fce0f150b8ce9a msgid "" "[Apache Toree](https://toree.apache.org/) and [spylon-" "kernel](https://github.com/maxpoint/spylon-kernel) to support Scala code " "in Jupyter notebooks" msgstr "" -#: ../../using/selecting.md:161 b3004ef48a4b4adb9cc9ccf50febeb09 +#: ../../using/selecting.md:161 3ae8900f3aaf41329387eeec8a4c9a22 msgid "" "[ggplot2](https://ggplot2.tidyverse.org), " "[sparklyr](http://spark.rstudio.com/), and " @@ -2083,11 +1401,11 @@ msgid "" "packages" msgstr "" -#: ../../using/selecting.md:164 37ab1dcbb56a49a6a71319d40d8e8a62 -msgid "### Image Relationships" +#: ../../using/selecting.md:164 d268ff37cc9d4b299fb2df203e2f4579 +msgid "Image Relationships" msgstr "" -#: ../../using/selecting.md:166 719ef21645aa42c18822e39e3d0e4bb0 +#: ../../using/selecting.md:166 84d7369b0bcb49ef8911b089b13a6107 msgid "" "The following diagram depicts the build dependency tree of the core " "images. (i.e., the `FROM` statements in their Dockerfiles). Any given " @@ -2095,7 +1413,7 @@ msgid "" "it." msgstr "" -#: ../../using/selecting.md:170 ba5ae0294d054a079770e65424d749f9 +#: ../../using/selecting.md:170 d01ff3f48a7943edaba6fd76aaf2e0c0 msgid "" "[![Image inheritance " "diagram](../images/inherit.svg)](http://interactive.blockdiag.com/?compression=deflate&src" @@ -2104,11 +1422,11 @@ msgid "" "Zh7Z24OLLq2SjaxpvP10lX35vCf6pOxELFmUbQiUz4oQhYzMc3gCrRt2cWe_FKosmSjyFHC6OS1AwdQWCtyj7sfh523_BI9hKlQ25YdOFdv5fcH0kiEMA)" msgstr "" -#: ../../using/selecting.md:173 b8b3e0e17adf437fb6107aca31996017 -msgid "### Builds" +#: ../../using/selecting.md:173 bbe858a2bd6446f782204123c0144843 +msgid "Builds" msgstr "" -#: ../../using/selecting.md:175 5bee0d0af6114c8aa237f5a04ee55d44 +#: ../../using/selecting.md:175 f7524f64f4ba4bc487c6d8e3461cd2e4 msgid "" "Pull requests to the `jupyter/docker-stacks` repository trigger builds of" " all images on GitHub Actions. These images are for testing purposes only" @@ -2117,18 +1435,18 @@ msgid "" "Docker Hub." msgstr "" -#: ../../using/selecting.md:180 276192f9ebc747f09f967760a791ee40 -msgid "### Versioning" +#: ../../using/selecting.md:180 3ff3096a94d64782a9f8bc85af1896cd +msgid "Versioning" msgstr "" -#: ../../using/selecting.md:182 1d7ce792205d4804886ab9d92ca5a6d1 +#: ../../using/selecting.md:182 c9028dbb618f49d6bf3978d28b82ce84 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 "" -#: ../../using/selecting.md:185 da6b448ac42f4b53861ec2c2fa105dc4 +#: ../../using/selecting.md:185 8a2767fce64041eeb3e97ced4afa33a1 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 " @@ -2139,7 +1457,7 @@ msgid "" "stacks/tree/7c45ec67c8e7))." msgstr "" -#: ../../using/selecting.md:191 d4cb7c291bcc4e909781e7f7426fd4da +#: ../../using/selecting.md:191 a3a0c3928c354c2eb91aac8c891309f5 msgid "" "You must refer to git-SHA image tags when stability and reproducibility " "are important in your work. (e.g. `FROM jupyter/scipy-" @@ -2149,12 +1467,12 @@ msgid "" "library in a notebook)." msgstr "" -#: ../../using/selecting.md:197 a2251150e31347c8befff6ddaa1658bf -msgid "## Community Stacks" +#: ../../using/selecting.md:197 58e6584e971b406988a54ed5671a92ad +msgid "Community Stacks" msgstr "" # a448d28293544f72b0e5de024b0a1ef5 -#: ../../using/selecting.md:199 6f774547897347529077094caf820ace +#: ../../using/selecting.md:199 a1e39607bdbe4aca8182476ccef6ec86 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 " @@ -2162,7 +1480,7 @@ msgid "" "them below." msgstr "" -#: ../../using/selecting.md:203 d54d965036cd47408108a969e459d4cc +#: ../../using/selecting.md:203 1b5ef8d9252d4b849ea151ff10f87265 msgid "" "[csharp-notebook is a community Jupyter Docker Stack image. Try C# in " "Jupyter Notebooks](https://github.com/tlinnet/csharp-notebook). The image" @@ -2172,7 +1490,7 @@ msgid "" "/csharp-notebook/master)." msgstr "" -#: ../../using/selecting.md:208 044210f3ae8e45379e0debeb635846a1 +#: ../../using/selecting.md:208 2e551c8f10534df5b21bc27163426760 msgid "" "[education-notebook is a community Jupyter Docker Stack " "image](https://github.com/umsi-mads/education-notebook). The image " @@ -2182,11 +1500,11 @@ msgid "" "/umsi-mads/education-notebook/master)." msgstr "" -#: ../../using/selecting.md:213 eba805c780f342409504f7738701545d +#: ../../using/selecting.md:213 933c1f8521e94b939c55d94edd23170c msgid "**crosscompass/ihaskell-notebook**" msgstr "" -#: ../../using/selecting.md:215 2bf255e9bdf446d18650ccd1ce7f0586 +#: ../../using/selecting.md:215 cda19100240442be863e632d9b14be49 msgid "" "[Source on GitHub](https://github.com/jamesdbrock/ihaskell-notebook) | " "[Dockerfile commit history](https://github.com/jamesdbrock/ihaskell-" @@ -2194,14 +1512,14 @@ msgid "" "tags](https://hub.docker.com/r/crosscompass/ihaskell-notebook/tags)" msgstr "" -#: ../../using/selecting.md:219 aba3275f84844ffe8e322afb809035b9 +#: ../../using/selecting.md:219 9fdfdc7e8699445da6741fb990e00c4c msgid "" "`crosscompass/ihaskell-notebook` is based on " "[IHaskell](https://github.com/gibiansky/IHaskell). Includes popular " "packages and example notebooks." msgstr "" -#: ../../using/selecting.md:222 8392c240abd24d5aba656bd9c0bd1c24 +#: ../../using/selecting.md:222 2cf4111187964220a9877b220009901c msgid "" "Try it on " "[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/jamesdbrock" @@ -2209,7 +1527,7 @@ msgid "" "notebook/master?urlpath=lab/tree/ihaskell_examples/ihaskell/IHaskell.ipynb)" msgstr "" -#: ../../using/selecting.md:225 940587bd2d9742c796cd7d985db16c3b +#: ../../using/selecting.md:225 aed16a76070f41d7a87c0539ec88218b msgid "" "[java-notebook is a community Jupyter Docker Stack " "image](https://github.com/jbindinga/java-notebook). The image includes " @@ -2219,7 +1537,7 @@ msgid "" "/java-notebook/master)." msgstr "" -#: ../../using/selecting.md:230 11fe154abfcf454988ed2a6da9d2d867 +#: ../../using/selecting.md:230 94b147ddc61d468587c25f519a5a36c1 msgid "" "[sage-notebook](https://github.com/sharpTrick/sage-notebook) is a " "community Jupyter Docker Stack image with the " @@ -2229,7 +1547,7 @@ msgid "" "/sage-notebook/master)." msgstr "" -#: ../../using/selecting.md:235 33dc16e6ac4b4e17b6b3b2912c75dbe5 +#: ../../using/selecting.md:235 f03a47b9888e410a85f03e8f6f1e2770 msgid "" "[GPU-Jupyter](https://github.com/iot-salzburg/gpu-jupyter/): Leverage " "Jupyter Notebooks with the power of your NVIDIA GPU and perform GPU " @@ -2240,7 +1558,7 @@ msgid "" "**Keras** and **PyTorch** on top of it." msgstr "" -#: ../../using/selecting.md:241 7f970e05f88c4b55a41bad20082f2a3f +#: ../../using/selecting.md:241 57dcccffd0ef45c092d553da8274f992 msgid "" "[PRP GPU Jupyter repo](https://gitlab.nautilus.optiputer.net/prp/jupyter-" "stack/-/tree/prp) and " @@ -2252,7 +1570,7 @@ msgid "" "proxy." msgstr "" -#: ../../using/selecting.md:243 438d22181a1848448c24b4a78b625d56 +#: ../../using/selecting.md:243 d92076eb869d4034b8e40b6e95603231 msgid "" "[cgspatial-notebook](https://github.com/SCiO-systems/cgspatial-notebook) " "is a community Jupyter Docker Stack image. The image includes major " @@ -2262,7 +1580,7 @@ msgid "" "/SCiO-systems/cgspatial-notebook/master)" msgstr "" -#: ../../using/selecting.md:248 0a2d7bd5000b4f19a150795798d61051 +#: ../../using/selecting.md:248 ba30b667c43b40ad9cc9c1a1d6e56365 msgid "" "[kotlin-notebook](https://github.com/knonm/kotlin-notebook) is a " "community Jupyter Docker Stack image. The image includes [Kotlin kernel " @@ -2272,30 +1590,30 @@ msgid "" "/kotlin-notebook/main)" msgstr "" -#: ../../using/selecting.md:253 bf37ebbababb495e8e3ad5dde5da5aa2 +#: ../../using/selecting.md:253 cb15515160194bc99862b6668f54e7d0 msgid "" "See the [contributing guide](../contributing/stacks.md) for information " "about how to create your own Jupyter Docker Stack." msgstr "" -#: ../../using/specifics.md:1 6eb122a4d5214cf79cf1c18ab87443a3 -msgid "# Image Specifics" +#: ../../using/specifics.md:1 614f497eb4974af0b051eab0f966023c +msgid "Image Specifics" msgstr "" # 06b0d21a881140a29e17e5b9fa5598ab -#: ../../using/specifics.md:3 ff41fc78829143af8c5fae0ed662a2e1 +#: ../../using/specifics.md:3 2eabaf40434a4b6eb131bcd779ea5efc msgid "This page provides details about features specific to one or more images." msgstr "" -#: ../../using/specifics.md:5 4f0044d31abd48d0a1eed222551fb8ed -msgid "## Apache Spark™" +#: ../../using/specifics.md:5 1e4fbbbbf0484b1aadedbe1b4336e339 +msgid "Apache Spark™" msgstr "" -#: ../../using/specifics.md:7 e404a9f872fc4706b18ac80c159ca59e -msgid "### Specific Docker Image Options" +#: ../../using/specifics.md:7 4abcdc88f63f4c458349454c092b83e0 +msgid "Specific Docker Image Options" msgstr "" -#: ../../using/specifics.md:9 25e84d79adc24bd086d22cabe8c7e36d +#: ../../using/specifics.md:9 72a77e874d9046c68bd1cfb935ff7da0 msgid "" "`-p 4040:4040` - The `jupyter/pyspark-notebook` and `jupyter/all-spark-" "notebook` images open [SparkUI (Spark Monitoring and Instrumentation " @@ -2307,74 +1625,59 @@ msgid "" "8888:8888 -p 4040:4040 -p 4041:4041 jupyter/pyspark-notebook`." msgstr "" -#: ../../using/specifics.md:11 c0e92fe91ae843f59948e3b61c77a924 -msgid "### Build an Image with a Different Version of Spark" +#: ../../using/specifics.md:11 4b849803db3f45fa971e43501fed54fc +msgid "Build an Image with a Different Version of Spark" msgstr "" -#: ../../using/specifics.md:13 f56c65a8b6c24d6c96f04e025d079673 +#: ../../using/specifics.md:13 d2a39ecf92a44574a8f99d79e9d3e94d msgid "" "You can build a `pyspark-notebook` image (and also the downstream `all-" "spark-notebook` image) with a different version of Spark by overriding " "the default value of the following arguments at build time." msgstr "" -#: ../../using/specifics.md:15 379949d1a9ff4de1b1f149ba1aad6a4f +#: ../../using/specifics.md:15 dbd0c3c196294df097a75a0bef343817 msgid "" "Spark distribution is defined by the combination of the Spark and the " "Hadoop version and verified by the package checksum, see [Download Apache" " Spark](https://spark.apache.org/downloads.html) and the [archive " -"repo](https://archive.apache.org/dist/spark/) for more information. * " -"`spark_version`: The Spark version to install (`3.0.0`). * " -"`hadoop_version`: The Hadoop version (`3.2`). * `spark_checksum`: The " -"package checksum (`BFE4540...`)." +"repo](https://archive.apache.org/dist/spark/) for more information." msgstr "" -#: ../../using/specifics.md:19 93828386335d42df9fc7299ab1e6eaed +#: ../../using/specifics.md:16 cd2c1509b6c347bbaa126141d35055b8 +msgid "`spark_version`: The Spark version to install (`3.0.0`)." +msgstr "" + +#: ../../using/specifics.md:17 e36c801f221e41acacb1d4d9a203a6ea +msgid "`hadoop_version`: The Hadoop version (`3.2`)." +msgstr "" + +#: ../../using/specifics.md:18 816474812c8b404487c02ab132e787db +msgid "`spark_checksum`: The package checksum (`BFE4540...`)." +msgstr "" + +#: ../../using/specifics.md:19 5619e4cdbf374ed18733ae5c53a51e34 +msgid "Spark can run with different OpenJDK versions." +msgstr "" + +#: ../../using/specifics.md:20 0e62a66543894cdb9651a1f22e6550aa msgid "" -"Spark can run with different OpenJDK versions. * `openjdk_version`: The " -"version of (JRE headless) the OpenJDK distribution (`11`), see [Ubuntu " +"`openjdk_version`: The version of (JRE headless) the OpenJDK distribution" +" (`11`), see [Ubuntu " "packages](https://packages.ubuntu.com/search?keywords=openjdk)." msgstr "" -#: ../../using/specifics.md:22 e2d6a2b5bb044499b18c9cf5988956b1 +#: ../../using/specifics.md:22 5d8f762319874b9ea2ff2373796a1855 msgid "" "For example here is how to build a `pyspark-notebook` image with Spark " "`2.4.6`, Hadoop `2.7` and OpenJDK `8`." msgstr "" -#: ../../using/specifics.md:24 23a5958675304657aaa60fba6862bf91 -msgid "" -"```bash # From the root of the project # Build the image with different " -"arguments docker build --rm --force-rm \\" +#: ../../using/specifics.md:47 94ae25cbdeb34fb49087e942a41b41ae +msgid "Usage Examples" msgstr "" -#: ../../using/specifics.md:28 94861d3d7af34c3e92f0143d6871dda6 -msgid "" -"-t jupyter/pyspark-notebook:spark-2.4.7 ./pyspark-notebook \\ --build-arg" -" spark_version=2.4.7 \\ --build-arg hadoop_version=2.7 \\ --build-arg " -"spark_checksum=0F5455672045F6110B030CE343C049855B7BA86C0ECB5E39A075FF9D093C7F648DA55DED12E72FFE65D84C32DCD5418A6D764F2D6295A3F894A4286CC80EF478" -" \\ --build-arg openjdk_version=8" -msgstr "" - -#: ../../using/specifics.md:34 b42e4a47011b4be2987d806b05dd98f7 -msgid "" -"# Check the newly built image docker run -it --rm jupyter/pyspark-" -"notebook:spark-2.4.7 pyspark --version" -msgstr "" - -#: ../../using/specifics.md:37 d8398670e78b4c539ac5733b7454bf99 -msgid "" -"# Welcome to # ____ __ # / __/__ ___ _____/ /__ " -"# _\\ \\/ _ \\/ _ `/ __/ '_/ # /___/ .__/\\_,_/_/ /_/\\_\\ " -"version 2.4.7 # /_/ # # Using Scala version 2.11.12, OpenJDK 64-Bit" -" Server VM, 1.8.0_275 ```" -msgstr "" - -#: ../../using/specifics.md:47 f3e5461c94e6408da41c6a2b07a2c28d -msgid "### Usage Examples" -msgstr "" - -#: ../../using/specifics.md:49 f976080fe39b4b06803a85fc20b3adab +#: ../../using/specifics.md:49 1bacd33360a7470387ca777d9b245359 msgid "" "The `jupyter/pyspark-notebook` and `jupyter/all-spark-notebook` images " "support the use of [Apache Spark](https://spark.apache.org/) in Python, " @@ -2382,149 +1685,55 @@ msgid "" "how to get started using them." msgstr "" -#: ../../using/specifics.md:51 c4c61293755140bb8da8ec711e9762c6 -msgid "#### Using Spark Local Mode" +#: ../../using/specifics.md:51 8719c163eed1437ba840f51c1428098a +msgid "Using Spark Local Mode" msgstr "" -#: ../../using/specifics.md:53 7af7f30dcd8a4b17820995e8098a2b02 +#: ../../using/specifics.md:53 24146fb6b5004fcb892865c8dd56fb62 msgid "" "Spark **local mode** is useful for experimentation on small data when you" " do not have a Spark cluster available." msgstr "" -#: ../../using/specifics.md:55 d22e574af8064d5f82e29bc44dc65e07 -msgid "##### Local Mode in Python" +#: ../../using/specifics.md:55 a55001fb3bba4a068c9e7b81a6215f68 +msgid "Local Mode in Python" msgstr "" -#: ../../using/specifics.md:57 8199222226794abb95925c2530fe809a +#: ../../using/specifics.md:57 6a246f928f8644959b48966931267bd6 msgid "In a Python notebook." msgstr "" -#: ../../using/specifics.md:59 ../../using/specifics.md:148 -#: 2ab7027b7f9c4c67bc0b55a0a606a10f df85ff6ef4fc437c995eade5b0ee3310 -msgid "```python from pyspark.sql import SparkSession" -msgstr "" - -#: ../../using/specifics.md:62 3b8c5d74652740bba406a9c4a5f2fa57 -msgid "" -"# Spark session & context spark = " -"SparkSession.builder.master('local').getOrCreate() sc = " -"spark.sparkContext" -msgstr "" - -#: ../../using/specifics.md:66 ../../using/specifics.md:155 -#: 7c875e0bb8cd4d3e8c3784a00dd92127 a58e9901428845a3b04eed58f6035661 -msgid "" -"# Sum of the first 100 whole numbers rdd = sc.parallelize(range(100 + 1))" -" rdd.sum() # 5050 ```" -msgstr "" - -#: ../../using/specifics.md:72 f16fcf769a8e40179cf45e79962b2d51 -msgid "##### Local Mode in R" +#: ../../using/specifics.md:72 f81341d08f274986ad36d677cf2c8b9d +msgid "Local Mode in R" msgstr "" #: ../../using/specifics.md:74 ../../using/specifics.md:163 -#: 6198a6a7ca4e46f69fd35ba64267a42b b8539fbd6a0e44a689b7705f4c81874b +#: c5503b9ccbcd4d9ca868b083ae2e4746 d490668939d64dcc987b59df8643f01c msgid "In a R notebook with [SparkR][sparkr]." msgstr "" -#: ../../using/specifics.md:76 ../../using/specifics.md:165 -#: 7382866cff6e4b07a7030afac696e341 d8da924eec9c402dbe20d278a86090c3 -msgid "```R library(SparkR)" -msgstr "" - -#: ../../using/specifics.md:79 f952949b15a04a8c8f5cf47bfabc8090 -msgid "# Spark session & context sc <- sparkR.session(\"local\")" -msgstr "" - -#: ../../using/specifics.md:82 ../../using/specifics.md:171 -#: 0172cd0c8fb649bda6fb5e90db7e62ee dcf6b983b36a4eebbfbc5c3dcd58bec9 -msgid "" -"# Sum of the first 100 whole numbers sdf <- createDataFrame(list(1:100)) " -"dapplyCollect(sdf," -msgstr "" - -#: ../../using/specifics.md:85 ../../using/specifics.md:174 -#: 3c9abff17a3c41bf9c5db51c5f6da29d d9bbddf628814b70a7f97acd7fc3faa5 -msgid "function(x) { x <- sum(x)}" -msgstr "" - -#: ../../using/specifics.md:87 ../../using/specifics.md:176 -#: 42ee6d3db1bc46b4b430355b758ebfd2 5faf55b208b449d587a191837bf7d715 -msgid ")" -msgstr "" - -#: ../../using/specifics.md:88 ../../using/specifics.md:107 -#: ../../using/specifics.md:177 ../../using/specifics.md:195 -#: 2fb4482ce8194b06973f6da2d5f4926a 661e604b1a2d419ca7e2d2e396cd160e -#: 66d5fd214c864f72b2047306b4150eda fd4523853d4b411980fc3e027eacb27b -msgid "# 5050 ```" -msgstr "" - #: ../../using/specifics.md:91 ../../using/specifics.md:180 -#: 0b9ec7967a86414c9d0c35724282a468 269577dc0d9840699c65e55558e944c3 +#: 7e0836c24f5842f2a77a4b0c705b8b4a bba665f8fa2e4808970fd1ac10cb868e msgid "In a R notebook with [sparklyr][sparklyr]." msgstr "" -#: ../../using/specifics.md:93 ../../using/specifics.md:182 -#: 03eb26a538fc48a9a92334bc4cfa83f0 73650322bf434413b0e2027bc5b0ff70 -msgid "```R library(sparklyr)" -msgstr "" - -#: ../../using/specifics.md:96 1106d0b97b034ae4b46acf256633b7f4 -msgid "" -"# Spark configuration conf <- spark_config() # Set the catalog " -"implementation in-memory conf$spark.sql.catalogImplementation <- \"in-" -"memory\"" -msgstr "" - -#: ../../using/specifics.md:101 26e27224a0cc4574ae68147f2674180e -msgid "" -"# Spark session & context sc <- spark_connect(master = \"local\", config " -"= conf)" -msgstr "" - -#: ../../using/specifics.md:104 ../../using/specifics.md:192 -#: 1fe8d7348a294c92aba20cd977f9da3b 4fe881629a96464fa71e7f93ffb25106 -msgid "# Sum of the first 100 whole numbers sdf_len(sc, 100, repartition = 1) %>%" -msgstr "" - -#: ../../using/specifics.md:106 ../../using/specifics.md:194 -#: 18bb58ee90e24cb78d334965f2b6dfa0 fa8d2ee8a21b45048572d8815a10dc84 -msgid "spark_apply(function(e) sum(e))" -msgstr "" - -#: ../../using/specifics.md:110 8521d472c22f4b2f9e5b5e9b6e6cee45 -msgid "##### Local Mode in Scala" +#: ../../using/specifics.md:110 bfd64e413d0e43a4b84233058e3cb02c +msgid "Local Mode in Scala" msgstr "" #: ../../using/specifics.md:112 ../../using/specifics.md:200 -#: 8fd042e5b86245f3a3287f3697802c35 a3d289039d8a42f5b7cc7c576e8acc4a +#: b19f5bd3273947c0b7b6063489a613a5 b6c369a7da9e4351998b875c618fe564 #, python-format msgid "" "Spylon kernel instantiates a `SparkContext` for you in variable `sc` " "after you configure Spark options in a `%%init_spark` magic cell." msgstr "" -#: ../../using/specifics.md:115 8dec507df4364fbfa8465d7ec32d8027 -#, python-format -msgid "" -"```python %%init_spark # Configure Spark to use a local master " -"launcher.master = \"local\" ```" +#: ../../using/specifics.md:128 bd8667d04654411383d39a213ce40e5c +msgid "Connecting to a Spark Cluster in Standalone Mode" msgstr "" -#: ../../using/specifics.md:121 ../../using/specifics.md:209 -#: 0d6626148bb54b64b9ded8f85abaa961 3ff7e76d998648ba98869117818c4ff8 -msgid "" -"```scala // Sum of the first 100 whole numbers val rdd = sc.parallelize(0" -" to 100) rdd.sum() // 5050 ```" -msgstr "" - -#: ../../using/specifics.md:128 36ca61ed55254d65a917c6a20466067b -msgid "#### Connecting to a Spark Cluster in Standalone Mode" -msgstr "" - -#: ../../using/specifics.md:130 0c1c03a429194e6cb161be125a865079 +#: ../../using/specifics.md:130 0a277c4858e24bedb5a36e3817c63678 msgid "" "Connection to Spark Cluster on **[Standalone " "Mode](https://spark.apache.org/docs/latest/spark-standalone.html)** " @@ -2532,40 +1741,45 @@ msgid "" msgstr "" # 2c728588b6df4753a0c08f969364a79a -#: ../../using/specifics.md:132 3e034f21f0b04905a2f359451a868566 +#: ../../using/specifics.md:132 624ed5ef60eb41f88da23b2f2019cdc9 msgid "" "Verify that the docker image (check the Dockerfile) and the Spark Cluster" " which is being deployed, run the same version of Spark." msgstr "" -#: ../../using/specifics.md:134 37307ff27de840858887723053b7a03b +#: ../../using/specifics.md:134 1159539f83ee4804a5c117e9ce09181b msgid "" "[Deploy Spark in Standalone Mode](http://spark.apache.org/docs/latest" "/spark-standalone.html)." msgstr "" -#: ../../using/specifics.md:135 90e9e0194b874789ae44852cd6819e7d +#: ../../using/specifics.md:135 a42910e4d3904a39b4da798840488c63 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](http://spark.apache.org/docs/latest/cluster-" -"overview.html#components).) * NOTE: When using `--net=host`, you must " -"also use the flags `--pid=host -e TINI_SUBREAPER=true`. See " -" for details." +"overview.html#components).)" msgstr "" -#: ../../using/specifics.md:141 b8385cf51e3f436691c8545b4f8aacff +#: ../../using/specifics.md:138 63b0608a907f42b3b7436d688427a268 +msgid "" +"NOTE: When using `--net=host`, you must also use the flags `--pid=host -e" +" TINI_SUBREAPER=true`. See for details." +msgstr "" + +#: ../../using/specifics.md:141 f0f10631839b451f9647e0b51ea9609f msgid "" "**Note**: In the following examples we are using the Spark master URL " "`spark://master:7077` that shall be replaced by the URL of the Spark " "master." msgstr "" -#: ../../using/specifics.md:143 80c2545d794c4a37a128b963f7a7e046 -msgid "##### Standalone Mode in Python" +#: ../../using/specifics.md:143 2ba3e23b582c4805b83b457d175115f1 +msgid "Standalone Mode in Python" msgstr "" -#: ../../using/specifics.md:145 1e0438aa18cd4ff7930ac99a13537800 +#: ../../using/specifics.md:145 1d3848f815844097a9fb3062311c3f8a msgid "" "The **same Python version** need to be used on the notebook (where the " "driver is located) and on the Spark workers. The python version used at " @@ -2574,92 +1788,31 @@ msgid "" "Configuration][spark-conf] for more information." msgstr "" -#: ../../using/specifics.md:151 e11920b486ba429a9fbca4ac0bf84445 -msgid "" -"# Spark session & context spark = " -"SparkSession.builder.master('spark://master:7077').getOrCreate() sc = " -"spark.sparkContext" +#: ../../using/specifics.md:161 a90cfc28e6a94aa5a47b22c33e4eabb6 +msgid "Standalone Mode in R" msgstr "" -#: ../../using/specifics.md:161 c91980fee2094b0aa28d625a695030a5 -msgid "##### Standalone Mode in R" +#: ../../using/specifics.md:198 d6c95001377f4c8a850aeb44f87f7a3f +msgid "Standalone Mode in Scala" msgstr "" -#: ../../using/specifics.md:168 e3d6bcab9306487bbcb22bdac1d5bd1b -msgid "# Spark session & context sc <- sparkR.session(\"spark://master:7077\")" +#: ../../using/specifics.md:216 0a3da178359740bdad5bd9cf26b621a4 +msgid "Tensorflow" msgstr "" -#: ../../using/specifics.md:185 426220b6dcbe4284b09ac5390511809c -msgid "" -"# Spark session & context # Spark configuration conf <- spark_config() # " -"Set the catalog implementation in-memory " -"conf$spark.sql.catalogImplementation <- \"in-memory\" sc <- " -"spark_connect(master = \"spark://master:7077\", config = conf)" -msgstr "" - -#: ../../using/specifics.md:198 25624066c32b4d7c9fcf4285bba7ffef -msgid "##### Standalone Mode in Scala" -msgstr "" - -#: ../../using/specifics.md:203 5209072787a0410c921630bd548d5958 -#, python-format -msgid "" -"```python %%init_spark # Configure Spark to use a local master " -"launcher.master = \"spark://master:7077\" ```" -msgstr "" - -#: ../../using/specifics.md:216 faed98313c4846a2b79d3e28b67e04fc -msgid "## Tensorflow" -msgstr "" - -#: ../../using/specifics.md:218 a148742355984de4a71e1c76bf738f85 +#: ../../using/specifics.md:218 ebc8e24eb53448fca831d2a3c0e160fd msgid "" "The `jupyter/tensorflow-notebook` image supports the use of " "[Tensorflow](https://www.tensorflow.org/) in single machine or " "distributed mode." msgstr "" -#: ../../using/specifics.md:221 5ffac465540e4ac681cad950435b4ca3 -msgid "### Single Machine Mode" +#: ../../using/specifics.md:221 a98a8781c5c941fa9ad0753df41fee70 +msgid "Single Machine Mode" msgstr "" -#: ../../using/specifics.md:223 ../../using/specifics.md:237 -#: 57e9cb29ee124697ad24506d8bc02299 9969f1dca9734d77b3c45e47b2d596fd -msgid "```python import tensorflow as tf" -msgstr "" - -#: ../../using/specifics.md:226 ed8364ec26ca4feda923cdb47854d347 -msgid "hello = tf.Variable('Hello World!')" -msgstr "" - -#: ../../using/specifics.md:228 e749a042229f403b937c6169ab7e1402 -msgid "sess = tf.Session() init = tf.global_variables_initializer()" -msgstr "" - -#: ../../using/specifics.md:231 ../../using/specifics.md:246 -#: 6bd758aeeed04500980a292759c2c77b fe3fac1c4ae6484eb554b10bd63f28c9 -msgid "sess.run(init) sess.run(hello) ```" -msgstr "" - -#: ../../using/specifics.md:235 35382d3d15454acaa30e2970425e8b23 -msgid "### Distributed Mode" -msgstr "" - -#: ../../using/specifics.md:240 8fd28a1b5d01421b9c09e50b03b257d3 -msgid "hello = tf.Variable('Hello Distributed World!')" -msgstr "" - -#: ../../using/specifics.md:242 070ed8b2a066439e95113812e46589cd -msgid "" -"server = tf.train.Server.create_local_server() sess = " -"tf.Session(server.target) init = tf.global_variables_initializer()" -msgstr "" - -#: ../../using/specifics.md:250 0e3c4b2adc914f05ac3184686a6004b8 -msgid "" -"[sparkr]: https://spark.apache.org/docs/latest/sparkr.html [sparklyr]: " -"https://spark.rstudio.com/ [spark-conf]: " -"https://spark.apache.org/docs/latest/configuration.html" +#: ../../using/specifics.md:235 5eae8f926d674dd69e8d955d602200a7 +msgid "Distributed Mode" msgstr "" # 5e06096348924f51881d05f984e91381 @@ -5376,3 +4529,1113 @@ msgstr "" #~ "from Docker Hub." #~ msgstr "" +#~ msgid "# Common Features" +#~ msgstr "" + +#~ msgid "## Notebook Options" +#~ msgstr "" + +#~ msgid "" +#~ "```bash docker run -d -p 8888:8888 " +#~ "jupyter/base-notebook start-notebook.sh " +#~ "--NotebookApp.password='sha1:74ba40f8a388:c913541b7ee99d15d5ed31d4226bf7838f83a50e'" +#~ " ```" +#~ msgstr "" + +#~ msgid "" +#~ "```bash docker run -d -p 8888:8888 " +#~ "jupyter/base-notebook start-notebook.sh " +#~ "--NotebookApp.base_url=/some/path ```" +#~ msgstr "" + +#~ msgid "## Docker Options" +#~ msgstr "" + +#~ msgid "## Startup Hooks" +#~ msgstr "" + +#~ msgid "## SSL Certificates" +#~ msgstr "" + +#~ msgid "```bash docker run -d -p 8888:8888 \\" +#~ msgstr "" + +#~ msgid "" +#~ "-v /some/host/folder:/etc/ssl/notebook \\ jupyter" +#~ "/base-notebook start-notebook.sh \\ " +#~ "--NotebookApp.keyfile=/etc/ssl/notebook/notebook.key " +#~ "--NotebookApp.certfile=/etc/ssl/notebook/notebook.crt" +#~ msgstr "" + +#~ msgid "```" +#~ msgstr "" + +#~ msgid "" +#~ "-v /some/host/folder/notebook.pem:/etc/ssl/notebook.pem \\" +#~ " jupyter/base-notebook start-notebook.sh \\" +#~ " --NotebookApp.certfile=/etc/ssl/notebook.pem" +#~ msgstr "" + +#~ msgid "## Alternative Commands" +#~ msgstr "" + +#~ msgid "### start.sh" +#~ msgstr "" + +#~ msgid "```bash docker run -it --rm jupyter/base-notebook start.sh ipython ```" +#~ msgstr "" + +#~ msgid "" +#~ "```bash docker run -it --rm -p " +#~ "8888:8888 jupyter/base-notebook start.sh " +#~ "jupyter lab ```" +#~ msgstr "" + +#~ msgid "### Others" +#~ msgstr "" + +#~ msgid "## Conda Environments" +#~ msgstr "" + +#~ msgid "" +#~ "```bash # install a package into " +#~ "the default (python 3.x) environment pip" +#~ " install some-package conda install " +#~ "some-package mamba install some-package " +#~ "```" +#~ msgstr "" + +#~ msgid "### Using alternative channels" +#~ msgstr "" + +#~ msgid "" +#~ "```bash # using defaults channels to " +#~ "install a package conda install " +#~ "--channel defaults humanize # configure " +#~ "conda to add default channels at " +#~ "the top of the list conda config" +#~ " --system --prepend channels defaults # " +#~ "install a package conda install humanize" +#~ " ```" +#~ msgstr "" + +#~ msgid "# Contributed Recipes" +#~ msgstr "" + +#~ msgid "## Using `sudo` within a container" +#~ msgstr "" + +#~ msgid "" +#~ "```bash docker run -it -e GRANT_SUDO=yes" +#~ " --user root jupyter/minimal-notebook ```" +#~ msgstr "" + +#~ msgid "## Using `pip install` or `conda install` in a Child Docker image" +#~ msgstr "" + +#~ msgid "" +#~ "```dockerfile # Start from a core " +#~ "stack version FROM jupyter/datascience-" +#~ "notebook:9f9e5ca8fe5a # Install in the " +#~ "default python3 environment RUN pip " +#~ "install 'ggplot==0.6.8' ```" +#~ msgstr "" + +#~ msgid "```bash docker build --rm -t jupyter/my-datascience-notebook . ```" +#~ msgstr "" + +#~ msgid "" +#~ "```dockerfile # Start from a core " +#~ "stack version FROM jupyter/datascience-" +#~ "notebook:9f9e5ca8fe5a # Install from " +#~ "requirements.txt file COPY " +#~ "--chown=${NB_UID}:${NB_GID} requirements.txt /tmp/ " +#~ "RUN pip install --requirement " +#~ "/tmp/requirements.txt && \\" +#~ msgstr "" + +#~ msgid "fix-permissions $CONDA_DIR && \\ fix-permissions /home/$NB_USER" +#~ msgstr "" + +#~ msgid "" +#~ "```dockerfile # Start from a core " +#~ "stack version FROM jupyter/datascience-" +#~ "notebook:9f9e5ca8fe5a # Install from " +#~ "requirements.txt file COPY " +#~ "--chown=${NB_UID}:${NB_GID} requirements.txt /tmp/ " +#~ "RUN conda install --yes --file " +#~ "/tmp/requirements.txt && \\" +#~ msgstr "" + +#~ msgid "## Add a Python 2.x environment" +#~ msgstr "" + +#~ msgid "" +#~ "```dockerfile # Choose your desired base" +#~ " image FROM jupyter/scipy-notebook:latest" +#~ msgstr "" + +#~ msgid "" +#~ "# Create a Python 2.x environment " +#~ "using conda including at least the " +#~ "ipython kernel # and the kernda " +#~ "utility. Add any additional packages you" +#~ " want available for use # in a" +#~ " Python 2 notebook to the first " +#~ "line here (e.g., pandas, matplotlib, " +#~ "etc.) RUN conda create --quiet --yes " +#~ "-p $CONDA_DIR/envs/python2 python=2.7 ipython " +#~ "ipykernel kernda && \\" +#~ msgstr "" + +#~ msgid "conda clean --all -f -y" +#~ msgstr "" + +#~ msgid "USER root" +#~ msgstr "" + +#~ msgid "" +#~ "# Create a global kernelspec in " +#~ "the image and modify it so that" +#~ " it properly activates # the python2" +#~ " conda environment. RUN " +#~ "$CONDA_DIR/envs/python2/bin/python -m ipykernel " +#~ "install && \\ $CONDA_DIR/envs/python2/bin/kernda " +#~ "-o -y /usr/local/share/jupyter/kernels/python2/kernel.json" +#~ msgstr "" + +#~ msgid "USER $NB_USER ```" +#~ msgstr "" + +#~ msgid "## Add a Python 3.x environment" +#~ msgstr "" + +#~ msgid "" +#~ "```dockerfile # Choose your desired base" +#~ " image FROM jupyter/minimal-notebook:latest" +#~ msgstr "" + +#~ msgid "" +#~ "# name your environment and choose " +#~ "python 3.x version ARG conda_env=python36 " +#~ "ARG py_ver=3.6" +#~ msgstr "" + +#~ msgid "" +#~ "# you can add additional libraries " +#~ "you want conda to install by " +#~ "listing them below the first line " +#~ "and ending with \"&& \\\" RUN " +#~ "conda create --quiet --yes -p " +#~ "$CONDA_DIR/envs/$conda_env python=$py_ver ipython " +#~ "ipykernel && \\" +#~ msgstr "" + +#~ msgid "" +#~ "# alternatively, you can comment out " +#~ "the lines above and uncomment those " +#~ "below # if you'd prefer to use " +#~ "a YAML file present in the docker" +#~ " build context" +#~ msgstr "" + +#~ msgid "" +#~ "# COPY --chown=${NB_UID}:${NB_GID} environment.yml" +#~ " /home/$NB_USER/tmp/ # RUN cd " +#~ "/home/$NB_USER/tmp/ && \\ # conda " +#~ "env create -p $CONDA_DIR/envs/$conda_env -f" +#~ " environment.yml && \\ # conda " +#~ "clean --all -f -y" +#~ msgstr "" + +#~ msgid "" +#~ "# create Python 3.x environment and " +#~ "link it to jupyter RUN " +#~ "$CONDA_DIR/envs/${conda_env}/bin/python -m ipykernel " +#~ "install --user --name=${conda_env} && \\" +#~ msgstr "" + +#~ msgid "" +#~ "# any additional pip installs can " +#~ "be added by uncommenting the following" +#~ " line # RUN $CONDA_DIR/envs/${conda_env}/bin/pip" +#~ " install" +#~ msgstr "" + +#~ msgid "" +#~ "# prepend conda environment to path " +#~ "ENV PATH $CONDA_DIR/envs/${conda_env}/bin:$PATH" +#~ msgstr "" + +#~ msgid "" +#~ "# if you want this environment to" +#~ " be the default one, uncomment the" +#~ " following line: # ENV CONDA_DEFAULT_ENV" +#~ " ${conda_env} ```" +#~ msgstr "" + +#~ msgid "## Run JupyterLab" +#~ msgstr "" + +#~ msgid "## Dask JupyterLab Extension" +#~ msgstr "" + +#~ msgid "" +#~ "```dockerfile # Start from a core " +#~ "stack version FROM jupyter/scipy-" +#~ "notebook:latest" +#~ msgstr "" + +#~ msgid "# Install the Dask dashboard RUN pip install dask-labextension" +#~ msgstr "" + +#~ msgid "# Dask Scheduler & Bokeh ports EXPOSE 8787 EXPOSE 8786" +#~ msgstr "" + +#~ msgid "" +#~ "ENTRYPOINT [\"jupyter\", \"lab\", \"--" +#~ "ip=0.0.0.0\", \"--allow-root\"] ```" +#~ msgstr "" + +#~ msgid "```bash docker build -t jupyter/scipy-dasklabextension:latest . ```" +#~ msgstr "" + +#~ msgid "" +#~ "```bash docker run -it --rm -p " +#~ "8888:8888 -p 8787:8787 jupyter/scipy-" +#~ "dasklabextension:latest ```" +#~ msgstr "" + +#~ msgid "## Let's Encrypt a Notebook server" +#~ msgstr "" + +#~ msgid "## Slideshows with Jupyter and RISE" +#~ msgstr "" + +#~ msgid "" +#~ "```bash # Add Live slideshows with " +#~ "RISE RUN conda install -c damianavila82" +#~ " rise ```" +#~ msgstr "" + +#~ msgid "## xgboost" +#~ msgstr "" + +#~ msgid "```bash %%bash conda install -y gcc pip install xgboost" +#~ msgstr "" + +#~ msgid "import xgboost ```" +#~ msgstr "" + +#~ msgid "## Running behind a nginx proxy" +#~ msgstr "" + +#~ msgid "## Host volume mounts and notebook errors" +#~ msgstr "" + +#~ msgid "## Manpage installation" +#~ msgstr "" + +#~ msgid "" +#~ "```dockerfile # Choose your desired base" +#~ " image ARG BASE_CONTAINER=jupyter/datascience-" +#~ "notebook:latest FROM $BASE_CONTAINER" +#~ msgstr "" + +#~ msgid "" +#~ "# Remove the manpage blacklist, install" +#~ " man, install docs RUN rm " +#~ "/etc/dpkg/dpkg.cfg.d/excludes \\" +#~ msgstr "" + +#~ msgid "" +#~ "&& apt-get update \\ && dpkg " +#~ "-l | grep ^ii | cut -d' '" +#~ " -f3 | xargs apt-get install " +#~ "-yq --no-install-recommends --reinstall " +#~ "man \\ && apt-get clean \\ " +#~ "&& rm -rf /var/lib/apt/lists/*" +#~ msgstr "" + +#~ msgid "USER $NB_UID ```" +#~ msgstr "" + +#~ msgid "" +#~ "```dockerfile # Ubuntu 20.04 (focal) " +#~ "from 2020-04-23 # https://github.com/docker-" +#~ "library/official-" +#~ "images/commit/4475094895093bcc29055409494cce1e11b52f94 ARG " +#~ "BASE_CONTAINER=ubuntu:focal-20200423@sha256:238e696992ba9913d24cfc3727034985abd136e08ee3067982401acdc30cbf3f" +#~ " ```" +#~ msgstr "" + +#~ msgid "" +#~ "```dockerfile # https://git.savannah.gnu.org/cgit/man-" +#~ "db.git/commit/?id=8197d7824f814c5d4b992b4c8730b5b0f7ec589a # " +#~ "http://launchpadlibrarian.net/435841763/man-" +#~ "db_2.8.5-2_2.8.6-1.diff.gz" +#~ msgstr "" + +#~ msgid "" +#~ "RUN echo \"MANPATH_MAP ${CONDA_DIR}/bin " +#~ "${CONDA_DIR}/man\" >> /etc/manpath.config \\" +#~ msgstr "" + +#~ msgid "" +#~ "&& echo \"MANPATH_MAP ${CONDA_DIR}/bin " +#~ "${CONDA_DIR}/share/man\" >> /etc/manpath.config \\" +#~ " && mandb" +#~ msgstr "" + +#~ msgid "## JupyterHub" +#~ msgstr "" + +#~ msgid "### Use JupyterHub's dockerspawner" +#~ msgstr "" + +#~ msgid "### Containers with a specific version of JupyterHub" +#~ msgstr "" + +#~ msgid "" +#~ "```dockerfile FROM jupyter/base-" +#~ "notebook:5ded1de07260 RUN pip install " +#~ "jupyterhub==0.8.0b1 ```" +#~ msgstr "" + +#~ msgid "## Spark" +#~ msgstr "" + +#~ msgid "### Using PySpark with AWS S3" +#~ msgstr "" + +#~ msgid "" +#~ "```py import os # !ls " +#~ "/usr/local/spark/jars/hadoop* # to figure out" +#~ " what version of hadoop " +#~ "os.environ['PYSPARK_SUBMIT_ARGS'] = '--packages " +#~ "\"org.apache.hadoop:hadoop-aws:2.7.3\" pyspark-" +#~ "shell'" +#~ msgstr "" + +#~ msgid "import pyspark myAccessKey = input() mySecretKey = input()" +#~ msgstr "" + +#~ msgid "spark = pyspark.sql.SparkSession.builder \\" +#~ msgstr "" + +#~ msgid "" +#~ ".master(\"local[*]\") \\ " +#~ ".config(\"spark.hadoop.fs.s3a.access.key\", myAccessKey) " +#~ "\\ .config(\"spark.hadoop.fs.s3a.secret.key\", " +#~ "mySecretKey) \\ .getOrCreate()" +#~ msgstr "" + +#~ msgid "df = spark.read.parquet(\"s3://myBucket/myKey\") ```" +#~ msgstr "" + +#~ msgid "" +#~ "```py import os os.environ['PYSPARK_SUBMIT_ARGS']" +#~ " = '--packages com.amazonaws:aws-java-" +#~ "sdk:1.10.34,org.apache.hadoop:hadoop-aws:2.6.0 pyspark-" +#~ "shell'" +#~ msgstr "" + +#~ msgid "import pyspark sc = pyspark.SparkContext(\"local[*]\")" +#~ msgstr "" + +#~ msgid "from pyspark.sql import SQLContext sqlContext = SQLContext(sc)" +#~ msgstr "" + +#~ msgid "" +#~ "hadoopConf = sc._jsc.hadoopConfiguration() " +#~ "myAccessKey = input() mySecretKey = " +#~ "input() hadoopConf.set(\"fs.s3.impl\", " +#~ "\"org.apache.hadoop.fs.s3native.NativeS3FileSystem\") " +#~ "hadoopConf.set(\"fs.s3.awsAccessKeyId\", myAccessKey) " +#~ "hadoopConf.set(\"fs.s3.awsSecretAccessKey\", mySecretKey)" +#~ msgstr "" + +#~ msgid "df = sqlContext.read.parquet(\"s3://myBucket/myKey\") ```" +#~ msgstr "" + +#~ msgid "### Using Local Spark JARs" +#~ msgstr "" + +#~ msgid "" +#~ "```python import os " +#~ "os.environ['PYSPARK_SUBMIT_ARGS'] = '--jars " +#~ "/home/jovyan/spark-streaming-kafka-" +#~ "assembly_2.10-1.6.1.jar pyspark-shell' import " +#~ "pyspark from pyspark.streaming.kafka import " +#~ "KafkaUtils from pyspark.streaming import " +#~ "StreamingContext sc = pyspark.SparkContext() " +#~ "ssc = StreamingContext(sc,1) broker = " +#~ "\"\" directKafkaStream = " +#~ "KafkaUtils.createDirectStream(ssc, [\"test1\"], " +#~ "{\"metadata.broker.list\": broker}) " +#~ "directKafkaStream.pprint() ssc.start() ```" +#~ msgstr "" + +#~ msgid "### Using spark-packages.org" +#~ msgstr "" + +#~ msgid "### Use jupyter/all-spark-notebooks with an existing Spark/YARN cluster" +#~ msgstr "" + +#~ msgid "```dockerfile FROM jupyter/all-spark-notebook" +#~ msgstr "" + +#~ msgid "" +#~ "# Set env vars for pydoop ENV " +#~ "HADOOP_HOME /usr/local/hadoop-2.7.3 ENV JAVA_HOME" +#~ " /usr/lib/jvm/java-8-openjdk-amd64 ENV " +#~ "HADOOP_CONF_HOME /usr/local/hadoop-2.7.3/etc/hadoop ENV" +#~ " HADOOP_CONF_DIR /usr/local/hadoop-2.7.3/etc/hadoop" +#~ msgstr "" + +#~ msgid "" +#~ "USER root # Add proper open-jdk-8" +#~ " not just the jre, needed for " +#~ "pydoop RUN echo 'deb http://cdn-" +#~ "fastly.deb.debian.org/debian jessie-backports main'" +#~ " > /etc/apt/sources.list.d/jessie-backports.list " +#~ "&& \\" +#~ msgstr "" + +#~ msgid "" +#~ "apt-get -y update && \\ apt-" +#~ "get install --no-install-recommends -t" +#~ " jessie-backports -y openjdk-8-jdk && " +#~ "\\ rm /etc/apt/sources.list.d/jessie-backports.list" +#~ " && \\ apt-get clean && \\ " +#~ "rm -rf /var/lib/apt/lists/ && \\" +#~ msgstr "" + +#~ msgid "# Add hadoop binaries" +#~ msgstr "" + +#~ msgid "" +#~ "wget " +#~ "http://mirrors.ukfast.co.uk/sites/ftp.apache.org/hadoop/common/hadoop-2.7.3/hadoop-2.7.3.tar.gz" +#~ " && \\ tar -xvf hadoop-2.7.3.tar.gz " +#~ "-C /usr/local && \\ chown -R " +#~ "$NB_USER:users /usr/local/hadoop-2.7.3 && \\ " +#~ "rm -f hadoop-2.7.3.tar.gz && \\" +#~ msgstr "" + +#~ msgid "# Install os dependencies required for pydoop, pyhive" +#~ msgstr "" + +#~ msgid "" +#~ "apt-get update && \\ apt-get " +#~ "install --no-install-recommends -y " +#~ "build-essential python-dev libsasl2-dev &&" +#~ " \\ apt-get clean && \\ rm " +#~ "-rf /var/lib/apt/lists/* && \\" +#~ msgstr "" + +#~ msgid "" +#~ "# Remove the example hadoop configs " +#~ "and replace # with those for our" +#~ " cluster. # Alternatively this could " +#~ "be mounted as a volume" +#~ msgstr "" + +#~ msgid "rm -f /usr/local/hadoop-2.7.3/etc/hadoop/*" +#~ msgstr "" + +#~ msgid "" +#~ "# Download this from ambari / " +#~ "cloudera manager and copy here COPY " +#~ "example-hadoop-conf/ " +#~ "/usr/local/hadoop-2.7.3/etc/hadoop/" +#~ msgstr "" + +#~ msgid "" +#~ "# Spark-Submit doesn't work unless " +#~ "I set the following RUN echo " +#~ "\"spark.driver.extraJavaOptions -Dhdp.version=2.5.3.0-37\" " +#~ ">> /usr/local/spark/conf/spark-defaults.conf && " +#~ "\\" +#~ msgstr "" + +#~ msgid "" +#~ "echo \"spark.yarn.am.extraJavaOptions " +#~ "-Dhdp.version=2.5.3.0-37\" >> /usr/local/spark/conf" +#~ "/spark-defaults.conf && \\ echo " +#~ "\"spark.master=yarn\" >> /usr/local/spark/conf/spark-" +#~ "defaults.conf && \\ echo \"spark.hadoop.yarn" +#~ ".timeline-service.enabled=false\" >> " +#~ "/usr/local/spark/conf/spark-defaults.conf && \\ " +#~ "chown -R $NB_USER:users /usr/local/spark/conf" +#~ "/spark-defaults.conf && \\ # Create " +#~ "an alternative HADOOP_CONF_HOME so we " +#~ "can mount as a volume and repoint" +#~ " # using ENV var if needed " +#~ "mkdir -p /etc/hadoop/conf/ && \\ chown" +#~ " $NB_USER:users /etc/hadoop/conf/" +#~ msgstr "" + +#~ msgid "USER $NB_USER" +#~ msgstr "" + +#~ msgid "" +#~ "# Install useful jupyter extensions and" +#~ " python libraries like : # - " +#~ "Dashboards # - PyDoop # - PyHive" +#~ " RUN pip install jupyter_dashboards faker" +#~ " && \\" +#~ msgstr "" + +#~ msgid "" +#~ "jupyter dashboards quick-setup --sys-" +#~ "prefix && \\ pip2 install pyhive " +#~ "pydoop thrift sasl thrift_sasl faker" +#~ msgstr "" + +#~ msgid "" +#~ "USER root # Ensure we overwrite " +#~ "the kernel config so that toree " +#~ "connects to cluster RUN jupyter toree" +#~ " install --sys-prefix --spark_opts=\"--" +#~ "master yarn --deploy-mode client " +#~ "--driver-memory 512m --executor-memory " +#~ "512m --executor-cores 1 --driver-" +#~ "java-options -Dhdp.version=2.5.3.0-37 --conf " +#~ "spark.hadoop.yarn.timeline-service.enabled=false\" USER" +#~ " $NB_USER ```" +#~ msgstr "" + +#~ msgid "" +#~ "## Run Jupyter Notebook/Lab inside an" +#~ " already secured environment (i.e., with" +#~ " no token)" +#~ msgstr "" + +#~ msgid "" +#~ "```bash docker run jupyter/base-" +#~ "notebook:6d2a05346196 start.sh jupyter lab " +#~ "--LabApp.token='' ```" +#~ msgstr "" + +#~ msgid "" +#~ "```bash docker run jupyter/base-" +#~ "notebook:6d2a05346196 start.sh jupyter notebook " +#~ "--NotebookApp.token='' ```" +#~ msgstr "" + +#~ msgid "" +#~ "## Enable nbextension spellchecker for " +#~ "markdown (or any other nbextension)" +#~ msgstr "" + +#~ msgid "" +#~ "```dockerfile # Update with your base" +#~ " image of choice FROM jupyter/minimal-" +#~ "notebook:latest" +#~ msgstr "" + +#~ msgid "RUN pip install jupyter_contrib_nbextensions && \\" +#~ msgstr "" + +#~ msgid "" +#~ "jupyter contrib nbextension install --user " +#~ "&& \\ # can modify or enable " +#~ "additional extensions here jupyter nbextension" +#~ " enable spellchecker/main --user" +#~ msgstr "" + +#~ msgid "## Enable auto-sklearn notebooks" +#~ msgstr "" + +#~ msgid "" +#~ "```dockerfile ARG BASE_CONTAINER=jupyter/scipy-" +#~ "notebook FROM jupyter/scipy-notebook:latest" +#~ msgstr "" + +#~ msgid "" +#~ "# autosklearn requires swig, which no" +#~ " other image has RUN apt-get " +#~ "update && \\" +#~ msgstr "" + +#~ msgid "" +#~ "apt-get install -y --no-install-" +#~ "recommends swig && \\ apt-get " +#~ "clean && \\ rm -rf /var/lib/apt/lists/*" +#~ msgstr "" + +#~ msgid "USER $NB_UID" +#~ msgstr "" + +#~ msgid "RUN pip install --quiet --no-cache-dir auto-sklearn ```" +#~ msgstr "" + +#~ msgid "## Enable Delta Lake in Spark notebooks" +#~ msgstr "" + +#~ msgid "```dockerfile FROM jupyter/pyspark-notebook:latest" +#~ msgstr "" + +#~ msgid "ARG DELTA_CORE_VERSION=\"0.8.0\"" +#~ msgstr "" + +#~ msgid "" +#~ "RUN echo \"spark.jars.packages io.delta:delta-" +#~ "core_2.12:${DELTA_CORE_VERSION}\" >> $SPARK_HOME/conf" +#~ "/spark-defaults.conf && \\" +#~ msgstr "" + +#~ msgid "" +#~ "echo 'spark.sql.extensions " +#~ "io.delta.sql.DeltaSparkSessionExtension' >> " +#~ "$SPARK_HOME/conf/spark-defaults.conf && \\ " +#~ "echo 'spark.sql.catalog.spark_catalog " +#~ "org.apache.spark.sql.delta.catalog.DeltaCatalog' >> " +#~ "$SPARK_HOME/conf/spark-defaults.conf" +#~ msgstr "" + +#~ msgid "" +#~ "# Run pyspark and exit to trigger" +#~ " the download of the delta lake " +#~ "jars RUN echo \"quit()\" > /tmp/init-" +#~ "delta.py && \\" +#~ msgstr "" + +#~ msgid "spark-submit /tmp/init-delta.py && \\ rm /tmp/init-delta.py" +#~ msgstr "" + +#~ msgid "# Running a Container" +#~ msgstr "" + +#~ msgid "## Using the Docker CLI" +#~ msgstr "" + +#~ msgid "```bash $ docker run -p 8888:8888 jupyter/scipy-notebook:2c80cf3537ca" +#~ msgstr "" + +#~ msgid "" +#~ "Executing the command: jupyter notebook " +#~ "[I 15:33:00.567 NotebookApp] Writing notebook" +#~ " server cookie secret to " +#~ "/home/jovyan/.local/share/jupyter/runtime/notebook_cookie_secret " +#~ "[W 15:33:01.084 NotebookApp] WARNING: The " +#~ "notebook server is listening on all " +#~ "IP addresses and not using encryption." +#~ " This is not recommended. [I " +#~ "15:33:01.150 NotebookApp] JupyterLab alpha " +#~ "preview extension loaded from " +#~ "/opt/conda/lib/python3.6/site-packages/jupyterlab [I " +#~ "15:33:01.150 NotebookApp] JupyterLab application " +#~ "directory is /opt/conda/share/jupyter/lab [I " +#~ "15:33:01.155 NotebookApp] Serving notebooks " +#~ "from local directory: /home/jovyan [I " +#~ "15:33:01.156 NotebookApp] 0 active kernels " +#~ "[I 15:33:01.156 NotebookApp] The Jupyter " +#~ "Notebook is running at: [I 15:33:01.157" +#~ " NotebookApp] http://[all ip addresses on" +#~ " your " +#~ "system]:8888/?token=112bb073331f1460b73768c76dffb2f87ac1d4ca7870d46a" +#~ " [I 15:33:01.157 NotebookApp] Use Control-C" +#~ " to stop this server and shut " +#~ "down all kernels (twice to skip " +#~ "confirmation). [C 15:33:01.160 NotebookApp]" +#~ msgstr "" + +#~ msgid "" +#~ "Copy/paste this URL into your browser" +#~ " when you connect for the first " +#~ "time, to login with a token:" +#~ msgstr "" + +#~ msgid "http://localhost:8888/?token=112bb073331f1460b73768c76dffb2f87ac1d4ca7870d46a" +#~ msgstr "" + +#~ msgid "" +#~ "```bash # list containers $ docker " +#~ "ps -a CONTAINER ID IMAGE" +#~ " COMMAND CREATED " +#~ "STATUS PORTS NAMES " +#~ "d67fe77f1a84 jupyter/base-notebook \"tini" +#~ " -- start-noteb…\" 44 seconds ago" +#~ " Exited (0) 39 seconds ago" +#~ " cocky_mirzakhani" +#~ msgstr "" + +#~ msgid "" +#~ "# start the stopped container $ " +#~ "docker start -a d67fe77f1a84 Executing " +#~ "the command: jupyter notebook [W " +#~ "16:45:02.020 NotebookApp] WARNING: The " +#~ "notebook server is listening on all " +#~ "IP addresses and not using encryption." +#~ " This is not recommended. ..." +#~ msgstr "" + +#~ msgid "" +#~ "# remove the stopped container $ " +#~ "docker rm d67fe77f1a84 d67fe77f1a84 ```" +#~ msgstr "" + +#~ msgid "" +#~ "```bash $ docker run --rm -p " +#~ "10000:8888 -v \"$PWD\":/home/jovyan/work " +#~ "jupyter/r-notebook:e5c5a7d3e52d" +#~ msgstr "" + +#~ msgid "" +#~ "Executing the command: jupyter notebook " +#~ "[I 19:31:09.573 NotebookApp] Writing notebook" +#~ " server cookie secret to " +#~ "/home/jovyan/.local/share/jupyter/runtime/notebook_cookie_secret " +#~ "[W 19:31:11.930 NotebookApp] WARNING: The " +#~ "notebook server is listening on all " +#~ "IP addresses and not using encryption." +#~ " This is not recommended. [I " +#~ "19:31:12.085 NotebookApp] JupyterLab alpha " +#~ "preview extension loaded from " +#~ "/opt/conda/lib/python3.6/site-packages/jupyterlab [I " +#~ "19:31:12.086 NotebookApp] JupyterLab application " +#~ "directory is /opt/conda/share/jupyter/lab [I " +#~ "19:31:12.117 NotebookApp] Serving notebooks " +#~ "from local directory: /home/jovyan [I " +#~ "19:31:12.117 NotebookApp] 0 active kernels " +#~ "[I 19:31:12.118 NotebookApp] The Jupyter " +#~ "Notebook is running at: [I 19:31:12.119" +#~ " NotebookApp] http://[all ip addresses on" +#~ " your " +#~ "system]:8888/?token=3b8dce890cb65570fb0d9c4a41ae067f7604873bd604f5ac" +#~ " [I 19:31:12.120 NotebookApp] Use Control-C" +#~ " to stop this server and shut " +#~ "down all kernels (twice to skip " +#~ "confirmation). [C 19:31:12.122 NotebookApp]" +#~ msgstr "" + +#~ msgid "http://localhost:8888/?token=3b8dce890cb65570fb0d9c4a41ae067f7604873bd604f5ac" +#~ msgstr "" + +#~ msgid "```bash docker run -d -P --name notebook jupyter/all-spark-notebook ```" +#~ msgstr "" + +#~ msgid "" +#~ "```bash # get the random host port" +#~ " assigned to the container port 8888" +#~ " $ docker port notebook 8888 " +#~ "0.0.0.0:32769" +#~ msgstr "" + +#~ msgid "# get the notebook token from the logs $ docker logs --tail 3 notebook" +#~ msgstr "" + +#~ msgid "http://localhost:8888/?token=15914ca95f495075c0aa7d0e060f1a78b6d94f70ea373b00" +#~ msgstr "" + +#~ msgid "```bash # stop the container docker stop notebook notebook" +#~ msgstr "" + +#~ msgid "# remove the container permanently docker rm notebook notebook ```" +#~ msgstr "" + +#~ msgid "## Using Binder" +#~ msgstr "" + +#~ msgid "## Using JupyterHub" +#~ msgstr "" + +#~ msgid "## Using Other Tools and Services" +#~ msgstr "" + +#~ msgid "# Selecting an Image" +#~ msgstr "" + +#~ msgid "## Core Stacks" +#~ msgstr "" + +#~ msgid "### jupyter/base-notebook" +#~ msgstr "" + +#~ msgid "" +#~ "[Miniforge](https://github.com/conda-forge/miniforge) " +#~ "Python 3.x in `/opt/conda` with two " +#~ "package managers - " +#~ "[conda](https://github.com/conda/conda): \"cross-platform," +#~ " language-agnostic binary package " +#~ "manager\". - [mamba](https://github.com/mamba-" +#~ "org/mamba): \"reimplementation of the conda" +#~ " package manager in C++\"." +#~ msgstr "" + +#~ msgid "### jupyter/minimal-notebook" +#~ msgstr "" + +#~ msgid "### jupyter/r-notebook" +#~ msgstr "" + +#~ msgid "### jupyter/scipy-notebook" +#~ msgstr "" + +#~ msgid "### jupyter/tensorflow-notebook" +#~ msgstr "" + +#~ msgid "### jupyter/datascience-notebook" +#~ msgstr "" + +#~ msgid "### jupyter/pyspark-notebook" +#~ msgstr "" + +#~ msgid "### jupyter/all-spark-notebook" +#~ msgstr "" + +#~ msgid "### Image Relationships" +#~ msgstr "" + +#~ msgid "### Builds" +#~ msgstr "" + +#~ msgid "### Versioning" +#~ msgstr "" + +#~ msgid "## Community Stacks" +#~ msgstr "" + +#~ msgid "# Image Specifics" +#~ msgstr "" + +#~ msgid "## Apache Spark™" +#~ msgstr "" + +#~ msgid "### Specific Docker Image Options" +#~ msgstr "" + +#~ msgid "### Build an Image with a Different Version of Spark" +#~ msgstr "" + +#~ msgid "" +#~ "Spark distribution is defined by the " +#~ "combination of the Spark and the " +#~ "Hadoop version and verified by the " +#~ "package checksum, see [Download Apache " +#~ "Spark](https://spark.apache.org/downloads.html) and the" +#~ " [archive repo](https://archive.apache.org/dist/spark/) " +#~ "for more information. * `spark_version`: " +#~ "The Spark version to install (`3.0.0`)." +#~ " * `hadoop_version`: The Hadoop version " +#~ "(`3.2`). * `spark_checksum`: The package " +#~ "checksum (`BFE4540...`)." +#~ msgstr "" + +#~ msgid "" +#~ "Spark can run with different OpenJDK " +#~ "versions. * `openjdk_version`: The version " +#~ "of (JRE headless) the OpenJDK " +#~ "distribution (`11`), see [Ubuntu " +#~ "packages](https://packages.ubuntu.com/search?keywords=openjdk)." +#~ msgstr "" + +#~ msgid "" +#~ "```bash # From the root of the " +#~ "project # Build the image with " +#~ "different arguments docker build --rm " +#~ "--force-rm \\" +#~ msgstr "" + +#~ msgid "" +#~ "-t jupyter/pyspark-notebook:spark-2.4.7 " +#~ "./pyspark-notebook \\ --build-arg " +#~ "spark_version=2.4.7 \\ --build-arg " +#~ "hadoop_version=2.7 \\ --build-arg " +#~ "spark_checksum=0F5455672045F6110B030CE343C049855B7BA86C0ECB5E39A075FF9D093C7F648DA55DED12E72FFE65D84C32DCD5418A6D764F2D6295A3F894A4286CC80EF478" +#~ " \\ --build-arg openjdk_version=8" +#~ msgstr "" + +#~ msgid "" +#~ "# Check the newly built image " +#~ "docker run -it --rm jupyter/pyspark-" +#~ "notebook:spark-2.4.7 pyspark --version" +#~ msgstr "" + +#~ msgid "" +#~ "# Welcome to # ____ " +#~ "__ # / __/__ ___ _____/ /__" +#~ " # _\\ \\/ _ \\/ _ `/ " +#~ "__/ '_/ # /___/ .__/\\_,_/_/ " +#~ "/_/\\_\\ version 2.4.7 # /_/ #" +#~ " # Using Scala version 2.11.12, " +#~ "OpenJDK 64-Bit Server VM, 1.8.0_275 ```" +#~ msgstr "" + +#~ msgid "### Usage Examples" +#~ msgstr "" + +#~ msgid "#### Using Spark Local Mode" +#~ msgstr "" + +#~ msgid "##### Local Mode in Python" +#~ msgstr "" + +#~ msgid "```python from pyspark.sql import SparkSession" +#~ msgstr "" + +#~ msgid "" +#~ "# Spark session & context spark =" +#~ " SparkSession.builder.master('local').getOrCreate() sc " +#~ "= spark.sparkContext" +#~ msgstr "" + +#~ msgid "" +#~ "# Sum of the first 100 whole " +#~ "numbers rdd = sc.parallelize(range(100 + " +#~ "1)) rdd.sum() # 5050 ```" +#~ msgstr "" + +#~ msgid "##### Local Mode in R" +#~ msgstr "" + +#~ msgid "```R library(SparkR)" +#~ msgstr "" + +#~ msgid "# Spark session & context sc <- sparkR.session(\"local\")" +#~ msgstr "" + +#~ msgid "" +#~ "# Sum of the first 100 whole " +#~ "numbers sdf <- createDataFrame(list(1:100)) " +#~ "dapplyCollect(sdf," +#~ msgstr "" + +#~ msgid "function(x) { x <- sum(x)}" +#~ msgstr "" + +#~ msgid ")" +#~ msgstr "" + +#~ msgid "# 5050 ```" +#~ msgstr "" + +#~ msgid "```R library(sparklyr)" +#~ msgstr "" + +#~ msgid "" +#~ "# Spark configuration conf <- " +#~ "spark_config() # Set the catalog " +#~ "implementation in-memory " +#~ "conf$spark.sql.catalogImplementation <- \"in-" +#~ "memory\"" +#~ msgstr "" + +#~ msgid "" +#~ "# Spark session & context sc <-" +#~ " spark_connect(master = \"local\", config =" +#~ " conf)" +#~ msgstr "" + +#~ msgid "" +#~ "# Sum of the first 100 whole " +#~ "numbers sdf_len(sc, 100, repartition = " +#~ "1) %>%" +#~ msgstr "" + +#~ msgid "spark_apply(function(e) sum(e))" +#~ msgstr "" + +#~ msgid "##### Local Mode in Scala" +#~ msgstr "" + +#~ msgid "" +#~ "```python %%init_spark # Configure Spark " +#~ "to use a local master launcher.master" +#~ " = \"local\" ```" +#~ msgstr "" + +#~ msgid "" +#~ "```scala // Sum of the first 100" +#~ " whole numbers val rdd = " +#~ "sc.parallelize(0 to 100) rdd.sum() // " +#~ "5050 ```" +#~ msgstr "" + +#~ msgid "#### Connecting to a Spark Cluster in Standalone Mode" +#~ msgstr "" + +#~ 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](http://spark.apache.org/docs/latest" +#~ "/cluster-overview.html#components).) * NOTE: When" +#~ " using `--net=host`, you must also " +#~ "use the flags `--pid=host -e " +#~ "TINI_SUBREAPER=true`. See for details." +#~ msgstr "" + +#~ msgid "##### Standalone Mode in Python" +#~ msgstr "" + +#~ msgid "" +#~ "# Spark session & context spark =" +#~ " SparkSession.builder.master('spark://master:7077').getOrCreate()" +#~ " sc = spark.sparkContext" +#~ msgstr "" + +#~ msgid "##### Standalone Mode in R" +#~ msgstr "" + +#~ msgid "# Spark session & context sc <- sparkR.session(\"spark://master:7077\")" +#~ msgstr "" + +#~ msgid "" +#~ "# Spark session & context # Spark" +#~ " configuration conf <- spark_config() # " +#~ "Set the catalog implementation in-memory" +#~ " conf$spark.sql.catalogImplementation <- \"in-" +#~ "memory\" sc <- spark_connect(master = " +#~ "\"spark://master:7077\", config = conf)" +#~ msgstr "" + +#~ msgid "##### Standalone Mode in Scala" +#~ msgstr "" + +#~ msgid "" +#~ "```python %%init_spark # Configure Spark " +#~ "to use a local master launcher.master" +#~ " = \"spark://master:7077\" ```" +#~ msgstr "" + +#~ msgid "## Tensorflow" +#~ msgstr "" + +#~ msgid "### Single Machine Mode" +#~ msgstr "" + +#~ msgid "```python import tensorflow as tf" +#~ msgstr "" + +#~ msgid "hello = tf.Variable('Hello World!')" +#~ msgstr "" + +#~ msgid "sess = tf.Session() init = tf.global_variables_initializer()" +#~ msgstr "" + +#~ msgid "sess.run(init) sess.run(hello) ```" +#~ msgstr "" + +#~ msgid "### Distributed Mode" +#~ msgstr "" + +#~ msgid "hello = tf.Variable('Hello Distributed World!')" +#~ msgstr "" + +#~ msgid "" +#~ "server = tf.train.Server.create_local_server() sess" +#~ " = tf.Session(server.target) init = " +#~ "tf.global_variables_initializer()" +#~ msgstr "" + +#~ msgid "" +#~ "[sparkr]: https://spark.apache.org/docs/latest/sparkr.html " +#~ "[sparklyr]: https://spark.rstudio.com/ [spark-conf]:" +#~ " https://spark.apache.org/docs/latest/configuration.html" +#~ msgstr "" +