[ https://issues.apache.org/jira/browse/BEAM-8209?focusedWorklogId=317942&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-317942 ]
ASF GitHub Bot logged work on BEAM-8209: ---------------------------------------- Author: ASF GitHub Bot Created on: 25/Sep/19 00:43 Start Date: 25/Sep/19 00:43 Worklog Time Spent: 10m Work Description: Hannah-Jiang commented on pull request #9607: [BEAM-8209] Custom container docs URL: https://github.com/apache/beam/pull/9607#discussion_r327878351 ########## File path: website/src/documentation/runtime/environments.md ########## @@ -0,0 +1,187 @@ +--- +layout: section +title: "Runtime environments" +section_menu: section-menu/documentation.html +permalink: /documentation/runtime/environments/ +redirect_from: + - /documentation/execution-model/ +--- +<!-- +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> + +# Runtime environments + +Any execution engine can run the Beam SDK beacuse the SDK runtime environment is [containerized](https://s.apache.org/beam-fn-api-container-contract) with [Docker](https://www.docker.com/) and isolated from other runtime systems. This page describes how to build, customize, and push Beam SDK container images. + +## Building container images + +Before building Beam SDK container images: +* Register a [Bintray](https://bintray.com/) account with a Docker repository named `apache`. +* Install [Docker](https://www.docker.com/) on your workstation. + +To build Beam SDK container images: + +<ol> + <li> + Navigate to your local copy of the <a href="https://github.com/apache/beam"><code>beam</code></a> + </li> + <li> + Run Gradle with the <code>docker</code> target: <pre>./gradlew docker</pre> + </li> +</ol> + +> **Note**: It may take a long time to build all of the container images. You can instead build the images for specific SDKs: +> +> ``` +> ./gradlew -p sdks/java/container docker +> ./gradlew -p sdks/python/container docker +> ./gradlew -p sdks/go/container docker +> ``` + +Run `docker images` to examine the containers. For example, if you successfully built the container images, the command prompt displays a response like: + +``` +REPOSITORY TAG IMAGE ID CREATED SIZE +$USER-docker-apache.bintray.io/beam/python latest 4ea515403a1a 3 minutes ago 1.27GB +$USER-docker-apache.bintray.io/beam/java latest 0103512f1d8f 34 minutes ago 780MB +$USER-docker-apache.bintray.io/beam/go latest ce055985808a 35 minutes ago 121MB +``` Review comment: Let's use these examples. ``` REPOSITORY TAG IMAGE ID CREATED SIZE apachebeam/java_sdk latest 16ca619d489e 2 weeks ago 550MB apachebeam/python2.7_sdk latest b6fb40539c29 2 weeks ago 1.78GB apachebeam/python3.5_sdk latest bae309000d09 2 weeks ago 1.85GB apachebeam/python3.6_sdk latest 42faad307d1a 2 weeks ago 1.86GB apachebeam/python3.7_sdk latest 18267df54139 2 weeks ago 1.86GB apachebeam/go_sdk latest 30cf602e9763 2 weeks ago 124MB ``` ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: us...@infra.apache.org Issue Time Tracking ------------------- Worklog Id: (was: 317942) Time Spent: 3h 10m (was: 3h) > Document custom docker containers > --------------------------------- > > Key: BEAM-8209 > URL: https://issues.apache.org/jira/browse/BEAM-8209 > Project: Beam > Issue Type: Sub-task > Components: website > Reporter: Cyrus Maden > Assignee: Cyrus Maden > Priority: Minor > Fix For: 2.16.0 > > Time Spent: 3h 10m > Remaining Estimate: 0h > -- This message was sent by Atlassian Jira (v8.3.4#803005)